ts-procedures 5.16.0 → 6.0.0

package/build/implementations/http/express-rpc/index.js

@@ -1,6 +1,8 @@
 import express from 'express';
 import { kebabCase } from 'es-toolkit/string';
+import { defineErrorTaxonomy, resolveErrorResponse, } from '../error-taxonomy.js';
 import { castArray } from 'es-toolkit/compat';
+export { defineErrorTaxonomy };
 /**
  * Builder class for creating an Express application with RPC routes.
  *
@@ -49,11 +51,13 @@ export class ExpressRPCAppBuilder {
     }
     /**
      * Generates the RPC route path based on the RPC configuration.
-     * The RPCConfig name can be a string or an array of strings to form nested paths.
+     * `RPCConfig.scope` can be a string or an array of strings to form nested paths.
      *
      * Example
-     *  name: ['string', 'string-string', 'string']
-     *  path: /string/string-string/string/version
+     *  name:  'GetUser'
+     *  scope: ['users', 'profile']
+     *  version: 1
+     *  path: /users/profile/get-user/1
      * @param config
      */
     static makeRPCHttpRoutePath({ name, config, prefix, }) {
@@ -127,16 +131,40 @@ export class ExpressRPCAppBuilder {
                         }
                     }
                     catch (error) {
+                        if (this.config?.onRequestError) {
+                            try {
+                                await this.config.onRequestError({ err: error, procedure, raw: { req, res } });
+                            }
+                            catch (observerErr) {
+                                console.error('[ts-procedures express-rpc] onRequestError threw — swallowed:', observerErr);
+                            }
+                        }
+                        if (this.config?.errors || this.config?.unknownError) {
+                            const resolved = resolveErrorResponse({
+                                err: error,
+                                userTaxonomy: this.config.errors,
+                                unknownError: this.config.unknownError,
+                                procedure,
+                                raw: { req, res },
+                            });
+                            if (resolved) {
+                                await resolved.runOnCatch();
+                                if (!res.headersSent) {
+                                    res.status(resolved.statusCode).json(resolved.body);
+                                }
+                                return;
+                            }
+                        }
                         if (this.config?.onError) {
                             this.config.onError(procedure, req, res, error);
                             return;
                         }
-                        if (!res.status) {
-                            res.status(500);
-                        }
-                        // if no res.json set, set default error message
+                        // Hard default — `res.status` is always truthy (it's a method),
+                        // so the previous `if (!res.status)` guard never ran. Set status
+                        // and body together unconditionally, respecting an already-sent
+                        // response.
                         if (!res.headersSent) {
-                            res.json({ error: error.message });
+                            res.status(500).json({ error: error.message });
                         }
                     }
                 });
@@ -172,6 +200,9 @@ export class ExpressRPCAppBuilder {
             method,
             jsonSchema,
         };
