import { type TRoutePathScope } from '../common/constants';
import type { Hook } from '@hono/zod-openapi';
import { OpenAPIHono } from '@hono/zod-openapi';
import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
import { BaseHelper } from '@venizia/ignis-helpers/core';
import type { Env, Schema } from 'hono';
import type { IAuthRouteConfig, IBindRouteOptions, IController, IControllerOptions, IDefineRouteOptions, TRouteHandler } from '../common/types';
/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */
export declare abstract class AbstractRestController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>> extends BaseHelper implements IController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
    isConfigured: boolean;
    router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
    path: string;
    definitions: Definitions;
    constructor(opts: IControllerOptions);
    /** Returns the OpenAPIHono router instance for this controller. */
    getRouter(): OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
    /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */
    registerRoutesFromRegistry(opts?: {
        paths?: TRoutePathScope;
    }): void;
    /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */
    configure(opts?: ConfigurableOptions): Promise<OpenAPIHono<RouteEnv, RouteSchema, BasePath>>;
    /** @internal Builds auth + custom middlewares and security specs from route config. */
    buildRouteMiddlewares<RouteConfig extends IAuthRouteConfig>(opts: {
        configs: RouteConfig;
    }): {
        restConfig: Omit<RouteConfig, "authenticate" | "authorize">;
        security: {
            [x: string]: never[];
        }[];
        mws: import("hono").MiddlewareHandler<Env>[];
    };
    /** Processes route config, injecting auth middleware and OpenAPI security specs. */
    getRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: {
        configs: RouteConfig;
    }): RouteConfig & {
        getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${/*elided*/ any}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : T : never : never;
    };
    /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */
    getJSXRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: {
        configs: RouteConfig;
    }): RouteConfig & {
        getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${/*elided*/ any}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : T : never : never;
    };
    /** Override to register routes using bindRoute or defineRoute. */
    abstract binding(): ValueOrPromise<void>;
    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
    abstract bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {
        configs: RouteConfig;
    }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
    /** Defines and registers a route with its handler in a single call. */
    abstract 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>;
}
//# sourceMappingURL=abstract.d.ts.map