honestjs 0.1.11 → 0.1.12

package/dist/application.d.ts

@@ -2,143 +2,30 @@ import { Hono } from 'hono';
 import type { HonestOptions, IApplicationContext, RouteInfo } from './interfaces';
 import type { Constructor } from './types';
 /**
- * Main application class for the Honest framework
- * Serves as the entry point for creating and configuring web applications
+ * Main application class for the Honest framework.
  *
- * Features:
- * - Module-based architecture for organizing application components
- * - Dependency injection container integration
- * - Plugin system for extending functionality
- * - Route management with versioning support
- * - Global error handling
- *
- * @example
- * ```ts
- * const { app } = await Application.create(AppModule, {
- *   routing: { prefix: '/api', version: 1 },
- *   plugins: [new LoggerPlugin()]
- * });
- * ```
+ * All per-app runtime state (routes, global components, DI container) is
+ * instance-based. Static decorator metadata lives in MetadataRegistry and
+ * is shared across all Application instances in the same process.
  */
 export declare class Application {
     private readonly hono;
     private readonly container;
     private readonly context;
+    private readonly routeRegistry;
+    private readonly componentManager;
     private readonly routeManager;
     private readonly options;
-    /**
-     * Creates a new Application instance with the specified configuration
-     * @param options - Configuration options for the application
-     * @param options.routing - Route configuration (prefix, versioning)
-     * @param options.plugins - Array of plugins to extend functionality
-     * @param options.container - Custom dependency injection container
-     * @param options.hono - Hono-specific configuration options
-     * @throws {Error} If options are invalid or initialization fails
-     */
     constructor(options?: HonestOptions);
-    /**
-     * Sets up global components from application options
-     * Initializes the component manager and registers global middleware,
-     * guards, pipes, and filters
-     * @private
-     */
-    private setupComponents;
-    /**
-     * Sets up global error handlers for the application
-     * Configures handlers for 404 Not Found and general error cases
-     * @private
-     */
     private setupErrorHandlers;
-    /**
-     * Resolves a plugin from either a constructor or instance
-     * @param pluginType - Plugin constructor or instance
-     * @returns Resolved plugin instance
-     * @private
-     * @throws {Error} If plugin instantiation fails
-     */
     private resolvePlugin;
-    /**
-     * Normalizes a plugin entry to a resolved plugin with pre/post processor arrays.
-     * @param entry - Plugin entry (plain plugin or object with plugin and processors)
-     * @returns Normalized entry with plugin instance and processor arrays
-     * @private
-     */
     private normalizePluginEntry;
-    /**
-     * Registers a module with the application
-     * Processes the module's metadata and registers its controllers
-     *
-     * @param moduleClass - The module class to register
-     * @returns The application instance for method chaining
-     * @throws {Error} If module registration fails
-     *
-     * @example
-     * ```ts
-     * const app = new Application();
-     * await app.register(UsersModule)
-     *         .register(AuthModule);
-     * ```
-     */
     register(moduleClass: Constructor): Promise<Application>;
-    /**
-     * Creates and initializes a new application with a root module
-     *
-     * Process:
-     * 1. Creates application instance with provided options
-     * 2. Initializes and runs plugin lifecycle hooks
-     * 3. Registers the root module
-     * 4. Returns both the application and Hono instances
-     *
-     * @param rootModule - The root module class for the application
-     * @param options - Application configuration options
-     * @returns Object containing the application and Hono instances
-     * @throws {Error} If application creation or module registration fails
-     *
-     * @example
-     * ```ts
-     * const { app, hono } = await Application.create(AppModule, {
-     *   routing: { prefix: '/api' }
-     * });
-     * ```
-     */
     static create(rootModule: Constructor, options?: HonestOptions): Promise<{
         app: Application;
         hono: Hono;
     }>;
-    /**
-     * Gets the underlying Hono instance for direct access
-     * Use this method when you need to access Hono-specific features
-     *
-     * @returns The Hono application instance
-     * @example
-     * ```ts
-     * const hono = app.getApp();
-     * hono.use(someHonoMiddleware());
-     * ```
-     */
     getApp(): Hono;
-    /**
-     * Gets the app-level registry (context) where your app can publish and read pipeline data by key.
-     * Use namespaced keys (e.g. 'app.config', 'openapi.spec') and document contracts in your app.
-     *
-     * @returns The application context instance
-     * @example
-     * ```ts
-     * app.getContext().set('app.config', { env: process.env.NODE_ENV })
-     * const config = app.getContext().get<{ env: string }>('app.config')
-     * ```
-     */
     getContext(): IApplicationContext;
-    /**
-     * Gets information about all registered routes in the application
-     * Useful for documentation and debugging purposes
-     *
-     * @returns Array of route information objects (read-only)
-     * @example
-     * ```ts
-     * const routes = app.getRoutes();
-     * console.log(routes.map(r => r.path));
-     * ```
-     */
     getRoutes(): ReadonlyArray<RouteInfo>;
 }

package/dist/decorators/decorators.test.d.ts

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

package/dist/di/container.d.ts

@@ -11,14 +11,19 @@ export declare class Container implements DiContainer {
     /**
      * Resolves a class instance, creating it if necessary and injecting its dependencies
      * @param target - The class constructor to resolve
-     * @param resolving - A set of classes currently being resolved, for circular dependency detection
      * @returns An instance of the target class
      */
-    resolve<T>(target: Constructor<T>, resolving?: Set<Constructor>): T;
+    resolve<T>(target: Constructor<T>): T;
+    /**
+     * Internal recursive resolver with circular dependency tracking
+     */
+    private resolveWithTracking;
     /**
      * Registers a pre-created instance for a class
      * @param target - The class constructor to register
      * @param instance - The instance to register
      */
     register<T>(target: Constructor<T>, instance: T): void;
+    has<T>(target: Constructor<T>): boolean;
+    clear(): void;
 }

