@venizia/ignis 0.0.1-3 → 0.0.1-4

package/dist/base/applications/types.d.ts

@@ -0,0 +1,95 @@
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type { Context, Env, Schema } from 'hono';
+import { IPRestrictionRules as IIPRestrictionRules } from 'hono/ip-restriction';
+import { IComponentMixin, IControllerMixin, IRepositoryMixin, IServiceMixin, IStaticServeMixin } from '../mixins/types';
+import { ValueOrPromise } from '@venizia/ignis-helpers';
+export interface IBaseMiddlewareOptions {
+    enable: boolean;
+    path?: string;
+    [extra: string | symbol]: any;
+}
+export interface ICompressOptions extends IBaseMiddlewareOptions {
+    encoding: 'gzip' | 'deflate';
+    threshold?: number;
+}
+export type TOrigin = string | string[] | ((origin: string, c: Context) => Promise<string | undefined | null> | string | undefined | null);
+export interface ICORSOptions extends IBaseMiddlewareOptions {
+    origin: TOrigin;
+    allowMethods?: string[] | ((origin: string, c: Context) => Promise<string[]> | string[]);
+    allowHeaders?: string[];
+    maxAge?: number;
+    credentials?: boolean;
+    exposeHeaders?: string[];
+}
+export type TIsAllowedOriginHandler = (origin: string, context: Context) => boolean;
+export declare const SecFetchSiteValues: readonly ["same-origin", "same-site", "none", "cross-site"];
+export type TSecFetchSite = (typeof SecFetchSiteValues)[number];
+export type TIsAllowedSecFetchSiteHandler = (secFetchSite: TSecFetchSite, context: Context) => boolean;
+export interface ICSRFOptions extends IBaseMiddlewareOptions {
+    origin?: string | string[] | TIsAllowedOriginHandler;
+    secFetchSite?: TSecFetchSite | TSecFetchSite[] | TIsAllowedSecFetchSiteHandler;
+}
+export interface IBodyLimitOptions extends IBaseMiddlewareOptions {
+    maxSize: number;
+    onError?: (c: Context) => Response | Promise<Response>;
+}
+export interface IRequestIdOptions extends IBaseMiddlewareOptions {
+}
+export type TBunServerInstance = ReturnType<typeof Bun.serve>;
+export type TNodeServerInstance = any;
+export interface IMiddlewareConfigs {
+    requestId?: IRequestIdOptions;
+    compress?: ICompressOptions;
+    cors?: ICORSOptions;
+    csrf?: ICSRFOptions;
+    bodyLimit?: IBodyLimitOptions;
+    ipRestriction?: IBaseMiddlewareOptions & IIPRestrictionRules;
+    [extra: string | symbol]: any;
+}
+export interface IApplicationConfigs {
+    host?: string;
+    port?: number;
+    path: {
+        base: string;
+        isStrict: boolean;
+    };
+    favicon?: string;
+    autoLoad?: {
+        dirs: {
+            [key: string | symbol]: {
+                path: string;
+            };
+        };
+    };
+    debug?: {
+        shouldShowRoutes?: boolean;
+    };
+    [key: string]: any;
+}
+export interface IApplicationInfo {
+    name: string;
+    version: string;
+    description: string;
+    author?: {
+        name: string;
+        email: string;
+        url?: string;
+    };
+    [extra: string | symbol]: any;
+}
+export interface IApplication<AppEnv extends Env = Env, AppSchema extends Schema = Schema, BasePath extends string = '/'> {
+    getProjectRoot(): string;
+    getProjectConfigs(): IApplicationConfigs;
+    getServerHost(): string;
+    getServerPort(): number;
+    getServerAddress(): string;
+    getServer(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    getRootRouter(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    setupMiddlewares(): ValueOrPromise<void>;
+    initialize(): ValueOrPromise<void>;
+    start(): ValueOrPromise<void>;
+    stop(): ValueOrPromise<void>;
+}
+export interface IRestApplication extends IApplication, IComponentMixin, IControllerMixin, IRepositoryMixin, IServiceMixin, IStaticServeMixin {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/base/applications/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/base/applications/types.ts"],"names":[],"mappings":"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"}

package/dist/base/applications/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecFetchSiteValues = void 0;
+exports.SecFetchSiteValues = ['same-origin', 'same-site', 'none', 'cross-site'];
+//# sourceMappingURL=types.js.map

package/dist/base/applications/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/base/applications/types.ts"],"names":[],"mappings":";;;AAoDa,QAAA,kBAAkB,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC"}

package/dist/base/components/base.d.ts

@@ -0,0 +1,23 @@
+import { BaseHelper, Binding, Container, IConfigurable, ValueOrPromise } from '@venizia/ignis-helpers';
+type TInitDefault = {
+    enable: false;
+} | {
+    enable: true;
+    container: Container;
+};
+export declare abstract class BaseComponent<ConfigurableOptions extends object = {}> extends BaseHelper implements IConfigurable<ConfigurableOptions> {
+    protected bindings: Record<string | symbol, Binding>;
+    protected initDefault: TInitDefault;
+    constructor(opts: {
+        scope: string;
+        initDefault?: TInitDefault;
+        bindings?: Record<string | symbol, Binding>;
+    });
+    abstract binding(): ValueOrPromise<void>;
+    protected initDefaultBindings(opts: {
+        container: Container;
+    }): void;
+    configure(opts?: ConfigurableOptions): Promise<void>;
+}
+export {};
+//# sourceMappingURL=base.d.ts.map

package/dist/base/components/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base/components/base.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EAET,aAAa,EACb,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC,KAAK,YAAY,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC;AAE/E,8BAAsB,aAAa,CAAC,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACzE,SAAQ,UACR,YAAW,aAAa,CAAC,mBAAmB,CAAC;IAE7C,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;IAErD,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC;gBAExB,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,YAAY,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C;IAOD,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAGxC,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE;IAmBtD,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAc3D"}

package/dist/base/components/base.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseComponent = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+class BaseComponent extends ignis_helpers_1.BaseHelper {
+    constructor(opts) {
+        super(opts);
+        this.initDefault = opts.initDefault ?? { enable: false };
+        this.bindings = opts.bindings ?? {};
+    }
+    // ------------------------------------------------------------------------------
+    initDefaultBindings(opts) {
+        const { container } = opts;
+        if (!container) {
+            throw (0, ignis_helpers_1.getError)({
+                message: '[initBindings] Invalid DI Container to init bindings!',
+            });
+        }
+        for (const key in this.bindings) {
+            if (container.isBound({ key })) {
+                continue;
+            }
+            container.set({ binding: this.bindings[key] });
+        }
+    }
+    // ------------------------------------------------------------------------------
+    async configure(opts) {
+        const t = performance.now();
+        const configureOptions = opts ?? {};
+        this.logger.info('[binding] START | Binding component | Options: %j', configureOptions);
+        if (this.initDefault?.enable) {
+            this.initDefaultBindings({ container: this.initDefault.container });
+        }
+        await this.binding();
+        this.logger.info('[binding] DONE | Binding component | Took: %s (ms)', performance.now() - t);
+    }
+}
+exports.BaseComponent = BaseComponent;
+//# sourceMappingURL=base.js.map

package/dist/base/components/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/base/components/base.ts"],"names":[],"mappings":";;;AAAA,0DAOgC;AAIhC,MAAsB,aACpB,SAAQ,0BAAU;IAOlB,YAAY,IAIX;QACC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,CAAC;IAID,iFAAiF;IACvE,mBAAmB,CAAC,IAA8B;QAC1D,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE3B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,uDAAuD;aACjE,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YAED,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,SAAS,CAAC,IAA0B;QACxC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAE5B,MAAM,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE,gBAAgB,CAAC,CAAC;QAExF,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,mBAAmB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAErB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChG,CAAC;CACF;AAvDD,sCAuDC"}

package/dist/base/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/base/components/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+//# sourceMappingURL=index.js.map

package/dist/base/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/components/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB"}

package/dist/base/controllers/abstract.d.ts

@@ -0,0 +1,34 @@
+import { Hook, OpenAPIHono, RouteConfig } from '@hono/zod-openapi';
+import { BaseHelper, TAuthStrategy, ValueOrPromise } from '@venizia/ignis-helpers';
+import { Env, Schema } from 'hono';
+import { IController, IControllerOptions, TAuthRouteConfig, TLazyRouteHandler, TRouteBindingOptions, TRouteDefinition } from './common/types';
+export declare abstract class AbstractController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}> extends BaseHelper implements IController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
+    router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+    definitions: Record<string, TAuthRouteConfig<RouteConfig>>;
+    constructor(opts: IControllerOptions);
+    getRouter(): OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+    registerRoutesFromRegistry(): void;
+    configure(opts?: ConfigurableOptions): Promise<OpenAPIHono<RouteEnv, RouteSchema, BasePath>>;
+    getRouteConfigs<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+    }): RC & {
+        getRoutingPath(): RC["path"] extends infer T ? T extends RC["path"] ? T extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${/*elided*/ any}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : T : never : never;
+    };
+    getJSXRouteConfigs<RC extends RouteConfig & {
+        authStrategies?: Array<TAuthStrategy>;
+    }>(opts: {
+        configs: RC;
+    }): RC & {
+        getRoutingPath(): RC["path"] extends infer T ? T extends RC["path"] ? T extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${/*elided*/ any}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : T : never : never;
+    };
+    abstract binding(): ValueOrPromise<void>;
+    abstract bindRoute<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+    }): TRouteBindingOptions<RC, RouteEnv, RouteSchema, BasePath>;
+    abstract defineRoute<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+        handler: TLazyRouteHandler<RC, RouteEnv>;
+        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
+    }): TRouteDefinition<RC, RouteEnv, RouteSchema, BasePath>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/base/controllers/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../src/base/controllers/abstract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EACL,UAAU,EAEV,aAAa,EACb,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAGxB,8BAAsB,kBAAkB,CACtC,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAEvC,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAE5E,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;gBAG/C,IAAI,EAAE,kBAAkB;IAepC,SAAS;IAKT,0BAA0B,IAAI,IAAI;IAiB5B,SAAS,CACb,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAgBxD,eAAe,CAAC,EAAE,SAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;KAAE;;;IAiC/E,kBAAkB,CAAC,EAAE,SAAS,WAAW,GAAG;QAAE,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;KAAE,EAAE,IAAI,EAAE;QAC3F,OAAO,EAAE,EAAE,CAAC;KACb;;;IA6BD,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAExC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE;QACjE,OAAO,EAAE,EAAE,CAAC;KACb,GAAG,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAE7D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE;QACnE,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,EAAE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CAC1D"}

