ts-procedures 7.3.0 → 8.0.0

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

@@ -0,0 +1,274 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Hono } from 'hono';
+import { Type } from 'typebox';
+import { Procedures } from '../../../index.js';
+import { HonoAppBuilder } from './index.js';
+import { defineErrorTaxonomy } from '../error-taxonomy.js';
+import { DocRegistry } from '../doc-registry.js';
+describe('HonoAppBuilder — public surface', () => {
+    test('constructor with no args', () => {
+        const b = new HonoAppBuilder();
+        expect(b.app).toBeInstanceOf(Hono);
+        expect(b.docs).toEqual([]);
+        expect(b.skippedProcedures).toEqual([]);
+    });
+    test('constructor accepts existing Hono app', () => {
+        const custom = new Hono();
+        const b = new HonoAppBuilder({ app: custom });
+        expect(b.app).toBe(custom);
+    });
+    test('register is chainable', () => {
+        const b = new HonoAppBuilder();
+        const P = Procedures();
+        const result = b.register(P, () => ({}));
+        expect(result).toBe(b);
+    });
+    test('docs is lazily computed before build()', () => {
+        const b = new HonoAppBuilder();
+        const P = Procedures();
+        P.Create('A', { scope: 's', version: 1 }, async () => ({}));
+        b.register(P, () => ({}));
+        const docs1 = b.docs;
+        expect(docs1).toHaveLength(1);
+        expect(docs1[0].kind).toBe('rpc');
+        // Calling docs again returns the same cached array reference
+        expect(b.docs).toBe(docs1);
+    });
+    test('docs reads after build() return the same content', () => {
+        const b = new HonoAppBuilder();
+        const P = Procedures();
+        P.Create('A', { scope: 's', version: 1 }, async () => ({}));
+        b.register(P, () => ({}));
+        b.build();
+        expect(b.docs).toHaveLength(1);
+    });
+});
+describe('HonoAppBuilder — mixed-kind dispatch', () => {
+    test('one factory with all four kinds mounts each at the correct path', async () => {
+        const P = Procedures();
+        P.Create('Echo', { scope: 'rpc', version: 1 }, async (_ctx, p) => p);
+        P.CreateStream('Tail', { scope: 'rpc', version: 1 }, async function* () { yield 1; });
+        P.CreateHttp('GetUser', {
+            path: '/users/:id',
+            method: 'get',
+            schema: {
+                req: { pathParams: Type.Object({ id: Type.String() }) },
+                res: { body: Type.Object({ id: Type.String() }) },
+            },
+        }, async () => ({ id: '1' }));
+        P.CreateHttpStream('Watch', {
+            path: '/watch', method: 'get',
+            schema: { yield: Type.String() },
+        }, (async function* () { yield 'tick'; }));
+        const app = new HonoAppBuilder()
+            .register(P, () => ({ uid: 'u1' }))
+            .build();
+        const rpc = await app.request('/rpc/echo/1', { method: 'POST', body: '{}', headers: { 'Content-Type': 'application/json' } });
+        expect(rpc.status).toBe(200);
+        const stream = await app.request('/rpc/tail/1', { method: 'POST', body: '{}', headers: { 'Content-Type': 'application/json' } });
+        expect(stream.status).toBe(200);
+        await stream.text();
+        const http = await app.request('/users/1');
+        expect(http.status).toBe(200);
+        const httpStream = await app.request('/watch');
+        expect(httpStream.status).toBe(200);
+        await httpStream.text();
+    });
+    test('toDocEnvelope produces same shape as DocRegistry.toJSON', () => {
+        const P = Procedures();
+        P.Create('Echo', { scope: 'e', version: 1 }, async () => ({}));
+        const errors = defineErrorTaxonomy({});
+        const builder = new HonoAppBuilder({ pathPrefix: '/api', errors });
+        builder.register(P, () => ({}));
+        builder.build();
+        const builderEnvelope = builder.toDocEnvelope({ basePath: '/api', errors });
+        const registryEnvelope = new DocRegistry({ basePath: '/api', errors }).from(builder).toJSON();
+        expect(builderEnvelope.basePath).toBe(registryEnvelope.basePath);
+        expect(builderEnvelope.routes).toEqual(registryEnvelope.routes);
+        expect(builderEnvelope.errors.map(e => e.name).sort()).toEqual(registryEnvelope.errors.map(e => e.name).sort());
+    });
+    test('toDocEnvelope filter and transform options work', () => {
+        const P = Procedures();
+        P.Create('A', { scope: 's', version: 1 }, async () => ({}));
+        P.Create('B', { scope: 's', version: 1 }, async () => ({}));
+        const builder = new HonoAppBuilder().register(P, () => ({}));
+        const onlyA = builder.toDocEnvelope({ filter: r => r.name === 'A' });
+        expect(onlyA.routes).toHaveLength(1);
+        expect(onlyA.routes[0].name).toBe('A');
+        const tagged = builder.toDocEnvelope({
+            transform: env => ({ ...env, tagged: true }),
+        });
+        expect(tagged.tagged).toBe(true);
+    });
+    test('makeRoutePath static is exposed', () => {
+        const P = Procedures();
+        P.Create('GetUser', { scope: 'users', version: 1 }, async () => ({}));
+        const proc = P.getProcedure('GetUser');
+        expect(HonoAppBuilder.makeRoutePath({ procedure: proc })).toBe('/users/get-user/1');
+    });
+});
+describe('HonoAppBuilder — factoryContext variants', () => {
+    test('factoryContext as a static object is forwarded into ctx', async () => {
+        const P = Procedures();
+        P.Create('GetRequestId', { scope: 'get-request-id', version: 1 }, async (ctx) => ({
+            id: ctx.requestId,
+        }));
+        const app = new HonoAppBuilder()
+            .register(P, { requestId: 'req-123' })
+            .build();
+        const res = await app.request('/get-request-id/get-request-id/1', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({}),
+        });
+        expect(await res.json()).toEqual({ id: 'req-123' });
+    });
+    test('factoryContext as an async function is awaited and result reaches handler', async () => {
+        const factoryContext = vi.fn(async () => ({ requestId: 'req-456' }));
+        const P = Procedures();
+        P.Create('GetRequestId', { scope: 'get-request-id', version: 1 }, async (ctx) => ({
+            id: ctx.requestId,
+        }));
+        const app = new HonoAppBuilder().register(P, factoryContext).build();
+        const res = await app.request('/get-request-id/get-request-id/1', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({}),
+        });
+        expect(factoryContext).toHaveBeenCalledTimes(1);
+        expect(await res.json()).toEqual({ id: 'req-456' });
+    });
+    test('factoryContext rejection flows through dispatchPreStreamError → 500', async () => {
+        const P = Procedures();
+        P.Create('GetRequestId', { scope: 'get-request-id', version: 1 }, async (ctx) => ({
+            id: ctx.requestId,
+        }));
+        const app = new HonoAppBuilder()
+            .register(P, async () => {
+            throw new Error('context-load-failed');
+        })
+            .build();
+        const res = await app.request('/get-request-id/get-request-id/1', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({}),
+        });
+        expect(res.status).toBe(500);
+        const body = await res.json();
+        expect(body.error).toContain('context-load-failed');
+    });
+    test('factoryContext function receives Hono Context with req.header access', async () => {
+        const factoryContext = vi.fn((c) => ({
+            authHeader: c.req.header('authorization'),
+        }));
+        const P = Procedures();
+        P.Create('GetAuth', { scope: 'get-auth', version: 1 }, async (ctx) => ({
+            auth: ctx.authHeader,
+        }));
+        const app = new HonoAppBuilder().register(P, factoryContext).build();
+        const res = await app.request('/get-auth/get-auth/1', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: 'Bearer token123',
+            },
+            body: JSON.stringify({}),
+        });
+        expect(factoryContext).toHaveBeenCalledTimes(1);
+        expect(factoryContext.mock.calls[0][0]).toHaveProperty('req');
+        expect(await res.json()).toEqual({ auth: 'Bearer token123' });
+    });
+});
+describe('HonoAppBuilder — extendProcedureDoc discriminated union per kind', () => {
+    test('rpc: base.kind === "rpc" and returned object is merged into doc', () => {
+        const extend = vi.fn(({ base }) => ({
+            summary: `RPC: ${base.kind}`,
+            tags: ['rpc'],
+        }));
+        const P = Procedures();
+        P.Create('GetUser', { scope: 'users', version: 1 }, async () => ({}));
+        const builder = new HonoAppBuilder().register(P, () => ({}), { extendProcedureDoc: extend });
+        builder.build();
+        expect(extend).toHaveBeenCalledTimes(1);
+        expect(extend.mock.calls[0][0].base.kind).toBe('rpc');
+        const doc = builder.docs[0];
+        expect(doc.summary).toBe('RPC: rpc');
+        expect(doc.tags).toEqual(['rpc']);
+    });
+    test('api (http): base.kind === "api" and returned object is merged into doc', () => {
+        const extend = vi.fn(({ base }) => ({
+            summary: `API: ${base.kind}`,
+            tags: ['api'],
+        }));
+        const P = Procedures();
+        P.CreateHttp('GetUser', {
+            path: '/users/:id',
+            method: 'get',
+            schema: {
+                req: { pathParams: Type.Object({ id: Type.String() }) },
+                res: { body: Type.Object({ id: Type.String() }) },
+            },
+        }, async () => ({ id: '1' }));
+        const builder = new HonoAppBuilder().register(P, () => ({}), { extendProcedureDoc: extend });
+        builder.build();
+        expect(extend).toHaveBeenCalledTimes(1);
+        expect(extend.mock.calls[0][0].base.kind).toBe('api');
+        const doc = builder.docs[0];
+        expect(doc.summary).toBe('API: api');
+        expect(doc.tags).toEqual(['api']);
+    });
+    test('rpc-stream: base.kind === "stream" and returned object is merged into doc', () => {
+        const extend = vi.fn(({ base }) => ({
+            summary: `Stream: ${base.kind}`,
+            tags: ['stream'],
+        }));
+        const P = Procedures();
+        P.CreateStream('Tail', { scope: 'rpc', version: 1 }, async function* () {
+            yield 1;
+        });
+        const builder = new HonoAppBuilder().register(P, () => ({}), { extendProcedureDoc: extend });
+        builder.build();
+        expect(extend).toHaveBeenCalledTimes(1);
+        expect(extend.mock.calls[0][0].base.kind).toBe('stream');
+        const doc = builder.docs[0];
+        expect(doc.summary).toBe('Stream: stream');
+        expect(doc.tags).toEqual(['stream']);
+    });
+    test('http-stream: base.kind === "http-stream" and returned object is merged into doc', () => {
+        const extend = vi.fn(({ base }) => ({
+            summary: `HTTP-Stream: ${base.kind}`,
+            tags: ['http-stream'],
+        }));
+        const P = Procedures();
+        P.CreateHttpStream('Watch', { path: '/watch', method: 'get', schema: { yield: Type.String() } }, (async function* () {
+            yield 'tick';
+        }));
+        const builder = new HonoAppBuilder().register(P, () => ({}), { extendProcedureDoc: extend });
+        builder.build();
+        expect(extend).toHaveBeenCalledTimes(1);
+        expect(extend.mock.calls[0][0].base.kind).toBe('http-stream');
+        const doc = builder.docs[0];
+        expect(doc.summary).toBe('HTTP-Stream: http-stream');
+        expect(doc.tags).toEqual(['http-stream']);
+    });
+});
+describe('HonoAppBuilder — per-factory streamMode override', () => {
+    test('register options.streamMode overrides stream.defaultStreamMode', async () => {
+        const P = Procedures();
+        P.CreateStream('Test', { scope: 'test', version: 1 }, async function* () {
+            yield { ok: true };
+        });
+        const app = new HonoAppBuilder({ stream: { defaultStreamMode: 'sse' } })
+            .register(P, () => ({}), { streamMode: 'text' })
+            .build();
+        const res = await app.request('/test/test/1', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: '{}',
+        });
+        expect(res.headers.get('content-type')).toContain('text/plain');
+        // Drain the response so the stream lifecycle completes cleanly.
+        await res.text();
+    });
+});
+//# sourceMappingURL=index.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../src/implementations/http/hono/index.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,mBAAmB,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,IAAI,cAAc,EAAE,CAAA;QAC9B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC1B,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAA;QACzB,MAAM,CAAC,GAAG,IAAI,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7C,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,IAAI,cAAc,EAAE,CAAA;QAC9B,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,IAAI,cAAc,EAAE,CAAA;QAC9B,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3D,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAEzB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAA;QACpB,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClC,6DAA6D;QAC7D,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,IAAI,cAAc,EAAE,CAAA;QAC9B,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3D,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACzB,CAAC,CAAC,KAAK,EAAE,CAAA;QACT,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,IAAI,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,CAAC,GAAG,UAAU,EAA8B,CAAA;QAClD,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,SAAS,CAAC,MAAM,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QACpF,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE;YACtB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE;gBACN,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;gBACvD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;aAClD;SACF,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;QAC7B,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE;YAC1B,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK;YAC7B,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE;SACjC,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,MAAM,MAAM,CAAA,CAAC,CAAC,CAAQ,CAAC,CAAA;QAEhD,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE;aAC7B,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;aAClC,KAAK,EAAE,CAAA;QAEV,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAC7H,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE5B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAChI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAEnB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE7B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnC,MAAM,UAAU,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAE9D,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAA;QACtC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAClE,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3E,MAAM,gBAAgB,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAA;QAE7F,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAChE,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC/D,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACjH,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3D,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAE3D,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAA;QACpE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEvC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YACnC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAQ;SACpD,CAAQ,CAAA;QACT,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACrE,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,SAAS,CAAE,CAAA;QACvC,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,IAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC5F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,CAAC,GAAG,UAAU,EAAoC,CAAA;QACxD,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAChF,EAAE,EAAE,GAAG,CAAC,SAAS;SAClB,CAAC,CAAC,CAAA;QAEH,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE;aAC7B,QAAQ,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;aACrC,KAAK,EAAE,CAAA;QAEV,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,kCAAkC,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACzB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QACpE,MAAM,CAAC,GAAG,UAAU,EAAoC,CAAA;QACxD,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAChF,EAAE,EAAE,GAAG,CAAC,SAAS;SAClB,CAAC,CAAC,CAAA;QAEH,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,KAAK,EAAE,CAAA;QAEpE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,kCAAkC,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACzB,CAAC,CAAA;QACF,MAAM,CAAC,cAAc,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,CAAC,GAAG,UAAU,EAAoC,CAAA;QACxD,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAChF,EAAE,EAAE,GAAG,CAAC,SAAS;SAClB,CAAC,CAAC,CAAA;QAEH,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE;aAC7B,QAAQ,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QACxC,CAAC,CAAC;aACD,KAAK,EAAE,CAAA;QAEV,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,kCAAkC,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACzB,CAAC,CAAA;QACF,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,qBAAqB,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACxC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC;SAC1C,CAAC,CAAC,CAAA;QACH,MAAM,CAAC,GAAG,UAAU,EAAsC,CAAA;QAC1D,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACrE,IAAI,EAAE,GAAG,CAAC,UAAU;SACrB,CAAC,CAAC,CAAA;QAEH,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,KAAK,EAAE,CAAA;QAEpE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,iBAAiB;aACjC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACzB,CAAC,CAAA;QACF,MAAM,CAAC,cAAc,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QAC9D,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAChF,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;QAC3E,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAA8B,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,CAAC,KAAK,CAAC;SACd,CAAC,CAAC,CAAA;QACH,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAErE,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5F,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAClF,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAA8B,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,CAAC,KAAK,CAAC;SACd,CAAC,CAAC,CAAA;QACH,MAAM,CAAC,GAAG,UAAU,EAAM,CAAA;QAC1B,CAAC,CAAC,UAAU,CACV,SAAS,EACT;YACE,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE;gBACN,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;gBACvD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;aAClD;SACF,EACD,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAC1B,CAAA;QAED,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5F,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACrF,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAA8B,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;YAC/B,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB,CAAC,CAAC,CAAA;QACH,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,SAAS,CAAC;YAClE,MAAM,CAAC,CAAA;QACT,CAAC,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5F,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iFAAiF,EAAE,GAAG,EAAE;QAC3F,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAA8B,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,gBAAgB,IAAI,CAAC,IAAI,EAAE;YACpC,IAAI,EAAE,CAAC,aAAa,CAAC;SACtB,CAAC,CAAC,CAAA;QACH,MAAM,CAAC,GAAG,UAAU,EAAM,CAAA;QAC1B,CAAC,CAAC,gBAAgB,CAChB,OAAO,EACP,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EACnE,CAAC,KAAK,SAAS,CAAC;YACd,MAAM,MAAM,CAAA;QACd,CAAC,CAAQ,CACV,CAAA;QAED,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5F,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,IAAI,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,CAAC,GAAG,UAAU,EAAiB,CAAA;QACrC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,SAAS,CAAC;YACnE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACpB,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAAE,CAAC;aACrE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;aAC/C,KAAK,EAAE,CAAA;QAEV,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;SACX,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QAC/D,gEAAgE;QAChE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IAClB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,17 @@
+import type { TProcedureRegistration, TStreamProcedureRegistration, THttpProcedureRegistration, THttpStreamProcedureRegistration } from '../../../types.js';
+export type AnyProcedureRegistration = TProcedureRegistration | TStreamProcedureRegistration | THttpProcedureRegistration<any> | THttpStreamProcedureRegistration<any>;
+/**
+ * Resolves the full route path for any procedure kind.
+ *
+ * - `rpc` / `rpc-stream`: `{prefix}/{kebab(scope)}/{kebab(name)}/{version}`
+ * - `http` / `http-stream`: `{prefix}{config.path}` (path-as-given, prefix normalized)
+ */
+export declare function makeRoutePath({ procedure, prefix, }: {
+    procedure: AnyProcedureRegistration;
+    prefix?: string;
+}): string;
+/**
+ * Combines a developer-supplied path with an optional prefix. Both are
+ * normalized to begin with a single `/`.
+ */
+export declare function resolveFullPath(procedurePath: string, prefix?: string): string;

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

@@ -0,0 +1,39 @@
+import { kebabCase } from 'es-toolkit/string';
+import { castArray } from 'es-toolkit/compat';
+function normalizePrefix(prefix) {
+    if (!prefix)
+        return '';
+    return prefix.startsWith('/') ? prefix : `/${prefix}`;
+}
+/**
+ * Resolves the full route path for any procedure kind.
+ *
+ * - `rpc` / `rpc-stream`: `{prefix}/{kebab(scope)}/{kebab(name)}/{version}`
+ * - `http` / `http-stream`: `{prefix}{config.path}` (path-as-given, prefix normalized)
+ */
+export function makeRoutePath({ procedure, prefix, }) {
+    const normalizedPrefix = normalizePrefix(prefix);
+    switch (procedure.kind) {
+        case 'rpc':
+        case 'rpc-stream': {
+            const cfg = procedure.config;
+            const scopeSegments = castArray(cfg.scope).map(kebabCase).join('/');
+            return `${normalizedPrefix}/${scopeSegments}/${kebabCase(procedure.name)}/${String(cfg.version).trim()}`;
+        }
+        case 'http':
+        case 'http-stream': {
+            const cfg = procedure.config;
+            return resolveFullPath(cfg.path, prefix);
+        }
+    }
+}
+/**
+ * Combines a developer-supplied path with an optional prefix. Both are
+ * normalized to begin with a single `/`.
+ */
+export function resolveFullPath(procedurePath, prefix) {
+    const normalizedPrefix = normalizePrefix(prefix);
+    const normalizedPath = procedurePath.startsWith('/') ? procedurePath : `/${procedurePath}`;
+    return `${normalizedPrefix}${normalizedPath}`;
+}
+//# sourceMappingURL=path.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../../src/implementations/http/hono/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAc7C,SAAS,eAAe,CAAC,MAAe;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAA;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,SAAS,EACT,MAAM,GAIP;IACC,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAEhD,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,KAAK,CAAC;QACX,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,GAAG,GAAG,SAAS,CAAC,MAAuD,CAAA;YAC7E,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACnE,OAAO,GAAG,gBAAgB,IAAI,aAAa,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;QAC1G,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,SAAS,CAAC,MAA0B,CAAA;YAChD,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB,EAAE,MAAe;IACpE,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAChD,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAA;IAC1F,OAAO,GAAG,gBAAgB,GAAG,cAAc,EAAE,CAAA;AAC/C,CAAC"}