+        if (config.errors && config.errors.length > 0) {
+            base.errors = [...config.errors];
+        }
         let extendedDoc = {};
         if (extendProcedureDoc) {
             extendedDoc = extendProcedureDoc({ base, procedure });

package/build/implementations/http/express-rpc/index.js.map

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

package/build/implementations/http/hono-api/error-taxonomy.test.d.ts

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

package/build/implementations/http/hono-api/error-taxonomy.test.js

@@ -0,0 +1,137 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Type } from 'typebox';
+import { Procedures } from '../../../index.js';
+import { HonoAPIAppBuilder, defineErrorTaxonomy } from './index.js';
+class UseCaseError extends Error {
+    externalMsg;
+    internalMsg;
+    constructor(externalMsg, internalMsg) {
+        super(externalMsg);
+        this.externalMsg = externalMsg;
+        this.internalMsg = internalMsg;
+        this.name = 'UseCaseError';
+        Object.setPrototypeOf(this, UseCaseError.prototype);
+    }
+}
+describe('HonoAPIAppBuilder — error taxonomy', () => {
+    test('taxonomy serializes user error with configured status + body', async () => {
+        const errors = defineErrorTaxonomy({
+            UseCaseError: {
+                class: UseCaseError,
+                statusCode: 422,
+                toResponse: (err) => ({ name: 'UseCaseError', message: err.externalMsg }),
+            },
+        });
+        const API = Procedures();
+        API.Create('Boom', {
+            path: '/boom',
+            method: 'get',
+            schema: { returnType: Type.Object({}) },
+        }, async () => {
+            throw new UseCaseError('public detail', 'private stack');
+        });
+        const app = new HonoAPIAppBuilder({ errors }).register(API, () => ({})).build();
+        const res = await app.request('/boom');
+        expect(res.status).toBe(422);
+        expect(await res.json()).toEqual({ name: 'UseCaseError', message: 'public detail' });
+    });
+    test('onCatch is awaited before response is sent', async () => {
+        const logged = [];
+        const onCatch = vi.fn(async (err) => {
+            await Promise.resolve();
+            logged.push(err.internalMsg);
+        });
+        const errors = defineErrorTaxonomy({
+            UseCaseError: {
+                class: UseCaseError,
+                statusCode: 422,
+                onCatch,
+            },
+        });
+        const API = Procedures();
+        API.Create('Boom', { path: '/boom', method: 'get', schema: { returnType: Type.Object({}) } }, async () => {
+            throw new UseCaseError('ext', 'int-log');
+        });
+        const app = new HonoAPIAppBuilder({ errors }).register(API, () => ({})).build();
+        await app.request('/boom');
+        expect(onCatch).toHaveBeenCalledOnce();
+        expect(logged).toEqual(['int-log']);
+    });
+    test('unknownError catches errors the taxonomy does not match', async () => {
+        const API = Procedures();
+        API.Create('Boom', { path: '/boom', method: 'get', schema: { returnType: Type.Object({}) } }, async () => {
+            throw new TypeError('ts-broke');
+        });
+        const app = new HonoAPIAppBuilder({
+            unknownError: {
+                statusCode: 503,
+                toResponse: () => ({ name: 'ServiceUnavailable' }),
+            },
+        })
+            .register(API, () => ({}))
+            .build();
+        const res = await app.request('/boom');
+        expect(res.status).toBe(503);
+        expect(await res.json()).toEqual({ name: 'ServiceUnavailable' });
+    });
+    test('default taxonomy catches ProcedureValidationError at 400 when user opts in', async () => {
+        const API = Procedures();
+        API.Create('Validate', {
+            path: '/v',
+            method: 'post',
+            schema: {
+                input: { body: Type.Object({ n: Type.Number() }) },
+                returnType: Type.Object({}),
+            },
+        }, async () => ({}));
+        // Empty user taxonomy opts into the default chain.
+        const app = new HonoAPIAppBuilder({ errors: {} }).register(API, () => ({})).build();
+        const res = await app.request('/v', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ n: 'not-a-number' }),
+        });
+        expect(res.status).toBe(400);
+        const body = (await res.json());
+        expect(body.name).toBe('ProcedureValidationError');
+    });
+    test('onError callback runs when taxonomy/unknownError do not match', async () => {
+        const onError = vi.fn(async (_p, c) => c.json({ legacy: true }, 418));
+        const API = Procedures();
+        API.Create('Boom', { path: '/boom', method: 'get', schema: { returnType: Type.Object({}) } }, async () => {
+            throw new TypeError('legacy path');
+        });
+        const app = new HonoAPIAppBuilder({ onError }).register(API, () => ({})).build();
+        const res = await app.request('/boom');
+        expect(res.status).toBe(418);
+        expect(await res.json()).toEqual({ legacy: true });
+        expect(onError).toHaveBeenCalledOnce();
+    });
+    test('no config → hard default unchanged ({ error: message }, 500)', async () => {
+        const API = Procedures();
+        API.Create('Boom', { path: '/boom', method: 'get', schema: { returnType: Type.Object({}) } }, async () => {
+            throw new TypeError('untouched');
+        });
+        const app = new HonoAPIAppBuilder().register(API, () => ({})).build();
+        const res = await app.request('/boom');
+        expect(res.status).toBe(500);
+        // The handler's TypeError is wrapped by the core into a ProcedureError with
+        // `cause` set. The default ProcedureError entry skips wrappers, no
+        // unknownError is configured, and no onError is provided — so we hit the
+        // hard default: { error: message }.
+        expect(await res.json()).toEqual({ error: expect.stringContaining('untouched') });
+    });
+    test('ctx.error() is serialized by the default ProcedureError taxonomy entry when opted in', async () => {
+        const API = Procedures();
+        API.Create('Boom', { path: '/boom', method: 'get', schema: { returnType: Type.Object({}) } }, async (ctx) => {
+            throw ctx.error('direct from ctx.error', { code: 'E1' });
+        });
+        const app = new HonoAPIAppBuilder({ errors: {} }).register(API, () => ({})).build();
+        const res = await app.request('/boom');
+        expect(res.status).toBe(500);
+        const body = (await res.json());
+        expect(body.name).toBe('ProcedureError');
+        expect(body.procedureName).toBe('Boom');
+    });
+});
+//# sourceMappingURL=error-taxonomy.test.js.map

