honestjs 0.1.17 → 0.1.19

package/README.md

@@ -144,7 +144,7 @@ const { app, hono } = await Application.create(AppModule, {
 		di: true,
 		startup: true
 	},
-	diagnostics: myDiagnosticsEmitter,
+	logger: myLogger,
 	strict: { requireRoutes: true },
 	deprecations: { printPreV1Warning: true },
 	container: myContainer,
@@ -166,7 +166,12 @@ const { app, hono } = await Application.create(AppModule, {
 	plugins: [
 		new RPCPlugin(),
 		new ApiDocsPlugin(),
-		{ plugin: MyPlugin, name: 'core', preProcessors: [pre], postProcessors: [post] },
+		{
+			plugin: MyPlugin,
+			name: 'core',
+			preProcessors: [pre],
+			postProcessors: [post]
+		},
 		{ plugin: MetricsPlugin, name: 'metrics', after: ['core'] }
 	],
 	onError: (err, c) => c.json({ error: err.message }, 500),
@@ -219,7 +224,7 @@ If constraints are invalid (missing dependency, cycle, or missing required capab
 Honest exports lightweight helpers for common test setups.
 
 ```typescript
-import { createTestApplication, createControllerTestApplication, createServiceTestContainer } from 'honestjs'
+import { createControllerTestApplication, createServiceTestContainer, createTestApplication } from 'honestjs'
 
 const app = await createTestApplication({
 	controllers: [UsersController],
@@ -238,6 +243,22 @@ const services = createServiceTestContainer({
 })
 ```
 
+### Running tests in this package
+
+This repo uses [Bun's test runner](https://bun.sh/docs/cli/test). From the package root:
+
+- `bun test` — run all tests once
+- `bun test --watch` — watch mode
+- `bun test <pattern>` — limit to matching file or test names (for example `bun test application.bootstrap`)
+- `bun run test:coverage` — same suite with coverage (summary in the terminal and `coverage/lcov.info`)
+
+Co-locate tests as `*.test.ts` next to sources. Import `reflect-metadata` first in any file that loads decorated
+classes, same as in application code.
+
+Integration-style cases use `*.integration.test.ts` where the whole `Application` stack is exercised (for example the
+request pipeline). Shared HTTP fixtures for application tests live under `src/testing/fixtures/` as **factory
+functions** so each test gets fresh decorator metadata after `MetadataRegistry.clear()` in `afterEach`.
+
 ## Startup diagnostics guide mode
 
 Enable startup guidance to get actionable remediation hints when initialization fails.

package/dist/application.d.ts

@@ -16,7 +16,7 @@ export declare class Application {
     private readonly metadataRepository;
     private readonly componentManager;
     private readonly routeManager;
-    private readonly diagnosticsEmitter;
+    private readonly logger;
     private readonly options;
     private static readonly DEFAULT_PLUGIN_NAME;
     constructor(options?: HonestOptions, metadataRepository?: IMetadataRepository);

package/dist/application.di-harness.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/application.diagnostics.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/application.isolation.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/application.plugins.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/application.regressions.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/application.routing-errors.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/application.runtime-metadata.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/di/container.d.ts

@@ -1,18 +1,18 @@
-import type { DiContainer, IDiagnosticsEmitter, IServiceRegistry } from '../interfaces';
+import type { DiContainer, ILogger, IServiceRegistry } from '../interfaces';
 import type { Constructor } from '../types';
 /**
  * Dependency Injection container that manages class instances and their dependencies
  */
 export declare class Container implements DiContainer {
     private readonly serviceRegistry;
-    private readonly diagnosticsEmitter;
+    private readonly logger;
     private readonly debugDi;
-    constructor(serviceRegistry?: IServiceRegistry, diagnosticsEmitter?: IDiagnosticsEmitter, debugDi?: boolean);
+    constructor(serviceRegistry?: IServiceRegistry, logger?: ILogger, debugDi?: boolean);
     /**
      * Map of class constructors to their instances
      */
     private instances;
-    private emitDiagnostic;
+    private emitLog;
     /**
      * Resolves a class instance, creating it if necessary and injecting its dependencies
      * @param target - The class constructor to resolve

package/dist/diagnostics/console-diagnostics.emitter.d.ts

@@ -1,7 +1,7 @@
-import type { DiagnosticEvent, IDiagnosticsEmitter } from '../interfaces';
+import type { LogEvent, ILogger } from '../interfaces';
 /**
- * Default diagnostics emitter that writes structured events to console.
+ * Default logger that writes structured events to console.
  */
-export declare class ConsoleDiagnosticsEmitter implements IDiagnosticsEmitter {
-    emit(event: DiagnosticEvent): void;
+export declare class ConsoleLogger implements ILogger {
+    emit(event: LogEvent): void;
 }

package/dist/diagnostics/noop-diagnostics.emitter.d.ts

@@ -1,7 +1,7 @@
-import type { DiagnosticEvent, IDiagnosticsEmitter } from '../interfaces';
+import type { LogEvent, ILogger } from '../interfaces';
 /**
- * Diagnostics emitter implementation that intentionally does nothing.
+ * Logger implementation that intentionally does nothing.
  */
-export declare class NoopDiagnosticsEmitter implements IDiagnosticsEmitter {
-    emit(_event: DiagnosticEvent): void;
+export declare class NoopLogger implements ILogger {
+    emit(_event: LogEvent): void;
 }

package/dist/index.js

@@ -1,22 +1,22 @@
-import"reflect-metadata";import{Hono as B$}from"hono";class h{store=new Map;get($){return this.store.get($)}set($,_){this.store.set($,_)}has($){return this.store.has($)}delete($){return this.store.delete($)}keys(){return this.store.keys()}}class g{emit($){let _=`[HonestJS:${$.category}]`,W=$.details?[_,$.message,$.details]:[_,$.message];switch($.level){case"debug":case"info":console.info(...W);break;case"warn":console.warn(...W);break;case"error":console.error(...W);break}}}class H{emit($){}}class L{static routes=new Map;static controllers=new Map;static controllerOptions=new Map;static services=new Set;static modules=new Map;static parameters=new Map;static contextIndices=new Map;static controller=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);static handler=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);static getRoutes($){return this.routes.get($)||[]}static setRoutes($,_){this.routes.set($,_)}static addRoute($,_){if(!this.routes.has($))this.routes.set($,[]);this.routes.get($).push(_)}static getControllerPath($){return this.controllers.get($)||""}static hasController($){return this.controllers.has($)}static setControllerPath($,_){this.controllers.set($,_)}static getControllerOptions($){return this.controllerOptions.get($)||{}}static setControllerOptions($,_){this.controllerOptions.set($,_)}static isService($){return this.services.has($)}static addService($){this.services.add($)}static getAllServices(){return this.services}static getModuleOptions($){return this.modules.get($)}static setModuleOptions($,_){this.modules.set($,_)}static getParameters($){return this.parameters.get($)||new Map}static setParameterMap($,_){this.parameters.set($,_)}static getContextIndices($){return this.contextIndices.get($)||new Map}static setContextIndices($,_){this.contextIndices.set($,_)}static registerController($,_,W){let Q=this.controller.get($);if(!Q.has(_))Q.set(_,[]);Q.get(_).push(W)}static getController($,_){return this.controller.get($).get(_)||[]}static registerHandler($,_,W){let Q=this.handler.get($);if(!Q.has(_))Q.set(_,[]);Q.get(_).push(W)}static getHandler($,_){return this.handler.get($).get(_)||[]}static clear(){this.routes.clear(),this.controllers.clear(),this.controllerOptions.clear(),this.services.clear(),this.modules.clear(),this.parameters.clear(),this.contextIndices.clear();for(let $ of this.controller.values())$.clear();for(let $ of this.handler.values())$.clear()}}class D{hasController($){return L.hasController($)}getControllerPath($){return L.getControllerPath($)}getControllerOptions($){return L.getControllerOptions($)}getRoutes($){return L.getRoutes($)}getParameters($){return L.getParameters($)}getContextIndices($){return L.getContextIndices($)}getModuleOptions($){return L.getModuleOptions($)}getControllerComponents($,_){return L.getController($,_)}getHandlerComponents($,_){return L.getHandler($,_)}}class C{controllerPaths=new Map;controllerOptions=new Map;routes=new Map;parameters=new Map;contextIndices=new Map;modules=new Map;controllerComponents=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);handlerComponents=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);static fromRootModule($,_=new D){let W=new C;return W.captureModuleGraph($,_),W}hasController($){return this.controllerPaths.has($)}getControllerPath($){return this.controllerPaths.get($)||""}getControllerOptions($){let _=this.controllerOptions.get($);return _?{..._}:{}}getRoutes($){return(this.routes.get($)||[]).map((_)=>this.cloneRouteDefinition(_))}getParameters($){let _=this.parameters.get($);if(!_)return new Map;let W=new Map;for(let[Q,X]of _.entries())W.set(Q,X.map((Z)=>({...Z})));return W}getContextIndices($){return new Map(this.contextIndices.get($)||new Map)}getModuleOptions($){let _=this.modules.get($);if(!_)return;return{controllers:_.controllers?[..._.controllers]:void 0,services:_.services?[..._.services]:void 0,imports:_.imports?[..._.imports]:void 0}}getControllerComponents($,_){return[...this.controllerComponents.get($).get(_)||[]]}getHandlerComponents($,_){return[...this.handlerComponents.get($).get(_)||[]]}captureModuleGraph($,_){let W=new Set,Q=new Set,X=(Z)=>{if(W.has(Z))return;W.add(Z);let U=_.getModuleOptions(Z);if(!U)return;let J={controllers:U.controllers?[...U.controllers]:void 0,services:U.services?[...U.services]:void 0,imports:U.imports?[...U.imports]:void 0};this.modules.set(Z,J);for(let Y of J.controllers||[])Q.add(Y);for(let Y of J.imports||[])X(Y)};X($);for(let Z of Q)this.captureController(Z,_)}captureController($,_){if(!_.hasController($))return;this.controllerPaths.set($,_.getControllerPath($)||""),this.controllerOptions.set($,{..._.getControllerOptions($)});let W=(_.getRoutes($)||[]).map((Z)=>this.cloneRouteDefinition(Z));this.routes.set($,W);let Q=_.getParameters($),X=new Map;for(let[Z,U]of Q.entries())X.set(Z,(U||[]).map((J)=>({...J})));this.parameters.set($,X),this.contextIndices.set($,new Map(_.getContextIndices($)||new Map));for(let Z of["middleware","guard","pipe","filter"])this.controllerComponents.get(Z).set($,[..._.getControllerComponents(Z,$)||[]]);for(let Z of W){let U=`${$.name}:${String(Z.handlerName)}`;for(let J of["middleware","guard","pipe","filter"])this.handlerComponents.get(J).set(U,[..._.getHandlerComponents(J,U)||[]])}}cloneRouteDefinition($){return{...$,version:Array.isArray($.version)?[...$.version]:$.version}}}class m{routes=[];registerRoute($){if(!$)throw Error("Route info is required");if(!$.controller)throw Error("Route controller is required");if(!$.handler)throw Error("Route handler is required");if(!$.method)throw Error("Route method is required");if(!$.fullPath)throw Error("Route fullPath is required");if(this.routes.some((W)=>W.fullPath===$.fullPath&&W.method.toUpperCase()===$.method.toUpperCase()))throw Error(`Duplicate route detected: ${$.method.toUpperCase()} ${$.fullPath} (${String($.controller)}.${String($.handler)})`);this.routes.push($)}getRoutes(){return this.routes}getRoutesByController($){return this.routes.filter((_)=>_.controller===$)}getRoutesByMethod($){return this.routes.filter((_)=>_.method.toUpperCase()===$.toUpperCase())}getRoutesByPath($){return this.routes.filter((_)=>$.test(_.fullPath))}clear(){this.routes.length=0}}class u{isService($){return L.isService($)}}class E{serviceRegistry;diagnosticsEmitter;debugDi;constructor($=new u,_=new H,W=!1){this.serviceRegistry=$;this.diagnosticsEmitter=_;this.debugDi=W}instances=new Map;emitDiagnostic($){if(!this.debugDi)return;this.diagnosticsEmitter.emit($)}resolve($){return this.resolveWithTracking($,new Set)}resolveWithTracking($,_){if(this.instances.has($))return this.emitDiagnostic({level:"debug",category:"di",message:`Resolved ${$.name} from DI cache`}),this.instances.get($);if(_.has($)){let Z=[..._.keys(),$].map((U)=>U.name).join(" -> ");throw this.emitDiagnostic({level:"error",category:"di",message:`Circular dependency detected while resolving ${$.name}`,details:{cycle:Z}}),Error(`Circular dependency detected: ${Z}`)}_.add($),this.emitDiagnostic({level:"debug",category:"di",message:`Resolving ${$.name}`,details:{resolving:[..._].map((Z)=>Z.name)}});let W=Reflect.getMetadata("design:paramtypes",$)||[];if($.length>0&&W.length===0){if(!this.serviceRegistry.isService($))throw this.emitDiagnostic({level:"error",category:"di",message:`Cannot resolve ${$.name}: missing @Service() decorator`}),Error(`Cannot resolve ${$.name}: it is not decorated with @Service(). Did you forget to add @Service() to the class?`);throw this.emitDiagnostic({level:"error",category:"di",message:`Cannot resolve ${$.name}: missing constructor metadata`}),Error(`Cannot resolve dependencies for ${$.name}: constructor metadata is missing. Ensure 'reflect-metadata' is imported and 'emitDecoratorMetadata' is enabled.`)}let Q=W.map((Z,U)=>{if(!Z||Z===Object||Z===Array||Z===Function)throw this.emitDiagnostic({level:"error",category:"di",message:`Cannot resolve dependency at index ${U} of ${$.name}`}),Error(`Cannot resolve dependency at index ${U} of ${$.name}. Use concrete class types for constructor dependencies.`);return this.resolveWithTracking(Z,new Set(_))}),X=new $(...Q);return this.instances.set($,X),this.emitDiagnostic({level:"debug",category:"di",message:`Created ${$.name} instance`,details:{dependencyCount:Q.length}}),X}register($,_){this.instances.set($,_)}has($){return this.instances.has($)}clear(){this.instances.clear()}}import{HTTPException as U$}from"hono/http-exception";class d extends Error{status;code;category;remediation;details;constructor($,_){super($);if(this.name="FrameworkError",this.status=_.status,this.code=_.code,this.category=_.category,this.remediation=_.remediation,this.details=_.details,_.cause!==void 0)this.cause=_.cause}}function R($,_,W){let Q=$ instanceof Error?$:Error(String($)),X=new Date().toISOString(),Z=_.get("requestId"),U=_.req.path;if(Q instanceof U$)return{response:{status:W?.status||Q.status,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:W?.status||Q.status};if(Q instanceof d){let B=W?.status||Q.status||500;return{response:{status:B,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code||Q.code,details:{category:Q.category,remediation:Q.remediation,...Q.details,...W?.additionalDetails},...W?.detail&&{detail:W.detail}},status:B}}if(Q.statusCode||Q.status){let B=Q.statusCode||Q.status||500,q=W?.status||B;return{response:{status:q,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code||Q.name,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:q}}let J=W?.status||500;return{response:{status:J,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code||Q.name,details:W?.additionalDetails||{stack:Q.stack},...W?.detail&&{detail:W.detail}},status:J}}function T($){return(_="",W={})=>{return(Q,X,Z)=>{let U=Q.constructor;L.addRoute(U,{path:_,method:$,handlerName:X,version:W.version,prefix:W.prefix})}}}function z($,_){let W=(Q,X)=>{if(Q===void 0)return X;return X.get(String(Q))};return(Q)=>{return(X,Z,U)=>{let J=X.constructor;if(!L.getParameters(J).size)L.setParameterMap(J,new Map);let Y=L.getParameters(J);if(!Y.has(Z))Y.set(Z,[]);let q=Reflect.getMetadata("design:paramtypes",X,Z)?.[U];if(Y.get(Z).push({index:U,name:$,data:Q,factory:_||W,metatype:q}),$==="context"){if(!L.getContextIndices(J).size)L.setContextIndices(J,new Map);L.getContextIndices(J).set(Z,U)}}}}class c{static handle(){return async($,_)=>{let{response:W,status:Q}=R($,_);return _.json(W,Q)}}}class p{static handle(){return async($)=>{return $.json({message:`Not Found - ${$.req.path}`},404)}}}var i=Symbol("VERSION_NEUTRAL");var I="__honest_controllerClass",M="__honest_handlerName",l="__honest.body.cache";var X_=($)=>typeof $>"u",S=($)=>$===null||typeof $>"u",K=($)=>$!==null&&typeof $==="object",Z_=($)=>{if(!K($))return!1;let _=Object.getPrototypeOf($);if(_===null)return!0;let W=Object.prototype.hasOwnProperty.call(_,"constructor")&&_.constructor;return typeof W==="function"&&W instanceof W&&Function.prototype.toString.call(W)===Function.prototype.toString.call(Object)},_$=($)=>typeof $==="function",f=($)=>typeof $==="string",J_=($)=>typeof $==="number",U_=($)=>$.length===0,Y_=($)=>typeof $==="symbol",B_=($)=>typeof $==="string"?$.charAt(0)!=="/"?"/"+$:$:"",s=($)=>$?$.startsWith("/")?("/"+$.replace(/\/+$/,"")).replace(/\/+/g,"/"):"/"+$.replace(/\/+$/,""):"/",L_=($)=>$.endsWith("/")?$.slice(0,-1):$,W$=($)=>{return _$($)&&!S($.prototype)&&!_$($.prototype)&&Object.getOwnPropertyNames($.prototype).length>=1};class n{container;metadataRepository;diagnosticsEmitter;globalComponents=new Map([["middleware",new Set],["guard",new Set],["pipe",new Set],["filter",new Set]]);constructor($,_=new D,W=new H){this.container=$;this.metadataRepository=_;this.diagnosticsEmitter=W}setupGlobalComponents($){let _=$.components||{};if(_.middleware)this.registerGlobal("middleware",..._.middleware);if(_.guards)this.registerGlobal("guard",..._.guards);if(_.pipes)this.registerGlobal("pipe",..._.pipes);if(_.filters)this.registerGlobal("filter",..._.filters)}registerGlobal($,..._){_.forEach((W)=>{this.globalComponents.get($).add(W)})}getGlobal($){return this.globalComponents.get($)}getComponents($,_,W){let Q=`${_.name}:${String(W)}`,X=this.metadataRepository.getHandlerComponents($,Q),Z=this.metadataRepository.getControllerComponents($,_);return[...Array.from(this.globalComponents.get($)||[]),...Z,...X]}resolveMiddleware($){return $.map((_)=>{if(K(_)&&"use"in _)return _.use.bind(_);let W=this.container.resolve(_);return W.use.bind(W)})}getHandlerMiddleware($,_){let W=this.getComponents("middleware",$,_);return this.resolveMiddleware(W)}getGlobalMiddleware(){let $=Array.from(this.globalComponents.get("middleware")||[]);return this.resolveMiddleware($)}resolveGuards($){return $.map((_)=>{if(K(_)&&"canActivate"in _)return _;return this.container.resolve(_)})}getHandlerGuards($,_){let W=this.getComponents("guard",$,_);return this.resolveGuards(W)}resolvePipes($){return $.map((_)=>{if(K(_)&&"transform"in _)return _;return this.container.resolve(_)})}getHandlerPipes($,_){let W=this.getComponents("pipe",$,_);return this.resolvePipes(W)}async executePipes($,_,W){let Q=$;for(let X of W)Q=await X.transform(Q,_);return Q}async handleException($,_){let W=_.get(I),Q=_.get(M);if(W&&Q){let J=this.metadataRepository.getHandlerComponents("filter",`${W.name}:${Q}`);if(J.length>0){let Y=await this.executeFilters(J,$,_);if(Y)return Y}}if(W){let J=this.metadataRepository.getControllerComponents("filter",W);if(J.length>0){let Y=await this.executeFilters(J,$,_);if(Y)return Y}}let X=Array.from(this.globalComponents.get("filter")||[]);if(X.length>0){let J=await this.executeFilters(X,$,_);if(J)return J}let{response:Z,status:U}=R($,_);return _.json(Z,U)}async executeFilters($,_,W){for(let Q of $){let X;if(K(Q)&&"catch"in Q)X=Q;else X=this.container.resolve(Q);try{let Z=await X.catch(_,W);if(Z!==void 0)return Z}catch(Z){let U=X.constructor?.name||"UnknownFilter";this.diagnosticsEmitter.emit({level:"error",category:"errors",message:`Error in exception filter ${U}`,details:{error:Z instanceof Error?Z.message:String(Z)}});let{response:J,status:Y}=R(Z,W);return W.json(J,Y)}}return}async registerModule($,_=new Set){if(_.has($))return[];_.add($);let W=this.metadataRepository.getModuleOptions($);if(!W)throw this.diagnosticsEmitter.emit({level:"error",category:"startup",message:`Module ${$.name} is not properly decorated with @Module()`}),Error(`Module ${$.name} is not properly decorated with @Module()`);let Q=[];if(W.imports&&W.imports.length>0)for(let X of W.imports){let Z=await this.registerModule(X,_);Q.push(...Z)}if(W.services&&W.services.length>0)for(let X of W.services)this.container.resolve(X);if(W.controllers&&W.controllers.length>0)Q.push(...W.controllers);return Q}}class a{async invoke({handler:$,args:_,context:W,contextIndex:Q}){let X=await $(..._);if(Q!==void 0)return X;if(X instanceof Response)return X;if(S(X))return W.json(null);if(f(X))return W.text(X);return W.json(X)}}class o{componentManager;constructor($){this.componentManager=$}async resolveArguments($){let{controllerName:_,handlerName:W,handlerArity:Q,handlerParams:X,handlerPipes:Z,context:U}=$,J=X.length>0?Math.max(...X.map((B)=>B.index)):-1,Y=Array(Math.max(Q,J+1));for(let B of X){if(typeof B.factory!=="function")throw Error(`Invalid parameter decorator metadata for ${_}.${String(W)}`);let q=await B.factory(B.data,U),F=await this.componentManager.executePipes(q,{type:B.name,metatype:B.metatype,data:typeof B.data==="string"||typeof B.data>"u"?B.data:String(B.data)},Z);Y[B.index]=F}return Y}}import{HTTPException as Y$}from"hono/http-exception";class r{componentManager;parameterResolver;handlerInvoker;diagnosticsEmitter;debugPipeline;constructor($,_,W,Q=new H,X=!1){this.componentManager=$;this.parameterResolver=_;this.handlerInvoker=W;this.diagnosticsEmitter=Q;this.debugPipeline=X}async execute($){let{controllerClass:_,handlerName:W,handler:Q,handlerParams:X,handlerPipes:Z,contextIndex:U,context:J}=$;J.set(I,_),J.set(M,String(W));let Y=this.componentManager.getHandlerGuards(_,W);for(let q of Y)if(!await q.canActivate(J)){if(this.debugPipeline)this.diagnosticsEmitter.emit({level:"warn",category:"pipeline",message:`Guard rejected request at ${_.name}.${String(W)}`,details:{guard:q.constructor?.name||"UnknownGuard"}});throw new Y$(403,{message:`Forbidden by ${q.constructor?.name||"UnknownGuard"} at ${_.name}.${String(W)}`})}let B=await this.parameterResolver.resolveArguments({controllerName:_.name,handlerName:W,handlerArity:Q.length,handlerParams:X,handlerPipes:Z,context:J});if(this.debugPipeline)this.diagnosticsEmitter.emit({level:"debug",category:"pipeline",message:`Resolved handler arguments for ${_.name}.${String(W)}`,details:{guardCount:Y.length,parameterCount:X.length,pipeCount:Z.length}});return this.handlerInvoker.invoke({handler:Q,args:B,context:J,contextIndex:U})}}class t{hono;container;routeRegistry;componentManager;parameterResolver;pipelineExecutor;metadataRepository;diagnosticsEmitter;globalPrefix;globalVersion;constructor($,_,W,Q,X=new D,Z=new H,U={}){this.hono=$,this.container=_,this.routeRegistry=W,this.componentManager=Q,this.parameterResolver=new o(this.componentManager),this.diagnosticsEmitter=Z,this.pipelineExecutor=new r(this.componentManager,this.parameterResolver,new a,this.diagnosticsEmitter,Boolean(U.debugPipeline)),this.metadataRepository=X,this.globalPrefix=U.prefix!==void 0?this.normalizePath(U.prefix):void 0,this.globalVersion=U.version,this.applyGlobalMiddleware()}applyGlobalMiddleware(){let $=this.componentManager.getGlobalMiddleware();for(let _ of $)this.hono.use("*",_)}normalizePath($){if(!f($))throw Error(`Invalid path: expected a string but received ${typeof $}. Check your @Controller() and route decorator arguments.`);return s($)}registerRouteHandler($,_,W,Q){if(W.length>0)this.hono.on($.toUpperCase(),[_],...W,Q);else this.hono.on($.toUpperCase(),[_],Q)}buildRoutePath($,_,W,Q){return s(`${$}${_}${W}${Q}`)}formatVersionSegment($){if(S($))return"";return $===i?"":`/v${String($)}`}async registerController($){if(!this.metadataRepository.hasController($))throw Error(`Controller ${$.name} is not decorated with @Controller()`);let _=this.metadataRepository.getControllerPath($)||"",W=this.metadataRepository.getControllerOptions($)||{},Q=this.metadataRepository.getRoutes($)||[],X=this.metadataRepository.getParameters($)||new Map,Z=this.metadataRepository.getContextIndices($)||new Map,U=this.normalizePath(_),J=this.container.resolve($),Y=W.prefix!==void 0?W.prefix:this.globalPrefix,B=W.version!==void 0?W.version:this.globalVersion;if(Q.length===0)throw Error(`Controller ${$.name} has no route handlers. Add HTTP method decorators like @Get()`);for(let q of Q){let{path:F,method:A,version:V,prefix:G}=q,O=G!==void 0?G:Y,k=!S(O)?this.normalizePath(O):"",N=V!==void 0?V:B,P=this.normalizePath(F);if(S(N)){this.registerRoute(J,q,X,Z,$,k,"",U,P,A);continue}if(N===i){this.registerRoute(J,q,X,Z,$,k,"",U,P,A),this.registerRoute(J,q,X,Z,$,k,"/:version{v[0-9]+}",U,P,A);continue}if(Array.isArray(N)){for(let b of N){let y=this.formatVersionSegment(b);this.registerRoute(J,q,X,Z,$,k,y,U,P,A)}continue}let v=this.formatVersionSegment(N);this.registerRoute(J,q,X,Z,$,k,v,U,P,A)}}registerRoute($,_,W,Q,X,Z,U,J,Y,B){let{handlerName:q}=_,F=this.buildRoutePath(Z,U,J,Y),A=$[q].bind($),V=W.get(q)||[],G=Q.get(q),O=this.componentManager.getHandlerMiddleware(X,q),k=this.componentManager.getHandlerPipes(X,q);this.routeRegistry.registerRoute({controller:X.name,handler:q,method:B,prefix:Z,version:U,route:J,path:Y,fullPath:F,parameters:V});let N=this.componentManager,P=this.pipelineExecutor,v=async(b)=>{try{return await P.execute({controllerClass:X,handlerName:q,handler:A,handlerParams:V,handlerPipes:k,contextIndex:G,context:b})}catch(y){return N.handleException(y,b)}};this.registerRouteHandler(B,F,O,v)}}class w{hono;container;context;routeRegistry;metadataRepository;componentManager;routeManager;diagnosticsEmitter;options;static DEFAULT_PLUGIN_NAME="AnonymousPlugin";constructor($={},_=new D){this.options=K($)?$:{};let W=this.options.debug===!0||typeof this.options.debug==="object"&&Boolean(this.options.debug.pipeline),Q=this.options.debug===!0||typeof this.options.debug==="object"&&Boolean(this.options.debug.di);if(this.hono=new B$(this.options.hono),this.diagnosticsEmitter=this.options.diagnostics||new g,this.container=this.options.container||new E(void 0,this.diagnosticsEmitter,Q),this.context=new h,this.routeRegistry=new m,this.metadataRepository=_,this.componentManager=new n(this.container,this.metadataRepository,this.diagnosticsEmitter),this.componentManager.setupGlobalComponents(this.options),this.setupErrorHandlers(),this.routeManager=new t(this.hono,this.container,this.routeRegistry,this.componentManager,this.metadataRepository,this.diagnosticsEmitter,{prefix:this.options.routing?.prefix,version:this.options.routing?.version,debugPipeline:W}),this.options.deprecations?.printPreV1Warning)this.diagnosticsEmitter.emit({level:"warn",category:"deprecations",message:"Pre-v1 warning: APIs may change before 1.0.0."})}setupErrorHandlers(){this.hono.notFound(this.options.notFound||p.handle()),this.hono.onError(this.options.onError||c.handle())}resolvePlugin($){if(W$($))return new $;return $}normalizePluginEntry($,_){if($&&typeof $==="object"&&"plugin"in $){let Q=$,X=this.resolvePlugin(Q.plugin),Z=this.resolvePluginName(X,_,Q.name);return{plugin:X,name:Z,before:Q.before??[],after:Q.after??[],provides:X.meta?.provides??[],requires:X.meta?.requires??[],index:_,preProcessors:Q.preProcessors??[],postProcessors:Q.postProcessors??[]}}let W=this.resolvePlugin($);return{plugin:W,name:this.resolvePluginName(W,_),before:[],after:[],provides:W.meta?.provides??[],requires:W.meta?.requires??[],index:_,preProcessors:[],postProcessors:[]}}resolvePluginName($,_,W){let Q=W||$.meta?.name||$.constructor?.name;if(!Q||Q===w.DEFAULT_PLUGIN_NAME)return`${w.DEFAULT_PLUGIN_NAME}#${_+1}`;return Q}resolvePluginExecutionOrder($){if($.length===0)return $;let _=new Map;for(let J=0;J<$.length;J++){let Y=$[J];if(_.has(Y.name))throw Error(`Duplicate plugin name detected: ${Y.name}. Use unique plugin names in options.plugins.`);_.set(Y.name,J)}let W=Array($.length).fill(0),Q=new Map,X=(J,Y)=>{if(!Q.has(J))Q.set(J,new Set);let B=Q.get(J);if(!B.has(Y))B.add(Y),W[Y]++};for(let J=0;J<$.length;J++){let Y=$[J];for(let B of Y.after){let q=_.get(B);if(q===void 0)throw Error(`Plugin ordering error: ${Y.name} declares after '${B}', but no such plugin is registered.`);X(q,J)}for(let B of Y.before){let q=_.get(B);if(q===void 0)throw Error(`Plugin ordering error: ${Y.name} declares before '${B}', but no such plugin is registered.`);X(J,q)}}let Z=[];for(let J=0;J<$.length;J++)if(W[J]===0)Z.push(J);Z.sort((J,Y)=>$[J].index-$[Y].index);let U=[];while(Z.length>0){let J=Z.shift();U.push(J);let Y=Q.get(J);if(!Y)continue;for(let B of Y)if(W[B]--,W[B]===0)Z.push(B);Z.sort((B,q)=>$[B].index-$[q].index)}if(U.length!==$.length)throw Error("Plugin ordering cycle detected. Check before/after constraints in options.plugins.");return U.map((J)=>$[J])}validatePluginCapabilities($){if($.length===0)return;let _=new Set;for(let W of $){for(let Q of W.requires)if(!_.has(Q))throw Error(`Plugin capability error: ${W.name} requires '${Q}', but it was not provided by any previous plugin. Use before/after ordering or register the provider plugin earlier.`);for(let Q of W.provides)_.add(Q)}}shouldEmitRouteDiagnostics(){let $=this.options.debug;return $===!0||typeof $==="object"&&Boolean($.routes)}emitStartupGuide($,_){let W=this.options.startupGuide;if(!W)return;let Q=typeof W==="object"&&Boolean(W.verbose),X=$ instanceof Error?$.message:String($),Z=this.createStartupGuideHints(X);if(this.diagnosticsEmitter.emit({level:"warn",category:"startup",message:"Startup guide",details:{rootModule:_.name,errorMessage:X,hints:Z,verbose:Q}}),Q)this.diagnosticsEmitter.emit({level:"warn",category:"startup",message:"Startup guide (verbose)",details:{steps:["Verify decorators are present for controllers/services used by DI and routing.","Ensure 'reflect-metadata' is imported once at entry and 'emitDecoratorMetadata' is enabled.","Enable debug.startup for extra startup diagnostics and timing details."]}})}createStartupGuideHints($){let _=new Set;if(_.add("Check module wiring: root module imports, controllers, and services should be registered correctly."),$.includes("not decorated with @Controller()"))_.add("Add @Controller() to the class or remove it from module.controllers.");if($.includes("has no route handlers"))_.add("Add at least one HTTP method decorator such as @Get() or @Post() in the controller.");if($.includes("not decorated with @Service()"))_.add("Add @Service() to injectable classes used in constructor dependencies.");if($.includes("constructor metadata is missing")||$.includes("reflect-metadata"))_.add("Import 'reflect-metadata' in your entry file and enable 'emitDecoratorMetadata' in tsconfig.");if($.includes("Strict mode: no routes were registered"))_.add("Disable strict.requireRoutes for empty modules, or add a controller with at least one route.");if($.includes("Plugin ordering error")||$.includes("Plugin capability error"))_.add("Check plugin order and before/after constraints, then ensure required capabilities are provided earlier.");return[..._]}async register($){let _=await this.componentManager.registerModule($),W=this.shouldEmitRouteDiagnostics();for(let Q of _){let X=Date.now(),Z=this.routeRegistry.getRoutes().length;try{if(await this.routeManager.registerController(Q),W)this.diagnosticsEmitter.emit({level:"info",category:"routes",message:"Registered controller routes",details:{controller:Q.name,routeCountAdded:this.routeRegistry.getRoutes().length-Z,registrationDurationMs:Date.now()-X}})}catch(U){if(W)this.diagnosticsEmitter.emit({level:"error",category:"routes",message:"Failed to register controller routes",details:{controller:Q.name,registrationDurationMs:Date.now()-X,errorMessage:U instanceof Error?U.message:String(U)}});throw U}}return this}static async create($,_={}){let W=Date.now(),Q=C.fromRootModule($),X=new w(_,Q),Z=(_.plugins||[]).map((V,G)=>X.normalizePluginEntry(V,G)),U=X.resolvePluginExecutionOrder(Z);X.validatePluginCapabilities(U);let J=X.getContext(),Y=_.debug,B=Y===!0||typeof Y==="object"&&Y.plugins,q=Y===!0||typeof Y==="object"&&Y.routes,F=Y===!0||typeof Y==="object"&&(Y.startup||q),A=!1;try{if(B&&U.length>0)X.diagnosticsEmitter.emit({level:"info",category:"plugins",message:`Plugin order: ${U.map(({name:G})=>G).join(" -> ")}`});for(let{plugin:G,preProcessors:O}of U){for(let k of O)await k(X,X.hono,J);if(G.beforeModulesRegistered)await G.beforeModulesRegistered(X,X.hono)}await X.register($);let V=X.getRoutes();if(F)X.diagnosticsEmitter.emit({level:"info",category:"startup",message:`Application registered ${V.length} route(s)`,details:{routeCount:V.length,rootModule:$.name}});if(_.strict?.requireRoutes&&V.length===0){A=!0,X.diagnosticsEmitter.emit({level:"error",category:"startup",message:"Strict mode failed: no routes were registered",details:{rootModule:$.name,requireRoutes:!0,startupDurationMs:Date.now()-W}});let G=Error("Strict mode: no routes were registered. Check your module/controller decorators.");throw X.emitStartupGuide(G,$),G}if(q)X.diagnosticsEmitter.emit({level:"info",category:"routes",message:"Registered routes",details:{routes:V.map((G)=>`${G.method.toUpperCase()} ${G.fullPath}`)}});for(let{plugin:G,postProcessors:O}of U){if(G.afterModulesRegistered)await G.afterModulesRegistered(X,X.hono);for(let k of O)await k(X,X.hono,J)}if(F)X.diagnosticsEmitter.emit({level:"info",category:"startup",message:"Application startup completed",details:{rootModule:$.name,pluginCount:U.length,routeCount:V.length,startupDurationMs:Date.now()-W}});return{app:X,hono:X.getApp()}}catch(V){if(X.emitStartupGuide(V,$),F&&!A)X.diagnosticsEmitter.emit({level:"error",category:"startup",message:"Application startup failed",details:{rootModule:$.name,startupDurationMs:Date.now()-W,errorMessage:V instanceof Error?V.message:String(V)}});throw V}}getApp(){return this.hono}getContainer(){return this.container}getContext(){return this.context}getRoutes(){return this.routeRegistry.getRoutes()}}import{html as j,raw as e}from"hono/html";var L$={type:"website",locale:"en_US"},$$=($)=>{if(!$)return"";return Object.entries($).map(([_,W])=>{if(typeof W==="boolean")return W?_:"";let Q=String(W).replace(/"/g,"&quot;");return`${_}="${Q}"`}).filter(Boolean).join(" ")},r_=($)=>{let _={...L$,...$};return j`
+import"reflect-metadata";import{Hono as B$}from"hono";class h{store=new Map;get($){return this.store.get($)}set($,_){this.store.set($,_)}has($){return this.store.has($)}delete($){return this.store.delete($)}keys(){return this.store.keys()}}class g{emit($){let _=`[HonestJS:${$.category}]`,W=$.details?[_,$.message,$.details]:[_,$.message];switch($.level){case"debug":case"info":console.info(...W);break;case"warn":console.warn(...W);break;case"error":console.error(...W);break}}}class D{emit($){}}class q{static routes=new Map;static controllers=new Map;static controllerOptions=new Map;static services=new Set;static modules=new Map;static parameters=new Map;static contextIndices=new Map;static controller=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);static handler=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);static getRoutes($){return this.routes.get($)||[]}static setRoutes($,_){this.routes.set($,_)}static addRoute($,_){if(!this.routes.has($))this.routes.set($,[]);this.routes.get($).push(_)}static getControllerPath($){return this.controllers.get($)||""}static hasController($){return this.controllers.has($)}static setControllerPath($,_){this.controllers.set($,_)}static getControllerOptions($){return this.controllerOptions.get($)||{}}static setControllerOptions($,_){this.controllerOptions.set($,_)}static isService($){return this.services.has($)}static addService($){this.services.add($)}static getAllServices(){return this.services}static getModuleOptions($){return this.modules.get($)}static setModuleOptions($,_){this.modules.set($,_)}static getParameters($){return this.parameters.get($)||new Map}static setParameterMap($,_){this.parameters.set($,_)}static getContextIndices($){return this.contextIndices.get($)||new Map}static setContextIndices($,_){this.contextIndices.set($,_)}static registerController($,_,W){let Q=this.controller.get($);if(!Q.has(_))Q.set(_,[]);Q.get(_).push(W)}static getController($,_){return this.controller.get($).get(_)||[]}static registerHandler($,_,W){let Q=this.handler.get($);if(!Q.has(_))Q.set(_,[]);Q.get(_).push(W)}static getHandler($,_){return this.handler.get($).get(_)||[]}static clearHandlerComponents(){for(let $ of this.handler.values())$.clear()}static clear(){this.routes.clear(),this.controllers.clear(),this.controllerOptions.clear(),this.services.clear(),this.modules.clear(),this.parameters.clear(),this.contextIndices.clear();for(let $ of this.controller.values())$.clear();for(let $ of this.handler.values())$.clear()}}class O{hasController($){return q.hasController($)}getControllerPath($){return q.getControllerPath($)}getControllerOptions($){return q.getControllerOptions($)}getRoutes($){return q.getRoutes($)}getParameters($){return q.getParameters($)}getContextIndices($){return q.getContextIndices($)}getModuleOptions($){return q.getModuleOptions($)}getControllerComponents($,_){return q.getController($,_)}getHandlerComponents($,_){return q.getHandler($,_)}}class C{controllerPaths=new Map;controllerOptions=new Map;routes=new Map;parameters=new Map;contextIndices=new Map;modules=new Map;controllerComponents=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);handlerComponents=new Map([["middleware",new Map],["guard",new Map],["pipe",new Map],["filter",new Map]]);static fromRootModule($,_=new O){let W=new C;return W.captureModuleGraph($,_),W}hasController($){return this.controllerPaths.has($)}getControllerPath($){return this.controllerPaths.get($)||""}getControllerOptions($){let _=this.controllerOptions.get($);return _?{..._}:{}}getRoutes($){return(this.routes.get($)||[]).map((_)=>this.cloneRouteDefinition(_))}getParameters($){let _=this.parameters.get($);if(!_)return new Map;let W=new Map;for(let[Q,X]of _.entries())W.set(Q,X.map((Z)=>({...Z})));return W}getContextIndices($){return new Map(this.contextIndices.get($)||new Map)}getModuleOptions($){let _=this.modules.get($);if(!_)return;return{controllers:_.controllers?[..._.controllers]:void 0,services:_.services?[..._.services]:void 0,imports:_.imports?[..._.imports]:void 0}}getControllerComponents($,_){return[...this.controllerComponents.get($).get(_)||[]]}getHandlerComponents($,_){return[...this.handlerComponents.get($).get(_)||[]]}captureModuleGraph($,_){let W=new Set,Q=new Set,X=(Z)=>{if(W.has(Z))return;W.add(Z);let U=_.getModuleOptions(Z);if(!U)return;let J={controllers:U.controllers?[...U.controllers]:void 0,services:U.services?[...U.services]:void 0,imports:U.imports?[...U.imports]:void 0};this.modules.set(Z,J);for(let Y of J.controllers||[])Q.add(Y);for(let Y of J.imports||[])X(Y)};X($);for(let Z of Q)this.captureController(Z,_)}captureController($,_){if(!_.hasController($))return;this.controllerPaths.set($,_.getControllerPath($)||""),this.controllerOptions.set($,{..._.getControllerOptions($)});let W=(_.getRoutes($)||[]).map((Z)=>this.cloneRouteDefinition(Z));this.routes.set($,W);let Q=_.getParameters($),X=new Map;for(let[Z,U]of Q.entries())X.set(Z,(U||[]).map((J)=>({...J})));this.parameters.set($,X),this.contextIndices.set($,new Map(_.getContextIndices($)||new Map));for(let Z of["middleware","guard","pipe","filter"])this.controllerComponents.get(Z).set($,[..._.getControllerComponents(Z,$)||[]]);for(let Z of W){let U=`${$.name}:${String(Z.handlerName)}`;for(let J of["middleware","guard","pipe","filter"])this.handlerComponents.get(J).set(U,[..._.getHandlerComponents(J,U)||[]])}}cloneRouteDefinition($){return{...$,version:Array.isArray($.version)?[...$.version]:$.version}}}class m{routes=[];registerRoute($){if(!$)throw Error("Route info is required");if(!$.controller)throw Error("Route controller is required");if(!$.handler)throw Error("Route handler is required");if(!$.method)throw Error("Route method is required");if(!$.fullPath)throw Error("Route fullPath is required");if(this.routes.some((W)=>W.fullPath===$.fullPath&&W.method.toUpperCase()===$.method.toUpperCase()))throw Error(`Duplicate route detected: ${$.method.toUpperCase()} ${$.fullPath} (${String($.controller)}.${String($.handler)})`);this.routes.push($)}getRoutes(){return this.routes}getRoutesByController($){return this.routes.filter((_)=>_.controller===$)}getRoutesByMethod($){return this.routes.filter((_)=>_.method.toUpperCase()===$.toUpperCase())}getRoutesByPath($){return this.routes.filter((_)=>$.test(_.fullPath))}clear(){this.routes.length=0}}class u{isService($){return q.isService($)}}class E{serviceRegistry;logger;debugDi;constructor($=new u,_=new D,W=!1){this.serviceRegistry=$;this.logger=_;this.debugDi=W}instances=new Map;emitLog($){if(!this.debugDi)return;this.logger.emit($)}resolve($){return this.resolveWithTracking($,new Set)}resolveWithTracking($,_){if(this.instances.has($))return this.emitLog({level:"debug",category:"di",message:`Resolved ${$.name} from DI cache`}),this.instances.get($);if(_.has($)){let Z=[..._.keys(),$].map((U)=>U.name).join(" -> ");throw this.emitLog({level:"error",category:"di",message:`Circular dependency detected while resolving ${$.name}`,details:{cycle:Z}}),Error(`Circular dependency detected: ${Z}`)}_.add($),this.emitLog({level:"debug",category:"di",message:`Resolving ${$.name}`,details:{resolving:[..._].map((Z)=>Z.name)}});let W=Reflect.getMetadata("design:paramtypes",$)||[];if($.length>0&&W.length===0){if(!this.serviceRegistry.isService($))throw this.emitLog({level:"error",category:"di",message:`Cannot resolve ${$.name}: missing @Service() decorator`}),Error(`Cannot resolve ${$.name}: it is not decorated with @Service(). Did you forget to add @Service() to the class?`);throw this.emitLog({level:"error",category:"di",message:`Cannot resolve ${$.name}: missing constructor metadata`}),Error(`Cannot resolve dependencies for ${$.name}: constructor metadata is missing. Ensure 'reflect-metadata' is imported and 'emitDecoratorMetadata' is enabled.`)}let Q=W.map((Z,U)=>{if(!Z||Z===Object||Z===Array||Z===Function)throw this.emitLog({level:"error",category:"di",message:`Cannot resolve dependency at index ${U} of ${$.name}`}),Error(`Cannot resolve dependency at index ${U} of ${$.name}. Use concrete class types for constructor dependencies.`);return this.resolveWithTracking(Z,new Set(_))}),X=new $(...Q);return this.instances.set($,X),this.emitLog({level:"debug",category:"di",message:`Created ${$.name} instance`,details:{dependencyCount:Q.length}}),X}register($,_){this.instances.set($,_)}has($){return this.instances.has($)}clear(){this.instances.clear()}}import{HTTPException as U$}from"hono/http-exception";class d extends Error{status;code;category;remediation;details;constructor($,_){super($);if(this.name="FrameworkError",this.status=_.status,this.code=_.code,this.category=_.category,this.remediation=_.remediation,this.details=_.details,_.cause!==void 0)this.cause=_.cause}}function R($,_,W){let Q=$ instanceof Error?$:Error(String($)),X=new Date().toISOString(),Z=_.get("requestId"),U=_.req.path;if(Q instanceof U$)return{response:{status:W?.status||Q.status,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:W?.status||Q.status};if(Q instanceof d){let B=W?.status||Q.status||500;return{response:{status:B,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code||Q.code,details:{category:Q.category,remediation:Q.remediation,...Q.details,...W?.additionalDetails},...W?.detail&&{detail:W.detail}},status:B}}if(Q.statusCode||Q.status){let B=Q.statusCode||Q.status||500,G=W?.status||B;return{response:{status:G,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code||Q.name,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:G}}let J=W?.status||500;return{response:{status:J,message:W?.title||Q.message,timestamp:X,path:U,requestId:Z,code:W?.code||Q.name,details:W?.additionalDetails||{stack:Q.stack},...W?.detail&&{detail:W.detail}},status:J}}function T($){return(_="",W={})=>{return(Q,X,Z)=>{let U=Q.constructor;q.addRoute(U,{path:_,method:$,handlerName:X,version:W.version,prefix:W.prefix})}}}function z($,_){let W=(Q,X)=>{if(Q===void 0)return X;return X.get(String(Q))};return(Q)=>{return(X,Z,U)=>{let J=X.constructor;if(!q.getParameters(J).size)q.setParameterMap(J,new Map);let Y=q.getParameters(J);if(!Y.has(Z))Y.set(Z,[]);let G=Reflect.getMetadata("design:paramtypes",X,Z)?.[U];if(Y.get(Z).push({index:U,name:$,data:Q,factory:_||W,metatype:G}),$==="context"){if(!q.getContextIndices(J).size)q.setContextIndices(J,new Map);q.getContextIndices(J).set(Z,U)}}}}class c{static handle(){return async($,_)=>{let{response:W,status:Q}=R($,_);return _.json(W,Q)}}}class p{static handle(){return async($)=>{return $.json({message:`Not Found - ${$.req.path}`},404)}}}var i=Symbol("VERSION_NEUTRAL");var I="__honest_controllerClass",M="__honest_handlerName",l="__honest.body.cache";var X_=($)=>typeof $>"u",w=($)=>$===null||typeof $>"u",K=($)=>$!==null&&typeof $==="object",Z_=($)=>{if(!K($))return!1;let _=Object.getPrototypeOf($);if(_===null)return!0;let W=Object.prototype.hasOwnProperty.call(_,"constructor")&&_.constructor;return typeof W==="function"&&W instanceof W&&Function.prototype.toString.call(W)===Function.prototype.toString.call(Object)},_$=($)=>typeof $==="function",f=($)=>typeof $==="string",J_=($)=>typeof $==="number",U_=($)=>$.length===0,Y_=($)=>typeof $==="symbol",B_=($)=>typeof $==="string"?$.charAt(0)!=="/"?"/"+$:$:"",s=($)=>$?$.startsWith("/")?("/"+$.replace(/\/+$/,"")).replace(/\/+/g,"/"):"/"+$.replace(/\/+$/,""):"/",q_=($)=>$.endsWith("/")?$.slice(0,-1):$,W$=($)=>{return _$($)&&!w($.prototype)&&!_$($.prototype)&&Object.getOwnPropertyNames($.prototype).length>=1};class n{container;metadataRepository;logger;globalComponents=new Map([["middleware",new Set],["guard",new Set],["pipe",new Set],["filter",new Set]]);constructor($,_=new O,W=new D){this.container=$;this.metadataRepository=_;this.logger=W}setupGlobalComponents($){let _=$.components||{};if(_.middleware)this.registerGlobal("middleware",..._.middleware);if(_.guards)this.registerGlobal("guard",..._.guards);if(_.pipes)this.registerGlobal("pipe",..._.pipes);if(_.filters)this.registerGlobal("filter",..._.filters)}registerGlobal($,..._){_.forEach((W)=>{this.globalComponents.get($).add(W)})}getGlobal($){return this.globalComponents.get($)}getComponents($,_,W){let Q=`${_.name}:${String(W)}`,X=this.metadataRepository.getHandlerComponents($,Q),Z=this.metadataRepository.getControllerComponents($,_);return[...Array.from(this.globalComponents.get($)||[]),...Z,...X]}resolveMiddleware($){return $.map((_)=>{if(K(_)&&"use"in _)return _.use.bind(_);let W=this.container.resolve(_);return W.use.bind(W)})}getHandlerMiddleware($,_){let W=this.getComponents("middleware",$,_);return this.resolveMiddleware(W)}getGlobalMiddleware(){let $=Array.from(this.globalComponents.get("middleware")||[]);return this.resolveMiddleware($)}resolveGuards($){return $.map((_)=>{if(K(_)&&"canActivate"in _)return _;return this.container.resolve(_)})}getHandlerGuards($,_){let W=this.getComponents("guard",$,_);return this.resolveGuards(W)}resolvePipes($){return $.map((_)=>{if(K(_)&&"transform"in _)return _;return this.container.resolve(_)})}getHandlerPipes($,_){let W=this.getComponents("pipe",$,_);return this.resolvePipes(W)}async executePipes($,_,W){let Q=$;for(let X of W)Q=await X.transform(Q,_);return Q}async handleException($,_){let W=_.get(I),Q=_.get(M);if(W&&Q){let J=this.metadataRepository.getHandlerComponents("filter",`${W.name}:${Q}`);if(J.length>0){let Y=await this.executeFilters(J,$,_);if(Y)return Y}}if(W){let J=this.metadataRepository.getControllerComponents("filter",W);if(J.length>0){let Y=await this.executeFilters(J,$,_);if(Y)return Y}}let X=Array.from(this.globalComponents.get("filter")||[]);if(X.length>0){let J=await this.executeFilters(X,$,_);if(J)return J}let{response:Z,status:U}=R($,_);return _.json(Z,U)}async executeFilters($,_,W){for(let Q of $){let X;if(K(Q)&&"catch"in Q)X=Q;else X=this.container.resolve(Q);try{let Z=await X.catch(_,W);if(Z!==void 0)return Z}catch(Z){let U=X.constructor?.name||"UnknownFilter";this.logger.emit({level:"error",category:"errors",message:`Error in exception filter ${U}`,details:{error:Z instanceof Error?Z.message:String(Z)}});let{response:J,status:Y}=R(Z,W);return W.json(J,Y)}}return}async registerModule($,_=new Set){if(_.has($))return[];_.add($);let W=this.metadataRepository.getModuleOptions($);if(!W)throw this.logger.emit({level:"error",category:"startup",message:`Module ${$.name} is not properly decorated with @Module()`}),Error(`Module ${$.name} is not properly decorated with @Module()`);let Q=[];if(W.imports&&W.imports.length>0)for(let X of W.imports){let Z=await this.registerModule(X,_);Q.push(...Z)}if(W.services&&W.services.length>0)for(let X of W.services)this.container.resolve(X);if(W.controllers&&W.controllers.length>0)Q.push(...W.controllers);return Q}}class a{async invoke({handler:$,args:_,context:W,contextIndex:Q}){let X=await $(..._);if(Q!==void 0)return X;if(X instanceof Response)return X;if(w(X))return W.json(null);if(f(X))return W.text(X);return W.json(X)}}class o{componentManager;constructor($){this.componentManager=$}async resolveArguments($){let{controllerName:_,handlerName:W,handlerArity:Q,handlerParams:X,handlerPipes:Z,context:U}=$,J=X.length>0?Math.max(...X.map((B)=>B.index)):-1,Y=Array(Math.max(Q,J+1));for(let B of X){if(typeof B.factory!=="function")throw Error(`Invalid parameter decorator metadata for ${_}.${String(W)}`);let G=await B.factory(B.data,U),L=await this.componentManager.executePipes(G,{type:B.name,metatype:B.metatype,data:typeof B.data==="string"||typeof B.data>"u"?B.data:String(B.data)},Z);Y[B.index]=L}return Y}}import{HTTPException as Y$}from"hono/http-exception";class r{componentManager;parameterResolver;handlerInvoker;logger;debugPipeline;constructor($,_,W,Q=new D,X=!1){this.componentManager=$;this.parameterResolver=_;this.handlerInvoker=W;this.logger=Q;this.debugPipeline=X}async execute($){let{controllerClass:_,handlerName:W,handler:Q,handlerParams:X,handlerPipes:Z,contextIndex:U,context:J}=$;J.set(I,_),J.set(M,String(W));let Y=this.componentManager.getHandlerGuards(_,W);for(let G of Y)if(!await G.canActivate(J)){if(this.debugPipeline)this.logger.emit({level:"warn",category:"pipeline",message:`Guard rejected request at ${_.name}.${String(W)}`,details:{guard:G.constructor?.name||"UnknownGuard"}});throw new Y$(403,{message:`Forbidden by ${G.constructor?.name||"UnknownGuard"} at ${_.name}.${String(W)}`})}let B=await this.parameterResolver.resolveArguments({controllerName:_.name,handlerName:W,handlerArity:Q.length,handlerParams:X,handlerPipes:Z,context:J});if(this.debugPipeline)this.logger.emit({level:"debug",category:"pipeline",message:`Resolved handler arguments for ${_.name}.${String(W)}`,details:{guardCount:Y.length,parameterCount:X.length,pipeCount:Z.length}});return this.handlerInvoker.invoke({handler:Q,args:B,context:J,contextIndex:U})}}class t{hono;container;routeRegistry;componentManager;parameterResolver;pipelineExecutor;metadataRepository;logger;globalPrefix;globalVersion;constructor($,_,W,Q,X=new O,Z=new D,U={}){this.hono=$,this.container=_,this.routeRegistry=W,this.componentManager=Q,this.parameterResolver=new o(this.componentManager),this.logger=Z,this.pipelineExecutor=new r(this.componentManager,this.parameterResolver,new a,this.logger,Boolean(U.debugPipeline)),this.metadataRepository=X,this.globalPrefix=U.prefix!==void 0?this.normalizePath(U.prefix):void 0,this.globalVersion=U.version,this.applyGlobalMiddleware()}applyGlobalMiddleware(){let $=this.componentManager.getGlobalMiddleware();for(let _ of $)this.hono.use("*",_)}normalizePath($){if(!f($))throw Error(`Invalid path: expected a string but received ${typeof $}. Check your @Controller() and route decorator arguments.`);return s($)}registerRouteHandler($,_,W,Q){if(W.length>0)this.hono.on($.toUpperCase(),[_],...W,Q);else this.hono.on($.toUpperCase(),[_],Q)}buildRoutePath($,_,W,Q){return s(`${$}${_}${W}${Q}`)}formatVersionSegment($){if(w($))return"";return $===i?"":`/v${String($)}`}async registerController($){if(!this.metadataRepository.hasController($))throw Error(`Controller ${$.name} is not decorated with @Controller()`);let _=this.metadataRepository.getControllerPath($)||"",W=this.metadataRepository.getControllerOptions($)||{},Q=this.metadataRepository.getRoutes($)||[],X=this.metadataRepository.getParameters($)||new Map,Z=this.metadataRepository.getContextIndices($)||new Map,U=this.normalizePath(_),J=this.container.resolve($),Y=W.prefix!==void 0?W.prefix:this.globalPrefix,B=W.version!==void 0?W.version:this.globalVersion;if(Q.length===0)throw Error(`Controller ${$.name} has no route handlers. Add HTTP method decorators like @Get()`);for(let G of Q){let{path:L,method:A,version:j,prefix:V}=G,H=V!==void 0?V:Y,k=!w(H)?this.normalizePath(H):"",N=j!==void 0?j:B,P=this.normalizePath(L);if(w(N)){this.registerRoute(J,G,X,Z,$,k,"",U,P,A);continue}if(N===i){this.registerRoute(J,G,X,Z,$,k,"",U,P,A),this.registerRoute(J,G,X,Z,$,k,"/:version{v[0-9]+}",U,P,A);continue}if(Array.isArray(N)){for(let b of N){let y=this.formatVersionSegment(b);this.registerRoute(J,G,X,Z,$,k,y,U,P,A)}continue}let v=this.formatVersionSegment(N);this.registerRoute(J,G,X,Z,$,k,v,U,P,A)}}registerRoute($,_,W,Q,X,Z,U,J,Y,B){let{handlerName:G}=_,L=this.buildRoutePath(Z,U,J,Y),A=$[G].bind($),j=W.get(G)||[],V=Q.get(G),H=this.componentManager.getHandlerMiddleware(X,G),k=this.componentManager.getHandlerPipes(X,G);this.routeRegistry.registerRoute({controller:X.name,handler:G,method:B,prefix:Z,version:U,route:J,path:Y,fullPath:L,parameters:j});let N=this.componentManager,P=this.pipelineExecutor,v=async(b)=>{try{return await P.execute({controllerClass:X,handlerName:G,handler:A,handlerParams:j,handlerPipes:k,contextIndex:V,context:b})}catch(y){return N.handleException(y,b)}};this.registerRouteHandler(B,L,H,v)}}class S{hono;container;context;routeRegistry;metadataRepository;componentManager;routeManager;logger;options;static DEFAULT_PLUGIN_NAME="AnonymousPlugin";constructor($={},_=new O){this.options=K($)?$:{};let W=this.options.debug===!0||typeof this.options.debug==="object"&&Boolean(this.options.debug.pipeline),Q=this.options.debug===!0||typeof this.options.debug==="object"&&Boolean(this.options.debug.di);if(this.hono=new B$(this.options.hono),this.logger=this.options.logger||new g,this.container=this.options.container||new E(void 0,this.logger,Q),this.context=new h,this.routeRegistry=new m,this.metadataRepository=_,this.componentManager=new n(this.container,this.metadataRepository,this.logger),this.componentManager.setupGlobalComponents(this.options),this.setupErrorHandlers(),this.routeManager=new t(this.hono,this.container,this.routeRegistry,this.componentManager,this.metadataRepository,this.logger,{prefix:this.options.routing?.prefix,version:this.options.routing?.version,debugPipeline:W}),this.options.deprecations?.printPreV1Warning)this.logger.emit({level:"warn",category:"deprecations",message:"Pre-v1 warning: APIs may change before 1.0.0."})}setupErrorHandlers(){this.hono.notFound(this.options.notFound||p.handle()),this.hono.onError(this.options.onError||c.handle())}resolvePlugin($){if(W$($))return new $;return $}normalizePluginEntry($,_){if($&&typeof $==="object"&&"plugin"in $){let Q=$,X=this.resolvePlugin(Q.plugin),Z=this.resolvePluginName(X,_,Q.name);return{plugin:X,name:Z,before:Q.before??[],after:Q.after??[],provides:X.meta?.provides??[],requires:X.meta?.requires??[],index:_,preProcessors:Q.preProcessors??[],postProcessors:Q.postProcessors??[]}}let W=this.resolvePlugin($);return{plugin:W,name:this.resolvePluginName(W,_),before:[],after:[],provides:W.meta?.provides??[],requires:W.meta?.requires??[],index:_,preProcessors:[],postProcessors:[]}}resolvePluginName($,_,W){let Q=W||$.meta?.name||$.constructor?.name;if(!Q||Q===S.DEFAULT_PLUGIN_NAME)return`${S.DEFAULT_PLUGIN_NAME}#${_+1}`;return Q}resolvePluginExecutionOrder($){if($.length===0)return $;let _=new Map;for(let J=0;J<$.length;J++){let Y=$[J];if(_.has(Y.name))throw Error(`Duplicate plugin name detected: ${Y.name}. Use unique plugin names in options.plugins.`);_.set(Y.name,J)}let W=Array($.length).fill(0),Q=new Map,X=(J,Y)=>{if(!Q.has(J))Q.set(J,new Set);let B=Q.get(J);if(!B.has(Y))B.add(Y),W[Y]++};for(let J=0;J<$.length;J++){let Y=$[J];for(let B of Y.after){let G=_.get(B);if(G===void 0)throw Error(`Plugin ordering error: ${Y.name} declares after '${B}', but no such plugin is registered.`);X(G,J)}for(let B of Y.before){let G=_.get(B);if(G===void 0)throw Error(`Plugin ordering error: ${Y.name} declares before '${B}', but no such plugin is registered.`);X(J,G)}}let Z=[];for(let J=0;J<$.length;J++)if(W[J]===0)Z.push(J);Z.sort((J,Y)=>$[J].index-$[Y].index);let U=[];while(Z.length>0){let J=Z.shift();U.push(J);let Y=Q.get(J);if(!Y)continue;for(let B of Y)if(W[B]--,W[B]===0)Z.push(B);Z.sort((B,G)=>$[B].index-$[G].index)}if(U.length!==$.length)throw Error("Plugin ordering cycle detected. Check before/after constraints in options.plugins.");return U.map((J)=>$[J])}validatePluginCapabilities($){if($.length===0)return;let _=new Set;for(let W of $){for(let Q of W.requires)if(!_.has(Q))throw Error(`Plugin capability error: ${W.name} requires '${Q}', but it was not provided by any previous plugin. Use before/after ordering or register the provider plugin earlier.`);for(let Q of W.provides)_.add(Q)}}shouldEmitRouteDiagnostics(){let $=this.options.debug;return $===!0||typeof $==="object"&&Boolean($.routes)}emitStartupGuide($,_){let W=this.options.startupGuide;if(!W)return;let Q=typeof W==="object"&&Boolean(W.verbose),X=$ instanceof Error?$.message:String($),Z=this.createStartupGuideHints(X);if(this.logger.emit({level:"warn",category:"startup",message:"Startup guide",details:{rootModule:_.name,errorMessage:X,hints:Z,verbose:Q}}),Q)this.logger.emit({level:"warn",category:"startup",message:"Startup guide (verbose)",details:{steps:["Verify decorators are present for controllers/services used by DI and routing.","Ensure 'reflect-metadata' is imported once at entry and 'emitDecoratorMetadata' is enabled.","Enable debug.startup for extra startup diagnostics and timing details."]}})}createStartupGuideHints($){let _=new Set;if(_.add("Check module wiring: root module imports, controllers, and services should be registered correctly."),$.includes("not decorated with @Controller()"))_.add("Add @Controller() to the class or remove it from module.controllers.");if($.includes("has no route handlers"))_.add("Add at least one HTTP method decorator such as @Get() or @Post() in the controller.");if($.includes("not decorated with @Service()"))_.add("Add @Service() to injectable classes used in constructor dependencies.");if($.includes("constructor metadata is missing")||$.includes("reflect-metadata"))_.add("Import 'reflect-metadata' in your entry file and enable 'emitDecoratorMetadata' in tsconfig.");if($.includes("Strict mode: no routes were registered"))_.add("Disable strict.requireRoutes for empty modules, or add a controller with at least one route.");if($.includes("Plugin ordering error")||$.includes("Plugin capability error"))_.add("Check plugin order and before/after constraints, then ensure required capabilities are provided earlier.");return[..._]}async register($){let _=await this.componentManager.registerModule($),W=this.shouldEmitRouteDiagnostics();for(let Q of _){let X=Date.now(),Z=this.routeRegistry.getRoutes().length;try{if(await this.routeManager.registerController(Q),W)this.logger.emit({level:"info",category:"routes",message:"Registered controller routes",details:{controller:Q.name,routeCountAdded:this.routeRegistry.getRoutes().length-Z,registrationDurationMs:Date.now()-X}})}catch(U){if(W)this.logger.emit({level:"error",category:"routes",message:"Failed to register controller routes",details:{controller:Q.name,registrationDurationMs:Date.now()-X,errorMessage:U instanceof Error?U.message:String(U)}});throw U}}return this}static async create($,_={}){let W=Date.now(),Q=C.fromRootModule($),X=new S(_,Q),Z=(_.plugins||[]).map((j,V)=>X.normalizePluginEntry(j,V)),U=X.resolvePluginExecutionOrder(Z);X.validatePluginCapabilities(U);let J=X.getContext(),Y=_.debug,B=Y===!0||typeof Y==="object"&&Y.plugins,G=Y===!0||typeof Y==="object"&&Y.routes,L=Y===!0||typeof Y==="object"&&(Y.startup||G),A=!1;try{if(B&&U.length>0)X.logger.emit({level:"info",category:"plugins",message:`Plugin order: ${U.map(({name:V})=>V).join(" -> ")}`});for(let{plugin:V,preProcessors:H}of U){V.logger=X.logger;for(let k of H)await k(X,X.hono,J);if(V.beforeModulesRegistered)await V.beforeModulesRegistered(X,X.hono)}await X.register($);let j=X.getRoutes();if(L)X.logger.emit({level:"info",category:"startup",message:`Application registered ${j.length} route(s)`,details:{routeCount:j.length,rootModule:$.name}});if(_.strict?.requireRoutes&&j.length===0){A=!0,X.logger.emit({level:"error",category:"startup",message:"Strict mode failed: no routes were registered",details:{rootModule:$.name,requireRoutes:!0,startupDurationMs:Date.now()-W}});let V=Error("Strict mode: no routes were registered. Check your module/controller decorators.");throw X.emitStartupGuide(V,$),V}if(G)X.logger.emit({level:"info",category:"routes",message:"Registered routes",details:{routes:j.map((V)=>`${V.method.toUpperCase()} ${V.fullPath}`)}});for(let{plugin:V,postProcessors:H}of U){if(V.afterModulesRegistered)await V.afterModulesRegistered(X,X.hono);for(let k of H)await k(X,X.hono,J)}if(L)X.logger.emit({level:"info",category:"startup",message:"Application startup completed",details:{rootModule:$.name,pluginCount:U.length,routeCount:j.length,startupDurationMs:Date.now()-W}});return{app:X,hono:X.getApp()}}catch(j){if(X.emitStartupGuide(j,$),L&&!A)X.logger.emit({level:"error",category:"startup",message:"Application startup failed",details:{rootModule:$.name,startupDurationMs:Date.now()-W,errorMessage:j instanceof Error?j.message:String(j)}});throw j}}getApp(){return this.hono}getContainer(){return this.container}getContext(){return this.context}getRoutes(){return this.routeRegistry.getRoutes()}}import{html as F,raw as e}from"hono/html";var q$={type:"website",locale:"en_US"},$$=($)=>{if(!$)return"";return Object.entries($).map(([_,W])=>{if(typeof W==="boolean")return W?_:"";let Q=String(W).replace(/"/g,"&quot;");return`${_}="${Q}"`}).filter(Boolean).join(" ")},r_=($)=>{let _={...q$,...$};return F`
 		<!DOCTYPE html>
 		<html lang="${_.locale?.split("_")[0]||"en"}" ${e($$(_.htmlAttributes))}>
 			<head ${e($$(_.headAttributes))}>
 				<meta charset="UTF-8" />
 				<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-				${_.csp?j`<meta http-equiv="Content-Security-Policy" content="${_.csp}" />`:""}
+				${_.csp?F`<meta http-equiv="Content-Security-Policy" content="${_.csp}" />`:""}
 				<title>${_.title}</title>
-				${_.description?j`<meta name="description" content="${_.description}" />`:""}
+				${_.description?F`<meta name="description" content="${_.description}" />`:""}
 
 				<!-- Open Graph / Facebook -->
 				<meta prefix="og: http://ogp.me/ns#" />
 				<meta property="og:title" content="${_.title}" />
-				${_.description?j`<meta property="og:description" content="${_.description}" />`:""}
-				${_.image?j`<meta property="og:image" content="${_.image}" />`:""}
-				${_.url?j`<meta property="og:url" content="${_.url}" />`:""}
-				${_.locale?j`<meta property="og:locale" content="${_.locale}" />`:""}
-				${_.type?j`<meta property="og:type" content="${_.type}" />`:""}
-				${_.siteName?j`<meta property="og:site_name" content="${_.siteName}" />`:""}
+				${_.description?F`<meta property="og:description" content="${_.description}" />`:""}
+				${_.image?F`<meta property="og:image" content="${_.image}" />`:""}
+				${_.url?F`<meta property="og:url" content="${_.url}" />`:""}
+				${_.locale?F`<meta property="og:locale" content="${_.locale}" />`:""}
+				${_.type?F`<meta property="og:type" content="${_.type}" />`:""}
+				${_.siteName?F`<meta property="og:site_name" content="${_.siteName}" />`:""}
 
 				<!-- Twitter -->
 				<meta
@@ -24,23 +24,23 @@ import"reflect-metadata";import{Hono as B$}from"hono";class h{store=new Map;get(
 					content="${_.twitterCard||(_.image?"summary_large_image":"summary")}"
 				/>
 				<meta name="twitter:title" content="${_.title}" />
-				${_.description?j`<meta name="twitter:description" content="${_.description}" />`:""}
-				${_.image?j`<meta name="twitter:image" content="${_.image}" />`:""}
+				${_.description?F`<meta name="twitter:description" content="${_.description}" />`:""}
+				${_.image?F`<meta name="twitter:image" content="${_.image}" />`:""}
 
 				<!-- Custom Meta Tags -->
-				${_.customMeta?_.customMeta.map((W)=>{let Q=W.name?`name="${W.name}"`:"",X=W.property?`property="${W.property}"`:"";return j`<meta ${Q} ${X} content="${W.content}" />`}):""}
+				${_.customMeta?_.customMeta.map((W)=>{let Q=W.name?`name="${W.name}"`:"",X=W.property?`property="${W.property}"`:"";return F`<meta ${Q} ${X} content="${W.content}" />`}):""}
 
 				<!-- Favicon -->
-				${_.favicon?j`<link rel="icon" href="${_.favicon}" />`:""}
+				${_.favicon?F`<link rel="icon" href="${_.favicon}" />`:""}
 
 				<!-- Stylesheets -->
-				${_.stylesheets?_.stylesheets.map((W)=>j`<link rel="stylesheet" href="${W}" />`):""}
+				${_.stylesheets?_.stylesheets.map((W)=>F`<link rel="stylesheet" href="${W}" />`):""}
 
 				<!-- Scripts -->
-				${_.scripts?_.scripts.map((W)=>{if(typeof W==="string")return j`<script src="${W}"></script>`;let{src:Q,async:X,defer:Z}=W;if(X&&Z)return j`<script src="${Q}" async defer></script>`;if(X)return j`<script src="${Q}" async></script>`;if(Z)return j`<script src="${Q}" defer></script>`;return j`<script src="${Q}"></script>`}):""}
+				${_.scripts?_.scripts.map((W)=>{if(typeof W==="string")return F`<script src="${W}"></script>`;let{src:Q,async:X,defer:Z}=W;if(X&&Z)return F`<script src="${Q}" async defer></script>`;if(X)return F`<script src="${Q}" async></script>`;if(Z)return F`<script src="${Q}" defer></script>`;return F`<script src="${Q}"></script>`}):""}
 			</head>
 			<body ${e($$(_.bodyAttributes))}>
 				${_.children}
 			</body>
 		</html>
-	`};function Q$($="",_={}){return(W)=>{L.setControllerPath(W,$),L.setControllerOptions(W,_)}}var X$=T("get"),XW=T("post"),ZW=T("put"),JW=T("delete"),UW=T("patch"),YW=T("options"),BW=T("all");function x($={}){return(_)=>{L.setModuleOptions(_,$)}}function zW($="",_={prefix:null,version:null}){return Q$($,_)}var AW=X$;function kW($={}){return x({imports:$.imports,services:$.services,controllers:($.views||[]).concat($.controllers||[])})}var TW=z("body",async($,_)=>{let W=_.get(l);if(W===void 0)W=await _.req.json(),_.set(l,W);if($&&W&&typeof W==="object")return W[String($)];return W}),KW=z("param",($,_)=>{return $?_.req.param(String($)):_.req.param()}),NW=z("query",($,_)=>{return $?_.req.query(String($)):_.req.query()}),PW=z("header",($,_)=>{return $?_.req.header(String($)):_.req.header()}),SW=z("request",($,_)=>_.req),wW=z("request",($,_)=>_.req),EW=z("response",($,_)=>_.res),RW=z("response",($,_)=>_.res),bW=z("context",($,_)=>_),CW=z("context",($,_)=>_),IW=z("variable",($,_)=>$===void 0?void 0:_.get(String($))),MW=z("variable",($,_)=>$===void 0?void 0:_.get(String($)));function vW(){return($)=>{L.addService($)}}function gW($,..._){return(W,Q)=>{if(Q){let Z=`${W.constructor.name}:${String(Q)}`;_.forEach((U)=>L.registerHandler($,Z,U))}else _.forEach((X)=>L.registerController($,W,X))}}function dW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>L.registerHandler("filter",X,Z))}else $.forEach((Q)=>L.registerController("filter",_,Q))}}function iW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>L.registerHandler("guard",X,Z))}else $.forEach((Q)=>L.registerController("guard",_,Q))}}function nW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>L.registerHandler("middleware",X,Z))}else $.forEach((Q)=>L.registerController("middleware",_,Q))}}function rW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>L.registerHandler("pipe",X,Z))}else $.forEach((Q)=>L.registerController("pipe",_,Q))}}function Z$($={}){let{controllers:_,services:W,imports:Q,name:X="TestModule"}=$,Z={[X]:class{}}[X];return x({controllers:_,services:W,imports:Q})(Z),Z}async function J$($={}){let{module:_,appOptions:W,...Q}=$,X=_??Z$(Q),{app:Z,hono:U}=await w.create(X,W);return{app:Z,hono:U,request:(Y,B)=>{if(typeof Y==="string"){let q=Y.startsWith("http://")||Y.startsWith("https://")?Y:`http://localhost${Y.startsWith("/")?Y:`/${Y}`}`;return Promise.resolve(U.request(q,B))}return Promise.resolve(U.request(Y))}}}async function g8($){let{controller:_,...W}=$;return J$({...W,controllers:[_]})}function c8($={}){let _=$.diagnostics??new H,W=new E(void 0,_,Boolean($.debugDi));for(let Q of $.overrides??[]){let X=Q;W.register(X.provide,X.useValue)}for(let Q of $.preload??[])W.resolve(Q);return{container:W,get(Q){return W.resolve(Q)},register(Q,X){W.register(Q,X)},has(Q){return W.has(Q)},clear(){W.clear()}}}export{L_ as stripEndSlash,s as normalizePath,X_ as isUndefined,Y_ as isSymbol,f as isString,Z_ as isPlainObject,K as isObject,J_ as isNumber,S as isNil,_$ as isFunction,U_ as isEmpty,W$ as isConstructor,Z$ as createTestingModule,J$ as createTestApplication,c8 as createServiceTestContainer,z as createParamDecorator,T as createHttpMethodDecorator,R as createErrorResponse,g8 as createControllerTestApplication,B_ as addLeadingSlash,zW as View,MW as Variable,IW as Var,i as VERSION_NEUTRAL,rW as UsePipes,nW as UseMiddleware,iW as UseGuards,dW as UseFilters,gW as UseComponent,u as StaticServiceRegistry,D as StaticMetadataRepository,C as SnapshotMetadataRepository,vW as Service,m as RouteRegistry,RW as Response,EW as Res,wW as Request,SW as Req,NW as Query,ZW as Put,XW as Post,UW as Patch,KW as Param,AW as Page,YW as Options,p as NotFoundHandler,H as NoopDiagnosticsEmitter,kW as MvcModule,x as Module,L as MetadataRegistry,r_ as Layout,PW as Header,M as HONEST_PIPELINE_HANDLER_KEY,I as HONEST_PIPELINE_CONTROLLER_KEY,l as HONEST_PIPELINE_BODY_CACHE_KEY,X$ as Get,d as FrameworkError,c as ErrorHandler,JW as Delete,bW as Ctx,Q$ as Controller,CW as Context,E as Container,g as ConsoleDiagnosticsEmitter,TW as Body,h as ApplicationContext,w as Application,BW as All};
+	`};function Q$($="",_={}){return(W)=>{q.setControllerPath(W,$),q.setControllerOptions(W,_)}}var X$=T("get"),XW=T("post"),ZW=T("put"),JW=T("delete"),UW=T("patch"),YW=T("options"),BW=T("all");function x($={}){return(_)=>{q.setModuleOptions(_,$)}}function zW($="",_={prefix:null,version:null}){return Q$($,_)}var AW=X$;function kW($={}){return x({imports:$.imports,services:$.services,controllers:($.views||[]).concat($.controllers||[])})}var TW=z("body",async($,_)=>{let W=_.get(l);if(W===void 0)W=await _.req.json(),_.set(l,W);if($&&W&&typeof W==="object")return W[String($)];return W}),KW=z("param",($,_)=>{return $?_.req.param(String($)):_.req.param()}),NW=z("query",($,_)=>{return $?_.req.query(String($)):_.req.query()}),PW=z("header",($,_)=>{return $?_.req.header(String($)):_.req.header()}),wW=z("request",($,_)=>_.req),SW=z("request",($,_)=>_.req),EW=z("response",($,_)=>_.res),RW=z("response",($,_)=>_.res),bW=z("context",($,_)=>_),CW=z("context",($,_)=>_),IW=z("variable",($,_)=>$===void 0?void 0:_.get(String($))),MW=z("variable",($,_)=>$===void 0?void 0:_.get(String($)));function vW(){return($)=>{q.addService($)}}function gW($,..._){return(W,Q)=>{if(Q){let Z=`${W.constructor.name}:${String(Q)}`;_.forEach((U)=>q.registerHandler($,Z,U))}else _.forEach((X)=>q.registerController($,W,X))}}function dW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>q.registerHandler("filter",X,Z))}else $.forEach((Q)=>q.registerController("filter",_,Q))}}function iW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>q.registerHandler("guard",X,Z))}else $.forEach((Q)=>q.registerController("guard",_,Q))}}function nW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>q.registerHandler("middleware",X,Z))}else $.forEach((Q)=>q.registerController("middleware",_,Q))}}function rW(...$){return(_,W)=>{if(W){let X=`${_.constructor.name}:${String(W)}`;$.forEach((Z)=>q.registerHandler("pipe",X,Z))}else $.forEach((Q)=>q.registerController("pipe",_,Q))}}function Z$($={}){let{controllers:_,services:W,imports:Q,name:X="TestModule"}=$,Z={[X]:class{}}[X];return x({controllers:_,services:W,imports:Q})(Z),Z}async function J$($={}){let{module:_,appOptions:W,...Q}=$,X=_??Z$(Q),{app:Z,hono:U}=await S.create(X,W);return{app:Z,hono:U,request:(Y,B)=>{if(typeof Y==="string"){let G=Y.startsWith("http://")||Y.startsWith("https://")?Y:`http://localhost${Y.startsWith("/")?Y:`/${Y}`}`;return Promise.resolve(U.request(G,B))}return Promise.resolve(U.request(Y))}}}async function g8($){let{controller:_,...W}=$;return J$({...W,controllers:[_]})}function c8($={}){let _=$.logger??new D,W=new E(void 0,_,Boolean($.debugDi));for(let Q of $.overrides??[]){let X=Q;W.register(X.provide,X.useValue)}for(let Q of $.preload??[])W.resolve(Q);return{container:W,get(Q){return W.resolve(Q)},register(Q,X){W.register(Q,X)},has(Q){return W.has(Q)},clear(){W.clear()}}}export{q_ as stripEndSlash,s as normalizePath,X_ as isUndefined,Y_ as isSymbol,f as isString,Z_ as isPlainObject,K as isObject,J_ as isNumber,w as isNil,_$ as isFunction,U_ as isEmpty,W$ as isConstructor,Z$ as createTestingModule,J$ as createTestApplication,c8 as createServiceTestContainer,z as createParamDecorator,T as createHttpMethodDecorator,R as createErrorResponse,g8 as createControllerTestApplication,B_ as addLeadingSlash,zW as View,MW as Variable,IW as Var,i as VERSION_NEUTRAL,rW as UsePipes,nW as UseMiddleware,iW as UseGuards,dW as UseFilters,gW as UseComponent,u as StaticServiceRegistry,O as StaticMetadataRepository,C as SnapshotMetadataRepository,vW as Service,m as RouteRegistry,RW as Response,EW as Res,SW as Request,wW as Req,NW as Query,ZW as Put,XW as Post,UW as Patch,KW as Param,AW as Page,YW as Options,p as NotFoundHandler,D as NoopLogger,kW as MvcModule,x as Module,q as MetadataRegistry,r_ as Layout,PW as Header,M as HONEST_PIPELINE_HANDLER_KEY,I as HONEST_PIPELINE_CONTROLLER_KEY,l as HONEST_PIPELINE_BODY_CACHE_KEY,X$ as Get,d as FrameworkError,c as ErrorHandler,JW as Delete,bW as Ctx,Q$ as Controller,CW as Context,E as Container,g as ConsoleLogger,TW as Body,h as ApplicationContext,S as Application,BW as All};

package/dist/interfaces/honest-options.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Context } from 'hono';
 import type { VERSION_NEUTRAL } from '../constants';
-import type { FilterType, GuardType, IDiagnosticsEmitter, MiddlewareType, PipeType, PluginEntry } from '../interfaces';
+import type { FilterType, GuardType, ILogger, MiddlewareType, PipeType, PluginEntry } from '../interfaces';
 import type { DiContainer } from './di-container.interface';
 /**
  * Options for configuring the Honest application
@@ -27,9 +27,9 @@ export interface HonestOptions {
         startup?: boolean;
     };
     /**
-     * Optional diagnostics emitter for structured framework events.
+     * Optional logger for structured framework events.
      */
-    diagnostics?: IDiagnosticsEmitter;
+    logger?: ILogger;
     /**
      * Optional strict-mode checks for startup validation.
      */

package/dist/interfaces/index.d.ts

@@ -1,7 +1,7 @@
 export * from './application-context.interface';
 export * from './controller-options.interface';
 export * from './di-container.interface';
-export * from './diagnostics.interface';
+export * from './logger.interface';
 export * from './error-response.interface';
 export * from './filter.interface';
 export * from './guard.interface';

package/dist/interfaces/logger.interface.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Log level.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Log category used to filter or route events.
+ */
+export type LogCategory = 'startup' | 'routes' | 'plugins' | 'deprecations' | 'pipeline' | 'di' | 'errors';
+/**
+ * Structured log event emitted by Honest runtime components.
+ */
+export interface LogEvent {
+    level: LogLevel;
+    category: LogCategory;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Logger contract.
+ */
+export interface ILogger {
+    emit(event: LogEvent): void;
+}

package/dist/interfaces/plugin.interface.d.ts

@@ -1,6 +1,7 @@
 import type { Hono } from 'hono';
 import type { Application } from '../application';
 import type { IApplicationContext } from './application-context.interface';
+import type { ILogger } from './logger.interface';
 import type { Constructor } from '../types';
 /**
  * Processor callback for plugin pre/post hooks.
@@ -57,19 +58,22 @@ export interface IPlugin {
      */
     meta?: PluginMeta;
     /**
-     * Hook that runs before module registration begins
-     * Use this to set up plugin functionality that modules might depend on
+     * Application logger, injected by the framework before lifecycle hooks run.
+     * Use this to emit structured log events from within plugin code.
+     */
+    logger?: ILogger;
+    /**
+     * Hook that runs before module registration begins.
+     * Use this to set up plugin functionality that modules might depend on.
      * @param app - The Honest application instance
      * @param hono - The underlying Hono application instance
-     * @returns Void or a Promise that resolves to void
      */
     beforeModulesRegistered?: (app: Application, hono: Hono) => void | Promise<void>;
     /**
-     * Hook that runs after all modules have been registered
-     * Use this to perform cleanup or setup that requires all modules to be ready
+     * Hook that runs after all modules have been registered.
+     * Use this to perform cleanup or setup that requires all modules to be ready.
      * @param app - The Honest application instance
      * @param hono - The underlying Hono application instance
-     * @returns Void or a Promise that resolves to void
      */
     afterModulesRegistered?: (app: Application, hono: Hono) => void | Promise<void>;
 }

package/dist/managers/component.manager.d.ts

@@ -1,5 +1,5 @@
 import type { Context, Next } from 'hono';
-import type { ArgumentMetadata, DiContainer, FilterType, GuardType, IDiagnosticsEmitter, IMetadataRepository, IGuard, IPipe, MiddlewareType, PipeType } from '../interfaces';
+import type { ArgumentMetadata, DiContainer, FilterType, GuardType, ILogger, IMetadataRepository, IGuard, IPipe, MiddlewareType, PipeType } from '../interfaces';
 import { type ComponentType, type ComponentTypeMap } from '../registries';
 import type { Constructor } from '../types';
 /**
@@ -13,9 +13,9 @@ import type { Constructor } from '../types';
 export declare class ComponentManager {
     private readonly container;
     private readonly metadataRepository;
-    private readonly diagnosticsEmitter;
+    private readonly logger;
     private readonly globalComponents;
-    constructor(container: DiContainer, metadataRepository?: IMetadataRepository, diagnosticsEmitter?: IDiagnosticsEmitter);
+    constructor(container: DiContainer, metadataRepository?: IMetadataRepository, logger?: ILogger);
     /**
      * Configures global components from application options.
      */

package/dist/managers/pipeline.executor.d.ts

@@ -1,5 +1,5 @@
 import type { Context } from 'hono';
-import type { IDiagnosticsEmitter, ParameterMetadata } from '../interfaces';
+import type { ILogger, ParameterMetadata } from '../interfaces';
 import type { IPipe } from '../interfaces';
 import { ComponentManager } from './component.manager';
 import { HandlerInvoker } from './handler.invoker';
@@ -21,8 +21,8 @@ export declare class PipelineExecutor {
     private readonly componentManager;
     private readonly parameterResolver;
     private readonly handlerInvoker;
-    private readonly diagnosticsEmitter;
+    private readonly logger;
     private readonly debugPipeline;
-    constructor(componentManager: ComponentManager, parameterResolver: ParameterResolver, handlerInvoker: HandlerInvoker, diagnosticsEmitter?: IDiagnosticsEmitter, debugPipeline?: boolean);
+    constructor(componentManager: ComponentManager, parameterResolver: ParameterResolver, handlerInvoker: HandlerInvoker, logger?: ILogger, debugPipeline?: boolean);
     execute(input: PipelineExecutionInput): Promise<unknown>;
 }

package/dist/managers/route.manager.d.ts

@@ -1,6 +1,6 @@
 import type { Hono } from 'hono';
 import { VERSION_NEUTRAL } from '../constants';
-import type { DiContainer, IDiagnosticsEmitter, IMetadataRepository } from '../interfaces';
+import type { DiContainer, ILogger, IMetadataRepository } from '../interfaces';
 import { ComponentManager } from './component.manager';
 import { RouteRegistry } from '../registries/route.registry';
 import type { Constructor } from '../types';
@@ -18,10 +18,10 @@ export declare class RouteManager {
     private parameterResolver;
     private pipelineExecutor;
     private metadataRepository;
-    private diagnosticsEmitter;
+    private logger;
     private globalPrefix?;
     private globalVersion?;
-    constructor(hono: Hono, container: DiContainer, routeRegistry: RouteRegistry, componentManager: ComponentManager, metadataRepository?: IMetadataRepository, diagnosticsEmitter?: IDiagnosticsEmitter, options?: {
+    constructor(hono: Hono, container: DiContainer, routeRegistry: RouteRegistry, componentManager: ComponentManager, metadataRepository?: IMetadataRepository, logger?: ILogger, options?: {
         prefix?: string;
         version?: number | typeof VERSION_NEUTRAL | number[];
         debugPipeline?: boolean;

package/dist/registries/metadata.registry.d.ts

@@ -148,9 +148,15 @@ export declare class MetadataRegistry {
      * Get all handler-level components of a specific type for a handler
      */
     static getHandler<T extends ComponentType>(type: T, handlerKey: string): ComponentTypeMap[T][];
+    /**
+     * Clears handler-level component registrations created via {@link registerHandler}.
+     * Does not remove decorator-defined routes, controllers, or modules.
+     */
+    static clearHandlerComponents(): void;
     /**
      * Clears all registered decorator metadata.
-     * Primarily used for testing.
+     * Primarily used for testing. Warning: clearing after importing decorated classes
+     * (e.g. shared fixtures) removes their metadata until those modules are re-evaluated.
      */
     static clear(): void;
 }

package/dist/testing/fixtures/application-test-fixtures.d.ts

@@ -0,0 +1,17 @@
+import type { Constructor } from '../../types';
+export declare function createTestController(): Constructor;
+export declare function createPayloadController(): Constructor;
+export declare function createRawResponseController(): Constructor;
+export declare function createOnlyAController(): Constructor;
+export declare function createOnlyBController(): Constructor;
+export declare function createUndecoratedController(): Constructor;
+export declare function createBrokenControllerModule(): Constructor;
+export declare function createEmptyModule(): Constructor;
+export declare function createDuplicateRouteControllers(): {
+    a: Constructor;
+    b: Constructor;
+};
+export declare function createUnsafeParamController(): Constructor;
+export declare function createDiagnosticsAController(): Constructor;
+export declare function createDiagnosticsBController(): Constructor;
+export declare function createRuntimeMetadataController(): Constructor;

package/dist/testing/testing.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Hono } from 'hono';
 import type { Application } from '../application';
-import type { DiContainer, HonestOptions, IDiagnosticsEmitter, ModuleOptions } from '../interfaces';
+import type { DiContainer, HonestOptions, ILogger, ModuleOptions } from '../interfaces';
 import type { Constructor } from '../types';
 /**
  * Options for creating a lightweight test module.
@@ -76,9 +76,9 @@ export interface CreateServiceTestContainerOptions {
      */
     preload?: Constructor[];
     /**
-     * Optional diagnostics emitter used when debugDi is enabled.
+     * Optional logger used when debugDi is enabled.
      */
-    diagnostics?: IDiagnosticsEmitter;
+    logger?: ILogger;
     /**
      * Enable DI diagnostics while resolving services.
      */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "honestjs",
 	"description": "HonestJS - a modern web framework built on top of Hono",
-	"version": "0.1.17",
+	"version": "0.1.19",
 	"author": "Orkhan Karimov <karimovok1@gmail.com> (https://github.com/kerimovok)",
 	"repository": {
 		"type": "git",
@@ -53,6 +53,7 @@
 		"prepare": "husky",
 		"test": "bun test",
 		"test:watch": "bun test --watch",
+		"test:coverage": "bun test --coverage --coverage-reporter=text --coverage-reporter=lcov",
 		"build": "bun run clean && bun build ./src/index.ts --outdir=dist --target=node --minify --external hono --external reflect-metadata && bun run build:types",
 		"build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
 		"lint": "eslint .",

package/dist/interfaces/diagnostics.interface.d.ts

@@ -1,23 +0,0 @@
-/**
- * Diagnostic log level.
- */
-export type DiagnosticLevel = 'debug' | 'info' | 'warn' | 'error';
-/**
- * Diagnostic category used to filter or route events.
- */
-export type DiagnosticCategory = 'startup' | 'routes' | 'plugins' | 'deprecations' | 'pipeline' | 'di' | 'errors';
-/**
- * Structured diagnostic event emitted by Honest runtime components.
- */
-export interface DiagnosticEvent {
-    level: DiagnosticLevel;
-    category: DiagnosticCategory;
-    message: string;
-    details?: Record<string, unknown>;
-}
-/**
- * Diagnostics emitter contract.
- */
-export interface IDiagnosticsEmitter {
-    emit(event: DiagnosticEvent): void;
-}