package/build/implementations/http/hono/path.test.d.ts

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

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

@@ -0,0 +1,83 @@
+import { describe, expect, test } from 'vitest';
+import { makeRoutePath, resolveFullPath } from './path.js';
+describe('makeRoutePath', () => {
+    test('rpc: scope/name/version with kebab-case', () => {
+        const proc = {
+            name: 'GetUser',
+            kind: 'rpc',
+            config: { scope: 'users', version: 1 },
+            handler: async () => undefined,
+        };
+        expect(makeRoutePath({ procedure: proc })).toBe('/users/get-user/1');
+    });
+    test('rpc: array scope joined with /', () => {
+        const proc = {
+            name: 'List',
+            kind: 'rpc',
+            config: { scope: ['UserModule', 'admin'], version: 2 },
+            handler: async () => undefined,
+        };
+        expect(makeRoutePath({ procedure: proc })).toBe('/user-module/admin/list/2');
+    });
+    test('rpc: pathPrefix is normalized (leading slash inserted)', () => {
+        const proc = {
+            name: 'Echo',
+            kind: 'rpc',
+            config: { scope: 'echo', version: 1 },
+            handler: async () => undefined,
+        };
+        expect(makeRoutePath({ procedure: proc, prefix: 'api/v1' })).toBe('/api/v1/echo/echo/1');
+    });
+    test('rpc-stream: same shape as rpc', () => {
+        const proc = {
+            name: 'Tail',
+            kind: 'rpc-stream',
+            isStream: true,
+            config: { scope: 'logs', version: 1 },
+            handler: async function* () { },
+        };
+        expect(makeRoutePath({ procedure: proc, prefix: '/api' })).toBe('/api/logs/tail/1');
+    });
+    test('http: prepends prefix to config.path', () => {
+        const proc = {
+            name: 'GetUser',
+            kind: 'http',
+            config: { path: '/users/:id', method: 'get' },
+            handler: async () => undefined,
+        };
+        expect(makeRoutePath({ procedure: proc, prefix: '/api/v1' })).toBe('/api/v1/users/:id');
+    });
+    test('http: leading slash on path is preserved (not duplicated)', () => {
+        const proc = {
+            name: 'Get',
+            kind: 'http',
+            config: { path: 'users', method: 'get' },
+            handler: async () => undefined,
+        };
+        expect(makeRoutePath({ procedure: proc, prefix: '/api' })).toBe('/api/users');
+    });
+    test('http-stream: same shape as http', () => {
+        const proc = {
+            name: 'TailLogs',
+            kind: 'http-stream',
+            config: { path: '/logs/tail', method: 'get' },
+            handler: async () => ({ stream: (async function* () { })(), initialHeaders: undefined }),
+        };
+        expect(makeRoutePath({ procedure: proc })).toBe('/logs/tail');
+    });
+});
+describe('resolveFullPath', () => {
+    test('combines prefix and path', () => {
+        expect(resolveFullPath('/users', '/api/v1')).toBe('/api/v1/users');
+    });
+    test('normalizes prefix without leading slash', () => {
+        expect(resolveFullPath('/users', 'api')).toBe('/api/users');
+    });
+    test('normalizes path without leading slash', () => {
+        expect(resolveFullPath('users', '/api')).toBe('/api/users');
+    });
+    test('no prefix', () => {
+        expect(resolveFullPath('/users')).toBe('/users');
+    });
+});
+//# sourceMappingURL=path.test.js.map

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

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

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