package/dist/base/controllers/abstract.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractController = void 0;
+const auth_1 = require("../../components/auth");
+const jsx_utility_1 = require("../../utilities/jsx.utility");
+const zod_openapi_1 = require("@hono/zod-openapi");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+// -----------------------------------------------------------------------------
+class AbstractController extends ignis_helpers_1.BaseHelper {
+    // ------------------------------------------------------------------------------
+    constructor(opts) {
+        super(opts);
+        const { isStrict = true } = opts;
+        this.router = new zod_openapi_1.OpenAPIHono({
+            strict: isStrict,
+            defaultHook: (result, _context) => {
+                if (!result.success) {
+                    throw result.error;
+                }
+            },
+        });
+    }
+    // ------------------------------------------------------------------------------
+    getRouter() {
+        return this.router;
+    }
+    // ------------------------------------------------------------------------------
+    registerRoutesFromRegistry() {
+        const routes = ignis_helpers_1.MetadataRegistry.getInstance().getRoutes({
+            target: Object.getPrototypeOf(this),
+        });
+        if (!routes?.size) {
+            return;
+        }
+        const routeDefs = routes.entries();
+        for (const [methodName, routeConfigs] of routeDefs) {
+            this.bindRoute({ configs: routeConfigs }).to({
+                handler: this[methodName].bind(this),
+            });
+        }
+    }
+    async configure(opts) {
+        const t = performance.now();
+        const configureOptions = opts ?? {};
+        this.logger.info('[configure] START | Binding controller | Options: %j', configureOptions);
+        await this.binding();
+        this.registerRoutesFromRegistry();
+        this.logger.info('[configure] DONE | Binding controller | Took: %s (ms)', performance.now() - t);
+        return this.router;
+    }
+    getRouteConfigs(opts) {
+        const { configs } = opts;
+        const { authStrategies = [], ...restConfig } = configs;
+        const security = authStrategies.map(strategy => ({ [strategy]: [] }));
+        const mws = authStrategies?.map(strategy => (0, auth_1.authenticate)({ strategy })) ?? [];
+        if (restConfig.middleware) {
+            const extraMws = Array.isArray(restConfig.middleware)
+                ? restConfig.middleware
+                : [restConfig.middleware];
+            for (const mw of extraMws) {
+                if (!mw) {
+                    continue;
+                }
+                mws.push(mw);
+            }
+        }
+        const { tags = [] } = configs;
+        return (0, zod_openapi_1.createRoute)(Object.assign({}, configs, {
+            middleware: mws,
+            tags: [...tags, this.scope],
+            security,
+        }));
+    }
+    getJSXRouteConfigs(opts) {
+        const { configs } = opts;
+        const { authStrategies = [], ...restConfig } = configs;
+        const security = authStrategies.map(strategy => ({ [strategy]: [] }));
+        const mws = authStrategies?.map(strategy => (0, auth_1.authenticate)({ strategy })) ?? [];
+        const extraMws = restConfig.middleware && Array.isArray(restConfig.middleware)
+            ? restConfig.middleware
+            : [restConfig.middleware];
+        for (const mw of extraMws) {
+            mws.push(mw);
+        }
+        const { responses, tags = [] } = configs;
+        return (0, zod_openapi_1.createRoute)(Object.assign({}, configs, {
+            responses: Object.assign({}, (0, jsx_utility_1.htmlResponse)({ description: 'HTML page' }), responses),
+            tags: [...tags, this.scope],
+            security,
+        }));
+    }
+}
+exports.AbstractController = AbstractController;
+//# sourceMappingURL=abstract.js.map

