import { Response } from "./Response.mjs";
import { RouterConfig } from "../types/basic.mjs";
import { Request } from "./Request.mjs";
import { BindToken, BindValue, BindingOptions, Container } from "./bindings.mjs";

//#region src/core/plugins.d.ts
type PluginSetupResult = void | Promise<void>;
interface ClearRouterPluginRequestContext<HttpContext = any> {
  ctx: HttpContext;
  request: Request;
  response: Response;
  getBindings: () => Record<string, BindValue>;
  [key: string]: any;
}
interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRequestContext<X> {
  target?: object;
  method?: PropertyKey;
  handler?: object;
  metadata?: object;
  tokens: BindToken[];
  designTokens: BindToken[];
}
type PluginBindFactory<T = any, X = any> = (ctx: ClearRouterPluginRequestContext<X>) => T | Promise<T>;
type PluginBindValue<T = any, X = any> = BindValue<T> | PluginBindFactory<T, X>;
type PluginBind<X = any> = <T>(token: BindToken<T>, value: PluginBindValue<T, X>, options?: BindingOptions) => void;
type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
interface ClearRouterPluginContext<Options = any, HttpContext = any> {
  /**
   * The service container
   */
  container: Container;
  /**
   * Register service container bindings
   */
  bind: PluginBind<HttpContext>;
  /**
   * Replace all controller method arguments
   * @param resolver
   * @returns
   */
  resolveArguments: (resolver: PluginArgumentsResolver<HttpContext>) => void;
  /**
   * Use the current http context
   */
  useHttpContext: (resolver: PluginArgumentsResolver<HttpContext>) => void;
  /**
   * All registered service container bindings
   */
  bindings: Record<string, BindValue>;
  /**
   * Configures the router with the given options, such as method override settings
   *
   * @param options
   * @returns
   */
  configure: (options: RouterConfig) => void;
  /**
   * Default configuration used for everytime the router is reset
   *
   * @param options
   */
  configureDefaults: (options: RouterConfig) => void;
  /**
   * The current Request instance
   */
  readonly request?: Request;
  /**
   * The current Response instance
   * @returns
   */
  readonly response?: Response;
  /**
   * Get the current Request instance
   * @returns
   */
  getRequest: () => Request | undefined;
  /**
   * Get the current Response instance
   * @returns
   */
  getResponse: () => Response | undefined;
  /**
   * Plugin configuration options
   */
  options: Options;
}
interface ClearRouterPlugin<Options = any, HttpContext = any> {
  /**
   * The name of the plugin
   */
  name?: string;
  /**
   * Plugin setup an implemnetation
   *
   * @param ctx
   * @returns
   */
  setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
}
type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options, HttpContext> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
/**
 * Creates a new plugin
 *
 * @param plugin
 * @returns
 */
declare function definePlugin<Options = any, HttpContext = any>(plugin: ClearRouterPlugin<Options, HttpContext>): ClearRouterPlugin<Options, HttpContext>;
//#endregion
export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin };