@rexeus/typeweaver-hono 0.0.3 → 0.1.0

package/README.md

@@ -1,61 +1,133 @@
-# @rexeus/typeweaver-hono
+# 🧵✨ @rexeus/typeweaver-hono
 
-TypeWeaver plugin for generating type-safe Hono routers from HTTP operation definitions.
+[![npm version](https://img.shields.io/npm/v/@rexeus/typeweaver-hono.svg)](https://www.npmjs.com/package/@rexeus/typeweaver-hono)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
-## Overview
+Typeweaver is a type-safe HTTP API framework built for API-first development with a focus on
+developer experience. Use typeweaver to specify your HTTP APIs in TypeScript and Zod, and generate
+clients, validators, routers, and more ✨
 
-This plugin generates Hono router classes that automatically handle request validation, type-safe
-routing, and error responses. Each entity gets its own router class extending `TypeweaverHono` with
-full TypeScript type inference.
+## 📝 Hono Plugin
 
-## Installation
+This plugin generates type-safe Hono routers from your typeweaver API definitions. For each
+resource, it produces a `<ResourceName>Hono` router class that sets up the routes, validates
+requests via the generated validators, and wires your handler methods with full type safety.
 
-```bash
-npm install @rexeus/typeweaver-hono
-```
+---
 
-## Usage
+## 📥 Installation
 
 ```bash
-# Via CLI
-npx typeweaver generate --plugins hono --input ./definitions --output ./generated
+# Install the CLI and the plugin as a dev dependency
+npm install -D @rexeus/typeweaver @rexeus/typeweaver-hono
 
-# Via config file
-npx typeweaver generate --config ./typeweaver.config.js
+# Install the runtime as a dependency
+npm install @rexeus/typeweaver-core
 ```
 
-```javascript
-// typeweaver.config.js
-export default {
-  input: "./api/definitions",
-  output: "./api/generated",
-  plugins: ["hono"],
-};
-```
+## 💡 How to use
 
-## Example
-
-## Features
+```bash
+npx typeweaver generate --input ./api/definition --output ./api/generated --plugins hono
+```
 
-- **Type-safe route handlers** - Full TypeScript inference for requests and responses
-- **Automatic request validation** - Built-in validation using generated validators
-- **Configurable error handling** - Customize validation and error responses
-- **Pure Hono compatibility** - Works with all Hono middleware and features
+More on the CLI in [@rexeus/typeweaver](https://github.com/rexeus/typeweaver/tree/main/packages/cli/README.md#️-cli).
+
+## 📂 Generated Output
+
+For each resource (e.g., `Todo`) this plugin generates a Hono router class, which handles the
+routing and request validation for all operations of the resource. This Hono router class can then
+be easily integrated into your Hono application.
+
+Generated files are like `<ResourceName>Hono.ts` – e.g. `TodoHono.ts`.
+
+## 🚀 Usage
+
+Implement your handlers and mount the generated router in a Hono app.
+
+```ts
+// api/user-handlers.ts
+import type { Context } from "hono";
+import { HttpStatusCode } from "@rexeus/typeweaver-core";
+import type { IGetUserRequest, GetUserResponse, UserNotFoundErrorResponse } from "./generated";
+import { GetUserSuccessResponse } from "./generated";
+
+export class UserHandlers implements UserApiHandler {
+    async handleGetUserRequest(request: IGetUserRequest, context: Context): Promise<GetUserResponse> {
+      // Symbolic database fetch
+      const databaseResult = {} as any;
+      if (!databaseResult) {
+        // Will be properly handled by the generated router and returned as a 404 response
+        return new UserNotFoundErrorResponse({
+          statusCode: HttpStatusCode.NotFound,
+          header: { "Content-Type": "application/json" },
+          body: { message: "User not found" },
+        });
+      }
+
+      return new GetUserSuccessResponse({
+        statusCode: HttpStatusCode.OK,
+        header: { "Content-Type": "application/json" },
+        body: { id: request.param.userId, name: "Jane", email: "jane@example.com" },
+      });
+  },
+  // Implement other operation handlers: handleCreateUserRequest, ...
+}
+```
 
-## Configuration Options
+```ts
+// api/server.ts
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { UserHono } from "./generated";
+import { UserHandlers } from "./user-handlers";
+
+const app = new Hono();
+const userHandlers = new UserHandlers();
+
+// Configure the generated router
+const userRouter = new UserHono({
+  requestHandlers: userHandlers,
+  validateRequests: true, // default, validates requests
+  handleValidationErrors: true, // default: returns 400 with issues
+  handleHttpResponseErrors: true, // default: returns thrown HttpResponse as-is
+  handleUnknownErrors: true, // default: returns 500
+});
 
-```typescript
-new ProjectHono({
-  requestHandlers: handlers,
+// Mount the router into your Hono app
+app.route("/", userRouter);
 
-  // Optional configurations, for example:
-  validateRequests: false, // Disable automatic validation
-  handleValidationErrors: false, // Let validation errors bubble up
-  handleHttpResponseErrors: true, // Handle thrown HttpResponse errors
-  handleUnknownErrors: customHandler, // Custom error handler function
+serve({ fetch: app.fetch, port: 3000 }, () => {
+  console.log("Hono server listening on http://localhost:3000");
 });
 ```
 
-## License
-
-ISC © Dennis Wentzien 2025
+### ⚙️ Configuration
+
+`TypeweaverHonoOptions<RequestHandlers>`
+
+- `requestHandlers`: object implementing the generated `<ResourceName>ApiHandler` interface
+- `validateRequests` (default: `true`): enable/disable request validation
+- `handleValidationErrors`: `true` | `false` | `(err, c) => IHttpResponse`,
+  - If `true` (default), returns `400 Bad Request` with validation issues in the body
+  - If `false`, lets the error propagate
+  - If function, calls the function with the error and context, expects an `IHttpResponse` to
+    return, so you can customize the response in the way you want
+- `handleHttpResponseErrors`: `true` | `false` | `(err, c) => IHttpResponse`
+  - If `true` (default), returns thrown `HttpResponse` as-is, they will be sent as the response
+  - If `false`, lets the error propagate, which will likely result in a `500 Internal Server Error`
+  - If function, calls the function with the error and context, expects an `IHttpResponse` to
+    return, so you can customize the response in the way you want
+- `handleUnknownErrors`: `true` | `false` | `(err, c) => IHttpResponse`
+  - If `true` (default), returns `500 Internal Server Error` with a generic message
+  - If `false`, lets the error propagate and the Hono app can handle it (e.g., via middleware)
+  - If function, calls the function with the error and context, expects an `IHttpResponse` to
+    return, so you can customize the response in the way you want
+
+You can also pass standard Hono options (e.g. `strict`, `getPath`, etc.) through the same options
+object.
+
+## 📄 License
+
+Apache 2.0 © Dennis Wentzien 2025

package/dist/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Dennis Wentzien
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/NOTICE

@@ -0,0 +1,4 @@
+Copyright 2025 Dennis Wentzien
+
+This project is licensed under the Apache License, Version 2.0
+See LICENSE file for details.

package/dist/index.js

@@ -1,25 +1,31 @@
+import path$1 from 'path';
+import { fileURLToPath as fileURLToPath$1 } from 'url';
 import { BasePlugin } from '@rexeus/typeweaver-gen';
-import Case from 'case';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { fileURLToPath as fileURLToPath$1 } from 'url';
-import path$1 from 'path';
+import { HttpMethod } from '@rexeus/typeweaver-core';
+import Case from 'case';
 
 class HonoRouterGenerator {
   static generate(context) {
     const __dirname = path.dirname(fileURLToPath(import.meta.url));
     const templateFile = path.join(__dirname, "templates", "HonoRouter.ejs");
-    for (const [entityName, operationResources] of Object.entries(
+    for (const [entityName, entityResource] of Object.entries(
       context.resources.entityResources
     )) {
-      this.writeHonoRouter(entityName, templateFile, operationResources, context);
+      this.writeHonoRouter(
+        entityName,
+        templateFile,
+        entityResource.operations,
+        context
+      );
     }
   }
   static writeHonoRouter(entityName, templateFile, operationResources, context) {
     const pascalCaseEntityName = Case.pascal(entityName);
     const outputDir = path.join(context.outputDir, entityName);
     const outputPath = path.join(outputDir, `${pascalCaseEntityName}Hono.ts`);
-    const operations = operationResources.map((resource) => this.createOperationData(resource));
+    const operations = operationResources.filter((resource) => resource.definition.method !== HttpMethod.HEAD).map((resource) => this.createOperationData(resource)).sort((a, b) => this.compareRoutes(a, b));
     const content = context.renderTemplate(templateFile, {
       coreDir: path.relative(outputDir, context.outputDir),
       entityName,
@@ -40,6 +46,38 @@ class HonoRouterGenerator {
       path: resource.definition.path
     };
   }
+  static compareRoutes(a, b) {
+    const aSegments = a.path.split("/").filter((s) => s);
+    const bSegments = b.path.split("/").filter((s) => s);
+    if (aSegments.length !== bSegments.length) {
+      return aSegments.length - bSegments.length;
+    }
+    for (let i = 0; i < aSegments.length; i++) {
+      const aSegment = aSegments[i];
+      const bSegment = bSegments[i];
+      const aIsParam = aSegment.startsWith(":");
+      const bIsParam = bSegment.startsWith(":");
+      if (aIsParam !== bIsParam) {
+        return aIsParam ? 1 : -1;
+      }
+      if (aSegment !== bSegment) {
+        return aSegment.localeCompare(bSegment);
+      }
+    }
+    return this.getMethodPriority(a.method) - this.getMethodPriority(b.method);
+  }
+  static getMethodPriority(method) {
+    const priorities = {
+      GET: 1,
+      POST: 2,
+      PUT: 3,
+      PATCH: 4,
+      DELETE: 5,
+      OPTIONS: 6,
+      HEAD: 7
+    };
+    return priorities[method] ?? 999;
+  }
 }
 
 const __dirname = path$1.dirname(fileURLToPath$1(import.meta.url));

package/dist/lib/FetchApiAdapter.ts

@@ -1,13 +1,19 @@
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ *
+ * @generated by @rexeus/typeweaver
+ */
+
 import type {
   HttpMethod,
-  IHttpRequest,
-  IHttpResponse,
+  IHttpBody,
   IHttpHeader,
   IHttpQuery,
-  IHttpBody,
+  IHttpRequest,
+  IHttpResponse,
 } from "@rexeus/typeweaver-core";
 import { HttpAdapter } from "./HttpAdapter";
-import { normalizeHeaders } from "./normalizeHeaders";
 
 /**
  * Adapter for converting between Fetch API Request/Response objects
@@ -79,11 +85,13 @@ export class FetchApiAdapter extends HttpAdapter<Request, Response> {
   }
 
   private extractHeaders(headers: Headers): IHttpHeader {
+    if (!headers) return undefined;
     const result: Record<string, string | string[]> = {};
     headers.forEach((value, key) => {
+      if (!value) return;
       this.addMultiValue(result, key, value);
     });
-    return normalizeHeaders(result);
+    return Object.keys(result).length > 0 ? result : undefined;
   }
 
   private extractQueryParams(url: URL): IHttpQuery {

package/dist/lib/HonoAdapter.ts

@@ -1,7 +1,14 @@
-import type { Context } from "hono";
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ *
+ * @generated by @rexeus/typeweaver
+ */
+
 import type { IHttpRequest, IHttpResponse } from "@rexeus/typeweaver-core";
 import { FetchApiAdapter } from "./FetchApiAdapter";
 import { HttpAdapter } from "./HttpAdapter";
+import type { Context } from "hono";
 
 /**
  * Adapter for converting between Hono's Context and the core HTTP types.

package/dist/lib/HonoRequestHandler.ts

@@ -1,3 +1,10 @@
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ *
+ * @generated by @rexeus/typeweaver
+ */
+
 import type { IHttpRequest, IHttpResponse } from "@rexeus/typeweaver-core";
 import type { Context } from "hono";
 

package/dist/lib/HttpAdapter.ts

@@ -1,3 +1,10 @@
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ *
+ * @generated by @rexeus/typeweaver
+ */
+
 import type { IHttpRequest, IHttpResponse } from "@rexeus/typeweaver-core";
 
 /**

package/dist/lib/TypeweaverHono.ts

@@ -1,13 +1,20 @@
-import { Hono, type Context } from "hono";
-import {
-  HttpResponse,
-  RequestValidationError,
-  type IHttpRequest,
-  type IHttpResponse,
-  type IRequestValidator,
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ *
+ * @generated by @rexeus/typeweaver
+ */
+
+import { HttpResponse, RequestValidationError } from "@rexeus/typeweaver-core";
+import { Hono } from "hono";
+import type {
+  IHttpRequest,
+  IHttpResponse,
+  IRequestValidator,
 } from "@rexeus/typeweaver-core";
 import { HonoAdapter } from "./HonoAdapter";
 import type { HonoRequestHandler } from "./HonoRequestHandler";
+import type { Context } from "hono";
 import type { HonoOptions } from "hono/hono-base";
 import type { BlankEnv, BlankSchema, Env, Schema } from "hono/types";
 
@@ -95,9 +102,9 @@ export type TypeweaverHonoOptions<
 };
 
 /**
- * Abstract base class for TypeWeaver-generated Hono routers.
+ * Abstract base class for typeweaver-generated Hono routers.
  *
- * Extends Hono with TypeWeaver-specific features:
+ * Extends Hono with typeweaver-specific features:
  * - Automatic request validation using generated validators
  * - Configurable error handling for validation, HTTP, and unknown errors
  * - Type-safe request/response handling with adapters
@@ -114,7 +121,7 @@ export abstract class TypeweaverHono<
   HonoBasePath extends string = "/",
 > extends Hono<HonoEnv, HonoSchema, HonoBasePath> {
   /**
-   * Adapter for converting between Hono and TypeWeaver request/response formats.
+   * Adapter for converting between Hono and typeweaver request/response formats.
    */
   protected readonly adapter = new HonoAdapter();
 
@@ -142,15 +149,13 @@ export abstract class TypeweaverHono<
     validation: (error: RequestValidationError): IHttpResponse => ({
       statusCode: 400,
       body: {
-        error: {
-          code: "VALIDATION_ERROR",
-          message: error.message,
-          details: {
-            headers: error.headerIssues,
-            body: error.bodyIssues,
-            query: error.queryIssues,
-            params: error.pathParamIssues,
-          },
+        code: "VALIDATION_ERROR",
+        message: error.message,
+        issues: {
+          header: error.headerIssues,
+          body: error.bodyIssues,
+          query: error.queryIssues,
+          param: error.pathParamIssues,
         },
       },
     }),
@@ -160,10 +165,8 @@ export abstract class TypeweaverHono<
     unknown: (): IHttpResponse => ({
       statusCode: 500,
       body: {
-        error: {
-          code: "INTERNAL_SERVER_ERROR",
-          message: "An unexpected error occurred.",
-        },
+        code: "INTERNAL_SERVER_ERROR",
+        message: "An unexpected error occurred.",
       },
     }),
   };
@@ -209,7 +212,10 @@ export abstract class TypeweaverHono<
       },
     };
 
-    this.registerErrorHandler();
+    // TODO: native onError handler of hono is currently not working in this context
+    // -> only validation errors were caught, other errors were not handled
+    // -> if this is fixed, the hono onError handler should be used instead of our try/catch logic
+    // this.registerErrorHandler();
   }
 
   /**
@@ -219,7 +225,7 @@ export abstract class TypeweaverHono<
    * @param defaultHandler - Default handler to use when option is true
    * @returns Resolved handler function or undefined if disabled
    */
-  private resolveErrorHandler<T extends Function>(
+  private resolveErrorHandler<T extends (...args: any[]) => any>(
     option: T | boolean | undefined,
     defaultHandler: T
   ): T | undefined {
@@ -233,37 +239,64 @@ export abstract class TypeweaverHono<
    * Processes errors in order: validation, HTTP response, unknown.
    */
   protected registerErrorHandler(): void {
-    this.onError(async (error, context) => {
-      // Handle validation errors
-      if (
-        error instanceof RequestValidationError &&
-        this.config.errorHandlers.validation
-      ) {
-        return this.adapter.toResponse(
-          await this.config.errorHandlers.validation(error, context)
-        );
-      }
+    this.onError(this.handleError.bind(this));
+  }
+
+  /**
+   * Safely executes an error handler and returns null if it fails.
+   * This allows for graceful fallback to the next handler in the chain.
+   *
+   * @param handlerFn - Function that executes the error handler
+   * @returns Response if successful, null if handler throws
+   */
+  private async safelyExecuteHandler(
+    handlerFn: () => Promise<IHttpResponse> | IHttpResponse
+  ): Promise<Response | null> {
+    try {
+      const response = await handlerFn();
+      return this.adapter.toResponse(response);
+    } catch {
+      // Handler execution failed, return null to continue to next handler
+      return null;
+    }
+  }
+
+  protected async handleError(
+    error: unknown,
+    context: Context
+  ): Promise<Response> {
+    // Handle validation errors
+    if (
+      error instanceof RequestValidationError &&
+      this.config.errorHandlers.validation
+    ) {
+      const response = await this.safelyExecuteHandler(() =>
+        this.config.errorHandlers.validation!(error, context)
+      );
+      if (response) return response;
+    }
 
-      // Handle HTTP response errors
-      if (
-        error instanceof HttpResponse &&
-        this.config.errorHandlers.httpResponse
-      ) {
-        return this.adapter.toResponse(
-          await this.config.errorHandlers.httpResponse(error, context)
-        );
-      }
+    // Handle HTTP response errors
+    if (
+      error instanceof HttpResponse &&
+      this.config.errorHandlers.httpResponse
+    ) {
+      const response = await this.safelyExecuteHandler(() =>
+        this.config.errorHandlers.httpResponse!(error, context)
+      );
+      if (response) return response;
+    }
 
-      // Handle unknown errors
-      if (this.config.errorHandlers.unknown) {
-        return this.adapter.toResponse(
-          await this.config.errorHandlers.unknown(error, context)
-        );
-      }
+    // Handle unknown errors
+    if (this.config.errorHandlers.unknown) {
+      const response = await this.safelyExecuteHandler(() =>
+        this.config.errorHandlers.unknown!(error, context)
+      );
+      if (response) return response;
+    }
 
-      // Default: re-throw
-      throw error;
-    });
+    // Default: re-throw
+    throw error;
   }
 
   /**
@@ -282,14 +315,18 @@ export abstract class TypeweaverHono<
     validator: IRequestValidator,
     handler: HonoRequestHandler<TRequest, TResponse>
   ): Promise<Response> {
-    const httpRequest = await this.adapter.toRequest(context);
+    try {
+      const httpRequest = await this.adapter.toRequest(context);
 
-    // Conditionally validate
-    const validatedRequest = this.config.validateRequests
-      ? (validator.validate(httpRequest) as TRequest)
-      : (httpRequest as TRequest);
+      // Conditionally validate
+      const validatedRequest = this.config.validateRequests
+        ? (validator.validate(httpRequest) as TRequest)
+        : (httpRequest as TRequest);
 
-    const httpResponse = await handler(validatedRequest, context);
-    return this.adapter.toResponse(httpResponse);
+      const httpResponse = await handler(validatedRequest, context);
+      return this.adapter.toResponse(httpResponse);
+    } catch (error) {
+      return this.handleError(error, context);
+    }
   }
 }

package/dist/lib/index.ts

@@ -1,3 +1,10 @@
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ *
+ * @generated by @rexeus/typeweaver
+ */
+
 export * from "./TypeweaverHono";
 export * from "./HonoRequestHandler";
 export * from "./HonoAdapter";

package/dist/templates/HonoRouter.ejs

@@ -1,5 +1,13 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated by typeweaver.
+ * DO NOT EDIT. Instead, modify the source definition file and generate again.
+ * 
+ * @generated by @rexeus/typeweaver
+ */
+
 import type { Context } from "hono";
-import { TypeweaverHono, type HonoRequestHandler } from "<%- coreDir %>/lib/hono";
+import { TypeweaverHono, type HonoRequestHandler, type TypeweaverHonoOptions } from "<%- coreDir %>/lib/hono";
 <% for (const operation of operations) { %>
 import type { I<%- operation.className %>Request } from "./<%- operation.className %>Request";
 import { <%- operation.className %>RequestValidator } from "./<%- operation.className %>RequestValidator";
@@ -13,8 +21,8 @@ export type <%- pascalCaseEntityName %>ApiHandler = {
 };
 
 export class <%- pascalCaseEntityName %>Hono extends TypeweaverHono<<%- pascalCaseEntityName %>ApiHandler> {
-  public constructor(handlers: <%- pascalCaseEntityName %>ApiHandler) {
-    super({ requestHandlers: handlers });
+  public constructor(options: TypeweaverHonoOptions<<%- pascalCaseEntityName %>ApiHandler>) {
+    super(options);
     this.setupRoutes();
   }
 
@@ -24,7 +32,7 @@ export class <%- pascalCaseEntityName %>Hono extends TypeweaverHono<<%- pascalCa
       this.handleRequest(
         context,
         new <%- operation.className %>RequestValidator(),
-        this.requestHandlers.<%- operation.handlerName %>
+        this.requestHandlers.<%- operation.handlerName %>.bind(this.requestHandlers)
       ));
 
 <% } %>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rexeus/typeweaver-hono",
-  "version": "0.0.3",
-  "description": "Hono router generator plugin for TypeWeaver",
+  "version": "0.1.0",
+  "description": "Hono router generator plugin for typeweaver",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,7 +14,9 @@
   "files": [
     "dist",
     "package.json",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "NOTICE"
   ],
   "keywords": [
     "typeweaver",
@@ -24,8 +26,8 @@
     "api",
     "http"
   ],
-  "author": "Dennis Wentzien <dennis@rexeus.com>",
-  "license": "ISC",
+  "author": "Dennis Wentzien <dw@rexeus.com>",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/rexeus/typeweaver.git",
@@ -36,14 +38,15 @@
   },
   "homepage": "https://github.com/rexeus/typeweaver#readme",
   "peerDependencies": {
-    "hono": "^4.0.0",
-    "@rexeus/typeweaver-core": "^0.0.3",
-    "@rexeus/typeweaver-gen": "^0.0.3"
+    "hono": "^4.9.7",
+    "@rexeus/typeweaver-gen": "^0.1.0",
+    "@rexeus/typeweaver-core": "^0.1.0"
   },
   "devDependencies": {
-    "hono": "^4.0.0",
-    "@rexeus/typeweaver-core": "^0.0.3",
-    "@rexeus/typeweaver-gen": "^0.0.3"
+    "hono": "^4.9.7",
+    "test-utils": "file:../test-utils",
+    "@rexeus/typeweaver-core": "^0.1.0",
+    "@rexeus/typeweaver-gen": "^0.1.0"
   },
   "dependencies": {
     "case": "^1.6.3"
@@ -51,7 +54,8 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "format": "prettier --write .",
-    "build": "pkgroll --clean-dist && cp -r ./src/templates ./dist/templates && cp -r ./src/lib ./dist/lib",
+    "build": "pkgroll --clean-dist && cp -r ./src/templates ./dist/templates && cp -r ./src/lib ./dist/lib && cp ../../LICENSE ../../NOTICE ./dist/",
+    "test": "vitest --run",
     "preversion": "npm run build"
   }
 }

package/dist/lib/normalizeHeaders.ts

@@ -1,36 +0,0 @@
-import Case from "case";
-import type { IHttpHeader } from "@rexeus/typeweaver-core";
-
-export interface NormalizedHeaders {
-  [key: string]: string | string[];
-}
-
-export const normalizeHeaders = (
-  headers: Record<string, string | string[] | undefined> | null
-): IHttpHeader => {
-  if (!headers) return undefined;
-
-  const result: NormalizedHeaders = {};
-
-  for (const [key, value] of Object.entries(headers)) {
-    if (value === undefined) continue;
-
-    const processedValue =
-      typeof value === "string" ? value.split(",").map(v => v.trim()) : value;
-
-    const filteredValue = processedValue.filter(v => v !== "");
-    if (filteredValue.length === 0) continue;
-
-    const lowerKey = key.toLowerCase();
-    const headerKey = Case.header(key);
-
-    const finalValue: string | string[] =
-      filteredValue.length === 1 ? filteredValue[0]! : filteredValue;
-
-    result[lowerKey] = finalValue;
-    result[headerKey] = finalValue;
-    result[key] = finalValue;
-  }
-
-  return Object.keys(result).length > 0 ? result : undefined;
-};