package/dist/handlers/handlers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/create-error-response.helper.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -1,22 +1,22 @@
-import"reflect-metadata";import{Hono as t}from"hono";class M{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 C{instances=new Map;resolve($,_=new Set){if(this.instances.has($))return this.instances.get($);if(_.has($))throw Error(`Circular dependency detected: ${[..._.keys(),$].map((Q)=>Q.name).join(" -> ")}`);_.add($);let W=Reflect.getMetadata("design:paramtypes",$)||[];if($.length>0&&W.length===0)throw Error(`Cannot resolve dependencies for ${$.name}: constructor metadata is missing. Ensure 'reflect-metadata' is imported and 'emitDecoratorMetadata' is enabled.`);let Y=W.map((Q,B)=>{if(!Q||Q===Object||Q===Array||Q===Function)throw Error(`Cannot resolve dependency at index ${B} of ${$.name}. Use concrete class types for constructor dependencies.`);return this.resolve(Q,new Set(_))}),q=new $(...Y);return this.instances.set($,q),q}register($,_){this.instances.set($,_)}}import{HTTPException as r}from"hono/http-exception";function R($,_,W){let Y=new Date().toISOString(),q=_.get("requestId"),Q=_.req.path;if($ instanceof r)return{response:{status:W?.status||$.status,message:W?.title||$.message,timestamp:Y,path:Q,requestId:q,code:W?.code,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:W?.status||$.status};if($.statusCode||$.status){let L=$.statusCode||$.status,A=W?.status||L;return{response:{status:A,message:W?.title||$.message,timestamp:Y,path:Q,requestId:q,code:W?.code||$.name,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:A}}let B=W?.status||500;return{response:{status:B,message:W?.title||$.message,timestamp:Y,path:Q,requestId:q,code:W?.code||$.name,details:W?.additionalDetails||{stack:$.stack},...W?.detail&&{detail:W.detail}},status:B}}class X{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 global=new Map([["middleware",new Set],["guard",new Set],["pipe",new Set],["filter",new Set]]);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 registerGlobal($,_){this.global.get($).add(_)}static getGlobal($){return this.global.get($)}static registerController($,_,W){let Y=this.controller.get($);if(!Y.has(_))Y.set(_,[]);Y.get(_).push(W)}static getController($,_){return this.controller.get($).get(_)||[]}static registerHandler($,_,W){let Y=this.handler.get($);if(!Y.has(_))Y.set(_,[]);Y.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.global.values())$.clear();for(let $ of this.controller.values())$.clear();for(let $ of this.handler.values())$.clear()}}class T{static routes=[];static 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($)}static getRoutes(){return this.routes}static getRoutesByController($){return this.routes.filter((_)=>_.controller===$)}static getRoutesByMethod($){return this.routes.filter((_)=>_.method.toUpperCase()===$.toUpperCase())}static getRoutesByPath($){return this.routes.filter((_)=>$.test(_.fullPath))}static clear(){this.routes.length=0}}function H($){return(_="",W={})=>{return(Y,q,Q)=>{let B=Y.constructor;X.addRoute(B,{path:_,method:$,handlerName:q,parameterMetadata:[],version:W.version,prefix:W.prefix})}}}function E($,_){let W=(Y,q)=>{if(Y===void 0)return q;return q.get(Y)};return(Y)=>{return(q,Q,B)=>{let Z=q.constructor;if(!X.getParameters(Z).size)X.setParameterMap(Z,new Map);let L=X.getParameters(Z);if(!L.has(Q))L.set(Q,[]);let z=Reflect.getMetadata("design:paramtypes",q,Q)?.[B];if(L.get(Q).push({index:B,name:$,data:Y,factory:_||W,metatype:z}),$==="context"){if(!X.getContextIndices(Z).size)X.setContextIndices(Z,new Map);X.getContextIndices(Z).set(Q,B)}}}}class x{static handle(){return async($,_)=>{let{response:W,status:Y}=R($,_);return _.json(W,Y)}}}class I{static handle(){return async($)=>{return $.json({message:`Not Found - ${$.req.path}`},404)}}}var N$=($)=>typeof $>"u",N=($)=>$===null||typeof $>"u",O=($)=>$!==null&&typeof $==="object",b$=($)=>{if(!O($))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)},i=($)=>typeof $==="function",v=($)=>typeof $==="string",w$=($)=>typeof $==="number",P$=($)=>$.length===0,K$=($)=>typeof $==="symbol",R$=($)=>typeof $==="string"?$.charAt(0)!=="/"?"/"+$:$:"",y=($)=>$?$.startsWith("/")?("/"+$.replace(/\/+$/,"")).replace(/\/+/g,"/"):"/"+$.replace(/\/+$/,""):"/",f$=($)=>$.endsWith("/")?$.slice(0,-1):$,c=($)=>{return i($)&&!N($.prototype)&&!i($.prototype)&&Object.getOwnPropertyNames($.prototype).length>=1};class J{static container;static init($){this.container=$}static 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)}static registerGlobal($,..._){_.forEach((W)=>{X.registerGlobal($,W)})}static registerController($,_,...W){W.forEach((Y)=>{X.registerController($,_,Y)})}static registerHandler($,_,W,...Y){let q=`${_.name}:${String(W)}`;Y.forEach((Q)=>{X.registerHandler($,q,Q)})}static getComponents($,_,W){let Y=`${_.name}:${String(W)}`,q=X.getHandler($,Y),Q=X.getController($,_);return[...Array.from(X.getGlobal($)),...Q,...q]}static resolveMiddleware($){return $.map((_)=>{if(O(_)&&"use"in _)return _.use.bind(_);let W=this.container.resolve(_);return W.use.bind(W)})}static getHandlerMiddleware($,_){let W=this.getComponents("middleware",$,_);return this.resolveMiddleware(W)}static getGlobalMiddleware(){let $=Array.from(X.getGlobal("middleware"));return this.resolveMiddleware($)}static resolveGuards($){return $.map((_)=>{if(O(_)&&"canActivate"in _)return _;return this.container.resolve(_)})}static getHandlerGuards($,_){let W=this.getComponents("guard",$,_);return this.resolveGuards(W)}static resolvePipes($){return $.map((_)=>{if(O(_)&&"transform"in _)return _;return this.container.resolve(_)})}static getHandlerPipes($,_){let W=this.getComponents("pipe",$,_);return this.resolvePipes(W)}static async executePipes($,_,W){let Y=$;for(let q of W)Y=await q.transform(Y,_);return Y}static async handleException($,_){let W=_.get("controllerClass"),Y=_.get("handlerName");if(W&&Y){let Z=X.getHandler("filter",`${W.name}:${Y}`);if(Z.length>0){let L=await this.executeFilters(Z,$,_);if(L)return L}}if(W){let Z=X.getController("filter",W);if(Z.length>0){let L=await this.executeFilters(Z,$,_);if(L)return L}}let q=Array.from(X.getGlobal("filter"));if(q.length>0){let Z=await this.executeFilters(q,$,_);if(Z)return Z}let{response:Q,status:B}=R($,_);return _.json(Q,B)}static async executeFilters($,_,W){for(let Y of $){let q;if(O(Y)&&"catch"in Y)q=Y;else q=this.container.resolve(Y);try{let Q=await q.catch(_,W);if(Q!==void 0)return Q}catch(Q){console.error("Error in exception filter:",Q)}}return}static async registerModule($,_){let W=X.getModuleOptions($);if(!W)throw Error(`Module ${$.name} is not properly decorated with @Module()`);let Y=[];if(W.imports&&W.imports.length>0)for(let q of W.imports){let Q=await this.registerModule(q,_);Y.push(...Q)}if(W.services&&W.services.length>0)for(let q of W.services)_.resolve(q);if(W.controllers&&W.controllers.length>0)Y.push(...W.controllers);return Y}}import{HTTPException as o}from"hono/http-exception";var h=Symbol("VERSION_NEUTRAL");class g{hono;container;globalPrefix;globalVersion;constructor($,_,W={}){this.hono=$,this.container=_,this.globalPrefix=W.prefix!==void 0?this.normalizePath(W.prefix):void 0,this.globalVersion=W.version,this.applyGlobalMiddleware()}applyGlobalMiddleware(){let $=J.getGlobalMiddleware();for(let _ of $)this.hono.use("*",_)}normalizePath($){if(v($))return y($);return $?`/${$}`:""}registerRouteHandler($,_,W,Y){if(W.length>0)this.hono.on($.toUpperCase(),_,...W,Y);else this.hono.on($.toUpperCase(),_,Y)}buildRoutePath($,_,W,Y){return y(`${$}${_}${W}${Y}`)}formatVersionSegment($){if(N($))return"";return $===h?"":`/v${String($)}`}async registerController($){if(!X.hasController($))throw Error(`Controller ${$.name} is not decorated with @Controller()`);let _=X.getControllerPath($)||"",W=X.getControllerOptions($)||{},Y=X.getRoutes($)||[],q=X.getParameters($)||new Map,Q=X.getContextIndices($)||new Map,B=this.normalizePath(_),Z=this.container.resolve($),L=W.prefix!==void 0?W.prefix:this.globalPrefix,A=W.version!==void 0?W.version:this.globalVersion;if(Y.length===0)throw Error(`Controller ${$.name} has no route handlers. Add HTTP method decorators like @Get()`);for(let z of Y){let{path:j,method:V,handlerName:f,version:b,prefix:w}=z,P=w!==void 0?w:L,S=!N(P)?this.normalizePath(P):"",G=b!==void 0?b:A,k=this.normalizePath(j);if(N(G)){this.registerRoute(Z,z,q,Q,$,S,"",B,k,V);continue}if(G===h){this.registerRoute(Z,z,q,Q,$,S,"",B,k,V),this.registerRoute(Z,z,q,Q,$,S,"/:version{v[0-9]+}",B,k,V);continue}if(Array.isArray(G)){for(let D of G){let F=this.formatVersionSegment(D);this.registerRoute(Z,z,q,Q,$,S,F,B,k,V)}continue}let K=this.formatVersionSegment(G);this.registerRoute(Z,z,q,Q,$,S,K,B,k,V)}}registerRoute($,_,W,Y,q,Q,B,Z,L,A){let{handlerName:z}=_,j=this.buildRoutePath(Q,B,Z,L),V=$[z].bind($),f=W.get(z)||[],b=Y.get(z),w=J.getHandlerMiddleware(q,z),P=J.getHandlerPipes(q,z);T.registerRoute({controller:q.name,handler:z,method:A,prefix:Q,version:B,route:Z,path:L,fullPath:j,parameters:f});let S=async(G)=>{try{G.set("controllerClass",q),G.set("handlerName",String(z));let k=J.getHandlerGuards(q,z);for(let F of k)if(!await F.canActivate(G))throw new o(403,{message:`Forbidden by ${F.constructor?.name||"UnknownGuard"} at ${q.name}.${String(z)}`});let K=Array(V.length);for(let F of f){if(typeof F.factory!=="function")throw Error(`Invalid parameter decorator metadata for ${q.name}.${String(z)}`);let d=F.factory(F.data,G),a=await J.executePipes(d,{type:F.name,metatype:F.metatype,data:F.data},P);K[F.index]=a}let D=await V(...K);if(b!==void 0)return D;if(D instanceof Response)return D;if(N(D))return G.json(null);if(v(D))return G.text(D);return G.json(D)}catch(k){return J.handleException(k,G)}};this.registerRouteHandler(A,j,w,S)}}class p{hono;container;context;routeManager;options;constructor($={}){if(this.options=O($)?$:{},T.clear(),this.hono=new t(this.options.hono),this.container=this.options.container||new C,this.context=new M,this.setupComponents(),this.setupErrorHandlers(),this.routeManager=new g(this.hono,this.container,{prefix:this.options.routing?.prefix,version:this.options.routing?.version}),this.options.deprecations?.printPreV1Warning)console.warn("[HonestJS] Pre-v1 warning: APIs may change before 1.0.0.")}setupComponents(){J.init(this.container),J.setupGlobalComponents(this.options)}setupErrorHandlers(){this.hono.notFound(this.options.notFound||I.handle()),this.hono.onError(this.options.onError||x.handle())}resolvePlugin($){if(c($))return new $;return $}normalizePluginEntry($){if($&&typeof $==="object"&&"plugin"in $){let _=$;return{plugin:this.resolvePlugin(_.plugin),preProcessors:_.preProcessors??[],postProcessors:_.postProcessors??[]}}return{plugin:this.resolvePlugin($),preProcessors:[],postProcessors:[]}}async register($){let _=await J.registerModule($,this.container);for(let W of _)await this.routeManager.registerController(W);return this}static async create($,_={}){let W=new p(_),Y=(_.plugins||[]).map((A)=>W.normalizePluginEntry(A)),q=W.getContext(),Q=_.debug,B=Q===!0||typeof Q==="object"&&Q.plugins,Z=Q===!0||typeof Q==="object"&&Q.routes;if(B&&Y.length>0)console.info("[HonestJS] Plugin order:",Y.map(({plugin:A})=>A.constructor?.name||"AnonymousPlugin").join(" -> "));for(let{plugin:A,preProcessors:z}of Y){for(let j of z)await j(W,W.hono,q);if(A.beforeModulesRegistered)await A.beforeModulesRegistered(W,W.hono)}await W.register($);let L=W.getRoutes();if(_.strict?.requireRoutes&&L.length===0)throw Error("Strict mode: no routes were registered. Check your module/controller decorators.");if(Z)console.info("[HonestJS] Registered routes:",L.map((A)=>`${A.method.toUpperCase()} ${A.fullPath}`));for(let{plugin:A,postProcessors:z}of Y){if(A.afterModulesRegistered)await A.afterModulesRegistered(W,W.hono);for(let j of z)await j(W,W.hono,q)}return{app:W,hono:W.getApp()}}getApp(){return this.hono}getContext(){return this.context}getRoutes(){return T.getRoutes()}}import{html as U,raw as u}from"hono/html";var e={type:"website",locale:"en_US"},m=($)=>{if(!$)return"";return Object.entries($).map(([_,W])=>{if(typeof W==="boolean")return W?_:"";let Y=String(W).replace(/"/g,""");return`${_}="${Y}"`}).filter(Boolean).join(" ")},X_=($)=>{let _={...e,...$};return U`
+import"reflect-metadata";import{Hono as $$}from"hono";class C{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 Z{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 Y=this.controller.get($);if(!Y.has(_))Y.set(_,[]);Y.get(_).push(W)}static getController($,_){return this.controller.get($).get(_)||[]}static registerHandler($,_,W){let Y=this.handler.get($);if(!Y.has(_))Y.set(_,[]);Y.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 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 f{instances=new Map;resolve($){return this.resolveWithTracking($,new Set)}resolveWithTracking($,_){if(this.instances.has($))return this.instances.get($);if(_.has($))throw Error(`Circular dependency detected: ${[..._.keys(),$].map((X)=>X.name).join(" -> ")}`);_.add($);let W=Reflect.getMetadata("design:paramtypes",$)||[];if($.length>0&&W.length===0){if(!Z.isService($))throw Error(`Cannot resolve ${$.name}: it is not decorated with @Service(). Did you forget to add @Service() to the class?`);throw Error(`Cannot resolve dependencies for ${$.name}: constructor metadata is missing. Ensure 'reflect-metadata' is imported and 'emitDecoratorMetadata' is enabled.`)}let Y=W.map((X,B)=>{if(!X||X===Object||X===Array||X===Function)throw Error(`Cannot resolve dependency at index ${B} of ${$.name}. Use concrete class types for constructor dependencies.`);return this.resolveWithTracking(X,new Set(_))}),Q=new $(...Y);return this.instances.set($,Q),Q}register($,_){this.instances.set($,_)}has($){return this.instances.has($)}clear(){this.instances.clear()}}import{HTTPException as t}from"hono/http-exception";function b($,_,W){let Y=new Date().toISOString(),Q=_.get("requestId"),X=_.req.path;if($ instanceof t)return{response:{status:W?.status||$.status,message:W?.title||$.message,timestamp:Y,path:X,requestId:Q,code:W?.code,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:W?.status||$.status};if($.statusCode||$.status){let q=$.statusCode||$.status,z=W?.status||q;return{response:{status:z,message:W?.title||$.message,timestamp:Y,path:X,requestId:Q,code:W?.code||$.name,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:z}}let B=W?.status||500;return{response:{status:B,message:W?.title||$.message,timestamp:Y,path:X,requestId:Q,code:W?.code||$.name,details:W?.additionalDetails||{stack:$.stack},...W?.detail&&{detail:W.detail}},status:B}}function k($){return(_="",W={})=>{return(Y,Q,X)=>{let B=Y.constructor;Z.addRoute(B,{path:_,method:$,handlerName:Q,version:W.version,prefix:W.prefix})}}}function j($,_){let W=(Y,Q)=>{if(Y===void 0)return Q;return Q.get(Y)};return(Y)=>{return(Q,X,B)=>{let J=Q.constructor;if(!Z.getParameters(J).size)Z.setParameterMap(J,new Map);let q=Z.getParameters(J);if(!q.has(X))q.set(X,[]);let U=Reflect.getMetadata("design:paramtypes",Q,X)?.[B];if(q.get(X).push({index:B,name:$,data:Y,factory:_||W,metatype:U}),$==="context"){if(!Z.getContextIndices(J).size)Z.setContextIndices(J,new Map);Z.getContextIndices(J).set(X,B)}}}}class x{static handle(){return async($,_)=>{let{response:W,status:Y}=b($,_);return _.json(W,Y)}}}class I{static handle(){return async($)=>{return $.json({message:`Not Found - ${$.req.path}`},404)}}}var K$=($)=>typeof $>"u",T=($)=>$===null||typeof $>"u",O=($)=>$!==null&&typeof $==="object",w$=($)=>{if(!O($))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)},p=($)=>typeof $==="function",v=($)=>typeof $==="string",R$=($)=>typeof $==="number",C$=($)=>$.length===0,M$=($)=>typeof $==="symbol",f$=($)=>typeof $==="string"?$.charAt(0)!=="/"?"/"+$:$:"",y=($)=>$?$.startsWith("/")?("/"+$.replace(/\/+$/,"")).replace(/\/+/g,"/"):"/"+$.replace(/\/+$/,""):"/",x$=($)=>$.endsWith("/")?$.slice(0,-1):$,s=($)=>{return p($)&&!T($.prototype)&&!p($.prototype)&&Object.getOwnPropertyNames($.prototype).length>=1};class g{container;globalComponents=new Map([["middleware",new Set],["guard",new Set],["pipe",new Set],["filter",new Set]]);constructor($){this.container=$}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 Y=`${_.name}:${String(W)}`,Q=Z.getHandler($,Y),X=Z.getController($,_);return[...Array.from(this.globalComponents.get($)||[]),...X,...Q]}resolveMiddleware($){return $.map((_)=>{if(O(_)&&"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(O(_)&&"canActivate"in _)return _;return this.container.resolve(_)})}getHandlerGuards($,_){let W=this.getComponents("guard",$,_);return this.resolveGuards(W)}resolvePipes($){return $.map((_)=>{if(O(_)&&"transform"in _)return _;return this.container.resolve(_)})}getHandlerPipes($,_){let W=this.getComponents("pipe",$,_);return this.resolvePipes(W)}async executePipes($,_,W){let Y=$;for(let Q of W)Y=await Q.transform(Y,_);return Y}async handleException($,_){let W=_.get("__honest_controllerClass"),Y=_.get("__honest_handlerName");if(W&&Y){let J=Z.getHandler("filter",`${W.name}:${Y}`);if(J.length>0){let q=await this.executeFilters(J,$,_);if(q)return q}}if(W){let J=Z.getController("filter",W);if(J.length>0){let q=await this.executeFilters(J,$,_);if(q)return q}}let Q=Array.from(this.globalComponents.get("filter")||[]);if(Q.length>0){let J=await this.executeFilters(Q,$,_);if(J)return J}let{response:X,status:B}=b($,_);return _.json(X,B)}async executeFilters($,_,W){for(let Y of $){let Q;if(O(Y)&&"catch"in Y)Q=Y;else Q=this.container.resolve(Y);try{let X=await Q.catch(_,W);if(X!==void 0)return X}catch(X){let B=Q.constructor?.name||"UnknownFilter";console.error(`Error in exception filter ${B}:`,X);let{response:J,status:q}=b(X,W);return W.json(J,q)}}return}async registerModule($,_=new Set){if(_.has($))return[];_.add($);let W=Z.getModuleOptions($);if(!W)throw Error(`Module ${$.name} is not properly decorated with @Module()`);let Y=[];if(W.imports&&W.imports.length>0)for(let Q of W.imports){let X=await this.registerModule(Q,_);Y.push(...X)}if(W.services&&W.services.length>0)for(let Q of W.services)this.container.resolve(Q);if(W.controllers&&W.controllers.length>0)Y.push(...W.controllers);return Y}}import{HTTPException as e}from"hono/http-exception";var h=Symbol("VERSION_NEUTRAL");class m{hono;container;routeRegistry;componentManager;globalPrefix;globalVersion;constructor($,_,W,Y,Q={}){this.hono=$,this.container=_,this.routeRegistry=W,this.componentManager=Y,this.globalPrefix=Q.prefix!==void 0?this.normalizePath(Q.prefix):void 0,this.globalVersion=Q.version,this.applyGlobalMiddleware()}applyGlobalMiddleware(){let $=this.componentManager.getGlobalMiddleware();for(let _ of $)this.hono.use("*",_)}normalizePath($){if(!v($))throw Error(`Invalid path: expected a string but received ${typeof $}. Check your @Controller() and route decorator arguments.`);return y($)}registerRouteHandler($,_,W,Y){if(W.length>0)this.hono.on($.toUpperCase(),_,...W,Y);else this.hono.on($.toUpperCase(),_,Y)}buildRoutePath($,_,W,Y){return y(`${$}${_}${W}${Y}`)}formatVersionSegment($){if(T($))return"";return $===h?"":`/v${String($)}`}async registerController($){if(!Z.hasController($))throw Error(`Controller ${$.name} is not decorated with @Controller()`);let _=Z.getControllerPath($)||"",W=Z.getControllerOptions($)||{},Y=Z.getRoutes($)||[],Q=Z.getParameters($)||new Map,X=Z.getContextIndices($)||new Map,B=this.normalizePath(_),J=this.container.resolve($),q=W.prefix!==void 0?W.prefix:this.globalPrefix,z=W.version!==void 0?W.version:this.globalVersion;if(Y.length===0)throw Error(`Controller ${$.name} has no route handlers. Add HTTP method decorators like @Get()`);for(let U of Y){let{path:E,method:V,version:H,prefix:K}=U,w=K!==void 0?K:q,D=!T(w)?this.normalizePath(w):"",A=H!==void 0?H:z,S=this.normalizePath(E);if(T(A)){this.registerRoute(J,U,Q,X,$,D,"",B,S,V);continue}if(A===h){this.registerRoute(J,U,Q,X,$,D,"",B,S,V),this.registerRoute(J,U,Q,X,$,D,"/:version{v[0-9]+}",B,S,V);continue}if(Array.isArray(A)){for(let P of A){let R=this.formatVersionSegment(P);this.registerRoute(J,U,Q,X,$,D,R,B,S,V)}continue}let F=this.formatVersionSegment(A);this.registerRoute(J,U,Q,X,$,D,F,B,S,V)}}registerRoute($,_,W,Y,Q,X,B,J,q,z){let{handlerName:U}=_,E=this.buildRoutePath(X,B,J,q),V=$[U].bind($),H=W.get(U)||[],K=Y.get(U),w=this.componentManager.getHandlerMiddleware(Q,U),D=this.componentManager.getHandlerPipes(Q,U);this.routeRegistry.registerRoute({controller:Q.name,handler:U,method:z,prefix:X,version:B,route:J,path:q,fullPath:E,parameters:H});let A=this.componentManager,S=async(F)=>{try{F.set("__honest_controllerClass",Q),F.set("__honest_handlerName",String(U));let P=A.getHandlerGuards(Q,U);for(let G of P)if(!await G.canActivate(F))throw new e(403,{message:`Forbidden by ${G.constructor?.name||"UnknownGuard"} at ${Q.name}.${String(U)}`});let R=H.length>0?Math.max(...H.map((G)=>G.index)):-1,c=Array(Math.max(V.length,R+1));for(let G of H){if(typeof G.factory!=="function")throw Error(`Invalid parameter decorator metadata for ${Q.name}.${String(U)}`);let i=G.factory(G.data,F),r=await A.executePipes(i,{type:G.name,metatype:G.metatype,data:G.data},D);c[G.index]=r}let N=await V(...c);if(K!==void 0)return N;if(N instanceof Response)return N;if(T(N))return F.json(null);if(v(N))return F.text(N);return F.json(N)}catch(P){return A.handleException(P,F)}};this.registerRouteHandler(z,E,w,S)}}class l{hono;container;context;routeRegistry;componentManager;routeManager;options;constructor($={}){if(this.options=O($)?$:{},this.hono=new $$(this.options.hono),this.container=this.options.container||new f,this.context=new C,this.routeRegistry=new M,this.componentManager=new g(this.container),this.componentManager.setupGlobalComponents(this.options),this.setupErrorHandlers(),this.routeManager=new m(this.hono,this.container,this.routeRegistry,this.componentManager,{prefix:this.options.routing?.prefix,version:this.options.routing?.version}),this.options.deprecations?.printPreV1Warning)console.warn("[HonestJS] Pre-v1 warning: APIs may change before 1.0.0.")}setupErrorHandlers(){this.hono.notFound(this.options.notFound||I.handle()),this.hono.onError(this.options.onError||x.handle())}resolvePlugin($){if(s($))return new $;return $}normalizePluginEntry($){if($&&typeof $==="object"&&"plugin"in $){let _=$;return{plugin:this.resolvePlugin(_.plugin),preProcessors:_.preProcessors??[],postProcessors:_.postProcessors??[]}}return{plugin:this.resolvePlugin($),preProcessors:[],postProcessors:[]}}async register($){let _=await this.componentManager.registerModule($);for(let W of _)await this.routeManager.registerController(W);return this}static async create($,_={}){let W=new l(_),Y=(_.plugins||[]).map((z)=>W.normalizePluginEntry(z)),Q=W.getContext(),X=_.debug,B=X===!0||typeof X==="object"&&X.plugins,J=X===!0||typeof X==="object"&&X.routes;if(B&&Y.length>0)console.info("[HonestJS] Plugin order:",Y.map(({plugin:z})=>z.constructor?.name||"AnonymousPlugin").join(" -> "));for(let{plugin:z,preProcessors:U}of Y){for(let E of U)await E(W,W.hono,Q);if(z.beforeModulesRegistered)await z.beforeModulesRegistered(W,W.hono)}await W.register($);let q=W.getRoutes();if(_.strict?.requireRoutes&&q.length===0)throw Error("Strict mode: no routes were registered. Check your module/controller decorators.");if(J)console.info("[HonestJS] Registered routes:",q.map((z)=>`${z.method.toUpperCase()} ${z.fullPath}`));for(let{plugin:z,postProcessors:U}of Y){if(z.afterModulesRegistered)await z.afterModulesRegistered(W,W.hono);for(let E of U)await E(W,W.hono,Q)}return{app:W,hono:W.getApp()}}getApp(){return this.hono}getContext(){return this.context}getRoutes(){return this.routeRegistry.getRoutes()}}import{html as L,raw as u}from"hono/html";var _$={type:"website",locale:"en_US"},d=($)=>{if(!$)return"";return Object.entries($).map(([_,W])=>{if(typeof W==="boolean")return W?_:"";let Y=String(W).replace(/"/g,""");return`${_}="${Y}"`}).filter(Boolean).join(" ")},B_=($)=>{let _={..._$,...$};return L`
 		<!DOCTYPE html>
-		<html lang="${_.locale?.split("_")[0]||"en"}" ${u(m(_.htmlAttributes))}>
-			<head ${u(m(_.headAttributes))}>
+		<html lang="${_.locale?.split("_")[0]||"en"}" ${u(d(_.htmlAttributes))}>
+			<head ${u(d(_.headAttributes))}>
 				<meta charset="UTF-8" />
 				<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-				${_.csp?U`<meta http-equiv="Content-Security-Policy" content="${_.csp}" />`:""}
+				${_.csp?L`<meta http-equiv="Content-Security-Policy" content="${_.csp}" />`:""}
 				<title>${_.title}</title>
-				${_.description?U`<meta name="description" content="${_.description}" />`:""}
+				${_.description?L`<meta name="description" content="${_.description}" />`:""}
 
 				<!-- Open Graph / Facebook -->
 				<meta prefix="og: http://ogp.me/ns#" />
 				<meta property="og:title" content="${_.title}" />
-				${_.description?U`<meta property="og:description" content="${_.description}" />`:""}
-				${_.image?U`<meta property="og:image" content="${_.image}" />`:""}
-				${_.url?U`<meta property="og:url" content="${_.url}" />`:""}
-				${_.locale?U`<meta property="og:locale" content="${_.locale}" />`:""}
-				${_.type?U`<meta property="og:type" content="${_.type}" />`:""}
-				${_.siteName?U`<meta property="og:site_name" content="${_.siteName}" />`:""}
+				${_.description?L`<meta property="og:description" content="${_.description}" />`:""}
+				${_.image?L`<meta property="og:image" content="${_.image}" />`:""}
+				${_.url?L`<meta property="og:url" content="${_.url}" />`:""}
+				${_.locale?L`<meta property="og:locale" content="${_.locale}" />`:""}
+				${_.type?L`<meta property="og:type" content="${_.type}" />`:""}
+				${_.siteName?L`<meta property="og:site_name" content="${_.siteName}" />`:""}
 
 				<!-- Twitter -->
 				<meta
@@ -24,23 +24,23 @@ import"reflect-metadata";import{Hono as t}from"hono";class M{store=new Map;get($
 					content="${_.twitterCard||(_.image?"summary_large_image":"summary")}"
 				/>
 				<meta name="twitter:title" content="${_.title}" />
-				${_.description?U`<meta name="twitter:description" content="${_.description}" />`:""}
-				${_.image?U`<meta name="twitter:image" content="${_.image}" />`:""}
+				${_.description?L`<meta name="twitter:description" content="${_.description}" />`:""}
+				${_.image?L`<meta name="twitter:image" content="${_.image}" />`:""}
 
 				<!-- Custom Meta Tags -->
-				${_.customMeta?_.customMeta.map((W)=>{let Y=W.name?`name="${W.name}"`:"",q=W.property?`property="${W.property}"`:"";return U`<meta ${Y} ${q} content="${W.content}" />`}):""}
+				${_.customMeta?_.customMeta.map((W)=>{let Y=W.name?`name="${W.name}"`:"",Q=W.property?`property="${W.property}"`:"";return L`<meta ${Y} ${Q} content="${W.content}" />`}):""}
 
 				<!-- Favicon -->
-				${_.favicon?U`<link rel="icon" href="${_.favicon}" />`:""}
+				${_.favicon?L`<link rel="icon" href="${_.favicon}" />`:""}
 
 				<!-- Stylesheets -->
-				${_.stylesheets?_.stylesheets.map((W)=>U`<link rel="stylesheet" href="${W}" />`):""}
+				${_.stylesheets?_.stylesheets.map((W)=>L`<link rel="stylesheet" href="${W}" />`):""}
 
 				<!-- Scripts -->
-				${_.scripts?_.scripts.map((W)=>{if(typeof W==="string")return U`<script src="${W}"></script>`;let{src:Y,async:q,defer:Q}=W;if(q&&Q)return U`<script src="${Y}" async defer></script>`;if(q)return U`<script src="${Y}" async></script>`;if(Q)return U`<script src="${Y}" defer></script>`;return U`<script src="${Y}"></script>`}):""}
+				${_.scripts?_.scripts.map((W)=>{if(typeof W==="string")return L`<script src="${W}"></script>`;let{src:Y,async:Q,defer:X}=W;if(Q&&X)return L`<script src="${Y}" async defer></script>`;if(Q)return L`<script src="${Y}" async></script>`;if(X)return L`<script src="${Y}" defer></script>`;return L`<script src="${Y}"></script>`}):""}
 			</head>
-			<body ${u(m(_.bodyAttributes))}>
+			<body ${u(d(_.bodyAttributes))}>
 				${_.children}
 			</body>
 		</html>
-	`};function s($="",_={}){return(W)=>{X.setControllerPath(W,$),X.setControllerOptions(W,_)}}var l=H("get"),U_=H("post"),G_=H("put"),E_=H("delete"),F_=H("patch"),j_=H("options"),V_=H("all");function n($={}){return(_)=>{X.setModuleOptions(_,$)}}function N_($="",_={prefix:null,version:null}){return s($,_)}var b_=l;function w_($={}){return n({imports:$.imports,services:$.services,controllers:($.views||[]).concat($.controllers||[])})}var R_=E("body",async($,_)=>{let W=_.get("__honest.body.cache");if(W===void 0)W=await _.req.json(),_.set("__honest.body.cache",W);if($&&W&&typeof W==="object")return W[String($)];return W}),f_=E("param",($,_)=>{return $?_.req.param($):_.req.param()}),M_=E("query",($,_)=>{return $?_.req.query($):_.req.query()}),C_=E("header",($,_)=>{return $?_.req.header($):_.req.header()}),x_=E("request",($,_)=>_.req),I_=E("request",($,_)=>_.req),v_=E("response",($,_)=>_.res),y_=E("response",($,_)=>_.res),h_=E("context",($,_)=>_),g_=E("context",($,_)=>_),u_=E("variable",($,_)=>_.get($)),m_=E("variable",($,_)=>_.get($));function c_(){return($)=>{X.addService($)}}function l_($,..._){return(W,Y)=>{if(Y){let q=W.constructor;J.registerHandler($,q,Y,..._)}else J.registerController($,W,..._)}}function r_(...$){return(_,W)=>{if(W){let Y=_.constructor;J.registerHandler("filter",Y,W,...$)}else J.registerController("filter",_,...$)}}function e_(...$){return(_,W)=>{if(W){let Y=_.constructor;J.registerHandler("guard",Y,W,...$)}else J.registerController("guard",_,...$)}}function WW(...$){return(_,W)=>{if(W){let Y=_.constructor;J.registerHandler("middleware",Y,W,...$)}else J.registerController("middleware",_,...$)}}function QW(...$){return(_,W)=>{if(W){let Y=_.constructor;J.registerHandler("pipe",Y,W,...$)}else J.registerController("pipe",_,...$)}}export{f$ as stripEndSlash,y as normalizePath,N$ as isUndefined,K$ as isSymbol,v as isString,b$ as isPlainObject,O as isObject,w$ as isNumber,N as isNil,i as isFunction,P$ as isEmpty,c as isConstructor,E as createParamDecorator,H as createHttpMethodDecorator,R as createErrorResponse,R$ as addLeadingSlash,N_ as View,m_ as Variable,u_ as Var,h as VERSION_NEUTRAL,QW as UsePipes,WW as UseMiddleware,e_ as UseGuards,r_ as UseFilters,l_ as UseComponent,c_ as Service,T as RouteRegistry,y_ as Response,v_ as Res,I_ as Request,x_ as Req,M_ as Query,G_ as Put,U_ as Post,F_ as Patch,f_ as Param,b_ as Page,j_ as Options,I as NotFoundHandler,w_ as MvcModule,n as Module,X as MetadataRegistry,X_ as Layout,C_ as Header,l as Get,x as ErrorHandler,E_ as Delete,h_ as Ctx,s as Controller,g_ as Context,C as Container,R_ as Body,M as ApplicationContext,p as Application,V_ as All};
+	`};function n($="",_={}){return(W)=>{Z.setControllerPath(W,$),Z.setControllerOptions(W,_)}}var a=k("get"),F_=k("post"),E_=k("put"),V_=k("delete"),A_=k("patch"),k_=k("options"),O_=k("all");function o($={}){return(_)=>{Z.setModuleOptions(_,$)}}function b_($="",_={prefix:null,version:null}){return n($,_)}var K_=a;function w_($={}){return o({imports:$.imports,services:$.services,controllers:($.views||[]).concat($.controllers||[])})}var M_=j("body",async($,_)=>{let W=_.get("__honest.body.cache");if(W===void 0)W=await _.req.json(),_.set("__honest.body.cache",W);if($&&W&&typeof W==="object")return W[String($)];return W}),f_=j("param",($,_)=>{return $?_.req.param($):_.req.param()}),x_=j("query",($,_)=>{return $?_.req.query($):_.req.query()}),I_=j("header",($,_)=>{return $?_.req.header($):_.req.header()}),v_=j("request",($,_)=>_.req),y_=j("request",($,_)=>_.req),g_=j("response",($,_)=>_.res),h_=j("response",($,_)=>_.res),m_=j("context",($,_)=>_),u_=j("context",($,_)=>_),d_=j("variable",($,_)=>_.get($)),c_=j("variable",($,_)=>_.get($));function s_(){return($)=>{Z.addService($)}}function a_($,..._){return(W,Y)=>{if(Y){let X=`${W.constructor.name}:${String(Y)}`;_.forEach((B)=>Z.registerHandler($,X,B))}else _.forEach((Q)=>Z.registerController($,W,Q))}}function t_(...$){return(_,W)=>{if(W){let Q=`${_.constructor.name}:${String(W)}`;$.forEach((X)=>Z.registerHandler("filter",Q,X))}else $.forEach((Y)=>Z.registerController("filter",_,Y))}}function _W(...$){return(_,W)=>{if(W){let Q=`${_.constructor.name}:${String(W)}`;$.forEach((X)=>Z.registerHandler("guard",Q,X))}else $.forEach((Y)=>Z.registerController("guard",_,Y))}}function QW(...$){return(_,W)=>{if(W){let Q=`${_.constructor.name}:${String(W)}`;$.forEach((X)=>Z.registerHandler("middleware",Q,X))}else $.forEach((Y)=>Z.registerController("middleware",_,Y))}}function JW(...$){return(_,W)=>{if(W){let Q=`${_.constructor.name}:${String(W)}`;$.forEach((X)=>Z.registerHandler("pipe",Q,X))}else $.forEach((Y)=>Z.registerController("pipe",_,Y))}}export{x$ as stripEndSlash,y as normalizePath,K$ as isUndefined,M$ as isSymbol,v as isString,w$ as isPlainObject,O as isObject,R$ as isNumber,T as isNil,p as isFunction,C$ as isEmpty,s as isConstructor,j as createParamDecorator,k as createHttpMethodDecorator,b as createErrorResponse,f$ as addLeadingSlash,b_ as View,c_ as Variable,d_ as Var,h as VERSION_NEUTRAL,JW as UsePipes,QW as UseMiddleware,_W as UseGuards,t_ as UseFilters,a_ as UseComponent,s_ as Service,M as RouteRegistry,h_ as Response,g_ as Res,y_ as Request,v_ as Req,x_ as Query,E_ as Put,F_ as Post,A_ as Patch,f_ as Param,K_ as Page,k_ as Options,I as NotFoundHandler,w_ as MvcModule,o as Module,Z as MetadataRegistry,B_ as Layout,I_ as Header,a as Get,x as ErrorHandler,V_ as Delete,m_ as Ctx,n as Controller,u_ as Context,f as Container,M_ as Body,C as ApplicationContext,l as Application,O_ as All};

package/dist/interfaces/di-container.interface.d.ts

@@ -21,4 +21,15 @@ export interface DiContainer {
      * @throws {Error} If registration fails
      */
     register<T>(target: Constructor<T>, instance: T): void;
+    /**
+     * Checks whether the container already holds an instance for the given class
+     * @param target - The class constructor to check
+     * @returns true if an instance has been resolved or registered
+     */
+    has<T>(target: Constructor<T>): boolean;
+    /**
+     * Removes all cached instances from the container
+     * Useful for resetting state between tests
+     */
+    clear(): void;
 }

package/dist/interfaces/route-definition.interface.d.ts

@@ -1,5 +1,4 @@
 import type { VERSION_NEUTRAL } from '../constants';
-import type { ParameterMetadata } from '../interfaces';
 /**
  * Internal metadata for defining a route. This interface is used by the framework
  * to store route information collected from decorators.
@@ -30,11 +29,6 @@ export interface RouteDefinition {
      * Name of the method in the controller class that handles this route
      */
     handlerName: string | symbol;
-    /**
-     * Metadata about the parameters of the handler method,
-     * including decorators like @Body(), @Param(), @Query(), etc.
-     */
-    parameterMetadata: ParameterMetadata[];
     /**
      * Route-specific API version, overrides controller and global version.
      *

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

@@ -1,143 +1,46 @@
 import type { Context, Next } from 'hono';
-import type { ArgumentMetadata, DiContainer, GuardType, IGuard, IPipe, MiddlewareType, PipeType } from '../interfaces';
+import type { ArgumentMetadata, DiContainer, FilterType, GuardType, IGuard, IPipe, MiddlewareType, PipeType } from '../interfaces';
 import { type ComponentType, type ComponentTypeMap } from '../registries';
 import type { Constructor } from '../types';
 /**
- * Manager class for handling all component types in the Honest framework
- * Provides unified management of middleware, guards, pipes, and filters
- * Handles component registration, resolution, and execution at global, controller, and handler levels
- * Works with the dependency injection container to resolve component instances
+ * Manager class for handling all component types in the Honest framework.
+ *
+ * Each Application instance owns a ComponentManager, which holds per-app
+ * global components and a reference to the DI container. Controller-level
+ * and handler-level components remain in MetadataRegistry (static, set at
+ * class-definition time by decorators).
  */
 export declare class ComponentManager {
-    private static container;
+    private readonly container;
+    private readonly globalComponents;
+    constructor(container: DiContainer);
     /**
-     * Initializes the ComponentManager with a dependency injection container
-     * Must be called before using any other ComponentManager methods
-     * @param container - The dependency injection container to use for resolving components
+     * Configures global components from application options.
      */
-    static init(container: DiContainer): void;
-    /**
-     * Configures global components from application options
-     * Global components are applied to all routes in the application
-     * @param options - Application options containing component configurations
-     * @param options.components - Optional component configuration object
-     * @param options.components.middleware - Optional array of global middleware
-     * @param options.components.guards - Optional array of global guards
-     * @param options.components.pipes - Optional array of global pipes
-     * @param options.components.filters - Optional array of global filters
-     */
-    static setupGlobalComponents(options: {
+    setupGlobalComponents(options: {
         components?: {
-            middleware?: any[];
-            guards?: any[];
-            pipes?: any[];
-            filters?: any[];
+            middleware?: MiddlewareType[];
+            guards?: GuardType[];
+            pipes?: PipeType[];
+            filters?: FilterType[];
         };
     }): void;
-    /**
-     * Registers a component at the global level
-     * @param type - The type of component to register
-     * @param components - The component classes or instances to register
-     */
-    static registerGlobal<T extends ComponentType>(type: T, ...components: ComponentTypeMap[T][]): void;
-    /**
-     * Registers a component at the controller level
-     * @param type - The type of component to register
-     * @param controller - The controller class to register the component for
-     * @param components - The component classes or instances to register
-     */
-    static registerController<T extends ComponentType>(type: T, controller: Constructor, ...components: ComponentTypeMap[T][]): void;
-    /**
-     * Registers a component at the handler level
-     * @param type - The type of component to register
-     * @param controller - The controller class
-     * @param handlerName - The handler method name
-     * @param components - The component classes or instances to register
-     */
-    static registerHandler<T extends ComponentType>(type: T, controller: Constructor, handlerName: string | symbol, ...components: ComponentTypeMap[T][]): void;
-    /**
-     * Gets all components of a specific type for a handler
-     * @param type - The type of component to get
-     * @param controller - The controller class
-     * @param handlerName - The handler method name
-     * @returns An array of component instances
-     */
-    static getComponents<T extends ComponentType>(type: T, controller: Constructor, handlerName: string | symbol): ComponentTypeMap[T][];
-    /**
-     * Resolves middleware classes or instances to middleware functions
-     * @param middlewareItems - The middleware classes or instances to resolve
-     * @returns An array of middleware functions
-     */
-    static resolveMiddleware(middlewareItems: MiddlewareType[]): ((c: Context, next: Next) => Promise<Response | void>)[];
-    /**
-     * Gets middleware for a specific handler
-     * @param controller - The controller class
-     * @param handlerName - The handler method name
-     * @returns An array of middleware functions
-     */
-    static getHandlerMiddleware(controller: Constructor, handlerName: string | symbol): ((c: Context, next: Next) => Promise<Response | void>)[];
-    /**
-     * Gets global middleware
-     * @returns An array of middleware functions
-     */
-    static getGlobalMiddleware(): ((c: Context, next: Next) => Promise<Response | void>)[];
-    /**
-     * Resolves guard classes or instances to guard instances
-     * @param guardItems - The guard classes or instances to resolve
-     * @returns An array of guard instances
-     */
-    static resolveGuards(guardItems: GuardType[]): IGuard[];
-    /**
-     * Gets guards for a specific handler
-     * @param controller - The controller class
-     * @param handlerName - The handler method name
-     * @returns An array of guard instances
-     */
-    static getHandlerGuards(controller: Constructor, handlerName: string | symbol): IGuard[];
-    /**
-     * Resolves pipe classes or instances to pipe instances
-     * @param pipeItems - The pipe classes or instances to resolve
-     * @returns An array of pipe instances
-     */
-    static resolvePipes(pipeItems: PipeType[]): IPipe[];
-    /**
-     * Gets pipes for a specific handler
-     * @param controller - The controller class
-     * @param handlerName - The handler method name
-     * @returns An array of pipe instances
-     */
-    static getHandlerPipes(controller: Constructor, handlerName: string | symbol): IPipe[];
-    /**
-     * Executes a series of pipes on a value
-     * Pipes are executed in sequence, with each pipe's output feeding into the next pipe
-     * @param value - The initial value to transform
-     * @param metadata - Metadata about the parameter being transformed
-     * @param pipes - Array of pipes to execute
-     * @returns The final transformed value after all pipes have executed
-     * @throws {Error} If any pipe transformation fails
-     */
-    static executePipes(value: any, metadata: ArgumentMetadata, pipes: IPipe[]): Promise<any>;
-    /**
-     * Handles an exception by passing it through registered exception filters
-     * Filters are executed in sequence until one returns a response
-     * @param exception - The error to handle
-     * @param context - The Hono context object
-     * @returns A Response object if a filter handles the exception, undefined otherwise
-     */
-    static handleException(exception: Error, context: Context): Promise<Response | undefined>;
-    /**
-     * Executes a list of exception filters
-     * @param filterItems - The exception filter classes or instances to execute
-     * @param exception - The exception that was thrown
-     * @param context - The Hono context object
-     * @returns The response from the first filter that handles the exception or undefined if no filter handled it
-     */
-    private static executeFilters;
-    /**
-     * Registers a module and its dependencies with the container
-     * @param moduleClass - The module class to register
-     * @param container - The dependency injection container
-     * @returns An array of controller classes registered from this module
-     */
-    static registerModule(moduleClass: Constructor, container: DiContainer): Promise<Constructor[]>;
+    registerGlobal<T extends ComponentType>(type: T, ...components: ComponentTypeMap[T][]): void;
+    getGlobal<T extends ComponentType>(type: T): Set<ComponentTypeMap[T]>;
+    /**
+     * Gets all components of a specific type for a handler.
+     * Merges: instance global → static controller → static handler.
+     */
+    getComponents<T extends ComponentType>(type: T, controller: Constructor, handlerName: string | symbol): ComponentTypeMap[T][];
+    resolveMiddleware(middlewareItems: MiddlewareType[]): ((c: Context, next: Next) => Promise<Response | void>)[];
+    getHandlerMiddleware(controller: Constructor, handlerName: string | symbol): ((c: Context, next: Next) => Promise<Response | void>)[];
+    getGlobalMiddleware(): ((c: Context, next: Next) => Promise<Response | void>)[];
+    resolveGuards(guardItems: GuardType[]): IGuard[];
+    getHandlerGuards(controller: Constructor, handlerName: string | symbol): IGuard[];
+    resolvePipes(pipeItems: PipeType[]): IPipe[];
+    getHandlerPipes(controller: Constructor, handlerName: string | symbol): IPipe[];
+    executePipes(value: any, metadata: ArgumentMetadata, pipes: IPipe[]): Promise<any>;
+    handleException(exception: Error, context: Context): Promise<Response | undefined>;
+    private executeFilters;
+    registerModule(moduleClass: Constructor, registered?: Set<Constructor>): Promise<Constructor[]>;
 }

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

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

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

@@ -1,109 +1,31 @@
 import type { Hono } from 'hono';
 import { VERSION_NEUTRAL } from '../constants';
 import type { DiContainer } from '../interfaces';
+import { ComponentManager } from './component.manager';
+import { RouteRegistry } from '../registries/route.registry';
 import type { Constructor } from '../types';
 /**
- * Manager class for handling route registration in the Honest framework
- * Responsible for:
- * - Registering controller routes with the Hono application
- * - Managing route versioning and prefixing
- * - Applying middleware and guards to routes
- * - Handling parameter transformation and validation
+ * Manager class for handling route registration in the Honest framework.
  *
- * Versioning features:
- * - Global version setting can be overridden at controller or method level
- * - Controllers can opt out of versioning by setting version to null
- * - Routes can use VERSION_NEUTRAL to be accessible with and without version prefix
- * - Routes can specify an array of versions to support multiple versions
- *
- * Path handling:
- * - Global prefix can be overridden at controller level
- * - Paths are automatically normalized
- * - Final path structure: prefix/version/controller-path/method-path
+ * Receives all per-app dependencies (Hono, Container, RouteRegistry,
+ * ComponentManager) via constructor — no static state.
  */
 export declare class RouteManager {
     private hono;
     private container;
+    private routeRegistry;
+    private componentManager;
     private globalPrefix?;
     private globalVersion?;
-    /**
-     * Creates a new RouteManager instance
-     * @param hono - The Hono application instance for route registration
-     * @param container - The dependency injection container for resolving controllers and dependencies
-     * @param options - Configuration options for the route manager
-     * @param options.prefix - Optional global prefix for all routes
-     * @param options.version - Optional global version or version array for all routes
-     */
-    constructor(hono: Hono, container: DiContainer, options?: {
+    constructor(hono: Hono, container: DiContainer, routeRegistry: RouteRegistry, componentManager: ComponentManager, options?: {
         prefix?: string;
         version?: number | typeof VERSION_NEUTRAL | number[];
     });
-    /**
-     * Applies global middleware to the application
-     */
     private applyGlobalMiddleware;
-    /**
-     * Normalizes a path segment for route registration
-     * @param path - The path segment to normalize
-     * @returns The normalized path segment
-     */
     private normalizePath;
-    /**
-     * Registers a wrapper handler with middleware for a route
-     * @param method - HTTP method
-     * @param path - Full path for the route
-     * @param handlerMiddleware - Middleware for the handler
-     * @param wrapperHandler - The wrapper handler function
-     */
     private registerRouteHandler;
-    /**
-     * Builds a route path with the correct order: prefix, version, controller path, method path
-     * @param prefix - Global or controller-specific prefix
-     * @param version - Version string (e.g., '/v1') or empty string if no version
-     * @param controllerPath - Controller path
-     * @param methodPath - Method-specific path
-     * @returns Properly formatted full path
-     */
     private buildRoutePath;
-    /**
-     * Formats a version number or VERSION_NEUTRAL into a path segment
-     * @param version - Version number or VERSION_NEUTRAL
-     * @returns Formatted version string (e.g., '/v1') or empty string if null
-     */
     private formatVersionSegment;
-    /**
-     * Registers a controller and all its routes with the application
-     * Handles versioning, prefixing, and middleware application
-     *
-     * @param controllerClass - The controller class to register
-     * @throws {Error} If controller registration fails or if required dependencies cannot be resolved
-     *
-     * Route registration process:
-     * 1. Resolves controller instance and metadata
-     * 2. Processes controller-level options (prefix, version)
-     * 3. Registers each route with appropriate:
-     *    - Path construction (prefix/version/controller-path/method-path)
-     *    - Middleware application
-     *    - Parameter processing
-     *    - Guard validation
-     */
     registerController(controllerClass: Constructor): Promise<void>;
-    /**
-     * Registers a specific route with the application
-     * Handles middleware setup, parameter processing, and response handling
-     *
-     * @param controllerInstance - Instance of the controller containing the route handler
-     * @param route - Route metadata including path and HTTP method
-     * @param parameterMetadata - Metadata for parameter processing
-     * @param contextIndices - Map of context parameter indices
-     * @param controllerClass - The controller class
-     * @param prefix - Route prefix
-     * @param versionSegment - Version segment of the path
-     * @param controllerSegment - Controller path segment
-     * @param methodSegment - Method-specific path segment
-     * @param method - HTTP method for the route
-     *
-     * @throws {Error} If route registration fails
-     */
     private registerRoute;
 }

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

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

package/dist/pipeline.integration.test.d.ts

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

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

@@ -1,19 +1,7 @@
 import type { ControllerOptions, FilterType, GuardType, MiddlewareType, ModuleOptions, ParameterMetadata, PipeType, RouteDefinition } from '../interfaces';
 import type { Constructor } from '../types';
-/**
- * Available component types that can be registered at different levels in the application
- * Each type corresponds to a specific aspect of request processing
- */
 export type ComponentType = 'middleware' | 'guard' | 'pipe' | 'filter';
-/**
- * Union type of all possible component instances
- * Represents any type of component that can be registered in the application
- */
 export type ComponentInstance = MiddlewareType | GuardType | PipeType | FilterType;
-/**
- * Maps component type identifiers to their specific instance types
- * Used for type-safe component registration and retrieval
- */
 export interface ComponentTypeMap {
     middleware: MiddlewareType;
     guard: GuardType;
@@ -64,11 +52,6 @@ export declare class MetadataRegistry {
      * Used for optimizing context injection
      */
     private static readonly contextIndices;
-    /**
-     * Registry for global-level components
-     * Components registered here apply to all routes
-     */
-    private static readonly global;
     /**
      * Registry for controller-level components
      * Components registered here apply to all routes in a specific controller
@@ -149,14 +132,6 @@ export declare class MetadataRegistry {
      * Set context indices
      */
     static setContextIndices(controller: Constructor, indices: Map<string | symbol, number>): void;
-    /**
-     * Register a component at the global level
-     */
-    static registerGlobal<T extends ComponentType>(type: T, component: ComponentTypeMap[T]): void;
-    /**
-     * Get all global components of a specific type
-     */
-    static getGlobal<T extends ComponentType>(type: T): Set<ComponentTypeMap[T]>;
     /**
      * Register a component at the controller level
      */
@@ -174,9 +149,8 @@ export declare class MetadataRegistry {
      */
     static getHandler<T extends ComponentType>(type: T, handlerKey: string): ComponentTypeMap[T][];
     /**
-     * Clears all registered metadata from the registry
-     * Primarily used for testing and development purposes
-     * Use with caution in production environments
+     * Clears all registered decorator metadata.
+     * Primarily used for testing.
      */
     static clear(): void;
 }

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

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

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

@@ -1,63 +1,16 @@
 import type { RouteInfo } from '../interfaces';
 /**
- * Registry for managing and querying route information in the application
+ * Registry for managing and querying route information in the application.
  *
- * Provides functionality to:
- * - Register new routes with their metadata
- * - Query routes by various criteria (controller, method, path)
- * - Access route information for documentation and debugging
- * - Manage route lifecycle (registration and cleanup)
- *
- * The registry maintains a read-only view of routes to prevent unintended modifications
+ * Each Application instance owns its own RouteRegistry, ensuring routes
+ * from one app never leak into another.
  */
 export declare class RouteRegistry {
-    /**
-     * Internal storage for registered routes
-     * Maintains the complete list of routes in registration order
-     */
-    private static readonly routes;
-    /**
-     * Registers a new route in the application
-     * @param routeInfo - Complete route information including path, method, and handler details
-     * @throws {Error} If the route information is invalid or incomplete
-     */
-    static registerRoute(routeInfo: RouteInfo): void;
-    /**
-     * Retrieves all registered routes in the application
-     * @returns A read-only array of all route information
-     * Routes are returned in their registration order
-     */
-    static getRoutes(): ReadonlyArray<RouteInfo>;
-    /**
-     * Retrieves all routes registered for a specific controller
-     * @param controllerName - Name or symbol identifying the controller
-     * @returns A read-only array of routes belonging to the specified controller
-     * Returns an empty array if no routes are found for the controller
-     */
-    static getRoutesByController(controllerName: string | symbol): ReadonlyArray<RouteInfo>;
-    /**
-     * Retrieves all routes registered for a specific HTTP method
-     * @param method - HTTP method to filter by (case-insensitive)
-     * @returns A read-only array of routes handling the specified HTTP method
-     * Returns an empty array if no routes are found for the method
-     */
-    static getRoutesByMethod(method: string): ReadonlyArray<RouteInfo>;
-    /**
-     * Retrieves routes matching a specific path pattern
-     * @param pattern - Regular expression to match against route paths
-     * @returns A read-only array of routes whose paths match the pattern
-     * Returns an empty array if no matching routes are found
-     * @example
-     * ```ts
-     * // Find all routes containing 'users'
-     * const userRoutes = RouteRegistry.getRoutesByPath(/users/);
-     * ```
-     */
-    static getRoutesByPath(pattern: RegExp): ReadonlyArray<RouteInfo>;
-    /**
-     * Removes all registered routes from the registry
-     * Primarily used for testing and development purposes
-     * Use with caution in production environments
-     */
-    static clear(): void;
+    private readonly routes;
+    registerRoute(routeInfo: RouteInfo): void;
+    getRoutes(): ReadonlyArray<RouteInfo>;
+    getRoutesByController(controllerName: string | symbol): ReadonlyArray<RouteInfo>;
+    getRoutesByMethod(method: string): ReadonlyArray<RouteInfo>;
+    getRoutesByPath(pattern: RegExp): ReadonlyArray<RouteInfo>;
+    clear(): void;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "honestjs",
 	"description": "HonestJS - a modern web framework built on top of Hono",
-	"version": "0.1.11",
+	"version": "0.1.12",
 	"author": "Orkhan Karimov <karimovok1@gmail.com> (https://github.com/kerimovok)",
 	"repository": {
 		"type": "git",
@@ -12,15 +12,15 @@
 	"type": "module",
 	"types": "dist/index.d.ts",
 	"devDependencies": {
-		"@eslint/js": "^9.39.3",
-		"@types/bun": "^1.3.9",
-		"eslint": "^9.39.3",
+		"@eslint/js": "^9.39.4",
+		"@types/bun": "^1.3.10",
+		"eslint": "^9.39.4",
 		"eslint-config-prettier": "^10.1.8",
 		"globals": "^16.5.0",
 		"husky": "^9.1.7",
-		"lint-staged": "^16.3.0",
+		"lint-staged": "^16.4.0",
 		"prettier": "3.6.2",
-		"typescript-eslint": "^8.56.1"
+		"typescript-eslint": "^8.57.0"
 	},
 	"peerDependencies": {
 		"hono": "^4.8.5",