package/build/implementations/http/hono-api/error-taxonomy.test.js.map

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

package/build/implementations/http/hono-api/index.d.ts

@@ -1,7 +1,10 @@
 import { Hono, Context } from 'hono';
 import { TProcedureRegistration } from '../../../index.js';
 import { ExtractConfig, ExtractContext, ProceduresFactory, APIConfig, APIHttpRouteDoc, APIInput, HttpMethod } from '../../types.js';
+import { ErrorTaxonomy, ErrorTaxonomyEntry, UnknownErrorConfig, defineErrorTaxonomy } from '../error-taxonomy.js';
 export type { APIConfig, APIHttpRouteDoc, APIInput, HttpMethod };
+export { defineErrorTaxonomy };
+export type { ErrorTaxonomy, ErrorTaxonomyEntry, UnknownErrorConfig };
 export type QueryParser = (queryString: string) => Record<string, unknown>;
 export type HonoAPIAppBuilderConfig = {
     /**
@@ -33,9 +36,43 @@ export type HonoAPIAppBuilderConfig = {
     onRequestEnd?: (c: Context) => void;
     onSuccess?: (procedure: TProcedureRegistration, c: Context) => void;
     /**
-     * Error handler called when a procedure throws an error.
+     * Declarative error-to-response mapping (one of the two peer error modes).
+     * When a thrown error matches an entry (by `class` or `match`), the builder
+     * serializes it automatically. User entries are checked before the framework
+     * defaults (`ProcedureValidationError`, `ProcedureYieldValidationError`,
+     * `ProcedureError`).
+     */
+    errors?: ErrorTaxonomy;
+    /**
+     * Fallback serializer for errors not matched by the taxonomy. Used together
+     * with `errors` for apps that want declarative dispatch plus a well-defined
+     * shape for unexpected errors.
+     */
+    unknownError?: UnknownErrorConfig;
+    /**
+     * Imperative error callback — the other peer error mode. Receives every
+     * error directly and returns the HTTP response. Use this when you want full
+     * control over the response shape, or alongside `errors` for the tail of
+     * errors the taxonomy doesn't cover.
      */
     onError?: (procedure: TProcedureRegistration, c: Context, error: Error) => Response | Promise<Response>;
+    /**
+     * Cross-cutting observer — fires for every caught error, BEFORE dispatch to
+     * the taxonomy or `onError`. Awaited. Cannot mutate the response. Intended
+     * for logging, tracing, and metrics (Sentry, Datadog, OpenTelemetry). Any
+     * error thrown inside the observer is swallowed and logged so the primary
+     * dispatch flow is never disrupted.
+     */
+    onRequestError?: (ctx: OnRequestErrorContext) => void | Promise<void>;
+};
+/**
+ * Context passed to the `onRequestError` observer. `raw` is the Hono
+ * `Context` for the in-flight request.
+ */
+export type OnRequestErrorContext = {
+    err: unknown;
+    procedure: TProcedureRegistration;
+    raw: Context;
 };
 /**
  * Builder class for creating a Hono application with REST-style API routes.

package/build/implementations/http/hono-api/index.js

@@ -1,4 +1,6 @@
 import { Hono } from 'hono';
+import { defineErrorTaxonomy, resolveErrorResponse, } from '../error-taxonomy.js';
+export { defineErrorTaxonomy };
 /** Default query parser using native URLSearchParams. */
 function parseQueryNative(queryString) {
     const searchParams = new URLSearchParams(queryString);
@@ -212,6 +214,33 @@ export class HonoAPIAppBuilder {
                 return c.json(result, successStatus);
             }
             catch (error) {
+                // Observer fires first — cross-cutting, cannot alter dispatch or the
+                // response. Swallow any throw from the observer so instrumentation
+                // bugs never break the primary error-response flow.
+                if (this.config?.onRequestError) {
+                    try {
+                        await this.config.onRequestError({ err: error, procedure, raw: c });
+                    }
+                    catch (observerErr) {
+                        console.error('[ts-procedures hono-api] onRequestError threw — swallowed:', observerErr);
+                    }
+                }
+                // Dispatch: taxonomy → onError → hard default. The two modes are
+                // peers; apps configure whichever fits (or both, in which case the
+                // taxonomy handles what it covers and `onError` handles the tail).
+                if (this.config?.errors || this.config?.unknownError) {
+                    const resolved = resolveErrorResponse({
+                        err: error,
+                        userTaxonomy: this.config.errors,
+                        unknownError: this.config.unknownError,
+                        procedure,
+                        raw: c,
+                    });
+                    if (resolved) {
+                        await resolved.runOnCatch();
+                        return c.json(resolved.body, resolved.statusCode);
+                    }
+                }
                 if (this.config?.onError) {
                     return this.config.onError(procedure, c, error);
                 }
@@ -299,6 +328,9 @@ export class HonoAPIAppBuilder {
         if (config.successStatus) {
             base.successStatus = config.successStatus;
         }
+        if (config.errors && config.errors.length > 0) {
+            base.errors = [...config.errors];
+        }
         let extendedDoc = {};
         if (extendProcedureDoc) {
             extendedDoc = extendProcedureDoc({ base, procedure });

package/build/implementations/http/hono-api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/implementations/http/hono-api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAW,MAAM,MAAM,CAAA;AAqBpC,yDAAyD;AACzD,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC,CAAA;IACrD,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,sFAAsF;AACtF,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;IACxD,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACtD,CAAC;AAED,kDAAkD;AAClD,SAAS,oBAAoB,CAAC,MAAkB;IAC9C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,GAAG,CAAA;QACZ,KAAK,QAAQ;YACX,OAAO,GAAG,CAAA;QACZ;YACE,OAAO,GAAG,CAAA;IACd,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,YAAY,GAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AAE3D,wFAAwF;AACxF,SAAS,YAAY,CAAC,GAAW,EAAE,WAAwB;IACzD,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,YAAY,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAA;IAC5C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxB,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAC;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,iBAAiB;IACP;IAArB,YAAqB,MAAgC;QAAhC,WAAM,GAAN,MAAM,CAA0B;QACnD,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAA;QACxB,CAAC;QAED,IAAI,MAAM,EAAE,cAAc,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;gBACnC,MAAM,CAAC,cAAe,CAAC,CAAC,CAAC,CAAA;gBACzB,MAAM,IAAI,EAAE,CAAA;YACd,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,MAAM,EAAE,YAAY,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;gBACnC,MAAM,IAAI,EAAE,CAAA;gBACZ,MAAM,CAAC,YAAa,CAAC,CAAC,CAAC,CAAA;YACzB,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEO,SAAS,GAA8B,EAAE,CAAA;IAEzC,IAAI,GAAS,IAAI,IAAI,EAAE,CAAA;IACvB,KAAK,GAAiC,EAAE,CAAA;IAEhD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CACN,OAAiB,EACjB,cAEkF,EAClF,kBAGyB;QAEzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAA6B,CAAC,CAAA;QAC/F,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,aAAqB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAA;QACtC,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACvF,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAA;QAC1F,OAAO,GAAG,gBAAgB,GAAG,cAAc,EAAE,CAAA;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,IAAI,gBAAgB,CAAA;QAEhE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,EAAE;YACzE,OAAO,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,SAAiD,EAAE,EAAE;gBAChF,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAClD,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAA;gBAElD,wFAAwF;gBACxF,IAAI,CAAC,4BAA4B,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;gBAE3E,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAA;gBAChF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAEtB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAoB,CAAA;gBAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;gBAEpG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;YACvD,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED;;OAEG;IACK,4BAA4B,CAClC,aAAqB,EACrB,IAAY,EACZ,WAAqC;QAErC,sFAAsF;QACtF,IAAI,CAAC,WAAW;YAAE,OAAM;QAExB,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;QAElD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,0BAA0B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,+DAA+D,aAAa,KAAK;gBAC/I,6DAA6D,CAChE,CAAA;QACH,CAAC;QAED,IAAI,WAAW,CAAC,UAAU,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,qDAAqD,aAAa,eAAe,IAAI,4BAA4B;gBAC/G,oEAAoE,CACvE,CAAA;QACH,CAAC;QAED,mFAAmF;QACnF,IAAI,WAAW,CAAC,UAAU,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,oBAAoB,GAAG,WAAW,CAAC,UAAqC,CAAA;YAC9E,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,UAAiD,CAAA;YAE/F,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;gBAChD,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC7E,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;gBAE3E,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3D,MAAM,KAAK,GAAa,EAAE,CAAA;oBAC1B,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC/B,KAAK,CAAC,IAAI,CAAC,aAAa,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;oBACzF,CAAC;oBACD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;oBACrF,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,sCAAsC,aAAa,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;wBAC3E,SAAS,IAAI,cAAc,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACtG,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,SAAiD,EACjD,cAAoD,EACpD,MAAiB,EACjB,WAAgD,EAChD,WAAwB;QAExB,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAEjF,OAAO,KAAK,EAAE,CAAU,EAAE,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,OAAO,GACX,OAAO,cAAc,KAAK,UAAU;oBAClC,CAAC,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC;oBACzB,CAAC,CAAE,cAAsB,CAAA;gBAE7B,IAAI,MAAe,CAAA;gBAEnB,IAAI,WAAW,EAAE,CAAC;oBAChB,+DAA+D;oBAC/D,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;gBACpF,CAAC;qBAAM,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBAC3C,iEAAiE;oBACjE,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;wBACzC,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;oBAC/C,CAAC;yBAAM,CAAC;wBACN,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;oBAC/C,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;gBACpD,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAA;gBAExF,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;oBAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;gBACrC,CAAC;gBAED,iCAAiC;gBACjC,IAAI,aAAa,KAAK,GAAG,EAAE,CAAC;oBAC1B,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;gBAC1B,CAAC;gBAED,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,aAAoB,CAAC,CAAA;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;oBACzB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,KAAc,CAAC,CAAA;gBAC1D,CAAC;gBACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;YACzD,CAAC;QACH,CAAC,CAAA;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,kBAAkB,CAC9B,CAAU,EACV,MAAkB,EAClB,WAAoC,EACpC,WAAwB;QAExB,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAE7C,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,QAAQ,OAAO,EAAE,CAAC;gBAChB,KAAK,YAAY;oBACf,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;oBACjC,MAAK;gBAEP,KAAK,OAAO;oBACV,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;oBACnD,MAAK;gBAEP,KAAK,MAAM;oBACT,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAClC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;oBACpD,CAAC;oBACD,MAAK;gBAEP,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,4EAA4E;oBAC5E,MAAM,UAAU,GAA2B,EAAE,CAAA;oBAC7C,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;wBACvC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;oBACzB,CAAC,CAAC,CAAA;oBACF,MAAM,CAAC,OAAO,GAAG,UAAU,CAAA;oBAC3B,MAAK;gBACP,CAAC;gBAED;oBACE,+EAA+E;oBAC/E,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;oBAC3B,MAAK;YACT,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;OAEG;IACK,oBAAoB,CAC1B,SAAiD,EACjD,QAAgB,EAChB,kBAA6D;QAE7D,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;QAC5B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAA;QACxC,MAAM,UAAU,GAAkC,EAAE,CAAA;QAEpD,sDAAsD;QACtD,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,WAAW,CAAC,UAAU;gBAAE,UAAU,CAAC,UAAU,GAAG,WAAW,CAAC,UAAqC,CAAA;YACrG,IAAI,WAAW,CAAC,KAAK;gBAAE,UAAU,CAAC,KAAK,GAAG,WAAW,CAAC,KAAgC,CAAA;YACtF,IAAI,WAAW,CAAC,IAAI;gBAAE,UAAU,CAAC,IAAI,GAAG,WAAW,CAAC,IAA+B,CAAA;YACnF,IAAI,WAAW,CAAC,OAAO;gBAAE,UAAU,CAAC,OAAO,GAAG,WAAW,CAAC,OAAkC,CAAA;QAC9F,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACjC,oEAAoE;YACpE,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzC,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;YACxC,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;YACzC,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;YAC9B,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAA;QAChD,CAAC;QAED,MAAM,IAAI,GAAoB;YAC5B,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ;YACR,UAAU;SACX,CAAA;QAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;QAC3C,CAAC;QAED,IAAI,WAAW,GAAW,EAAE,CAAA;QAE5B,IAAI,kBAAkB,EAAE,CAAC;YACvB,WAAW,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QACvD,CAAC;QAED,OAAO;YACL,GAAG,WAAW;YACd,GAAG,IAAI;SACR,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/implementations/http/hono-api/index.ts"],"names":[],"mappings":"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"}

package/build/implementations/http/hono-rpc/error-taxonomy.test.d.ts

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

package/build/implementations/http/hono-rpc/error-taxonomy.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Type } from 'typebox';
+import { Procedures } from '../../../index.js';
+import { HonoRPCAppBuilder, defineErrorTaxonomy } from './index.js';
+class UseCaseError extends Error {
+    externalMsg;
+    internalMsg;
+    constructor(externalMsg, internalMsg) {
+        super(externalMsg);
+        this.externalMsg = externalMsg;
+        this.internalMsg = internalMsg;
+        this.name = 'UseCaseError';
+        Object.setPrototypeOf(this, UseCaseError.prototype);
+    }
+}
+describe('HonoRPCAppBuilder — error taxonomy', () => {
+    test('taxonomy catches user error thrown from RPC handler', async () => {
+        const errors = defineErrorTaxonomy({
+            UseCaseError: {
+                class: UseCaseError,
+                statusCode: 422,
+                toResponse: (err) => ({ name: 'UseCaseError', message: err.externalMsg }),
+            },
+        });
+        const RPC = Procedures();
+        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
+            throw new UseCaseError('ext', 'int');
+        });
+        const app = new HonoRPCAppBuilder({ errors }).register(RPC, () => ({})).build();
+        const res = await app.request('/test/boom/1', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: '{}',
+        });
+        expect(res.status).toBe(422);
+        expect(await res.json()).toEqual({ name: 'UseCaseError', message: 'ext' });
+    });
+    test('unknownError catches unmapped errors', async () => {
+        const RPC = Procedures();
+        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
+            throw new TypeError('db down');
+        });
+        const app = new HonoRPCAppBuilder({
+            unknownError: { statusCode: 503, toResponse: () => ({ name: 'ServiceUnavailable' }) },
+        })
+            .register(RPC, () => ({}))
+            .build();
+        const res = await app.request('/test/boom/1', { method: 'POST', body: '{}' });
+        expect(res.status).toBe(503);
+        expect(await res.json()).toEqual({ name: 'ServiceUnavailable' });
+    });
+    test('onError callback runs when taxonomy does not match', async () => {
+        const onError = vi.fn(async (_p, c) => c.json({ legacy: true }, 418));
+        const RPC = Procedures();
+        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
+            throw new TypeError('legacy');
+        });
+        const app = new HonoRPCAppBuilder({ onError }).register(RPC, () => ({})).build();
+        const res = await app.request('/test/boom/1', { method: 'POST', body: '{}' });
+        expect(res.status).toBe(418);
+        expect(onError).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=error-taxonomy.test.js.map