package/dist/base/controllers/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../src/base/controllers/abstract.ts"],"names":[],"mappings":";;;AAAA,4CAAiD;AACjD,yDAAuD;AACvD,mDAAgF;AAChF,0DAKgC;AAWhC,gFAAgF;AAChF,MAAsB,kBAMpB,SAAQ,0BAAU;IAMlB,iFAAiF;IACjF,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEjC,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAW,CAAkC;YAC7D,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;gBAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,MAAM,CAAC,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IACjF,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,iFAAiF;IACjF,0BAA0B;QACxB,MAAM,MAAM,GAAG,gCAAgB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC;YACtD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;YACnD,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3C,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aACrC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CACb,IAA0B;QAE1B,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAE5B,MAAM,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sDAAsD,EAAE,gBAAgB,CAAC,CAAC;QAE3F,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAElC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,uDAAuD,EACvD,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CACtB,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe,CAA2C,IAAqB;QAC7E,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEzB,MAAM,EAAE,cAAc,GAAG,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QAEvD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAA,mBAAY,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9E,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;gBACnD,CAAC,CAAC,UAAU,CAAC,UAAU;gBACvB,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAE5B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,SAAS;gBACX,CAAC;gBAED,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QAED,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QAE9B,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE;YACzB,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAC,CACH,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAqE,IAEtF;QACC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEzB,MAAM,EAAE,cAAc,GAAG,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QAEvD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAA,mBAAY,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9E,MAAM,QAAQ,GACZ,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;YAC3D,CAAC,CAAC,UAAU,CAAC,UAAU;YACvB,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE9B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QAEzC,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE;YACzB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAA,0BAAY,EAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC;YACnF,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAC,CACH,CAAC;IACJ,CAAC;CAeF;AA/ID,gDA+IC"}

