@asenajs/hono-adapter 1.7.0 → 3.0.0

package/dist/lib/errors.js

@@ -1,23 +1,30 @@
 import { HTTPException } from 'hono/http-exception';
-import { VALIDATION_ERROR } from '@asenajs/asena/adapter';
+import { HTTP_EXCEPTION, VALIDATION_ERROR, } from '@asenajs/asena/adapter';
+import { flattenError } from 'zod';
 /**
  * @description Thrown when request validation fails, so the failure reaches the
  * application's `ConfigService.onError` like every other error instead of being
  * answered inside the validator middleware.
  *
- * Extends Hono's `HTTPException` with status 400 deliberately: an existing handler
- * that branches on `error instanceof HTTPException` and replies with `error.status`
- * keeps answering 400, so adopting this does not silently turn validation failures
- * into 500s.
+ * Extends Hono's `HTTPException` with status 400 deliberately: a handler that matches
+ * with `isHttpException()` - or with the older `error instanceof HTTPException` - and
+ * replies with `error.status` keeps answering 400, so adopting this does not silently
+ * turn validation failures into 500s.
+ *
+ * Note it does *not* extend `HttpException` from `@asenajs/asena/adapter`, the class
+ * applications throw. Both are branded, so `isHttpException()` cannot tell them apart and
+ * does not need to; `instanceof` can, which is one more reason not to reach for it.
  *
  * @example
  * ```typescript
  * public onError(error: Error, context: Context) {
+ *   // Before isHttpException: ValidationError is an HTTP exception too, so the
+ *   // generic branch below would otherwise swallow it.
  *   if (isValidationError(error)) {
  *     return context.send({ success: false, errors: error.issues }, 400);
  *   }
  *
- *   if (error instanceof HTTPException) {
+ *   if (isHttpException(error)) {
  *     return context.send({ error: error.message }, error.status);
  *   }
  *
@@ -27,6 +34,11 @@ import { VALIDATION_ERROR } from '@asenajs/asena/adapter';
  */
 export class ValidationError extends HTTPException {
     [VALIDATION_ERROR] = true;
+    /**
+     * Also branded as an HTTP exception. Inherited from `HTTPException` in practice - see
+     * `brandHonoHttpException` below - but declared here too so the type states it.
+     */
+    [HTTP_EXCEPTION] = true;
     /** Which part of the request failed: `json`, `query`, `form`, `param` or `header` */
     target;
     /** Field-level failures, adapter-agnostic */
@@ -44,5 +56,107 @@ export class ValidationError extends HTTPException {
             code: issue.code,
         }));
     }