@@ -0,0 +1,51 @@
+import type { Context, Hono } from 'hono';
+import type { ErrorTaxonomy, UnknownErrorConfig } from '../error-taxonomy.js';
+import type { AnyProcedureRegistration, OnRequestErrorObserver, OnMidStreamError, PreStreamOnError } from '../error-dispatch.js';
+import type { ProceduresFactory, ExtractContext, StreamMode, AnyHttpRouteDoc, RPCHttpRouteDoc, APIHttpRouteDoc, StreamHttpRouteDoc, HttpStreamRouteDoc } from '../../types.js';
+import type { TProcedureRegistration, TStreamProcedureRegistration, THttpProcedureRegistration, THttpStreamProcedureRegistration } from '../../../types.js';
+export type { AnyProcedureRegistration } from '../error-dispatch.js';
+/** Default query parser using URLSearchParams. */
+export type QueryParser = (queryString: string) => Record<string, unknown>;
+export type OnRequestErrorContext = {
+    err: unknown;
+    procedure: AnyProcedureRegistration;
+    raw: Context;
+};
+export type ExtendProcedureDoc = (params: {
+    base: RPCHttpRouteDoc | APIHttpRouteDoc | StreamHttpRouteDoc | HttpStreamRouteDoc;
+    procedure: AnyProcedureRegistration;
+}) => Record<string, unknown>;
+export type HonoFactoryItem<TFactory extends ProceduresFactory = ProceduresFactory> = {
+    factory: TFactory;
+    factoryContext: ExtractContext<TFactory> | ((c: Context) => ExtractContext<TFactory> | Promise<ExtractContext<TFactory>>);
+    streamMode?: StreamMode;
+    extendProcedureDoc?: ExtendProcedureDoc;
+};
+export type HonoAppBuilderConfig<TStreamErrorData = unknown> = {
+    /** Existing Hono app. If omitted, a new instance is created. */
+    app?: Hono;
+    /** Path prefix applied to every route across all kinds. */
+    pathPrefix?: string;
+    errors?: ErrorTaxonomy;
+    unknownError?: UnknownErrorConfig;
+    onError?: PreStreamOnError;
+    /** Cross-cutting observer — fires for every caught error before dispatch. */
+    onRequestError?: OnRequestErrorObserver;
+    onRequestStart?: (c: Context) => void;
+    onRequestEnd?: (c: Context) => void;
+    rpc?: {
+        onSuccess?: (procedure: TProcedureRegistration, c: Context) => void;
+    };
+    api?: {
+        queryParser?: QueryParser;
+        onSuccess?: (procedure: THttpProcedureRegistration<any>, c: Context) => void;
+    };
+    stream?: {
+        /** Default for both rpc-stream and http-stream. */
+        defaultStreamMode?: StreamMode;
+        onStreamStart?: (procedure: TStreamProcedureRegistration | THttpStreamProcedureRegistration<any>, c: Context, streamMode: StreamMode) => void;
+        onStreamEnd?: (procedure: TStreamProcedureRegistration | THttpStreamProcedureRegistration<any>, c: Context, streamMode: StreamMode) => void;
+        onMidStreamError?: OnMidStreamError<TStreamErrorData>;
+    };
+};
+export type DocAccumulator = AnyHttpRouteDoc[];

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/implementations/http/hono/types.ts"],"names":[],"mappings":""}