package/dist/base/controllers/base.d.ts

@@ -0,0 +1,48 @@
+import { Hook, RouteConfig } from '@hono/zod-openapi';
+import { TAuthStrategy, ValueOrPromise } from '@venizia/ignis-helpers';
+import { Env, Schema } from 'hono';
+import { AbstractController } from './abstract';
+import { TAuthRouteConfig, TLazyRouteHandler, TRouteBindingOptions, TRouteDefinition } from './common/types';
+export declare abstract class BaseController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}> extends AbstractController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
+    bindRoute<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+    }): TRouteBindingOptions<RC, RouteEnv, RouteSchema, BasePath>;
+    defineRoute<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+        handler: TLazyRouteHandler<RC, RouteEnv>;
+        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
+    }): TRouteDefinition<RC, RouteEnv, RouteSchema, BasePath>;
+    /**
+     * Define a JSX route that renders server-side HTML
+     * Scope: [BaseController][defineJSXRoute]
+     *
+     * JSX routes use Hono's built-in JSX support to render components to HTML.
+     * The handler must return c.html() with the JSX component.
+     *
+     * @example
+     * ```typescript
+     * this.defineJSXRoute({
+     *   configs: {
+     *     path: '/profile',
+     *     method: 'get',
+     *     description: 'User profile page',
+     *   },
+     *   handler: (c) => {
+     *     const user = c.get('user');
+     *     return c.html(<ProfilePage user={user} />);
+     *   }
+     * });
+     * ```
+     *
+     * @param opts - Route configuration and handler
+     * @returns Route definition
+     */
+    defineJSXRoute<RC extends RouteConfig & {
+        authStrategies?: Array<TAuthStrategy>;
+    }>(opts: {
+        configs: RC;
+        handler: TLazyRouteHandler<RC, RouteEnv>;
+        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
+    }): TRouteDefinition<RC, RouteEnv, RouteSchema, BasePath>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/base/controllers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base/controllers/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,8BAAsB,cAAc,CAClC,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAEhF,SAAS,CAAC,EAAE,SAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE;QACxD,OAAO,EAAE,EAAE,CAAC;KACb,GAAG,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAe7D,WAAW,CAAC,EAAE,SAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE;QAC1D,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,EAAE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IASzD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,cAAc,CAAC,EAAE,SAAS,WAAW,GAAG;QAAE,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;KAAE,EAAE,IAAI,EAAE;QACvF,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,EAAE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CAQ1D"}