+    /**
+     * The envelope the caller sees when the application does not answer this failure itself.
+     *
+     * It lives here rather than in the adapter so a validation failure has exactly one response
+     * shape - the adapter used to build a richer body inline for applications with no `onError`
+     * and fall back to `HTTPException`'s bare `Validation failed` text for everyone else, so the
+     * same failure answered two different bodies depending on an unrelated hook.
+     *
+     * Built on each call rather than passed to `super` as `res`: a `Response` body can only be
+     * read once, and Hono may ask for this more than one time.
+     */
+    getResponse() {
+        return new Response(JSON.stringify({
+            error: 'Validation failed',
+            details: flattenError(this.cause),
+            target: this.target,
+        }), {
+            status: this.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
 }
+/**
+ * Brands Hono's own `HTTPException` so `isHttpException()` recognises it.
+ *
+ * `HTTPException` comes from `hono/http-exception`, so this package cannot declare the brand on
+ * the class - but it can put it on the prototype, which is the same thing at runtime and covers
+ * every instance including ones the application constructs itself.
+ *
+ * Without this the brand is a trap rather than a feature: the JSDoc on `isHttpException` tells
+ * users to write `if (isHttpException(error)) ... else 500`, and on this adapter every
+ * deliberate 401/403/404/429 raised by `hono/basic-auth`, `hono/jwt` or hono's own validator
+ * would take the else branch and answer 500.
+ *
+ * The brand covers one copy of `hono` and cannot reach another: it is installed on the prototype
+ * of the class *this* package resolved. Since 3.0.0 `hono` is a **peer** dependency, so this
+ * package has no resolution slot of its own and an application normally resolves exactly one copy
+ * - which is what makes the brand sufficient rather than a trap. Before that it was a regular
+ * dependency, and a downstream application that bumped its own `hono` range ended up with a second
+ * nested copy whose `HTTPException` was unbranded: every deliberate 400/403 answered 500 while the
+ * API kept responding. `warnOnNestedHono` below reports the one shape that can still produce it.
+ *
+ * Import `HTTPException` from `@asenajs/hono-adapter` rather than from `hono/http-exception` to
+ * stay on this package's copy regardless. The adapter's default response also checks
+ * `instanceof HTTPException` before the brand, so a hono exception is answered correctly even if
+ * this function never ran.
+ *
+ * Idempotent, and called from the HonoAdapter constructor.
+ */
+export const brandHonoHttpException = () => {
+    if (Object.prototype.hasOwnProperty.call(HTTPException.prototype, HTTP_EXCEPTION)) {
+        return;
+    }
+    Object.defineProperty(HTTPException.prototype, HTTP_EXCEPTION, {
+        value: true,
+        enumerable: false,
+        configurable: true,
+    });
+};
+/**
+ * Warns when this package resolved a *nested* copy of `hono`.
+ *
+ * `hono` is a peer dependency, so it should always resolve from the application's own
+ * `node_modules`. A path under `@asenajs/hono-adapter/node_modules/hono` means a second copy was
+ * installed privately for this package - the exact topology that makes `brandHonoHttpException()`
+ * useless, because the brand lands on the prototype of *this* copy's class and an `HTTPException`
+ * the application threw from its own copy is neither `instanceof` it nor branded, so it is
+ * answered 500.
+ *
+ * This does not - and cannot - detect the *application's* copy. `import.meta.resolve` always
+ * answers relative to this module, Node resolution is per-importer so there is no single "the
+ * application's hono" to compare against, and after `asena build` or `bun build --compile` there
+ * is no `node_modules` to inspect at all. What it can prove is the asymmetric half: if *our* copy
+ * is nested, there are two. That is enough, because under a peer dependency a nested copy is the
+ * only way this package acquires one.
+ *
+ * Worth having even though the peer move makes the topology rare: `bun install` has been observed
+ * to drop the lockfile entry for a nested copy while leaving the directory on disk, so an
+ * application upgrading in place can still be broken by a leftover it cannot see.
+ *
+ * The path predicate is {@link isNestedHonoPath}, exported so it can be tested against both
+ * layouts directly - inside this repo `import.meta.resolve` always answers
+ * `hono-adapter/node_modules/hono`, which is the package's own root and deliberately does *not*
+ * match, so a test driving the real resolver could only ever assert the negative case.
+ */
+export const isNestedHonoPath = (resolved) => resolved.includes('@asenajs/hono-adapter/node_modules/hono');
+export const warnOnNestedHono = (logger) => {
+    try {
+        const resolved = import.meta.resolve('hono/http-exception');
+        if (!isNestedHonoPath(resolved)) {
+            return;
+        }
+        (logger ?? console).warn(`A nested copy of \`hono\` was found at ${resolved}.\n` +
+            `  \`hono\` is a peer dependency of @asenajs/hono-adapter and must resolve from your\n` +
+            `  application's node_modules. With two copies, an HTTPException thrown from your copy is\n` +
+            `  not recognised by isHttpException() and will be answered as 500.\n` +
+            `  Fix: rm -rf node_modules bun.lock && bun install`);
+    }
+    catch {
+        // `import.meta.resolve` is unavailable or throws under some bundlers and in compiled binaries.
+        // A diagnostic must never be the reason a server fails to boot.
+    }
+};
 //# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAkD,MAAM,wBAAwB,CAAC;AAG1G;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChC,CAAC,gBAAgB,CAAC,GAAG,IAAa,CAAC;IAEnD,qFAAqF;IACrE,MAAM,CAAS;IAE/B,6CAA6C;IAC7B,MAAM,CAAoB;IAE1C,mEAAmE;IACnD,KAAK,CAAW;IAEhC,YAAmB,KAAe,EAAE,MAAc;QAChD,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAE7C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/F,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../lib/errors.ts"],"names":[],"mappings":"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"}

package/dist/lib/middlewares/RateLimiterMiddleware.d.ts

@@ -294,9 +294,20 @@ export declare class RateLimiterMiddleware extends MiddlewareService {
      */
     handle(context: Context, next: () => Promise<void>): Promise<any>;
     /**
-     * Cleanup resources (stop cleanup timer)
+     * Cleanup resources (stop cleanup timer, drop bucket state)
      *
-     * Call this when shutting down the application.
+     * `@OnStop` hands this to the component lifecycle, so `server.stop()` calls it instead of the
+     * application having to remember to. The hook is inherited, so the `@Middleware()` subclass
+     * users actually register gets it without repeating the decorator - and it only fires for
+     * singletons, which is what a rate limiter has to be to share one bucket map across requests.
+     *
+     * The timer is `unref()`'d, so it never held the process open. What it does do is survive a
+     * stop/start cycle *inside* one process - twenty of them is an ordinary test suite - leaving a
+     * timer per stopped server still sweeping a bucket map nobody reads. The buckets go with it:
+     * a restarted server must not inherit the rate-limit state of the one before it, or the first
+     * requests after a restart get counted against a window that has already closed.
+     *
+     * Safe to call twice; the second call has nothing left to do.
      */
     destroy(): void;
     /**

package/dist/lib/middlewares/RateLimiterMiddleware.js

@@ -46,7 +46,17 @@
  * public login() { ... }
  * ```
  */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 import { MiddlewareService } from '../defaults';
+import { OnStop } from '@asenajs/asena/decorators/ioc';
 /**
  * Rate Limiter Middleware
  *
@@ -238,14 +248,27 @@ export class RateLimiterMiddleware extends MiddlewareService {
         return await next();
     }
     /**
-     * Cleanup resources (stop cleanup timer)
+     * Cleanup resources (stop cleanup timer, drop bucket state)
      *
-     * Call this when shutting down the application.
+     * `@OnStop` hands this to the component lifecycle, so `server.stop()` calls it instead of the
+     * application having to remember to. The hook is inherited, so the `@Middleware()` subclass
+     * users actually register gets it without repeating the decorator - and it only fires for
+     * singletons, which is what a rate limiter has to be to share one bucket map across requests.
+     *
+     * The timer is `unref()`'d, so it never held the process open. What it does do is survive a
+     * stop/start cycle *inside* one process - twenty of them is an ordinary test suite - leaving a
+     * timer per stopped server still sweeping a bucket map nobody reads. The buckets go with it:
+     * a restarted server must not inherit the rate-limit state of the one before it, or the first
+     * requests after a restart get counted against a window that has already closed.
+     *
+     * Safe to call twice; the second call has nothing left to do.
      */
     destroy() {
         if (this.cleanupTimer) {
             clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
         }
+        this.buckets.clear();
     }
     /**
      * Get current bucket state for a client (for testing/debugging)
@@ -300,4 +323,10 @@ export class RateLimiterMiddleware extends MiddlewareService {
         this.cleanupTimer.unref();
     }
 }
+__decorate([
+    OnStop(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], RateLimiterMiddleware.prototype, "destroy", null);
 //# sourceMappingURL=RateLimiterMiddleware.js.map

package/dist/lib/middlewares/RateLimiterMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"RateLimiterMiddleware.js","sourceRoot":"","sources":["../../../lib/middlewares/RateLimiterMiddleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RateLimiterMiddleware.js","sourceRoot":"","sources":["../../../lib/middlewares/RateLimiterMiddleware.ts"],"names":[],"mappings":"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"}

package/dist/lib/types/HonoAdapterOptions.d.ts

@@ -24,4 +24,18 @@ export interface HonoAdapterOptions {
      * @see https://hono.dev/docs/api/hono#strict-mode
      */
     strict?: boolean;
+    /**
+     * Whether the adapter logs errors before delegating to the application's error handler.
+     *
+     * The adapter's line has no correlation id, so for an application that already logs in
+     * its own `onError` it is pure duplication that cannot be joined with the app's own
+     * entry. Set to `false` to leave observability entirely to the application.
+     *
+     * When enabled (the default) the level follows the status the client will see: 5xx logs
+     * at ERROR with a stack, anything below logs at DEBUG (or INFO when the logger has no
+     * `debug`) without one.
+     *
+     * @default true
+     */
+    logErrors?: boolean;
 }

package/dist/lib/types/HonoHandler.d.ts

@@ -1,7 +1,8 @@
-import type { AsenaHandler, ErrorHandler } from '@asenajs/asena/adapter';
+import type { AsenaHandler, ErrorHandler, NotFoundHandler } from '@asenajs/asena/adapter';
 import type { Context } from '../defaults';
 export type HonoHandler = AsenaHandler<Context>;
 export type HonoErrorHandler = ErrorHandler<Context>;
+export type HonoNotFoundHandler = NotFoundHandler<Context>;
 /**
  * Typed route handler for better type inference
  */

package/dist/lib/utils/createHonoAdapter.js

@@ -2,10 +2,7 @@ import { HonoAdapter } from '../../index';
 export const createHonoAdapter = (loggerOrOptions) => {
     if (loggerOrOptions && typeof loggerOrOptions === 'object' && 'logger' in loggerOrOptions) {
         const logger = loggerOrOptions.logger;
-        return [
-            new HonoAdapter(loggerOrOptions),
-            logger,
-        ];
+        return [new HonoAdapter(loggerOrOptions), logger];
     }
     const logger = loggerOrOptions;
     return [new HonoAdapter(logger), logger];

package/dist/lib/utils/createHonoAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"createHonoAdapter.js","sourceRoot":"","sources":["../../../lib/utils/createHonoAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,eAA4D,EAC/B,EAAE;IAC/B,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,QAAQ,IAAI,eAAe,EAAE,CAAC;QAC1F,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;QAEtC,OAAO;YACL,IAAI,WAAW,CAAC,eAAqC,CAAC;YACtD,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,eAA+B,CAAC;IAE/C,OAAO,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC,CAAC"}
+{"version":3,"file":"createHonoAdapter.js","sourceRoot":"","sources":["../../../lib/utils/createHonoAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,eAA4D,EAC/B,EAAE;IAC/B,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,QAAQ,IAAI,eAAe,EAAE,CAAC;QAC1F,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;QAEtC,OAAO,CAAC,IAAI,WAAW,CAAC,eAAqC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,eAA+B,CAAC;IAE/C,OAAO,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC,CAAC"}

package/package.json

@@ -9,18 +9,22 @@
     "README.md",
     "LICENSE"
   ],
-  "version": "1.7.0",
+  "version": "3.0.0",
   "author": "LibirSoft",
   "repository": {
     "type": "git",
     "url": "https://github.com/AsenaJs/hono-adapter.git"
   },
   "license": "MIT",
+  "engines": {
+    "bun": ">=1.3.12"
+  },
   "scripts": {
     "test": "bun test",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
     "build": "bun run clean && tsc",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run build",
     "benchmark": "bun run benchmark/run-benchmark.ts",
@@ -37,23 +41,26 @@
     "release": "bun run build && changeset publish"
   },
   "devDependencies": {
-    "@asenajs/asena": "^0.8.1",
+    "@asenajs/asena": "^0.10.0",
     "@changesets/cli": "^2.30.0",
     "@types/bun": "latest",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
     "@typescript-eslint/parser": "^8.58.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^9.1.2",
+    "hono": "^4.12.32",
     "prettier": "^3.8.1",
-    "typescript-eslint": "^8.58.0"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.58.0",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@asenajs/asena": "^0.8.1",
-    "typescript": "^5.8.2"
+    "@asenajs/asena": "^0.10.0",
+    "hono": ">=4.12.9",
+    "typescript": "^5.8.2",
+    "zod": "^4.3.6"
   },
   "dependencies": {
-    "@hono/zod-validator": "^0.9.0",
-    "hono": "^4.12.9",
-    "zod": "^4.3.6"
+    "@hono/zod-validator": "^0.9.0"
   }
 }