/**
 * Composable Request Builder
 *
 * A type-safe, chainable request builder for the Yahoo Fantasy API.
 *
 * @module
 */
import type { HttpClient, RequestOptions } from '../client/HttpClient.js';
import type { PlayerStatusFilter, RosterChangeRequest, SortFilter } from '../types/request/filters.js';
import type { GameKeyLike, LeagueKeyLike, PendingTradeKeyLike, PlayerKeyLike, SubResourceName, TeamKeyLike, TransactionKeyLike, WaiverClaimKeyLike } from '../types/request/graph.js';
import type { InferResponseType } from '../types/request/response-routes.js';
import type { AllResponseTypes } from '../types/request/responses.js';
import type { FilterKeyForStage, NavigationMethodNamesForStage, NextStage, OutValueForStage, ParamHelperMethodsForStage, RouteStage, StagesWithNext, WriteMethodNamesForStage } from '../types/request/schema.js';
import type { TransactionBuilder } from './transaction.js';
/**
 * Path segment type used internally to build request paths.
 * There are two possible types of segments:
 *    - `/{resource}/{resource_key}[;out={sub_resource}[,{multi_sub_resource},...]][;{key}={value}]`
 *    - `/{collection};{resource}_keys={key}[,{key2},...][;out={sub_resource}[,{multi_sub_resource},...]][;{key}={value}]`
 */
export type PathSegment = ({
    type: 'resource';
    key: string;
} | {
    type: 'collection';
    keys?: string | string[];
}) & {
    name: string;
    out?: SubResourceName[];
    filters?: Record<string, string | string[] | number>;
};
interface RequestState {
    stage: RouteStage;
    segments: PathSegment[];
    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
    body?: Record<string, unknown> | string;
    options?: WriteRequestOptions;
    dispatchPath?: string;
    hasExecutedWriteRequest: boolean;
}
type FilterValue = string | string[] | number;
type TerminalMethodNames = 'buildPath' | 'execute' | 'post' | 'put' | 'delete' | 'toString' | '__pathType' | '__outType';
type BaseFilterMethodNames = 'filters';
type SharedMethodNames = TerminalMethodNames | BaseFilterMethodNames;
type WriteRequestOptions = Omit<RequestOptions, 'method' | 'body'>;
type DateFilterInput = string | Date;
type SplitCommaSeparated<TValue extends string> = TValue extends `${infer THead},${infer TTail}` ? THead | SplitCommaSeparated<TTail> : TValue;
type SelectedOutFromValue<TValue> = TValue extends readonly (infer TItem)[] ? Extract<TItem, string> : TValue extends string ? SplitCommaSeparated<TValue> : never;
type MergeSelectedOut<TStage extends RouteStage, TCurrentOut extends string, TValue> = Extract<TCurrentOut | SelectedOutFromValue<TValue>, OutValueForStage<TStage>>;
type StageMethodNames<TStage extends RouteStage> = SharedMethodNames | NavigationMethodNamesForStage<TStage> | ParamHelperMethodsForStage<TStage> | WriteMethodNamesForStage<TStage>;
type StageView<TStage extends RouteStage, TSelectedOut extends OutValueForStage<TStage> = never> = Pick<RequestBuilder<TStage, TSelectedOut>, Extract<StageMethodNames<TStage>, keyof RequestBuilder<TStage, TSelectedOut>>>;
/**
 * Composable Request Builder
 */