package/dist/base/controllers/base.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseController = void 0;
+const abstract_1 = require("./abstract");
+class BaseController extends abstract_1.AbstractController {
+    // ------------------------------------------------------------------------------
+    bindRoute(opts) {
+        const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
+        return {
+            configs: routeConfigs,
+            to: ({ handler }) => {
+                return {
+                    configs: routeConfigs,
+                    route: this.router.openapi(routeConfigs, handler),
+                };
+            },
+        };
+    }
+    // ------------------------------------------------------------------------------
+    defineRoute(opts) {
+        const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
+        return {
+            configs: routeConfigs,
+            route: this.router.openapi(routeConfigs, opts.handler, opts.hook),
+        };
+    }
+    /**
+     * Define a JSX route that renders server-side HTML
+     * Scope: [BaseController][defineJSXRoute]
+     *
+     * JSX routes use Hono's built-in JSX support to render components to HTML.
+     * The handler must return c.html() with the JSX component.
+     *
+     * @example
+     * ```typescript
+     * this.defineJSXRoute({
+     *   configs: {
+     *     path: '/profile',
+     *     method: 'get',
+     *     description: 'User profile page',
+     *   },
+     *   handler: (c) => {
+     *     const user = c.get('user');
+     *     return c.html(<ProfilePage user={user} />);
+     *   }
+     * });
+     * ```
+     *
+     * @param opts - Route configuration and handler
+     * @returns Route definition
+     */
+    defineJSXRoute(opts) {
+        const routeConfigs = this.getJSXRouteConfigs({ configs: opts.configs });
+        return {
+            configs: routeConfigs,
+            route: this.router.openapi(routeConfigs, opts.handler, opts.hook),
+        };
+    }
+}
+exports.BaseController = BaseController;
+//# sourceMappingURL=base.js.map

package/dist/base/controllers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/base/controllers/base.ts"],"names":[],"mappings":";;;AAGA,yCAAgD;AAQhD,MAAsB,cAKpB,SAAQ,6BAAwE;IAChF,iFAAiF;IACjF,SAAS,CAA2C,IAEnD;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEzE,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;gBAClB,OAAO;oBACL,OAAO,EAAE,YAAY;oBACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC;iBAClD,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,WAAW,CAA2C,IAIrD;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEzE,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC;SAClE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,cAAc,CAAqE,IAIlF;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAE5E,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC;SAClE,CAAC;IACJ,CAAC;CACF;AA1ED,wCA0EC"}

package/dist/base/controllers/common/constants.d.ts

