import { Path } from '../structures/path/index.js';
import { EndpointMethods } from './methods.js';
import type { IEndpointInfo } from './endpoint.types.js';
/** @import { buildApiCaller } from "./call" */
export type { IEndpointInfo };
/**
 * Defines REST API endpoint.
 *
 * Endpoint object can be used in a caller method (see {@link buildApiCaller}) to make a request.
 *
 * Basic definition {@link IEndpointInfo} which can be extended with additional properties and chaining mutation methods, see {@link IEndpointInfo.IForm} for example.
*/
export interface ApiEndpoint extends IEndpointInfo.Base {
    /** Applies specified HTTP method */
    withMethod(method: EndpointMethods): this;
    /** Applies GET HTTP method and specifies output type */
    get<TOut>(): this & IEndpointInfo.IOut<TOut>;
    /** Applies PUT HTTP method and specifies input and output types */
    put<TIn extends object | null, TOut>(): this & IEndpointInfo.IIn<TIn> & IEndpointInfo.IOut<TOut>;
    /** Applies PATCH HTTP method and specifies input and output types */
    patch<TIn extends object | null, TOut>(): this & IEndpointInfo.IIn<TIn> & IEndpointInfo.IOut<TOut>;
    /** Applies POST HTTP method and specifies input and output types */
    post<TIn extends object | null, TOut>(): this & IEndpointInfo.IIn<TIn> & IEndpointInfo.IOut<TOut>;
    /** Applies DELETE HTTP method and specifies output type */
    delete<TOut>(): this & IEndpointInfo.IOut<TOut>;
    /** Applies a type based on {@link Path.IBuilder} type by accepting arguments for {@link Path.construct} function */
    withPath<P extends readonly Path.BaseInput[]>(...path: P): this & IEndpointInfo.IPath<Path.CombineBuilders<P>>;
    /** Applies query type and also store query keys to make api caller be able to distinguish which keys should be ejected from request body. */
    withQuery<TQ extends object>(...queryKeys: (string & keyof TQ)[]): this & IEndpointInfo.IQuery<TQ>;
    /** Applies error type, optionally stores error processor. */
    withErrors<TErr>(errorProcessor?: (err: TErr) => void): this & IEndpointInfo.IErrors<TErr>;
    /** Applies headers type. */
    withHeaders<THeads>(_headersMarker?: THeads): this & IEndpointInfo.IHeaders<THeads>;
    /** Helper chain method for finalizing the type. Can make some runtime optimizations as well. */
    finalize(): IEndpointInfo.Finalized<this>;
}
export declare namespace ApiEndpoint {
    function isEndpoint(obj: any): obj is IEndpointInfo;
    interface IBuilder<T extends ApiEndpoint = ApiEndpoint> {
        (displayName?: string): T;
        extend<TExt>(extender: (base: T) => T & TExt): IBuilder<T & TExt>;
    }
    type IBuilderExtender<T> = <TBase extends ApiEndpoint>(base: TBase) => TBase & T;
    const create: IBuilder<ApiEndpoint>;
}