package/build/implementations/http/on-request-error.test.js

@@ -2,7 +2,7 @@
 /**
  * Cross-builder tests for the `onRequestError` observer hook.
  *
- * Invariants verified once per builder:
+ * Invariants verified per builder:
  *   1. Fires exactly once for every caught error.
  *   2. Runs BEFORE dispatch (taxonomy / onError / hard default).
  *   3. Is awaited — async observer work completes before the response is sent.
@@ -12,75 +12,16 @@
  *      path still produces a response.
  */
 import { describe, expect, test, vi } from 'vitest';
-import request from 'supertest';
 import { Type } from 'typebox';
 import { Procedures } from '../../index.js';
-import { HonoAPIAppBuilder } from './hono-api/index.js';
-import { HonoRPCAppBuilder } from './hono-rpc/index.js';
-import { ExpressRPCAppBuilder } from './express-rpc/index.js';
-import { HonoStreamAppBuilder } from './hono-stream/index.js';
-describe('onRequestError — HonoAPIAppBuilder', () => {
-    function boomApp(config) {
-        const API = Procedures();
-        API.Create('Boom', { path: '/boom', method: 'get', schema: { returnType: Type.Object({}) } }, async () => {
-            throw new TypeError('boom');
-        });
-        return new HonoAPIAppBuilder(config).register(API, () => ({})).build();
-    }
-    test('fires exactly once and before dispatch', async () => {
-        const order = [];
-        const onRequestError = vi.fn(() => {
-            order.push('observer');
-        });
-        const onError = vi.fn((_p, c) => {
-            order.push('onError');
-            return c.json({ handled: true }, 418);
-        });
-        const app = boomApp({ onRequestError, onError });
-        await app.request('/boom');
-        expect(onRequestError).toHaveBeenCalledTimes(1);
-        expect(order).toEqual(['observer', 'onError']);
-    });
-    test('is awaited — async work completes before response is sent', async () => {
-        const log = [];
-        const onRequestError = async () => {
-            await new Promise((r) => setTimeout(r, 5));
-            log.push('observer-done');
-        };
-        const app = boomApp({
-            onRequestError,
-            onError: (_p, c) => {
-                log.push('onError-called');
-                return c.json({ ok: true }, 500);
-            },
-        });
-        await app.request('/boom');
-        expect(log).toEqual(['observer-done', 'onError-called']);
-    });
-    test('observer-thrown errors are swallowed — dispatch still produces a response', async () => {
-        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-        const app = boomApp({
-            onRequestError: () => {
-                throw new Error('observer exploded');
-            },
-        });
-        const res = await app.request('/boom');
-        expect(res.status).toBe(500);
-        consoleSpy.mockRestore();
-    });
-    test('omitting observer preserves existing behavior', async () => {
-        const app = boomApp({ onError: (_p, c) => c.json({ ok: true }, 418) });
-        const res = await app.request('/boom');
-        expect(res.status).toBe(418);
-    });
-});
-describe('onRequestError — HonoRPCAppBuilder', () => {
+import { HonoAppBuilder } from './hono/index.js';
+describe('onRequestError — HonoAppBuilder (rpc kind)', () => {
     function boomApp(config) {
         const RPC = Procedures();
         RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
             throw new TypeError('boom');
         });
-        return new HonoRPCAppBuilder(config).register(RPC, () => ({})).build();
+        return new HonoAppBuilder(config).register(RPC, () => ({})).build();
     }
     test('fires once; runs before onError', async () => {
         const order = [];
@@ -108,44 +49,13 @@ describe('onRequestError — HonoRPCAppBuilder', () => {
         consoleSpy.mockRestore();
     });
 });
-describe('onRequestError — ExpressRPCAppBuilder', () => {
-    function boomApp(config) {
-        const RPC = Procedures();
-        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
-            throw new TypeError('boom');
-        });
-        return new ExpressRPCAppBuilder(config).register(RPC, () => ({})).build();
-    }
-    test('fires once; raw is { req, res }', async () => {
-        let rawSeen;
-        const app = boomApp({
-            onRequestError: (ctx) => {
-                rawSeen = ctx.raw;
-            },
-        });
-        await request(app).post('/test/boom/1').send({});
-        expect(rawSeen.req).toBeDefined();
-        expect(rawSeen.res).toBeDefined();
-    });
-    test('observer throws are swallowed', async () => {
-        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-        const app = boomApp({
-            onRequestError: () => {
-                throw new Error('observer bug');
-            },
-        });
-        const res = await request(app).post('/test/boom/1').send({});
-        expect(res.status).toBe(500);
-        consoleSpy.mockRestore();
-    });
-});
-describe('onRequestError — HonoStreamAppBuilder (pre-stream)', () => {
+describe('onRequestError — HonoAppBuilder (rpc-stream pre-stream)', () => {
     function boomApp(config) {
         const RPC = Procedures();
         RPC.CreateStream('Stream', { scope: 'test', version: 1 }, async function* () {
             yield { ok: true };
         });
-        return new HonoStreamAppBuilder(config)
+        return new HonoAppBuilder(config)
             .register(RPC, () => {
             throw new TypeError('context failed');
         })