export declare class RequestBuilder<TStage extends RouteStage = 'root', TSelectedOut extends OutValueForStage<TStage> = never> {
    readonly __pathType: TStage;
    readonly __outType: TSelectedOut;
    protected state: RequestState;
    protected httpClient: HttpClient;
    constructor(httpClient: HttpClient);
    private getCurrentStageConfig;
    private getNextRuntimeStage;
    private stageAllowsWriteMethod;
    private assertWriteMethodAllowed;
    private stageSerializesObjectBodyAsYahooXml;
    private assertOutValuesAllowed;
    private addSegment;
    private getCurrentSegment;
    private setOutValue;
    private normalizeOutValue;
    private setFilter;
    private setFilters;
    private normalizeDateValue;
    private serializeToYahooXml;
    private normalizeWriteBody;
    private assertTransactionsCollectionPath;
    private isTransactionResourcePath;
    private assertTransactionWritePath;
    private assertTeamRosterPath;
    private buildRosterChangePayload;
    private setPendingWriteRequest;
    private clearPendingWriteRequest;
    private asStage;
    game(key: GameKeyLike): StageView<'game'>;
    league(key: LeagueKeyLike): StageView<'league'>;
    team(key: TeamKeyLike): StageView<'team'>;
    player(key: PlayerKeyLike): StageView<'player'>;
    transaction(key: TransactionKeyLike | WaiverClaimKeyLike | PendingTradeKeyLike): StageView<'transaction'>;
    users(): StageView<'users'>;
    settings(): TStage extends StagesWithNext<'settings'> ? StageView<NextStage<TStage, 'settings'>> : never;
    standings(): TStage extends StagesWithNext<'standings'> ? StageView<NextStage<TStage, 'standings'>> : never;
    scoreboard(): TStage extends StagesWithNext<'scoreboard'> ? StageView<NextStage<TStage, 'scoreboard'>> : never;
    roster(filters?: {
        week?: string | number;
        date?: DateFilterInput;
    }): TStage extends StagesWithNext<'roster'> ? StageView<NextStage<TStage, 'roster'>> : never;
    matchups(filters?: {
        weeks?: string;
    }): TStage extends StagesWithNext<'matchups'> ? StageView<NextStage<TStage, 'matchups'>> : never;
    stats(filters?: {
        type?: string;
        week?: string | number;
        date?: DateFilterInput;
    }): TStage extends StagesWithNext<'stats'> ? StageView<NextStage<TStage, 'stats'>> : never;
    ownership(): TStage extends StagesWithNext<'ownership'> ? StageView<NextStage<TStage, 'ownership'>> : never;
    percentOwned(): TStage extends StagesWithNext<'percentOwned'> ? StageView<NextStage<TStage, 'percentOwned'>> : never;
    draftAnalysis(): TStage extends StagesWithNext<'draftAnalysis'> ? StageView<NextStage<TStage, 'draftAnalysis'>> : never;
    statCategories(): TStage extends StagesWithNext<'statCategories'> ? StageView<NextStage<TStage, 'statCategories'>> : never;
    positionTypes(): TStage extends StagesWithNext<'positionTypes'> ? StageView<NextStage<TStage, 'positionTypes'>> : never;
    gameWeeks(): TStage extends StagesWithNext<'gameWeeks'> ? StageView<NextStage<TStage, 'gameWeeks'>> : never;
    leagues(): TStage extends StagesWithNext<'leagues'> ? StageView<NextStage<TStage, 'leagues'>> : never;
    teams(): TStage extends StagesWithNext<'teams'> ? StageView<NextStage<TStage, 'teams'>> : never;
    players(): TStage extends StagesWithNext<'players'> ? StageView<NextStage<TStage, 'players'>> : never;
    transactions(): TStage extends StagesWithNext<'transactions'> ? StageView<NextStage<TStage, 'transactions'>> : never;
    create(transaction: TransactionBuilder, options?: WriteRequestOptions): this;
    /**
     * Stages a PUT request to edit a transaction.
     *
     * When called on a transaction resource (via `.transaction(key)`):
     * `@example`
     * request.transaction('248.l.55438.pt.11').edit({ transaction: { action: 'accept' } })
     *
     * When called on a transactions collection (via `.league(key).transactions()`):
     * `@example`
     * request.league('248.l.55438').transactions().edit('248.l.55438.w.c.2_6093', { transaction: { ... } })
     */
    edit(transactionKey: TransactionKeyLike | WaiverClaimKeyLike | PendingTradeKeyLike, payload: Record<string, unknown> | string, options?: WriteRequestOptions): this;
    edit(transactionKey: TransactionKeyLike | WaiverClaimKeyLike | PendingTradeKeyLike, payload: Record<string, unknown> | string, options?: WriteRequestOptions): this;
    edit(payload: Record<string, unknown> | string, options?: WriteRequestOptions): this;
    cancel(transactionKey: TransactionKeyLike | WaiverClaimKeyLike | PendingTradeKeyLike, options?: WriteRequestOptions): this;
    cancel(options?: WriteRequestOptions): this;
    updateLineup(payload: RosterChangeRequest, options?: WriteRequestOptions): this;
    drafts(): TStage extends StagesWithNext<'drafts'> ? StageView<NextStage<TStage, 'drafts'>> : never;
    games(): TStage extends StagesWithNext<'games'> ? StageView<NextStage<TStage, 'games'>> : never;
    filters<TFilters extends Partial<Record<FilterKeyForStage<TStage>, FilterValue>>>(filters: TFilters): this;
    out<TValue extends OutValueForStage<TStage> | readonly OutValueForStage<TStage>[]>(subResources: TValue): StageView<TStage, MergeSelectedOut<TStage, TSelectedOut, TValue>>;
    position(pos: string): this;
    status(status: PlayerStatusFilter | string): this;
    type(value: string): this;
    types(values: string | string[]): this;
    teamKey(key: TeamKeyLike): this;
    sort(sort: SortFilter | string): this;
    count(n: number): this;
    start(n: number): this;
    search(q: string): this;
    week(w: number | string): this;
    date(d: DateFilterInput): this;
    gameKeys(keys: string | string[]): this;
    isAvailable(value?: boolean | 0 | 1 | '0' | '1'): this;
    gameTypes(types: string | string[]): this;
    gameCodes(codes: string | string[]): this;
    seasons(values: number | string | Array<number | string>): this;
    leagueKeys(keys: string | string[]): this;
    teamKeys(keys: string | string[]): this;
    playerKeys(keys: string | string[]): this;
    useLogin(): this;
    buildPath(): string;
    execute<T = InferResponseType<TStage, TSelectedOut> extends never ? AllResponseTypes : InferResponseType<TStage, TSelectedOut>>(): Promise<T>;
    post<T = InferResponseType<TStage, TSelectedOut> extends never ? AllResponseTypes : InferResponseType<TStage, TSelectedOut>>(data?: Record<string, unknown> | string, options?: WriteRequestOptions): Promise<T>;
    put<T = InferResponseType<TStage, TSelectedOut> extends never ? AllResponseTypes : InferResponseType<TStage, TSelectedOut>>(data?: Record<string, unknown> | string, options?: WriteRequestOptions): Promise<T>;
    delete<T = InferResponseType<TStage, TSelectedOut> extends never ? AllResponseTypes : InferResponseType<TStage, TSelectedOut>>(options?: WriteRequestOptions): Promise<T>;
    toString(): string;
    protected formatValue(value: string | string[] | number): string;
}
export type RootRequestBuilder = StageView<'root'>;
export declare function createRequest(httpClient: HttpClient): RootRequestBuilder;
export {};
//# sourceMappingURL=request.d.ts.map