honestjs 0.1.7 → 0.1.9

package/README.md

@@ -61,7 +61,7 @@ ultra-fast performance of Hono, giving you the best of both worlds.
 
 > ⚠️ **Documentation is not yet complete** ⚠️
 >
-> If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.
+> If you find any issues or have suggestions for improvements, please open an issue or submit a pull request. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to contribute and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for community guidelines.
 
 ## Features
 

package/dist/application-context.d.ts

@@ -0,0 +1,13 @@
+import type { IApplicationContext } from './interfaces';
+/**
+ * Map-backed implementation of the app-level registry.
+ * Used by Application so the app (bootstrap, services, any code with `app`) can share pipeline data by key.
+ */
+export declare class ApplicationContext implements IApplicationContext {
+    private readonly store;
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    keys(): IterableIterator<string>;
+}

package/dist/application-context.test.d.ts

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

package/dist/application.d.ts

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import type { HonestOptions, RouteInfo } from './interfaces';
+import type { HonestOptions, IApplicationContext, RouteInfo } from './interfaces';
 import type { Constructor } from './types';
 /**
  * Main application class for the Honest framework
@@ -23,6 +23,7 @@ import type { Constructor } from './types';
 export declare class Application {
     private readonly hono;
     private readonly container;
+    private readonly context;
     private readonly routeManager;
     private readonly options;
     /**
@@ -56,6 +57,13 @@ export declare class Application {
      * @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
@@ -109,6 +117,18 @@ export declare class Application {
      * ```
      */
     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

package/dist/application.test.d.ts

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

package/dist/di/container.test.d.ts

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

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import 'reflect-metadata';
 export * from './application';
+export * from './application-context';
 export * from './components';
 export * from './constants';
 export * from './decorators';

package/dist/index.js

