@rexeus/typeweaver-hono 0.6.4 → 0.7.0

package/dist/index.cjs

@@ -58,6 +58,7 @@ var HonoRouterGenerator = class {
 		const operationId = resource.definition.operationId;
 		const className = case$1.default.pascal(operationId);
 		return {
+			operationId,
 			className,
 			handlerName: `handle${className}Request`,
 			method: resource.definition.method,

package/dist/index.mjs

@@ -29,6 +29,7 @@ var HonoRouterGenerator = class {
 		const operationId = resource.definition.operationId;
 		const className = Case.pascal(operationId);
 		return {
+			operationId,
 			className,
 			handlerName: `handle${className}Request`,
 			method: resource.definition.method,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/HonoRouterGenerator.ts","../src/index.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { HttpMethod } from \"@rexeus/typeweaver-core\";\nimport type {\n  GeneratorContext,\n  OperationResource,\n} from \"@rexeus/typeweaver-gen\";\nimport Case from \"case\";\n\nexport class HonoRouterGenerator {\n  public static generate(context: GeneratorContext): void {\n    const moduleDir = path.dirname(fileURLToPath(import.meta.url));\n    const templateFile = path.join(moduleDir, \"templates\", \"HonoRouter.ejs\");\n\n    for (const [entityName, entityResource] of Object.entries(\n      context.resources.entityResources\n    )) {\n      this.writeHonoRouter(\n        entityName,\n        templateFile,\n        entityResource.operations,\n        context\n      );\n    }\n  }\n\n  private static writeHonoRouter(\n    entityName: string,\n    templateFile: string,\n    operationResources: OperationResource[],\n    context: GeneratorContext\n  ): void {\n    const pascalCaseEntityName = Case.pascal(entityName);\n    const outputDir = path.join(context.outputDir, entityName);\n    const outputPath = path.join(outputDir, `${pascalCaseEntityName}Hono.ts`);\n\n    const operations = operationResources\n      // Hono handles HEAD requests automatically, so we skip them\n      .filter(resource => resource.definition.method !== HttpMethod.HEAD)\n      .map(resource => this.createOperationData(resource))\n      .sort((a, b) => this.compareRoutes(a, b));\n\n    const content = context.renderTemplate(templateFile, {\n      coreDir: path.relative(outputDir, context.outputDir),\n      entityName,\n      pascalCaseEntityName,\n      operations,\n    });\n\n    const relativePath = path.relative(context.outputDir, outputPath);\n    context.writeFile(relativePath, content);\n  }\n\n  private static createOperationData(resource: OperationResource) {\n    const operationId = resource.definition.operationId;\n    const className = Case.pascal(operationId);\n    const handlerName = `handle${className}Request`;\n\n    return {\n      className,\n      handlerName,\n      method: resource.definition.method,\n      path: resource.definition.path,\n    };\n  }\n\n  private static compareRoutes(\n    a: ReturnType<typeof HonoRouterGenerator.createOperationData>,\n    b: ReturnType<typeof HonoRouterGenerator.createOperationData>\n  ): number {\n    const aSegments = a.path.split(\"/\").filter(s => s);\n    const bSegments = b.path.split(\"/\").filter(s => s);\n\n    // 1. Compare by depth first (shallow to deep)\n    if (aSegments.length !== bSegments.length) {\n      return aSegments.length - bSegments.length;\n    }\n\n    // 2. Compare segment by segment\n    for (let i = 0; i < aSegments.length; i++) {\n      const aSegment = aSegments[i]!;\n      const bSegment = bSegments[i]!;\n\n      const aIsParam = aSegment.startsWith(\":\");\n      const bIsParam = bSegment.startsWith(\":\");\n\n      // Static segments before parameters\n      if (aIsParam !== bIsParam) {\n        return aIsParam ? 1 : -1;\n      }\n\n      // Within same type, alphabetical order\n      if (aSegment !== bSegment) {\n        return aSegment.localeCompare(bSegment);\n      }\n    }\n\n    // 3. Same path = sort by HTTP method priority\n    return this.getMethodPriority(a.method) - this.getMethodPriority(b.method);\n  }\n\n  private static getMethodPriority(method: string): number {\n    const priorities: Record<string, number> = {\n      GET: 1,\n      POST: 2,\n      PUT: 3,\n      PATCH: 4,\n      DELETE: 5,\n      OPTIONS: 6,\n      HEAD: 7,\n    };\n    return priorities[method] ?? 999;\n  }\n}\n","import path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { BasePlugin } from \"@rexeus/typeweaver-gen\";\nimport type { GeneratorContext } from \"@rexeus/typeweaver-gen\";\nimport { HonoRouterGenerator } from \"./HonoRouterGenerator\";\n\nconst moduleDir = path.dirname(fileURLToPath(import.meta.url));\n\nexport default class HonoPlugin extends BasePlugin {\n  public name = \"hono\";\n\n  public override generate(context: GeneratorContext): void {\n    const libSourceDir = path.join(moduleDir, \"lib\");\n    this.copyLibFiles(context, libSourceDir, this.name);\n\n    HonoRouterGenerator.generate(context);\n  }\n}\n"],"mappings":";;;;;;;AASA,IAAa,sBAAb,MAAiC;CAC/B,OAAc,SAAS,SAAiC;EACtD,MAAM,YAAY,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;EAC9D,MAAM,eAAe,KAAK,KAAK,WAAW,aAAa,iBAAiB;AAExE,OAAK,MAAM,CAAC,YAAY,mBAAmB,OAAO,QAChD,QAAQ,UAAU,gBACnB,CACC,MAAK,gBACH,YACA,cACA,eAAe,YACf,QACD;;CAIL,OAAe,gBACb,YACA,cACA,oBACA,SACM;EACN,MAAM,uBAAuB,KAAK,OAAO,WAAW;EACpD,MAAM,YAAY,KAAK,KAAK,QAAQ,WAAW,WAAW;EAC1D,MAAM,aAAa,KAAK,KAAK,WAAW,GAAG,qBAAqB,SAAS;EAEzE,MAAM,aAAa,mBAEhB,QAAO,aAAY,SAAS,WAAW,WAAW,WAAW,KAAK,CAClE,KAAI,aAAY,KAAK,oBAAoB,SAAS,CAAC,CACnD,MAAM,GAAG,MAAM,KAAK,cAAc,GAAG,EAAE,CAAC;EAE3C,MAAM,UAAU,QAAQ,eAAe,cAAc;GACnD,SAAS,KAAK,SAAS,WAAW,QAAQ,UAAU;GACpD;GACA;GACA;GACD,CAAC;EAEF,MAAM,eAAe,KAAK,SAAS,QAAQ,WAAW,WAAW;AACjE,UAAQ,UAAU,cAAc,QAAQ;;CAG1C,OAAe,oBAAoB,UAA6B;EAC9D,MAAM,cAAc,SAAS,WAAW;EACxC,MAAM,YAAY,KAAK,OAAO,YAAY;AAG1C,SAAO;GACL;GACA,aAJkB,SAAS,UAAU;GAKrC,QAAQ,SAAS,WAAW;GAC5B,MAAM,SAAS,WAAW;GAC3B;;CAGH,OAAe,cACb,GACA,GACQ;EACR,MAAM,YAAY,EAAE,KAAK,MAAM,IAAI,CAAC,QAAO,MAAK,EAAE;EAClD,MAAM,YAAY,EAAE,KAAK,MAAM,IAAI,CAAC,QAAO,MAAK,EAAE;AAGlD,MAAI,UAAU,WAAW,UAAU,OACjC,QAAO,UAAU,SAAS,UAAU;AAItC,OAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;GACzC,MAAM,WAAW,UAAU;GAC3B,MAAM,WAAW,UAAU;GAE3B,MAAM,WAAW,SAAS,WAAW,IAAI;AAIzC,OAAI,aAHa,SAAS,WAAW,IAAI,CAIvC,QAAO,WAAW,IAAI;AAIxB,OAAI,aAAa,SACf,QAAO,SAAS,cAAc,SAAS;;AAK3C,SAAO,KAAK,kBAAkB,EAAE,OAAO,GAAG,KAAK,kBAAkB,EAAE,OAAO;;CAG5E,OAAe,kBAAkB,QAAwB;AAUvD,SAT2C;GACzC,KAAK;GACL,MAAM;GACN,KAAK;GACL,OAAO;GACP,QAAQ;GACR,SAAS;GACT,MAAM;GACP,CACiB,WAAW;;;;;;ACzGjC,MAAM,YAAY,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE9D,IAAqB,aAArB,cAAwC,WAAW;CACjD,AAAO,OAAO;CAEd,AAAgB,SAAS,SAAiC;EACxD,MAAM,eAAe,KAAK,KAAK,WAAW,MAAM;AAChD,OAAK,aAAa,SAAS,cAAc,KAAK,KAAK;AAEnD,sBAAoB,SAAS,QAAQ"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/HonoRouterGenerator.ts","../src/index.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { HttpMethod } from \"@rexeus/typeweaver-core\";\nimport type {\n  GeneratorContext,\n  OperationResource,\n} from \"@rexeus/typeweaver-gen\";\nimport Case from \"case\";\n\nexport class HonoRouterGenerator {\n  public static generate(context: GeneratorContext): void {\n    const moduleDir = path.dirname(fileURLToPath(import.meta.url));\n    const templateFile = path.join(moduleDir, \"templates\", \"HonoRouter.ejs\");\n\n    for (const [entityName, entityResource] of Object.entries(\n      context.resources.entityResources\n    )) {\n      this.writeHonoRouter(\n        entityName,\n        templateFile,\n        entityResource.operations,\n        context\n      );\n    }\n  }\n\n  private static writeHonoRouter(\n    entityName: string,\n    templateFile: string,\n    operationResources: OperationResource[],\n    context: GeneratorContext\n  ): void {\n    const pascalCaseEntityName = Case.pascal(entityName);\n    const outputDir = path.join(context.outputDir, entityName);\n    const outputPath = path.join(outputDir, `${pascalCaseEntityName}Hono.ts`);\n\n    const operations = operationResources\n      // Hono handles HEAD requests automatically, so we skip them\n      .filter(resource => resource.definition.method !== HttpMethod.HEAD)\n      .map(resource => this.createOperationData(resource))\n      .sort((a, b) => this.compareRoutes(a, b));\n\n    const content = context.renderTemplate(templateFile, {\n      coreDir: path.relative(outputDir, context.outputDir),\n      entityName,\n      pascalCaseEntityName,\n      operations,\n    });\n\n    const relativePath = path.relative(context.outputDir, outputPath);\n    context.writeFile(relativePath, content);\n  }\n\n  private static createOperationData(resource: OperationResource) {\n    const operationId = resource.definition.operationId;\n    const className = Case.pascal(operationId);\n    const handlerName = `handle${className}Request`;\n\n    return {\n      operationId,\n      className,\n      handlerName,\n      method: resource.definition.method,\n      path: resource.definition.path,\n    };\n  }\n\n  private static compareRoutes(\n    a: ReturnType<typeof HonoRouterGenerator.createOperationData>,\n    b: ReturnType<typeof HonoRouterGenerator.createOperationData>\n  ): number {\n    const aSegments = a.path.split(\"/\").filter(s => s);\n    const bSegments = b.path.split(\"/\").filter(s => s);\n\n    // 1. Compare by depth first (shallow to deep)\n    if (aSegments.length !== bSegments.length) {\n      return aSegments.length - bSegments.length;\n    }\n\n    // 2. Compare segment by segment\n    for (let i = 0; i < aSegments.length; i++) {\n      const aSegment = aSegments[i]!;\n      const bSegment = bSegments[i]!;\n\n      const aIsParam = aSegment.startsWith(\":\");\n      const bIsParam = bSegment.startsWith(\":\");\n\n      // Static segments before parameters\n      if (aIsParam !== bIsParam) {\n        return aIsParam ? 1 : -1;\n      }\n\n      // Within same type, alphabetical order\n      if (aSegment !== bSegment) {\n        return aSegment.localeCompare(bSegment);\n      }\n    }\n\n    // 3. Same path = sort by HTTP method priority\n    return this.getMethodPriority(a.method) - this.getMethodPriority(b.method);\n  }\n\n  private static getMethodPriority(method: string): number {\n    const priorities: Record<string, number> = {\n      GET: 1,\n      POST: 2,\n      PUT: 3,\n      PATCH: 4,\n      DELETE: 5,\n      OPTIONS: 6,\n      HEAD: 7,\n    };\n    return priorities[method] ?? 999;\n  }\n}\n","import path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { BasePlugin } from \"@rexeus/typeweaver-gen\";\nimport type { GeneratorContext } from \"@rexeus/typeweaver-gen\";\nimport { HonoRouterGenerator } from \"./HonoRouterGenerator\";\n\nconst moduleDir = path.dirname(fileURLToPath(import.meta.url));\n\nexport default class HonoPlugin extends BasePlugin {\n  public name = \"hono\";\n\n  public override generate(context: GeneratorContext): void {\n    const libSourceDir = path.join(moduleDir, \"lib\");\n    this.copyLibFiles(context, libSourceDir, this.name);\n\n    HonoRouterGenerator.generate(context);\n  }\n}\n"],"mappings":";;;;;;;AASA,IAAa,sBAAb,MAAiC;CAC/B,OAAc,SAAS,SAAiC;EACtD,MAAM,YAAY,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;EAC9D,MAAM,eAAe,KAAK,KAAK,WAAW,aAAa,iBAAiB;AAExE,OAAK,MAAM,CAAC,YAAY,mBAAmB,OAAO,QAChD,QAAQ,UAAU,gBACnB,CACC,MAAK,gBACH,YACA,cACA,eAAe,YACf,QACD;;CAIL,OAAe,gBACb,YACA,cACA,oBACA,SACM;EACN,MAAM,uBAAuB,KAAK,OAAO,WAAW;EACpD,MAAM,YAAY,KAAK,KAAK,QAAQ,WAAW,WAAW;EAC1D,MAAM,aAAa,KAAK,KAAK,WAAW,GAAG,qBAAqB,SAAS;EAEzE,MAAM,aAAa,mBAEhB,QAAO,aAAY,SAAS,WAAW,WAAW,WAAW,KAAK,CAClE,KAAI,aAAY,KAAK,oBAAoB,SAAS,CAAC,CACnD,MAAM,GAAG,MAAM,KAAK,cAAc,GAAG,EAAE,CAAC;EAE3C,MAAM,UAAU,QAAQ,eAAe,cAAc;GACnD,SAAS,KAAK,SAAS,WAAW,QAAQ,UAAU;GACpD;GACA;GACA;GACD,CAAC;EAEF,MAAM,eAAe,KAAK,SAAS,QAAQ,WAAW,WAAW;AACjE,UAAQ,UAAU,cAAc,QAAQ;;CAG1C,OAAe,oBAAoB,UAA6B;EAC9D,MAAM,cAAc,SAAS,WAAW;EACxC,MAAM,YAAY,KAAK,OAAO,YAAY;AAG1C,SAAO;GACL;GACA;GACA,aALkB,SAAS,UAAU;GAMrC,QAAQ,SAAS,WAAW;GAC5B,MAAM,SAAS,WAAW;GAC3B;;CAGH,OAAe,cACb,GACA,GACQ;EACR,MAAM,YAAY,EAAE,KAAK,MAAM,IAAI,CAAC,QAAO,MAAK,EAAE;EAClD,MAAM,YAAY,EAAE,KAAK,MAAM,IAAI,CAAC,QAAO,MAAK,EAAE;AAGlD,MAAI,UAAU,WAAW,UAAU,OACjC,QAAO,UAAU,SAAS,UAAU;AAItC,OAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;GACzC,MAAM,WAAW,UAAU;GAC3B,MAAM,WAAW,UAAU;GAE3B,MAAM,WAAW,SAAS,WAAW,IAAI;AAIzC,OAAI,aAHa,SAAS,WAAW,IAAI,CAIvC,QAAO,WAAW,IAAI;AAIxB,OAAI,aAAa,SACf,QAAO,SAAS,cAAc,SAAS;;AAK3C,SAAO,KAAK,kBAAkB,EAAE,OAAO,GAAG,KAAK,kBAAkB,EAAE,OAAO;;CAG5E,OAAe,kBAAkB,QAAwB;AAUvD,SAT2C;GACzC,KAAK;GACL,MAAM;GACN,KAAK;GACL,OAAO;GACP,QAAQ;GACR,SAAS;GACT,MAAM;GACP,CACiB,WAAW;;;;;;AC1GjC,MAAM,YAAY,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE9D,IAAqB,aAArB,cAAwC,WAAW;CACjD,AAAO,OAAO;CAEd,AAAgB,SAAS,SAAiC;EACxD,MAAM,eAAe,KAAK,KAAK,WAAW,MAAM;AAChD,OAAK,aAAa,SAAS,cAAc,KAAK,KAAK;AAEnD,sBAAoB,SAAS,QAAQ"}

package/dist/lib/TypeweaverHono.ts

@@ -24,7 +24,7 @@ import type { BlankEnv, BlankSchema, Env, Schema } from "hono/types";
  * @param context - The Hono context for the current request
  * @returns The HTTP response to send to the client
  */
-export type HttpResponseErrorHandler = (
+export type HonoHttpResponseErrorHandler = (
   error: HttpResponse,
   context: Context
 ) => Promise<IHttpResponse> | IHttpResponse;
@@ -35,7 +35,7 @@ export type HttpResponseErrorHandler = (
  * @param context - The Hono context for the current request
  * @returns The HTTP response to send to the client
  */
-export type ValidationErrorHandler = (
+export type HonoValidationErrorHandler = (
   error: RequestValidationError,
   context: Context
 ) => Promise<IHttpResponse> | IHttpResponse;
@@ -46,7 +46,7 @@ export type ValidationErrorHandler = (
  * @param context - The Hono context for the current request
  * @returns The HTTP response to send to the client
  */
-export type UnknownErrorHandler = (
+export type HonoUnknownErrorHandler = (
   error: unknown,
   context: Context
 ) => Promise<IHttpResponse> | IHttpResponse;
@@ -80,7 +80,7 @@ export type TypeweaverHonoOptions<
    * - `function`: Use custom error handler
    * @default true
    */
-  handleHttpResponseErrors?: HttpResponseErrorHandler | boolean;
+  handleHttpResponseErrors?: HonoHttpResponseErrorHandler | boolean;
 
   /**
    * Configure handling of request validation errors.
@@ -89,7 +89,7 @@ export type TypeweaverHonoOptions<
    * - `function`: Use custom error handler
    * @default true
    */
-  handleValidationErrors?: ValidationErrorHandler | boolean;
+  handleValidationErrors?: HonoValidationErrorHandler | boolean;
 
   /**
    * Configure handling of unknown errors.
@@ -98,7 +98,7 @@ export type TypeweaverHonoOptions<
    * - `function`: Use custom error handler
    * @default true
    */
-  handleUnknownErrors?: UnknownErrorHandler | boolean;
+  handleUnknownErrors?: HonoUnknownErrorHandler | boolean;
 };
 
 /**
@@ -136,9 +136,9 @@ export abstract class TypeweaverHono<
   private readonly config: {
     validateRequests: boolean;
     errorHandlers: {
-      validation: ValidationErrorHandler | undefined;
-      httpResponse: HttpResponseErrorHandler | undefined;
-      unknown: UnknownErrorHandler | undefined;
+      validation: HonoValidationErrorHandler | undefined;
+      httpResponse: HonoHttpResponseErrorHandler | undefined;
+      unknown: HonoUnknownErrorHandler | undefined;
     };
   };
 
@@ -303,6 +303,7 @@ export abstract class TypeweaverHono<
    * Handles a request with validation and type-safe response conversion.
    *
    * @param context - Hono context for the current request
+   * @param operationId - Unique operation identifier from the API definition
    * @param validator - Request validator for the specific operation
    * @param handler - Type-safe request handler function
    * @returns Hono-compatible Response object
@@ -312,10 +313,13 @@ export abstract class TypeweaverHono<
     TResponse extends IHttpResponse,
   >(
     context: Context,
+    operationId: string,
     validator: IRequestValidator,
     handler: HonoRequestHandler<TRequest, TResponse>
   ): Promise<Response> {
     try {
+      context.set("operationId", operationId);
+
       const httpRequest = await this.adapter.toRequest(context);
 
       // Conditionally validate

package/dist/templates/HonoRouter.ejs

@@ -31,6 +31,7 @@ export class <%- pascalCaseEntityName %>Hono extends TypeweaverHono<Hono<%- pasc
     this.<%- operation.method.toLowerCase() %>('<%- operation.path %>', async (context: Context) =>
       this.handleRequest(
         context,
+        '<%- operation.operationId %>',
         new <%- operation.className %>RequestValidator(),
         this.requestHandlers.<%- operation.handlerName %>.bind(this.requestHandlers)
       ));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rexeus/typeweaver-hono",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "Generates Hono routers and handlers straight from your API definitions. Powered by Typeweaver 🧵✨",
   "type": "module",
   "sideEffects": false,
@@ -47,14 +47,14 @@
   "homepage": "https://github.com/rexeus/typeweaver#readme",
   "peerDependencies": {
     "hono": "^4.11.0",
-    "@rexeus/typeweaver-core": "^0.6.4",
-    "@rexeus/typeweaver-gen": "^0.6.4"
+    "@rexeus/typeweaver-core": "^0.7.0",
+    "@rexeus/typeweaver-gen": "^0.7.0"
   },
   "devDependencies": {
     "hono": "^4.11.3",
     "test-utils": "file:../test-utils",
-    "@rexeus/typeweaver-core": "^0.6.4",
-    "@rexeus/typeweaver-gen": "^0.6.4"
+    "@rexeus/typeweaver-core": "^0.7.0",
+    "@rexeus/typeweaver-gen": "^0.7.0"
   },
   "dependencies": {
     "case": "^1.6.3"