@venizia/ignis 0.0.7-2 → 0.0.7-21

package/dist/base/controllers/abstract.js

@@ -1,56 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractController = void 0;
-const auth_1 = require("../../components/auth");
-const inversion_1 = require("../../helpers/inversion");
+const constants_1 = require("../../components/auth/authenticate/common/constants");
+const authenticate_middleware_1 = require("../../components/auth/authenticate/middlewares/authenticate.middleware");
+const authorize_middleware_1 = require("../../components/auth/authorize/middlewares/authorize.middleware");
+const registry_1 = require("../../helpers/inversion/registry");
 const jsx_utility_1 = require("../../utilities/jsx.utility");
 const zod_openapi_1 = require("@hono/zod-openapi");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
-// -----------------------------------------------------------------------------
-/**
- * Abstract base class for all controllers in the Ignis framework.
- *
- * Provides core functionality for:
- * - Route registration and configuration
- * - Authentication middleware integration
- * - OpenAPI schema generation
- * - Decorator-based route binding
- *
- * Extend this class (or {@link BaseController}) to create custom controllers.
- *
- * @typeParam RouteEnv - Hono environment type for context variables
- * @typeParam RouteSchema - Combined schema type for all routes
- * @typeParam BasePath - Base path prefix for the router
- * @typeParam ConfigurableOptions - Options passed during configuration
- * @typeParam Definitions - Route definitions map type for strongly-typed method overrides
- *
- * @example
- * ```typescript
- * class UserController extends AbstractController {
- *   async binding() {
- *     this.defineRoute({
- *       configs: { path: '/', method: 'get', ... },
- *       handler: async (c) => c.json({ users: [] })
- *     });
- *   }
- *
- *   bindRoute(opts) { ... }
- *   defineRoute(opts) { ... }
- * }
- * ```
- */
+/** Abstract base class for all controllers, providing route registration and auth middleware integration. */
 class AbstractController extends ignis_helpers_1.BaseHelper {
-    /**
-     * Creates a new controller instance.
-     *
-     * @param opts - Controller configuration options
-     * @throws Error if no path is provided via constructor or decorator
-     */
     constructor(opts) {
         super(opts);
         const { isStrict = true } = opts;
         // Resolve path: decorator metadata takes priority, then constructor option
-        const decoratorMetadata = inversion_1.MetadataRegistry.getInstance().getControllerMetadata({
+        const decoratorMetadata = registry_1.MetadataRegistry.getInstance().getControllerMetadata({
             target: new.target,
         });
         const resolvedPath = decoratorMetadata?.path ?? opts.path;
@@ -69,22 +33,13 @@ class AbstractController extends ignis_helpers_1.BaseHelper {
             },
         });
     }
-    /**
-     * Returns the OpenAPIHono router instance for this controller.
-     *
-     * @returns The configured router with all registered routes
-     */
+    /** Returns the OpenAPIHono router instance for this controller. */
     getRouter() {
         return this.router;
     }
-    /**
-     * Registers routes defined via decorators (e.g., `@get`, `@post`) from the metadata registry.
-     *
-     * Called automatically during {@link configure}. Iterates through decorator-defined
-     * routes and binds them to their handler methods.
-     */
+    /** Registers routes defined via decorators (@get, @post, etc.) from the metadata registry. */
     registerRoutesFromRegistry() {
-        const routes = inversion_1.MetadataRegistry.getInstance().getRoutes({
+        const routes = registry_1.MetadataRegistry.getInstance().getRoutes({
             target: Object.getPrototypeOf(this),
         });
         if (!routes?.size) {
@@ -97,89 +52,84 @@ class AbstractController extends ignis_helpers_1.BaseHelper {
             });
         }
     }
-    /**
-     * Configures the controller by binding all routes and registering decorator-based routes.
-     *
-     * This is the main entry point called by the application during startup.
-     * It executes the {@link binding} method and then registers any decorator-defined routes.
-     *
-     * @param opts - Optional configuration options passed to the controller
-     * @returns The configured OpenAPIHono router ready for mounting
-     */
+    /** Configures the controller by binding all routes and registering decorator-based routes. */
     async configure(opts) {
         const t = performance.now();
+        const logger = this.logger.for(this.configure.name);
         const configureOptions = opts ?? {};
-        this.logger
-            .for(this.configure.name)
-            .info('START | Binding controller | Options: %j', configureOptions);
+        logger.info('START | Binding controller | Options: %j', configureOptions);
         await this.binding();
         this.registerRoutesFromRegistry();
-        this.logger
-            .for(this.configure.name)
-            .info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);
+        logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);
         return this.router;
     }