@@ -1,22 +1,22 @@
-import"reflect-metadata";import{Hono as o}from"hono";class M{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 Y=(Reflect.getMetadata("design:paramtypes",$)||[]).map((Q)=>{return this.resolve(Q,new Set(_))}),q=new $(...Y);return this.instances.set($,q),q}register($,_){this.instances.set($,_)}}import{HTTPException as a}from"hono/http-exception";function K($,_,W){let Y=new Date().toISOString(),q=_.get("requestId"),Q=_.req.path;if($ instanceof a)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 z=$.statusCode||$.status,G=W?.status||z;return{response:{status:G,message:W?.title||$.message,timestamp:Y,path:Q,requestId:q,code:W?.code||$.name,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:G}}let J=W?.status||500;return{response:{status:J,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:J}}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 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 S{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");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 b($){return(_="",W={})=>{return(Y,q,Q)=>{let J=Y.constructor;X.addRoute(J,{path:_,method:$,handlerName:q,parameterMetadata:[],version:W.version,prefix:W.prefix})}}}function k($,_){return(W)=>{return(Y,q,Q)=>{let J=Y.constructor;if(!X.getParameters(J).size)X.setParameterMap(J,new Map);let A=X.getParameters(J);if(!A.has(q))A.set(q,[]);let G=Reflect.getMetadata("design:paramtypes",Y,q)?.[Q];if(A.get(q).push({index:Q,name:$,data:W,factory:_,metatype:G}),$==="context"){if(!X.getContextIndices(J).size)X.setContextIndices(J,new Map);X.getContextIndices(J).set(q,Q)}}}}class x{static handle(){return async($,_)=>{let{response:W,status:Y}=K($,_);return _.json(W,Y)}}}class C{static handle(){return async($)=>{return $.json({message:`Not Found - ${$.req.path}`},404)}}}var O$=($)=>typeof $>"u",O=($)=>$===null||typeof $>"u",V=($)=>$!==null&&typeof $==="object",T$=($)=>{if(!V($))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)},d=($)=>typeof $==="function",I=($)=>typeof $==="string",S$=($)=>typeof $==="number",N$=($)=>$.length===0,w$=($)=>typeof $==="symbol",P$=($)=>typeof $==="string"?$.charAt(0)!=="/"?"/"+$:$:"",v=($)=>$?$.startsWith("/")?("/"+$.replace(/\/+$/,"")).replace(/\/+/g,"/"):"/"+$.replace(/\/+$/,""):"/",R$=($)=>$.endsWith("/")?$.slice(0,-1):$,c=($)=>{return d($)&&!O($.prototype)&&!d($.prototype)&&Object.getOwnPropertyNames($.prototype).length>1};class Z{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(V(_)&&"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(V(_)&&"canActivate"in _)return _;return this.container.resolve(_)})}static getHandlerGuards($,_){let W=this.getComponents("guard",$,_);return this.resolveGuards(W)}static resolvePipes($){return $.map((_)=>{if(V(_)&&"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 A=X.getHandler("filter",`${W.name}:${Y}`);if(A.length>0){let z=await this.executeFilters(A,$,_);if(z)return z}}if(W){let A=X.getController("filter",W);if(A.length>0){let z=await this.executeFilters(A,$,_);if(z)return z}}let q=Array.from(X.getGlobal("filter"));if(q.length>0){let A=await this.executeFilters(q,$,_);if(A)return A}let{response:Q,status:J}=K($,_);return _.json(Q,J)}static async executeFilters($,_,W){for(let Y of $){let q;if(V(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 r}from"hono/http-exception";var y=Symbol("VERSION_NEUTRAL");class h{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 $=Z.getGlobalMiddleware();for(let _ of $)this.hono.use("*",_)}normalizePath($){if(I($))return v($);return $?`/${$}`:""}registerRouteHandler($,_,W,Y){if(W.length>0)this.hono.on($.toUpperCase(),_,...W,Y);else this.hono.on($.toUpperCase(),_,Y)}buildRoutePath($,_,W,Y){return v(`${$}${_}${W}${Y}`)}formatVersionSegment($){if(O($))return"";return $===y?"":`/v${String($)}`}async registerController($){let _=X.getControllerPath($)||"",W=X.getControllerOptions($)||{},Y=X.getRoutes($)||[],q=X.getParameters($)||new Map,Q=X.getContextIndices($)||new Map,J=this.normalizePath(_),A=this.container.resolve($),z=W.prefix!==void 0?W.prefix:this.globalPrefix,G=W.version!==void 0?W.version:this.globalVersion;for(let U of Y){let{path:T,method:E,handlerName:f,version:N,prefix:w}=U,P=w!==void 0?w:z,D=!O(P)?this.normalizePath(P):"",L=N!==void 0?N:G,F=this.normalizePath(T);if(O(L)){this.registerRoute(A,U,q,Q,$,D,"",J,F,E);continue}if(L===y){this.registerRoute(A,U,q,Q,$,D,"",J,F,E),this.registerRoute(A,U,q,Q,$,D,"/:version{v[0-9]+}",J,F,E);continue}if(Array.isArray(L)){for(let H of L){let j=this.formatVersionSegment(H);this.registerRoute(A,U,q,Q,$,D,j,J,F,E)}continue}let R=this.formatVersionSegment(L);this.registerRoute(A,U,q,Q,$,D,R,J,F,E)}}registerRoute($,_,W,Y,q,Q,J,A,z,G){let{handlerName:U}=_,T=this.buildRoutePath(Q,J,A,z),E=$[U].bind($),f=W.get(U)||[],N=Y.get(U),w=Z.getHandlerMiddleware(q,U),P=Z.getHandlerPipes(q,U);S.registerRoute({controller:q.name,handler:U,method:G,prefix:Q,version:J,route:A,path:z,fullPath:T,parameters:f});let D=async(L)=>{try{L.set("controllerClass",q),L.set("handlerName",String(U));let F=Z.getHandlerGuards(q,U);for(let j of F)if(!await j.canActivate(L))throw new r(403,{message:"Forbidden"});let R=Array(E.length);for(let j of f){let m=j.factory(j.data,L),n=await Z.executePipes(m,{type:j.name,metatype:j.metatype,data:j.data},P);R[j.index]=n}let H=await E(...R);if(N!==void 0)return H;if(O(H))return L.json(null);if(I(H))return L.text(H);return L.json(H)}catch(F){return Z.handleException(F,L)}};this.registerRouteHandler(G,T,w,D)}}class i{hono;container;routeManager;options;constructor($={}){this.options=V($)?$:{},this.hono=new o(this.options.hono),this.container=this.options.container||new M,this.setupComponents(),this.setupErrorHandlers(),this.routeManager=new h(this.hono,this.container,{prefix:this.options.routing?.prefix,version:this.options.routing?.version})}setupComponents(){Z.init(this.container),Z.setupGlobalComponents(this.options)}setupErrorHandlers(){this.hono.notFound(this.options.notFound||C.handle()),this.hono.onError(this.options.onError||x.handle())}resolvePlugin($){if(c($))return new $;return $}async register($){let _=await Z.registerModule($,this.container);for(let W of _)await this.routeManager.registerController(W);return this}static async create($,_={}){let W=new i(_),Y=(_.plugins||[]).map((q)=>W.resolvePlugin(q));for(let q of Y)if(q.beforeModulesRegistered)await q.beforeModulesRegistered(W,W.hono);await W.register($);for(let q of Y)if(q.afterModulesRegistered)await q.afterModulesRegistered(W,W.hono);return{app:W,hono:W.getApp()}}getApp(){return this.hono}getRoutes(){return S.getRoutes()}}import{html as B,raw as g}from"hono/html";var t={type:"website",locale:"en_US"},u=($)=>{if(!$)return"";return Object.entries($).map(([_,W])=>{if(typeof W==="boolean")return W?_:"";let Y=String(W).replace(/"/g,""");return`${_}="${Y}"`}).filter(Boolean).join(" ")},Y_=($)=>{let _={...t,...$};return B`
+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 Y=(Reflect.getMetadata("design:paramtypes",$)||[]).map((Q)=>{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 K($,_,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,E=W?.status||L;return{response:{status:E,message:W?.title||$.message,timestamp:Y,path:Q,requestId:q,code:W?.code||$.name,details:W?.additionalDetails,...W?.detail&&{detail:W.detail}},status:E}}let Z=W?.status||500;return{response:{status:Z,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:Z}}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 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 S{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");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 k($){return(_="",W={})=>{return(Y,q,Q)=>{let Z=Y.constructor;X.addRoute(Z,{path:_,method:$,handlerName:q,parameterMetadata:[],version:W.version,prefix:W.prefix})}}}function G($,_){return(W)=>{return(Y,q,Q)=>{let Z=Y.constructor;if(!X.getParameters(Z).size)X.setParameterMap(Z,new Map);let B=X.getParameters(Z);if(!B.has(q))B.set(q,[]);let E=Reflect.getMetadata("design:paramtypes",Y,q)?.[Q];if(B.get(q).push({index:Q,name:$,data:W,factory:_,metatype:E}),$==="context"){if(!X.getContextIndices(Z).size)X.setContextIndices(Z,new Map);X.getContextIndices(Z).set(q,Q)}}}}class x{static handle(){return async($,_)=>{let{response:W,status:Y}=K($,_);return _.json(W,Y)}}}class I{static handle(){return async($)=>{return $.json({message:`Not Found - ${$.req.path}`},404)}}}var S$=($)=>typeof $>"u",b=($)=>$===null||typeof $>"u",D=($)=>$!==null&&typeof $==="object",N$=($)=>{if(!D($))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,R$=($)=>typeof $==="symbol",K$=($)=>typeof $==="string"?$.charAt(0)!=="/"?"/"+$:$:"",y=($)=>$?$.startsWith("/")?("/"+$.replace(/\/+$/,"")).replace(/\/+/g,"/"):"/"+$.replace(/\/+$/,""):"/",f$=($)=>$.endsWith("/")?$.slice(0,-1):$,c=($)=>{return i($)&&!b($.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(D(_)&&"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(D(_)&&"canActivate"in _)return _;return this.container.resolve(_)})}static getHandlerGuards($,_){let W=this.getComponents("guard",$,_);return this.resolveGuards(W)}static resolvePipes($){return $.map((_)=>{if(D(_)&&"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 B=X.getHandler("filter",`${W.name}:${Y}`);if(B.length>0){let L=await this.executeFilters(B,$,_);if(L)return L}}if(W){let B=X.getController("filter",W);if(B.length>0){let L=await this.executeFilters(B,$,_);if(L)return L}}let q=Array.from(X.getGlobal("filter"));if(q.length>0){let B=await this.executeFilters(q,$,_);if(B)return B}let{response:Q,status:Z}=K($,_);return _.json(Q,Z)}static async executeFilters($,_,W){for(let Y of $){let q;if(D(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 g=Symbol("VERSION_NEUTRAL");class h{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(b($))return"";return $===g?"":`/v${String($)}`}async registerController($){let _=X.getControllerPath($)||"",W=X.getControllerOptions($)||{},Y=X.getRoutes($)||[],q=X.getParameters($)||new Map,Q=X.getContextIndices($)||new Map,Z=this.normalizePath(_),B=this.container.resolve($),L=W.prefix!==void 0?W.prefix:this.globalPrefix,E=W.version!==void 0?W.version:this.globalVersion;for(let A of Y){let{path:T,method:V,handlerName:f,version:N,prefix:w}=A,P=w!==void 0?w:L,H=!b(P)?this.normalizePath(P):"",U=N!==void 0?N:E,j=this.normalizePath(T);if(b(U)){this.registerRoute(B,A,q,Q,$,H,"",Z,j,V);continue}if(U===g){this.registerRoute(B,A,q,Q,$,H,"",Z,j,V),this.registerRoute(B,A,q,Q,$,H,"/:version{v[0-9]+}",Z,j,V);continue}if(Array.isArray(U)){for(let O of U){let F=this.formatVersionSegment(O);this.registerRoute(B,A,q,Q,$,H,F,Z,j,V)}continue}let R=this.formatVersionSegment(U);this.registerRoute(B,A,q,Q,$,H,R,Z,j,V)}}registerRoute($,_,W,Y,q,Q,Z,B,L,E){let{handlerName:A}=_,T=this.buildRoutePath(Q,Z,B,L),V=$[A].bind($),f=W.get(A)||[],N=Y.get(A),w=J.getHandlerMiddleware(q,A),P=J.getHandlerPipes(q,A);S.registerRoute({controller:q.name,handler:A,method:E,prefix:Q,version:Z,route:B,path:L,fullPath:T,parameters:f});let H=async(U)=>{try{U.set("controllerClass",q),U.set("handlerName",String(A));let j=J.getHandlerGuards(q,A);for(let F of j)if(!await F.canActivate(U))throw new o(403,{message:"Forbidden"});let R=Array(V.length);for(let F of f){let d=F.factory(F.data,U),a=await J.executePipes(d,{type:F.name,metatype:F.metatype,data:F.data},P);R[F.index]=a}let O=await V(...R);if(N!==void 0)return O;if(b(O))return U.json(null);if(v(O))return U.text(O);return U.json(O)}catch(j){return J.handleException(j,U)}};this.registerRouteHandler(E,T,w,H)}}class p{hono;container;context;routeManager;options;constructor($={}){this.options=D($)?$:{},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 h(this.hono,this.container,{prefix:this.options.routing?.prefix,version:this.options.routing?.version})}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((Q)=>W.normalizePluginEntry(Q)),q=W.getContext();for(let{plugin:Q,preProcessors:Z}of Y){for(let B of Z)await B(W,W.hono,q);if(Q.beforeModulesRegistered)await Q.beforeModulesRegistered(W,W.hono)}await W.register($);for(let{plugin:Q,postProcessors:Z}of Y){if(Q.afterModulesRegistered)await Q.afterModulesRegistered(W,W.hono);for(let B of Z)await B(W,W.hono,q)}return{app:W,hono:W.getApp()}}getApp(){return this.hono}getContext(){return this.context}getRoutes(){return S.getRoutes()}}import{html as z,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 z`
 		<!DOCTYPE html>
-		<html lang="${_.locale?.split("_")[0]||"en"}" ${g(u(_.htmlAttributes))}>
-			<head ${g(u(_.headAttributes))}>
+		<html lang="${_.locale?.split("_")[0]||"en"}" ${u(m(_.htmlAttributes))}>
+			<head ${u(m(_.headAttributes))}>
 				<meta charset="UTF-8" />
 				<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-				${_.csp?B`<meta http-equiv="Content-Security-Policy" content="${_.csp}" />`:""}
+				${_.csp?z`<meta http-equiv="Content-Security-Policy" content="${_.csp}" />`:""}
 				<title>${_.title}</title>
-				${_.description?B`<meta name="description" content="${_.description}" />`:""}
+				${_.description?z`<meta name="description" content="${_.description}" />`:""}
 
 				<!-- Open Graph / Facebook -->
 				<meta prefix="og: http://ogp.me/ns#" />
 				<meta property="og:title" content="${_.title}" />
-				${_.description?B`<meta property="og:description" content="${_.description}" />`:""}
-				${_.image?B`<meta property="og:image" content="${_.image}" />`:""}
-				${_.url?B`<meta property="og:url" content="${_.url}" />`:""}
-				${_.locale?B`<meta property="og:locale" content="${_.locale}" />`:""}
-				${_.type?B`<meta property="og:type" content="${_.type}" />`:""}
-				${_.siteName?B`<meta property="og:site_name" content="${_.siteName}" />`:""}
+				${_.description?z`<meta property="og:description" content="${_.description}" />`:""}
+				${_.image?z`<meta property="og:image" content="${_.image}" />`:""}
+				${_.url?z`<meta property="og:url" content="${_.url}" />`:""}
+				${_.locale?z`<meta property="og:locale" content="${_.locale}" />`:""}
+				${_.type?z`<meta property="og:type" content="${_.type}" />`:""}
+				${_.siteName?z`<meta property="og:site_name" content="${_.siteName}" />`:""}
 
 				<!-- Twitter -->
 				<meta
@@ -24,23 +24,23 @@ import"reflect-metadata";import{Hono as o}from"hono";class M{instances=new Map;r
 					content="${_.twitterCard||(_.image?"summary_large_image":"summary")}"
 				/>
 				<meta name="twitter:title" content="${_.title}" />
-				${_.description?B`<meta name="twitter:description" content="${_.description}" />`:""}
-				${_.image?B`<meta name="twitter:image" content="${_.image}" />`:""}
+				${_.description?z`<meta name="twitter:description" content="${_.description}" />`:""}
+				${_.image?z`<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 B`<meta ${Y} ${q} content="${W.content}" />`}):""}
+				${_.customMeta?_.customMeta.map((W)=>{let Y=W.name?`name="${W.name}"`:"",q=W.property?`property="${W.property}"`:"";return z`<meta ${Y} ${q} content="${W.content}" />`}):""}
 
 				<!-- Favicon -->
-				${_.favicon?B`<link rel="icon" href="${_.favicon}" />`:""}
+				${_.favicon?z`<link rel="icon" href="${_.favicon}" />`:""}
 
 				<!-- Stylesheets -->
-				${_.stylesheets?_.stylesheets.map((W)=>B`<link rel="stylesheet" href="${W}" />`):""}
+				${_.stylesheets?_.stylesheets.map((W)=>z`<link rel="stylesheet" href="${W}" />`):""}
 
 				<!-- Scripts -->
-				${_.scripts?_.scripts.map((W)=>{if(typeof W==="string")return B`<script src="${W}"></script>`;let{src:Y,async:q,defer:Q}=W;if(q&&Q)return B`<script src="${Y}" async defer></script>`;if(q)return B`<script src="${Y}" async></script>`;if(Q)return B`<script src="${Y}" defer></script>`;return B`<script src="${Y}"></script>`}):""}
+				${_.scripts?_.scripts.map((W)=>{if(typeof W==="string")return z`<script src="${W}"></script>`;let{src:Y,async:q,defer:Q}=W;if(q&&Q)return z`<script src="${Y}" async defer></script>`;if(q)return z`<script src="${Y}" async></script>`;if(Q)return z`<script src="${Y}" defer></script>`;return z`<script src="${Y}"></script>`}):""}
 			</head>
-			<body ${g(u(_.bodyAttributes))}>
+			<body ${u(m(_.bodyAttributes))}>
 				${_.children}
 			</body>
 		</html>
-	`};function p($="",_={}){return(W)=>{X.setControllerPath(W,$),X.setControllerOptions(W,_)}}var s=b("get"),B_=b("post"),U_=b("put"),z_=b("delete"),L_=b("patch"),k_=b("options"),j_=b("all");function l($={}){return(_)=>{X.setModuleOptions(_,$)}}function H_($="",_={prefix:null,version:null}){return p($,_)}var O_=s;function T_($={}){return l({imports:$.imports,services:$.services,controllers:($.views||[]).concat($.controllers||[])})}var w_=k("body",async($,_)=>{let W=await _.req.json();return $?W[$]:W}),P_=k("param",($,_)=>{return $?_.req.param($):_.req.param()}),R_=k("query",($,_)=>{return $?_.req.query($):_.req.query()}),K_=k("header",($,_)=>{return $?_.req.header($):_.req.header()}),f_=k("request",($,_)=>_.req),M_=k("request",($,_)=>_.req),x_=k("response",($,_)=>_.res),C_=k("response",($,_)=>_.res),I_=k("context",($,_)=>_),v_=k("context",($,_)=>_),y_=k("variable",($,_)=>_.get($)),h_=k("variable",($,_)=>_.get($));function m_(){return($)=>{X.addService($)}}function i_($,..._){return(W,Y)=>{if(Y){let q=W.constructor;Z.registerHandler($,q,Y,..._)}else Z.registerController($,W,..._)}}function l_(...$){return(_,W)=>{if(W){let Y=_.constructor;Z.registerHandler("filter",Y,W,...$)}else Z.registerController("filter",_,...$)}}function r_(...$){return(_,W)=>{if(W){let Y=_.constructor;Z.registerHandler("guard",Y,W,...$)}else Z.registerController("guard",_,...$)}}function e_(...$){return(_,W)=>{if(W){let Y=_.constructor;Z.registerHandler("middleware",Y,W,...$)}else Z.registerController("middleware",_,...$)}}function WW(...$){return(_,W)=>{if(W){let Y=_.constructor;Z.registerHandler("pipe",Y,W,...$)}else Z.registerController("pipe",_,...$)}}export{R$ as stripEndSlash,v as normalizePath,O$ as isUndefined,w$ as isSymbol,I as isString,T$ as isPlainObject,V as isObject,S$ as isNumber,O as isNil,d as isFunction,N$ as isEmpty,c as isConstructor,k as createParamDecorator,b as createHttpMethodDecorator,K as createErrorResponse,P$ as addLeadingSlash,H_ as View,h_ as Variable,y_ as Var,y as VERSION_NEUTRAL,WW as UsePipes,e_ as UseMiddleware,r_ as UseGuards,l_ as UseFilters,i_ as UseComponent,m_ as Service,S as RouteRegistry,h as RouteManager,C_ as Response,x_ as Res,M_ as Request,f_ as Req,R_ as Query,U_ as Put,B_ as Post,L_ as Patch,P_ as Param,O_ as Page,k_ as Options,C as NotFoundHandler,T_ as MvcModule,l as Module,X as MetadataRegistry,Y_ as Layout,K_ as Header,s as Get,x as ErrorHandler,z_ as Delete,I_ as Ctx,p as Controller,v_ as Context,M as Container,Z as ComponentManager,w_ as Body,i as Application,j_ as All};
+	`};function s($="",_={}){return(W)=>{X.setControllerPath(W,$),X.setControllerOptions(W,_)}}var l=k("get"),U_=k("post"),G_=k("put"),F_=k("delete"),E_=k("patch"),j_=k("options"),V_=k("all");function n($={}){return(_)=>{X.setModuleOptions(_,$)}}function S_($="",_={prefix:null,version:null}){return s($,_)}var N_=l;function w_($={}){return n({imports:$.imports,services:$.services,controllers:($.views||[]).concat($.controllers||[])})}var K_=G("body",async($,_)=>{let W=await _.req.json();return $?W[$]:W}),f_=G("param",($,_)=>{return $?_.req.param($):_.req.param()}),M_=G("query",($,_)=>{return $?_.req.query($):_.req.query()}),C_=G("header",($,_)=>{return $?_.req.header($):_.req.header()}),x_=G("request",($,_)=>_.req),I_=G("request",($,_)=>_.req),v_=G("response",($,_)=>_.res),y_=G("response",($,_)=>_.res),g_=G("context",($,_)=>_),h_=G("context",($,_)=>_),u_=G("variable",($,_)=>_.get($)),m_=G("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,S$ as isUndefined,R$ as isSymbol,v as isString,N$ as isPlainObject,D as isObject,w$ as isNumber,b as isNil,i as isFunction,P$ as isEmpty,c as isConstructor,G as createParamDecorator,k as createHttpMethodDecorator,K as createErrorResponse,K$ as addLeadingSlash,S_ as View,m_ as Variable,u_ as Var,g as VERSION_NEUTRAL,QW as UsePipes,WW as UseMiddleware,e_ as UseGuards,r_ as UseFilters,l_ as UseComponent,c_ as Service,S as RouteRegistry,h as RouteManager,y_ as Response,v_ as Res,I_ as Request,x_ as Req,M_ as Query,G_ as Put,U_ as Post,E_ as Patch,f_ as Param,N_ 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,F_ as Delete,g_ as Ctx,s as Controller,h_ as Context,C as Container,J as ComponentManager,K_ as Body,M as ApplicationContext,p as Application,V_ as All};

package/dist/interfaces/application-context.interface.d.ts

@@ -0,0 +1,35 @@
+/**
+ * App-level registry where your application can publish and read pipeline data by key.
+ * Available to bootstrap code, services, and any code with access to `app`.
+ * Enables composition without hard coupling: producers and consumers use namespaced keys.
+ */
+export interface IApplicationContext {
+    /**
+     * Get a value by key. Caller provides type for type safety.
+     * @param key - Namespaced registry key (e.g. 'app.config', 'openapi.spec')
+     * @returns The value or undefined if not set
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set a value by key.
+     * @param key - Namespaced registry key
+     * @param value - Value to store
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * Check if a key is present.
+     * @param key - Registry key
+     * @returns true if the key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Remove a key and its value.
+     * @param key - Registry key
+     * @returns true if the key existed and was removed
+     */
+    delete(key: string): boolean;
+    /**
+     * Iterate over all registered keys.
+     */
+    keys(): IterableIterator<string>;
+}

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, MiddlewareType, PipeType, PluginType } from '../interfaces';
+import type { FilterType, GuardType, MiddlewareType, PipeType, PluginEntry } from '../interfaces';
 import type { DiContainer } from './di-container.interface';
 /**
  * Options for configuring the Honest application
@@ -64,9 +64,10 @@ export interface HonestOptions {
         filters?: FilterType[];
     };
     /**
-     * Plugins for extending the application functionality
+     * Plugins for extending the application functionality.
+     * Each entry can be a plain plugin or an object with plugin and optional pre/post processors.
      */
-    plugins?: PluginType[];
+    plugins?: PluginEntry[];
     /**
      * Default exception handler to use when no filter matches
      */

package/dist/interfaces/index.d.ts

@@ -1,3 +1,4 @@
+export * from './application-context.interface';
 export * from './controller-options.interface';
 export * from './di-container.interface';
 export * from './error-response.interface';

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

@@ -1,6 +1,21 @@
 import type { Hono } from 'hono';
 import type { Application } from '../application';
+import type { IApplicationContext } from './application-context.interface';
 import type { Constructor } from '../types';
+/**
+ * Processor callback for plugin pre/post hooks.
+ * Receives app, hono, and the application context (registry) for sharing pipeline data.
+ */
+export type PluginProcessor = (app: Application, hono: Hono, ctx: IApplicationContext) => void | Promise<void>;
+/**
+ * Object form of a plugin entry with optional pre/post processors.
+ * Processors run before (pre) or after (post) the plugin's lifecycle hooks.
+ */
+export interface PluginEntryObject {
+    plugin: IPlugin | Constructor<IPlugin>;
+    preProcessors?: PluginProcessor[];
+    postProcessors?: PluginProcessor[];
+}
 /**
  * Interface for Honest framework plugins
  * Plugins can extend the framework's functionality by hooking into
@@ -29,3 +44,9 @@ export interface IPlugin {
  * Can be either a class implementing IPlugin or an instance of IPlugin
  */
 export type PluginType = Constructor<IPlugin> | IPlugin;
+/**
+ * Plugin entry: either a plain plugin or an object wrapping a plugin with optional processors.
+ * Use the object form to attach preProcessors (run before lifecycle hooks) and postProcessors
+ * (run after). Processors receive (app, hono, ctx) where ctx is the application context.
+ */
+export type PluginEntry = PluginType | PluginEntryObject;

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

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

package/dist/utils/common.util.d.ts

@@ -98,11 +98,12 @@ export declare const normalizePath: (path?: string) => string;
  */
 export declare const stripEndSlash: (path: string) => string;
 /**
- * Checks if a value is a constructor function
+ * Checks if a value is a constructor function (callable with `new`).
  * A constructor function must:
  * - Be a function
- * - Have a prototype
- * - Have prototype properties beyond the default ones
+ * - Have a non-null prototype (excludes arrow functions, which have no prototype)
+ * - Have a prototype that is not a function (excludes rare edge cases)
+ * - Have at least the built-in 'constructor' on prototype (so empty classes are constructors)
  *
  * @param val - The value to check
  * @returns True if the value is a constructor function, false otherwise

package/dist/utils/common.util.test.d.ts

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

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "honestjs",
 	"description": "HonestJS - a modern web framework built on top of Hono",
-	"version": "0.1.7",
+	"version": "0.1.9",
 	"author": "Orkhan Karimov <karimovok1@gmail.com> (https://github.com/kerimovok)",
 	"repository": {
 		"type": "git",
@@ -51,6 +51,8 @@
 	"scripts": {
 		"clean": "rm -rf dist",
 		"prepare": "husky",
+		"test": "bun test",
+		"test:watch": "bun test --watch",
 		"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 .",