@venizia/ignis 0.0.7-8 → 0.0.7

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

@@ -6,10 +6,7 @@ import { createRoute, Hook, OpenAPIHono, z } from '@hono/zod-openapi';
 import { IConfigurable, ValueOrPromise } from '@venizia/ignis-helpers';
 import type { TypedResponse } from 'hono';
 import { Context, Env, Schema } from 'hono';
-/**
- * Typed validation results for route handlers.
- * Use with {@link TContext} to define handler parameter types without heavy inference.
- */
+/** Typed validation results for route handlers. */
 export interface IValidRequestProps<JsonType = unknown, QueryType = unknown, ParamType = unknown, HeaderType = unknown, CookieType = unknown, FormType = unknown> {
     json?: JsonType;
     query?: QueryType;
@@ -18,77 +15,30 @@ export interface IValidRequestProps<JsonType = unknown, QueryType = unknown, Par
     cookie?: CookieType;
     form?: FormType;
 }
-/**
- * Lightweight typed context that bypasses RouteHandler inference.
- *
- * Use `valid<T>('target')` for explicit typing of validated request data.
- *
- * @typeParam RouteEnv - Hono environment type
- *
- * @example
- * ```typescript
- * async createUser(opts: { context: TTypedContext }) {
- *   const body = opts.context.req.valid<{ name: string; email: string }>('json');
- *   const query = opts.context.req.valid<{ dryRun?: boolean }>('query');
- * }
- * ```
- */
+/** Lightweight typed context that bypasses RouteHandler inference. */
 export type TContext<RouteEnv extends Env = Env, ValidTargetKey extends string = string> = Omit<Context<RouteEnv>, 'req'> & {
     req: Omit<Context<RouteEnv>['req'], 'valid'> & {
         valid<T = unknown>(target: ValidTargetKey): T;
     };
 };
 export type TRouteContext<RouteEnv extends Env = Env> = TContext<RouteEnv, keyof IValidRequestProps>;
-/**
- * Type assertion function to cast middleware context to TContext.
- * Safe at runtime because TContext is structurally identical to Context.
- */
+/** Casts middleware context to TContext (safe -- structurally identical to Context). */
 export declare const asTypedContext: <E extends Env>(context: unknown) => TContext<E, string>;
-/**
- * Lightweight handler type for route handlers.
- * Uses TTypedContext to avoid heavy RouteHandler inference.
- */
+/** Lightweight handler type using TTypedContext to avoid heavy RouteHandler inference. */
 export type TRouteHandler<ResponseType = unknown, RouteEnv extends Env = Env> = (context: TRouteContext<RouteEnv>) => ValueOrPromise<Response | TypedResponse<ResponseType>>;
-/**
- * Represents a registered route with its configuration and router instance.
- *
- * Returned by {@link IController.bindRoute} and {@link IController.defineRoute}
- * after a route is registered with the router.
- *
- * @typeParam RouteConfig - The route configuration type
- * @typeParam RouteEnv - Hono environment type
- * @typeParam RouteSchema - Combined schema type for all routes
- * @typeParam BasePath - Base path prefix for the router
- */
+/** Registered route with its configuration and router instance. */
 export interface IDefineRouteOptions<RouteConfig extends HonoRouteConfig, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/'> {
     configs: ReturnType<typeof createRoute<string, RouteConfig>>;
     route: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
 }
-/**
- * Fluent binding options for registering a route handler.
- *
- * Enables a two-step binding pattern:
- * ```typescript
- * controller.bindRoute({ configs }).to({ handler });
- * ```
- *
- * @typeParam RouteConfig - The route configuration type
- * @typeParam RouteEnv - Hono environment type
- * @typeParam RouteSchema - Combined schema type
- * @typeParam BasePath - Base path prefix
- */
+/** Fluent binding for two-step route registration: bindRoute({ configs }).to({ handler }). */
 export interface IBindRouteOptions<RouteConfig extends HonoRouteConfig, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/'> {
     configs: RouteConfig;
     to: <ReponseType = unknown>(opts: {
         handler: TRouteHandler<ReponseType, RouteEnv>;
     }) => IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
 }