@@ -0,0 +1,6 @@
+export declare class RestPaths {
+    static readonly ROOT = "/";
+    static readonly COUNT = "/count";
+    static readonly FIND_ONE = "/find-one";
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/base/controllers/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,eAAe;CACxC"}

package/dist/base/controllers/common/constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestPaths = void 0;
+class RestPaths {
+    static { this.ROOT = '/'; }
+    static { this.COUNT = '/count'; }
+    static { this.FIND_ONE = '/find-one'; }
+}
+exports.RestPaths = RestPaths;
+//# sourceMappingURL=constants.js.map

package/dist/base/controllers/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAS;aACJ,SAAI,GAAG,GAAG,CAAC;aACX,UAAK,GAAG,QAAQ,CAAC;aACjB,aAAQ,GAAG,WAAW,CAAC;;AAHzC,8BAIC"}

package/dist/base/controllers/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/controllers/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/base/controllers/common/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/base/controllers/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}

package/dist/base/controllers/common/types.d.ts

@@ -0,0 +1,82 @@
+import type { RouteConfig, RouteHandler } from '@hono/zod-openapi';
+import { createRoute, Hook, OpenAPIHono } from '@hono/zod-openapi';
+import { IConfigurable, TAuthStrategy, ValueOrPromise } from '@venizia/ignis-helpers';
+import { Env, Schema } from 'hono';
+export type TLazyRouteHandler<RC extends RouteConfig, RouteEnv extends Env = Env> = RC extends RC ? RouteHandler<RC, RouteEnv> : never;
+export type TRouteDefinition<RC extends RouteConfig, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/'> = {
+    configs: ReturnType<typeof createRoute<string, RC>>;
+    route: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+};
+export type TRouteBindingOptions<RC extends RouteConfig, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/'> = {
+    configs: RC;
+    to: (opts: {
+        handler: TLazyRouteHandler<RC, RouteEnv>;
+    }) => TRouteDefinition<RC, RouteEnv, RouteSchema, BasePath>;
+};
+export type TAuthRouteConfig<RC extends RouteConfig> = RC & {
+    authStrategies?: readonly TAuthStrategy[];
+};
+/**
+ * Extract the context type from a route config for use in decorated handler methods
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   path: '/test',
+ *   method: 'post',
+ *   request: { body: jsonContent({ schema: z.object({ name: z.string() }) }) },
+ *   responses: { 200: jsonContent({ schema: z.object({ id: z.string() }) }) }
+ * } as const;
+ *
+ * class MyController extends BaseController {
+ *   @post({ configs: config })
+ *   myMethod(context: TRouteContext<typeof config>): TRouteResponse<typeof config> {
+ *     const body = context.req.valid('json'); // typed as { name: string }
+ *     return context.json({ id: '123' }, 200); // validated against response schema
+ *   }
+ * }
+ * ```
+ */
+export type TRouteContext<RC extends TAuthRouteConfig<RouteConfig>, RouteEnv extends Env = Env> = Parameters<TLazyRouteHandler<RC, RouteEnv>>[0];
+/**
+ * Extract the return type from a route config for use in decorated handler methods.
+ *
+ * **Note:** This type is optional for decorated methods, as TypeScript can automatically
+ * infer and validate the return type from the route configuration. It can be useful for
+ * explicit clarity or in complex scenarios.
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   path: '/test',
+ *   method: 'get',
+ *   responses: { 200: jsonContent({ schema: z.object({ message: z.string() }) }) }
+ * } as const;
+ *
+ * class MyController extends BaseController {
+ *   @get({ configs: config })
+ *   myMethod(context: TRouteContext<typeof config>) { // TRouteResponse is optional here
+ *     // Return type is validated - must return Response or TypedResponse matching the schema
+ *     return context.json({ message: 'hello' }, 200);
+ *   }
+ * }
+ * ```
+ */
+export type TRouteResponse<RC extends TAuthRouteConfig<RouteConfig>, RouteEnv extends Env = Env> = ReturnType<TLazyRouteHandler<RC, RouteEnv>>;
+export interface IController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}> extends IConfigurable<ConfigurableOptions, OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {
+    router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+    bindRoute<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+    }): TRouteBindingOptions<RC, RouteEnv, RouteSchema, BasePath>;
+    defineRoute<RC extends TAuthRouteConfig<RouteConfig>>(opts: {
+        configs: RC;
+        handler: TLazyRouteHandler<RC, RouteEnv>;
+        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
+    }): TRouteDefinition<RC, RouteEnv, RouteSchema, BasePath>;
+}
+export interface IControllerOptions {
+    scope: string;
+    path: string;
+    isStrict?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/base/controllers/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/common/types.ts"],"names":[],"mappings":"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"}