@basaltkit/hono 1.4.1 → 1.5.0

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import { Container } from '@basaltkit/core';
-import { type BasaltRoute, type RequestEnricher, type RouteGuard } from '@basaltkit/http';
+import { type HttpErrorReporter, type BasaltRoute, type RequestEnricher, type RouteGuard } from '@basaltkit/http';
 import { Hono } from 'hono';
 export declare const HONO: import("@basaltkit/core").Token<Hono<any, import("hono/types").BlankSchema, "/">>;
 /** Default maximum request body size (1 MiB) — override via honoPlugin({ bodyLimit }). */
 export declare const DEFAULT_BODY_LIMIT = 1048576;
 /** Mounts Basalt routes on a Hono app (usable without the plugin). */
-export declare function registerRoutes(app: Hono<any>, routes: BasaltRoute[], container?: Container, enrichers?: RequestEnricher[], guards?: RouteGuard[]): void;
+export declare function registerRoutes(app: Hono<any>, routes: BasaltRoute[], container?: Container, enrichers?: RequestEnricher[], guards?: RouteGuard[], onError?: HttpErrorReporter): void;
 export interface HonoPluginOptions {
     routes?: BasaltRoute[];
     /**
@@ -23,6 +23,12 @@ export interface HonoPluginOptions {
      * text default. Default: true. An app calling `hono.notFound(…)` later
      * still wins (Hono keeps the last handler); pass false to opt out entirely.
      */
+    /**
+     * Where failed requests are reported. Default: 5xx via `console.error` (with
+     * the stack) and 4xx via `console.warn`, prefixed `[basalt:http]`. Pass your
+     * own to route them into a real logger, or `() => {}` to silence them.
+     */
+    onError?: HttpErrorReporter;
     notFound?: boolean;
     /**
      * Maximum request body size in bytes. A request whose `Content-Length`

package/dist/index.js

@@ -1,5 +1,5 @@
 import { Container, createToken, definePlugin, ensureMetadata } from '@basaltkit/core';
-import { NOT_FOUND_RESPONSE, HttpServerCollector, HTTP_SERVER, runRoute, toErrorResponse, isSseResponse, sseProducerOf, driveSse, SSE_HEADERS, GUARDED_META_BUCKET, assertRoutesGuarded, } from '@basaltkit/http';
+import { NOT_FOUND_RESPONSE, HttpServerCollector, HTTP_SERVER, runRoute, toErrorResponse, reportHttpError, isSseResponse, sseProducerOf, driveSse, SSE_HEADERS, GUARDED_META_BUCKET, assertRoutesGuarded, } from '@basaltkit/http';
 import { Hono } from 'hono';
 export const HONO = createToken('hono');
 /** Default maximum request body size (1 MiB) — override via honoPlugin({ bodyLimit }). */
@@ -109,7 +109,7 @@ function toResponse(reply, payload) {
     }
     return new Response(body, { status: reply.statusCode, headers });
 }
-function handlerFor(definition, container, enrichers, guards) {
+function handlerFor(definition, container, enrichers, guards, onError) {
     return async (context) => {
         const reply = new HonoReply(context);
         try {
@@ -124,6 +124,13 @@ function handlerFor(definition, container, enrichers, guards) {
         }
         catch (error) {
             const { status, body } = toErrorResponse(error);
+            // This adapter previously reported nothing at all — a 500 reached the
+            // client and left no trace whatsoever on the server.
+            const entry = { error, status, code: body.error.code, method: context.req.method, url: context.req.url };
+            if (onError)
+                onError(entry);
+            else
+                reportHttpError(entry);
             return new Response(JSON.stringify(body), {
                 status,
                 headers: { 'content-type': 'application/json' },
@@ -132,9 +139,9 @@ function handlerFor(definition, container, enrichers, guards) {
     };
 }
 /** Mounts Basalt routes on a Hono app (usable without the plugin). */
-export function registerRoutes(app, routes, container, enrichers = [], guards = []) {
+export function registerRoutes(app, routes, container, enrichers = [], guards = [], onError) {
     for (const definition of routes) {
-        app.on(definition.method, definition.url, handlerFor(definition, container, enrichers, guards));
+        app.on(definition.method, definition.url, handlerFor(definition, container, enrichers, guards, onError));
     }
 }
 /**
@@ -184,7 +191,7 @@ export function honoPlugin(options = {}) {
                     await next();
                     return undefined;
                 });
-                registerRoutes(app, routes, container, enrichers, guards);
+                registerRoutes(app, routes, container, enrichers, guards, options.onError);
                 // Neutral JSON 404 (an app's own later `notFound` call replaces it).
                 if (options.notFound !== false) {
                     app.notFound((context) => context.json(NOT_FOUND_RESPONSE, 404));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basaltkit/hono",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "engines": {
     "node": ">=22.5.0"
   },
@@ -19,7 +19,7 @@
   ],
   "dependencies": {
     "@basaltkit/core": "^1.3.1",
-    "@basaltkit/http": "^1.14.0"
+    "@basaltkit/http": "^1.15.0"
   },
   "peerDependencies": {
     "hono": "^4.0.0"