-/**
- * Route configuration extended with authentication and authorization.
- *
- * Adds optional `authenticate` and `authorize` fields to standard route config
- * for declarative auth configuration on individual routes.
- */
+/** Route configuration extended with optional authenticate and authorize fields. */
 export interface IAuthRouteConfig extends HonoRouteConfig {
     authenticate?: {
         strategies?: TAuthStrategy[];
@@ -96,93 +46,28 @@ export interface IAuthRouteConfig extends HonoRouteConfig {
     };
     authorize?: IAuthorizationSpec | IAuthorizationSpec[];
 }
-/**
- * Base controller interface defining the contract for all controllers.
- *
- * Controllers are responsible for:
- * - Defining HTTP routes and their handlers
- * - Validating request/response schemas via OpenAPI
- * - Applying authentication middleware
- * - Returning the configured router for mounting
- *
- * @typeParam RouteEnv - Hono environment for context variables (e.g., user, db)
- * @typeParam RouteSchema - Combined schema type for all routes
- * @typeParam BasePath - Base path prefix for the router
- * @typeParam ConfigurableOptions - Options passed during controller configuration
- *
- * @example
- * ```typescript
- * class UserController extends BaseController implements IController {
- *   binding() {
- *     this.defineRoute({
- *       configs: { path: '/', method: 'get', ... },
- *       handler: (c) => c.json({ users: [] })
- *     });
- *   }
- * }
- * ```
- */
+/** Base controller interface defining route registration and configuration contract. */
 export interface IController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}> extends IConfigurable<ConfigurableOptions, OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {
-    /** The OpenAPIHono router instance for this controller */
     router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
-    /**
-     * Creates a fluent binding for registering a route.
-     *
-     * Use this when you need a two-step binding pattern or want to
-     * conditionally bind handlers.
-     *
-     * @param opts - Object containing route configuration
-     * @returns Binding options with a `to()` method for attaching the 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.
-     *
-     * Preferred method for most use cases. Applies authentication and authorization
-     * middleware automatically based on config.
-     *
-     * @param opts - Object containing route config, handler, and optional hook
-     * @returns The registered route definition
-     */
+    /** 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>;
 }
-/**
- * Configuration options for controller instantiation.
- */
+/** Configuration options for controller instantiation. */
 export interface IControllerOptions {
-    /** Logger scope identifier, typically the controller class name */
     scope: string;
-    /**
-     * Controller base path for all routes.
-     *
-     * If not provided, will be read from `@controller` decorator metadata.
-     * At least one of decorator path or constructor path must be provided.
-     *
-     * @example '/users' or '/api/products'
-     */
+    /** Falls back to @controller decorator path if not provided. */
     path?: string;
-    /**
-     * Whether to use strict path matching.
-     *
-     * When `true` (default), `/users` and `/users/` are different routes.
-     * When `false`, trailing slashes are ignored.
-     *
-     * @default true
-     */
+    /** When true (default), /users and /users/ are different routes. */
     isStrict?: boolean;
 }
-/**
- * Per-route authentication configuration (scoped under `authenticate`).
- *
- * - `{ skip: true }` — skip authentication for this route
- * - `{ strategies, mode }` — override controller-level authentication
- */
+/** Per-route authentication config: { skip: true } or { strategies, mode }. */
 export type TRouteAuthenticateConfig = {
     skip: true;
 } | {
@@ -190,39 +75,11 @@ export type TRouteAuthenticateConfig = {
     strategies?: TAuthStrategy[];
     mode?: TAuthMode;
 };
-/**
- * Per-route authorization configuration (scoped under `authorize`).
- *
- * - `{ skip: true }` — skip authorization for this route
- * - `IAuthorizationSpec` — single requirement
- * - `IAuthorizationSpec[]` — multiple requirements (all must pass)
- */
+/** Per-route authorization config: { skip: true }, single spec, or array of specs. */
 export type TRouteAuthorizeConfig = {
     skip: true;
 } | IAuthorizationSpec | IAuthorizationSpec[];
-/**
- * Per-route auth configuration for CRUD factory routes.
- *
- * Priority (endpoint config takes precedence over controller):
- * 1. If endpoint has `authenticate: { skip: true }` -> no auth (also skips authorize)
- * 2. If endpoint has `authenticate: { strategies, mode }` -> use these (overrides controller)
- * 3. Otherwise -> use controller-level authenticate
- *
- * @example
- * ```typescript
- * // Skip auth for public read endpoints
- * find: { authenticate: { skip: true } }
- *
- * // Override auth strategy for a specific route
- * create: { authenticate: { strategies: ['jwt'], mode: 'required' } }
- *
- * // Skip only authorization (keep authentication)
- * updateById: { authorize: { skip: true } }
- *
- * // Override authorization for a specific route
- * deleteById: { authorize: { action: 'delete', resource: 'User' } }
- * ```
- */
+/** Per-route auth config. Endpoint config takes precedence over controller-level config. */
 export type TRouteAuthConfig = {
     authenticate?: TRouteAuthenticateConfig;
     authorize?: TRouteAuthorizeConfig;
@@ -249,15 +106,7 @@ export type TCustomizableRouteConfig = TRouteAuthConfig & {
         headers?: TResponseHeaders;
     };
 };
-/**
- * Per-route configuration for CRUD controller endpoints.
- *
- * Each route supports full customization of:
- * - Authentication (authenticate: { skip } or { strategies, mode })
- * - Request (query, params, body, headers)
- * - Response (schema, headers)
- *
- */
+/** Per-route configuration for CRUD controller endpoints (auth, request, response). */
 export interface ICustomizableRoutes<RouteConfig extends TCustomizableRouteConfig = TCustomizableRouteConfig> {
     count?: RouteConfig;
     find?: RouteConfig;

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

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

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

@@ -1,10 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.asTypedContext = void 0;
-/**
- * Type assertion function to cast middleware context to TContext.
- * Safe at runtime because TContext is structurally identical to Context.
- */
+/** Casts middleware context to TContext (safe -- structurally identical to Context). */
 const asTypedContext = (context) => {
     return context;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/controllers/common/types.ts"],"names":[],"mappings":";;;AA+DA;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAgB,OAAgB,EAAuB,EAAE;IACrF,OAAO,OAA8B,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/controllers/common/types.ts"],"names":[],"mappings":";;;AAwCA,wFAAwF;AACjF,MAAM,cAAc,GAAG,CAAgB,OAAgB,EAAuB,EAAE;IACrF,OAAO,OAA8B,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB"}

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

@@ -7,29 +7,7 @@ import { IAuthorizationSpec } from '../../../components/auth/authorize/common/ty
 import { Env, Schema } from 'hono';
 import { z } from '@hono/zod-openapi';
 import { ICustomizableRoutes, TRouteContext } from '../common';
-/**
- * Configuration options for creating a CRUD controller via {@link ControllerFactory.defineCrudController}.
- *
- * @typeParam EntitySchema - The Drizzle table schema type with an ID column
- * @typeParam Routes - The routes configuration type (inferred from routes option)
- *
- * @example
- * ```typescript
- * const UserControllerClass = ControllerFactory.defineCrudController<UserSchema>({
- *   entity: UserEntity,
- *   repository: { name: 'UserRepository' },
- *   controller: {
- *     name: 'UserController',
- *     basePath: '/users'
- *   },
- *   authenticate: { strategies: ['jwt'] },
- *   routes: {
- *     find: { authenticate: { skip: true } },
- *     findById: { authenticate: { skip: true } }
- *   }
- * });
- * ```
- */
+/** Configuration options for creating a CRUD controller via ControllerFactory.defineCrudController. */
 export interface ICrudControllerOptions<EntitySchema extends TTableSchemaWithId, Routes extends ICustomizableRoutes = ICustomizableRoutes> {
     /** Entity class or resolver function returning the entity class */
     entity: TClass<BaseEntity<EntitySchema>> | TResolver<TClass<BaseEntity<EntitySchema>>>;
@@ -46,131 +24,24 @@ export interface ICrudControllerOptions<EntitySchema extends TTableSchemaWithId,
             requestSchema?: boolean;
         };
     };
-    /**
-     * Authentication config applied to all routes (unless overridden per-route)
-     *
-     * @example
-     * // Apply JWT auth to all routes
-     * authenticate: { strategies: ['jwt'] }
-     */
+    /** Authentication config applied to all routes (unless overridden per-route). */
     authenticate?: {
         strategies?: TAuthStrategy[];
         mode?: TAuthMode;
     };
-    /**
-     * Authorization config applied to all routes (unless overridden per-route)
-     *
-     * @example
-     * // Apply authorization to all routes
-     * authorize: { action: 'manage', resource: 'User' }
-     */
+    /** Authorization config applied to all routes (unless overridden per-route). */
     authorize?: IAuthorizationSpec | IAuthorizationSpec[];
-    /**
-     * Per-route configuration combining schema and auth
-     *
-     * @example
-     * // JWT auth on all, skip for public read endpoints
-     * authenticate: { strategies: ['jwt'] },
-     * routes: {
-     *   find: { authenticate: { skip: true } },
-     *   findById: { authenticate: { skip: true } },
-     *   count: { authenticate: { skip: true } },
-     * }
-     *
-     * @example
-     * // No controller auth, require JWT only for writes
-     * routes: {
-     *   create: { authenticate: { strategies: ['jwt'] } },
-     *   updateById: { authenticate: { strategies: ['jwt'] }, requestBody: CustomUpdateSchema },
-     *   deleteById: { authenticate: { strategies: ['jwt'] } },
-     * }
-     *
-     * @example
-     * // Custom response schema with auth
-     * authenticate: { strategies: ['jwt'] },
-     * routes: {
-     *   find: { authenticate: { skip: true }, schema: CustomFindResponseSchema },
-     *   create: { schema: CustomCreateResponseSchema, requestBody: CustomCreateBodySchema },
-     * }
-     */
+    /** Per-route configuration combining schema and auth overrides. */
     routes?: Routes;
 }
-/**
- * Factory for generating CRUD controllers from entity definitions.
- *
- * Creates fully-typed controller classes with standard CRUD endpoints
- * (count, find, findById, findOne, create, updateById, updateBy, deleteById, deleteBy)
- * based on entity schemas.
- *
- * @example
- * ```typescript
- * // Define a CRUD controller for User entity
- * const UserControllerClass = ControllerFactory.defineCrudController<UserSchema>({
- *   entity: UserEntity,
- *   repository: { name: 'UserRepository' },
- *   controller: { name: 'UserController', basePath: '/users' },
- *   authenticate: { strategies: ['jwt'] },
- *   routes: {
- *     find: { authenticate: { skip: true } },
- *     findById: { authenticate: { skip: true } }
- *   }
- * });
- *
- * // Instantiate with repository
- * const userController = new UserControllerClass(userRepository);
- * ```
- */
+/** Factory for generating typed CRUD controllers from entity definitions. */
 export declare class ControllerFactory extends BaseHelper {
     constructor();
-    /**
-     * Creates a CRUD controller class for the given entity.
-     *
-     * The returned class extends {@link BaseController} and includes handlers for:
-     * - `GET /count` - Count records matching filter
-     * - `GET /` - Find all records with pagination
-     * - `GET /:id` - Find record by ID
-     * - `GET /find-one` - Find single record matching filter
-     * - `POST /` - Create new record
-     * - `PATCH /:id` - Update record by ID
-     * - `PATCH /` - Update records matching filter
-     * - `DELETE /:id` - Delete record by ID
-     * - `DELETE /` - Delete records matching filter
-     *
-     * @typeParam EntitySchema - The Drizzle table schema type
-     * @typeParam RouteEnv - Hono environment type
-     * @typeParam RouteSchema - Combined route schema type
-     * @typeParam BasePath - Base path type
-     * @typeParam ConfigurableOptions - Controller configuration options type
-     * @param defOpts - Controller configuration options
-     * @returns A controller class constructor
-     *
-     * @example
-     * ```typescript
-     * const ProductController = ControllerFactory.defineCrudController({
-     *   entity: ProductEntity,
-     *   repository: { name: 'ProductRepository' },
-     *   controller: { name: 'ProductController', basePath: '/products' }
-     * });
-     * ```
-     */
+    /** Creates a CRUD controller class with standard endpoints (count, find, findById, create, update, delete). */
     static defineCrudController<EntitySchema extends TTableSchemaWithId, Routes extends ICustomizableRoutes = ICustomizableRoutes, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}>(defOpts: ICrudControllerOptions<EntitySchema, Routes>): {
         new (repository: AbstractRepository<EntitySchema>): {
-            /** Repository instance for database operations */
             repository: AbstractRepository<EntitySchema>;
-            /**
-             * Normalizes response data based on the `x-request-count` header.
-             *
-             * If the header is 'true' (default), returns full response with count.
-             * If 'false', returns only the data portion.
-             *
-             * Also sets the `X-Response-Count-Data` header with the count.
-             *
-             * @typeParam ResponseSchema - The response data type
-             * @typeParam RequestContext - Hono context type
-             * @typeParam ResponseData - Full response shape with count and data
-             * @param opts - Context and response data
-             * @returns Normalized response (full or data-only)
-             */
+            /** Normalizes response based on x-request-count header (returns full or data-only). */
             normalizeCountData<ResponseSchema extends unknown, RequestContext extends TRouteContext<RouteEnv> = TRouteContext<RouteEnv>, ResponseData extends {
                 count: number;
                 data?: TNullable<ResponseSchema>;
@@ -181,95 +52,43 @@ export declare class ControllerFactory extends BaseHelper {
                 context: RequestContext;
                 responseData: ResponseData;
             }): ResponseData | TNullable<ResponseSchema>;
-            /**
-             * Handles GET /count - Returns count of records matching the filter.
-             *
-             * @param opts - Request options containing the Hono context
-             * @returns JSON response with count
-             */
+            /** GET /count */
             count(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles GET / - Returns paginated list of records with Content-Range header.
-             *
-             * Sets `Content-Range` header following HTTP RFC 7233 standard for pagination.
-             *
-             * @param opts - Request options containing the Hono context
-             * @returns JSON response with data array and range information
-             */
+            /** GET / - Returns paginated list with Content-Range header. */
             find(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles GET /:id - Returns single record by ID.
-             *
-             * @param opts - Request options containing the Hono context
-             * @returns JSON response with the found record or null
-             */
+            /** GET /:id */
             findById(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles GET /find-one - Returns first record matching the filter.
-             *
-             * @param opts - Request options containing the Hono context
-             * @returns JSON response with the found record or null
-             */
+            /** GET /find-one */
             findOne(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles POST / - Creates a new record.
-             *
-             * @param opts - Request options containing the Hono context with request body
-             * @returns JSON response with created record and count
-             */
+            /** POST / */
             create(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles PATCH /:id - Updates a record by ID.
-             *
-             * @param opts - Request options containing the Hono context with ID param and body
-             * @returns JSON response with updated record and count
-             */
+            /** PATCH /:id */
             updateById(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles PATCH / - Updates records matching the where filter.
-             *
-             * @param opts - Request options containing the Hono context with where query and body
-             * @returns JSON response with updated records array and count
-             */
+            /** PATCH / */
             updateBy(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles DELETE /:id - Deletes a record by ID.
-             *
-             * @param opts - Request options containing the Hono context with ID param
-             * @returns JSON response with deleted record and count
-             */
+            /** DELETE /:id */
             deleteById(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Handles DELETE / - Deletes records matching the where filter.
-             *
-             * @param opts - Request options containing the Hono context with where query
-             * @returns JSON response with deleted records array and count
-             */
+            /** DELETE / */
             deleteBy(opts: {
                 context: TRouteContext<RouteEnv>;
             }): Promise<Response & import("hono").TypedResponse<any, 200, "json">>;
-            /**
-             * Registers all CRUD route handlers.
-             *
-             * Called during controller configuration. Binds all standard CRUD
-             * endpoints to their respective handler methods.
-             */
+            /** Registers all CRUD route handlers. */
             binding(): ValueOrPromise<void>;
             toHonoHandler<ResponseType = unknown>(opts: {
                 handler: import("../common").TRouteHandler<ResponseType, RouteEnv>;
@@ -297,7 +116,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         query: import("../../..").TAnyObjectSchema | z.ZodObject<{
                             where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]> | z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
@@ -351,7 +170,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         query: import("../../..").TAnyObjectSchema | z.ZodObject<{
                             filter: any;
@@ -406,7 +225,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         params: z.ZodObject<{
                             id: z.ZodNumber;
@@ -466,7 +285,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         query: import("../../..").TAnyObjectSchema | z.ZodObject<{
                             filter: any;
@@ -521,7 +340,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         readonly body: {
                             description: string;
@@ -582,7 +401,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         readonly params: z.ZodObject<{
                             id: z.ZodNumber;
@@ -648,7 +467,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         readonly query: import("../../..").TAnyObjectSchema | z.ZodObject<{
                             where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>;
@@ -712,7 +531,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         params: z.ZodObject<{
                             id: z.ZodNumber;
@@ -769,7 +588,7 @@ export declare class ControllerFactory extends BaseHelper {
                         strategies?: TAuthStrategy[];
                         mode?: TAuthMode;
                     };
-                    readonly authorize: IAuthorizationSpec<Env> | IAuthorizationSpec<Env>[] | undefined;
+                    readonly authorize: IAuthorizationSpec<Env, string, string> | IAuthorizationSpec<Env, string, string>[] | undefined;
                     readonly request: {
                         query: import("../../..").TAnyObjectSchema | z.ZodObject<{
                             where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>;