-    /**
-     * Processes route configuration, adding authentication middleware and OpenAPI metadata.
-     *
-     * Transforms a route config by:
-     * - Converting `authenticate.strategies` to OpenAPI security requirements
-     * - Creating authentication middleware based on strategies and mode
-     * - Adding the controller scope to route tags
-     * - Merging any existing middleware
-     *
-     * @typeParam RouteConfig - The route configuration type
-     * @param opts - Object containing the route configuration
-     * @returns Processed route configuration ready for registration
-     */
+    /** Processes route config, injecting auth middleware and OpenAPI security specs. */
     getRouteConfigs(opts) {
         const { configs } = opts;
-        const { authenticate = {}, ...restConfig } = configs;
-        const { strategies = [], mode = auth_1.AuthenticationModes.ANY } = authenticate;
-        const security = strategies.map(strategy => ({ [strategy]: [] }));
-        const mws = strategies.length > 0 ? [(0, auth_1.authenticate)({ strategies, mode })] : [];
+        const { authenticate = {}, authorize, ...restConfig } = configs;
+        const { strategies = [], mode = constants_1.AuthenticationModes.ANY } = authenticate;
+        const security = strategies.map((strategy) => ({ [strategy]: [] }));
+        const mws = [];
+        // Inject authenticate middleware
+        if (strategies.length > 0) {
+            mws.push((0, authenticate_middleware_1.authenticate)({ strategies, mode }));
+        }
+        // Inject authorize middleware AFTER authenticate
+        if (authorize) {
+            const specs = Array.isArray(authorize) ? authorize : [authorize];
+            for (const spec of specs) {
+                mws.push((0, authorize_middleware_1.authorize)({ spec }));
+            }
+        }
+        // Inject custom middleware
         if (restConfig.middleware) {
             const extraMws = Array.isArray(restConfig.middleware)
                 ? restConfig.middleware
                 : [restConfig.middleware];
             for (const mw of extraMws) {
-                if (!mw) {
-                    continue;
+                if (mw) {
+                    mws.push(mw);
                 }
-                mws.push(mw);
             }
         }
-        const { tags = [] } = configs;
-        return (0, zod_openapi_1.createRoute)(Object.assign({}, configs, {
+        const { tags = [] } = restConfig;
+        return (0, zod_openapi_1.createRoute)(Object.assign({}, restConfig, {
             middleware: mws,
             tags: [...tags, this.scope],
             security,
         }));
     }
-    /**
-     * Processes JSX route configuration for server-side rendered HTML responses.
-     *
-     * Similar to {@link getRouteConfigs} but automatically adds HTML response
-     * schema for JSX rendering. Use with {@link BaseController.defineJSXRoute}.
-     *
-     * @typeParam RouteConfig - The route configuration type
-     * @param opts - Object containing the route configuration
-     * @returns Processed route configuration with HTML response schema
-     */
+    /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */
     getJSXRouteConfigs(opts) {
         const { configs } = opts;
-        const { authenticate = {}, ...restConfig } = configs;
-        const { strategies = [], mode = auth_1.AuthenticationModes.ANY } = authenticate;
-        const security = strategies.map(strategy => ({ [strategy]: [] }));
-        const mws = strategies.length > 0 ? [(0, auth_1.authenticate)({ strategies, mode })] : [];
-        const extraMws = restConfig.middleware && Array.isArray(restConfig.middleware)
-            ? restConfig.middleware
-            : [restConfig.middleware];
-        for (const mw of extraMws) {
-            mws.push(mw);
+        const { authenticate = {}, authorize, ...restConfig } = configs;
+        const { strategies = [], mode = constants_1.AuthenticationModes.ANY } = authenticate;
+        const security = strategies.map((strategy) => ({ [strategy]: [] }));
+        const mws = [];
+        // Inject authenticate middleware
+        if (strategies.length > 0) {
+            mws.push((0, authenticate_middleware_1.authenticate)({ strategies, mode }));
+        }
+        // Inject authorize middleware AFTER authenticate
+        if (authorize) {
+            const specs = Array.isArray(authorize) ? authorize : [authorize];
+            for (const spec of specs) {
+                mws.push((0, authorize_middleware_1.authorize)({ spec }));
+            }
+        }
+        // Inject custom middleware
+        if (restConfig.middleware) {
+            const extraMws = Array.isArray(restConfig.middleware)
+                ? restConfig.middleware
+                : [restConfig.middleware];
+            for (const mw of extraMws) {
+                if (mw) {
+                    mws.push(mw);
+                }
+            }
         }
-        const { responses, tags = [] } = configs;
-        return (0, zod_openapi_1.createRoute)(Object.assign({}, configs, {
+        const { responses, tags = [] } = restConfig;
+        return (0, zod_openapi_1.createRoute)(Object.assign({}, restConfig, {
             responses: Object.assign({}, (0, jsx_utility_1.htmlResponse)({ description: 'HTML page' }), responses),
             tags: [...tags, this.scope],
             security,

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

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

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

@@ -2,133 +2,25 @@ import { Hook, OpenAPIHono } from '@hono/zod-openapi';
 import { ValueOrPromise } from '@venizia/ignis-helpers';
 import { Env, Schema } from 'hono';
 import { AbstractController } from './abstract';
-import { IAuthenticateRouteConfig, IBindRouteOptions, IDefineRouteOptions, TRouteHandler } from './common/types';
-/**
- * Base controller class with default implementations for route binding.
- *
- * Extends {@link AbstractController} with concrete implementations of
- * {@link bindRoute} and {@link defineRoute}. This is the recommended
- * base class for creating custom controllers.
- *
- * @typeParam RouteEnv - Hono environment type for context variables
- * @typeParam RouteSchema - Combined schema type for all routes
- * @typeParam BasePath - Base path prefix for the router
- * @typeParam ConfigurableOptions - Options passed during configuration
- * @typeParam Definitions - Route definitions map type for strongly-typed method overrides
- *
- * @example
- * ```typescript
- * class UserController extends BaseController {
- *   async binding() {
- *     // Define routes using defineRoute
- *     this.defineRoute({
- *       configs: {
- *         path: '/',
- *         method: 'get',
- *         authenticate: { strategies: ['jwt'] },
- *         responses: { 200: jsonResponse({ schema: UserSchema }) }
- *       },
- *       handler: async (c) => {
- *         const users = await this.userService.findAll();
- *         return c.json(users);
- *       }
- *     });
- *
- *     // Or use fluent bindRoute pattern
- *     this.bindRoute({
- *       configs: { path: '/{id}', method: 'get', ... }
- *     }).to({
- *       handler: (c) => c.json({ id: c.req.param('id') })
- *     });
- *   }
- * }
- * ```
- */
-export declare abstract class BaseController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, Definitions extends Record<string, IAuthenticateRouteConfig> = Record<string, IAuthenticateRouteConfig>> extends AbstractController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions, Definitions> {
-    /**
-     * Helper method to cast to Hono OpenAPI Handler
-     */
+import { IAuthRouteConfig, IBindRouteOptions, IDefineRouteOptions, TRouteHandler } from './common/types';
+/** Recommended base class for controllers with concrete bindRoute and defineRoute implementations. */
+export declare abstract class BaseController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>> extends AbstractController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions, Definitions> {
+    /** Casts handler to Hono OpenAPI Handler type. */
     toHonoHandler<ResponseType = unknown>(opts: {
         handler: TRouteHandler<ResponseType, RouteEnv>;
     }): Parameters<OpenAPIHono<RouteEnv>["openapi"]>[1];
-    /**
-     * Creates a fluent binding for registering a route.
-     *
-     * Returns an object with a `to()` method for attaching the handler.
-     * Useful for conditional binding or when you need access to the binding object.
-     *
-     * @typeParam RouteConfig - The route configuration type
-     * @param opts - Object containing route configuration
-     * @returns Binding options with `to()` method
-     *
-     * @example
-     * ```typescript
-     * const binding = this.bindRoute({ configs: myRouteConfig });
-     * binding.to({ handler: myHandler });
-     * ```
-     */
-    bindRoute<RouteConfig extends IAuthenticateRouteConfig>(opts: {
+    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
+    bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {
         configs: RouteConfig;
     }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-    /**
-     * Defines and registers a route with its handler in a single call.
-     *
-     * This is the preferred method for registering routes. It automatically:
-     * - Processes authentication strategies into middleware
-     * - Adds OpenAPI security requirements
-     * - Tags the route with the controller scope
-     *
-     * @typeParam RouteConfig - The route configuration type
-     * @param opts - Object containing route config, handler, and optional hook
-     * @returns The registered route definition
-     *
-     * @example
-     * ```typescript
-     * this.defineRoute({
-     *   configs: {
-     *     path: '/users',
-     *     method: 'get',
-     *     authenticate: { strategies: ['jwt'] },
-     *     responses: { 200: jsonResponse({ schema: z.array(UserSchema) }) }
-     *   },
-     *   handler: async (c) => {
-     *     const users = await db.select().from(usersTable);
-     *     return c.json(users, 200);
-     *   }
-     * });
-     * ```
-     */
-    defineRoute<RouteConfig extends IAuthenticateRouteConfig, ResponseType = unknown>(opts: {
+    /** Defines and registers a route with its handler in a single call. */
+    defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
         configs: RouteConfig;
         handler: TRouteHandler<ResponseType, RouteEnv>;
         hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
     }): IDefineRouteOptions<RouteConfig, 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<RouteConfig extends IAuthenticateRouteConfig, ResponseType = unknown>(opts: {
+    /** Defines a JSX route that renders server-side HTML via c.html(). */
+    defineJSXRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
         configs: RouteConfig;
         handler: TRouteHandler<ResponseType, RouteEnv>;
         hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;

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

@@ -1 +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,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,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,EACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,MAAM,CACnE,MAAM,EACN,wBAAwB,CACzB,CACD,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;IAC7F;;OAEG;IACH,aAAa,CAAC,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;KAAE,GACrE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAGxE;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,WAAW,SAAS,wBAAwB,EAAE,IAAI,EAAE;QAC5D,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAcnE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,WAAW,CAAC,WAAW,SAAS,wBAAwB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACtF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAarE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,cAAc,CAAC,WAAW,SAAS,wBAAwB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACzF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CAStE"}
+{"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,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,sGAAsG;AACtG,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,EACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CACvF,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;IAC7F,kDAAkD;IAClD,aAAa,CAAC,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;KAAE,GACrE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAGxE,uFAAuF;IACvF,SAAS,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QACpD,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAcnE,uEAAuE;IACvE,WAAW,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QAC9E,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAarE,sEAAsE;IACtE,cAAc,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACjF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CAStE"}

package/dist/base/controllers/base.js

@@ -2,70 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseController = void 0;
 const abstract_1 = require("./abstract");
-/**
- * Base controller class with default implementations for route binding.
- *
- * Extends {@link AbstractController} with concrete implementations of
- * {@link bindRoute} and {@link defineRoute}. This is the recommended
- * base class for creating custom controllers.
- *
- * @typeParam RouteEnv - Hono environment type for context variables
- * @typeParam RouteSchema - Combined schema type for all routes
- * @typeParam BasePath - Base path prefix for the router
- * @typeParam ConfigurableOptions - Options passed during configuration
- * @typeParam Definitions - Route definitions map type for strongly-typed method overrides
- *
- * @example
- * ```typescript
- * class UserController extends BaseController {
- *   async binding() {
- *     // Define routes using defineRoute
- *     this.defineRoute({
- *       configs: {
- *         path: '/',
- *         method: 'get',
- *         authenticate: { strategies: ['jwt'] },
- *         responses: { 200: jsonResponse({ schema: UserSchema }) }
- *       },
- *       handler: async (c) => {
- *         const users = await this.userService.findAll();
- *         return c.json(users);
- *       }
- *     });
- *
- *     // Or use fluent bindRoute pattern
- *     this.bindRoute({
- *       configs: { path: '/{id}', method: 'get', ... }
- *     }).to({
- *       handler: (c) => c.json({ id: c.req.param('id') })
- *     });
- *   }
- * }
- * ```
- */
+/** Recommended base class for controllers with concrete bindRoute and defineRoute implementations. */
 class BaseController extends abstract_1.AbstractController {
-    /**
-     * Helper method to cast to Hono OpenAPI Handler
-     */
+    /** Casts handler to Hono OpenAPI Handler type. */
     toHonoHandler(opts) {
         return opts.handler;
     }
-    /**
-     * Creates a fluent binding for registering a route.
-     *
-     * Returns an object with a `to()` method for attaching the handler.
-     * Useful for conditional binding or when you need access to the binding object.
-     *
-     * @typeParam RouteConfig - The route configuration type
-     * @param opts - Object containing route configuration
-     * @returns Binding options with `to()` method
-     *
-     * @example
-     * ```typescript
-     * const binding = this.bindRoute({ configs: myRouteConfig });
-     * binding.to({ handler: myHandler });
-     * ```
-     */
+    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
     bindRoute(opts) {
         const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
         return {
@@ -78,34 +21,7 @@ class BaseController extends abstract_1.AbstractController {
             },
         };
     }
-    /**
-     * Defines and registers a route with its handler in a single call.
-     *
-     * This is the preferred method for registering routes. It automatically:
-     * - Processes authentication strategies into middleware
-     * - Adds OpenAPI security requirements
-     * - Tags the route with the controller scope
-     *
-     * @typeParam RouteConfig - The route configuration type
-     * @param opts - Object containing route config, handler, and optional hook
-     * @returns The registered route definition
-     *
-     * @example
-     * ```typescript
-     * this.defineRoute({
-     *   configs: {
-     *     path: '/users',
-     *     method: 'get',
-     *     authenticate: { strategies: ['jwt'] },
-     *     responses: { 200: jsonResponse({ schema: z.array(UserSchema) }) }
-     *   },
-     *   handler: async (c) => {
-     *     const users = await db.select().from(usersTable);
-     *     return c.json(users, 200);
-     *   }
-     * });
-     * ```
-     */
+    /** Defines and registers a route with its handler in a single call. */
     defineRoute(opts) {
         const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
         return {
@@ -113,31 +29,7 @@ class BaseController extends abstract_1.AbstractController {
             route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler: 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
-     */
+    /** Defines a JSX route that renders server-side HTML via c.html(). */
     defineJSXRoute(opts) {
         const routeConfigs = this.getJSXRouteConfigs({ configs: opts.configs });
         return {

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

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/base/controllers/base.ts"],"names":[],"mappings":";;;AAGA,yCAAgD;AAQhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAsB,cASpB,SAAQ,6BAAqF;IAC7F;;OAEG;IACH,aAAa,CAAyB,IAAwD;QAC5F,OAAO,IAAI,CAAC,OAA0D,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAA+C,IAEvD;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElF,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,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;iBAC1E,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,WAAW,CAAuE,IAIjF;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,YAAY,EACZ,IAAI,CAAC,aAAa,CAAe,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAC3D,IAAI,CAAC,IAAI,CACV;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,cAAc,CAAuE,IAIpF;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAErF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,sEAAsE;YACtE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAc,EAAE,IAAI,CAAC,IAAI,CAAC;SACzE,CAAC;IACJ,CAAC;CACF;AApID,wCAoIC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/base/controllers/base.ts"],"names":[],"mappings":";;;AAGA,yCAAgD;AAQhD,sGAAsG;AACtG,MAAsB,cAMpB,SAAQ,6BAAqF;IAC7F,kDAAkD;IAClD,aAAa,CAAyB,IAAwD;QAC5F,OAAO,IAAI,CAAC,OAA0D,CAAC;IACzE,CAAC;IAED,uFAAuF;IACvF,SAAS,CAAuC,IAE/C;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElF,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,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;iBAC1E,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,WAAW,CAA+D,IAIzE;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,YAAY,EACZ,IAAI,CAAC,aAAa,CAAe,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAC3D,IAAI,CAAC,IAAI,CACV;SACF,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,cAAc,CAA+D,IAI5E;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAErF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,sEAAsE;YACtE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAc,EAAE,IAAI,CAAC,IAAI,CAAC;SACzE,CAAC;IACJ,CAAC;CACF;AA7DD,wCA6DC"}

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

@@ -1,21 +1,6 @@
 import { z } from '@hono/zod-openapi';
 import { TResponseHeaders } from './types';
-/**
- * Standard REST API path constants for CRUD controllers.
- *
- * These paths are used by {@link ControllerFactory} to define consistent
- * endpoint patterns across all generated controllers.
- *
- * @example
- * ```typescript
- * // Combined with controller basePath:
- * // basePath: '/users'
- * // GET /users        → find all (RestPaths.ROOT)
- * // GET /users/count  → count (RestPaths.COUNT)
- * // GET /users/find-one → find one (RestPaths.FIND_ONE)
- * // GET /users/:id    → find by id
- * ```
- */
+/** Standard REST API path constants for CRUD controllers. */
 export declare class RestPaths {
     static readonly ROOT = "/";
     static readonly COUNT = "/count";

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,eAAe;CACxC;AAKD,eAAO,MAAM,gBAAgB;;;;iBAkB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;iBAS3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAAkD,CAAC;AAGrF,eAAO,MAAM,qBAAqB,EAAE,gBAanC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,6DAA6D;AAC7D,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,eAAe;CACxC;AAED,eAAO,MAAM,gBAAgB;;;;iBAkB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;iBAS3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAAkD,CAAC;AAErF,eAAO,MAAM,qBAAqB,EAAE,gBAanC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC"}