package/build/implementations/http/hono-rpc/error-taxonomy.test.js.map

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

package/build/implementations/http/hono-rpc/index.d.ts

@@ -1,7 +1,10 @@
 import { Hono, Context } from 'hono';
 import { TProcedureRegistration } from '../../../index.js';
 import { ExtractConfig, ExtractContext, ProceduresFactory, RPCConfig, RPCHttpRouteDoc } from '../../types.js';
+import { ErrorTaxonomy, ErrorTaxonomyEntry, UnknownErrorConfig, defineErrorTaxonomy } from '../error-taxonomy.js';
 export type { RPCConfig, RPCHttpRouteDoc };
+export { defineErrorTaxonomy };
+export type { ErrorTaxonomy, ErrorTaxonomyEntry, UnknownErrorConfig };
 export type HonoRPCAppBuilderConfig = {
     /**
      * An existing Hono application instance to use.
@@ -14,12 +17,34 @@ export type HonoRPCAppBuilderConfig = {
     onRequestEnd?: (c: Context) => void;
     onSuccess?: (procedure: TProcedureRegistration, c: Context) => void;
     /**
-     * Error handler called when a procedure throws an error.
-     * @param procedure
-     * @param c
-     * @param error
+     * Declarative error-to-response mapping (one of the two peer error modes).
+     * See hono-api for the full taxonomy contract. User entries take precedence
+     * over the framework default taxonomy.
+     */
+    errors?: ErrorTaxonomy;
+    /** Fallback serializer for errors not matched by the taxonomy. */
+    unknownError?: UnknownErrorConfig;
+    /**
+     * Imperative error callback — the other peer error mode. Receives every
+     * error directly and returns the HTTP response. Use this when you want full
+     * control over the response shape, or alongside `errors` for the tail of
+     * errors the taxonomy doesn't cover.
      */
     onError?: (procedure: TProcedureRegistration, c: Context, error: Error) => Response | Promise<Response>;
+    /**
+     * Cross-cutting observer — fires for every caught error, BEFORE dispatch.
+     * Awaited. Cannot mutate the response. Intended for logging, tracing, and
+     * metrics. Thrown errors inside the observer are swallowed and logged.
+     */
+    onRequestError?: (ctx: OnRequestErrorContext) => void | Promise<void>;
+};
+/**
+ * Context passed to the `onRequestError` observer.
+ */
+export type OnRequestErrorContext = {
+    err: unknown;
+    procedure: TProcedureRegistration;
+    raw: Context;
 };
 /**
  * Builder class for creating a Hono application with RPC routes.
@@ -46,11 +71,13 @@ export declare class HonoRPCAppBuilder {
     constructor(config?: HonoRPCAppBuilderConfig | undefined);
     /**
      * Generates the RPC route path based on the RPC configuration.
-     * The RPCConfig name can be a string or an array of strings to form nested paths.
+     * `RPCConfig.scope` can be a string or an array of strings to form nested paths.
      *
      * Example
-     *  name: ['string', 'string-string', 'string']
-     *  path: /string/string-string/string/version
+     *  name:  'GetUser'
+     *  scope: ['users', 'profile']
+     *  version: 1
+     *  path: /users/profile/get-user/1
      * @param config
      */
     static makeRPCHttpRoutePath({ name, config, prefix, }: {

package/build/implementations/http/hono-rpc/index.js

@@ -1,6 +1,8 @@
 import { Hono } from 'hono';
 import { kebabCase } from 'es-toolkit/string';
+import { defineErrorTaxonomy, resolveErrorResponse, } from '../error-taxonomy.js';
 import { castArray } from 'es-toolkit/compat';
+export { defineErrorTaxonomy };
 /**
  * Builder class for creating a Hono application with RPC routes.
  *
@@ -43,11 +45,13 @@ export class HonoRPCAppBuilder {
     }
     /**
      * Generates the RPC route path based on the RPC configuration.
-     * The RPCConfig name can be a string or an array of strings to form nested paths.
+     * `RPCConfig.scope` can be a string or an array of strings to form nested paths.
      *
      * Example
-     *  name: ['string', 'string-string', 'string']
-     *  path: /string/string-string/string/version
+     *  name:  'GetUser'
+     *  scope: ['users', 'profile']
+     *  version: 1
+     *  path: /users/profile/get-user/1
      * @param config
      */
     static makeRPCHttpRoutePath({ name, config, prefix, }) {
@@ -109,10 +113,30 @@ export class HonoRPCAppBuilder {
                         return c.json(result);
                     }
                     catch (error) {
+                        if (this.config?.onRequestError) {
+                            try {
+                                await this.config.onRequestError({ err: error, procedure, raw: c });
+                            }
+                            catch (observerErr) {
+                                console.error('[ts-procedures hono-rpc] onRequestError threw — swallowed:', observerErr);
+                            }
+                        }
+                        if (this.config?.errors || this.config?.unknownError) {
+                            const resolved = resolveErrorResponse({
+                                err: error,
+                                userTaxonomy: this.config.errors,
+                                unknownError: this.config.unknownError,
+                                procedure,
+                                raw: c,
+                            });
+                            if (resolved) {
+                                await resolved.runOnCatch();
+                                return c.json(resolved.body, resolved.statusCode);
+                            }
+                        }
                         if (this.config?.onError) {
                             return this.config.onError(procedure, c, error);
                         }
-                        // Default error handling
                         return c.json({ error: error.message }, 500);
                     }
                 });
@@ -148,6 +172,9 @@ export class HonoRPCAppBuilder {
             method,
             jsonSchema,
         };
+        if (config.errors && config.errors.length > 0) {
+            base.errors = [...config.errors];
+        }
         let extendedDoc = {};
         if (extendProcedureDoc) {
             extendedDoc = extendProcedureDoc({ base, procedure });