import { type NamedService, type ServiceDescriptor } from '@conduit-client/utils';
import type { RetryService } from '@conduit-client/service-retry/v1';
export type FetchParameters = Parameters<typeof fetch>;
/**
 * The first argument to `fetch` (a `RequestInfo | URL` in lib.dom). Pulled
 * via index access so we don't depend on the DOM `RequestInfo` name being
 * directly resolvable in every consuming tsconfig.
 */
export type FetchInput = FetchParameters[0];
/**
 * Optional per-call data passed by callers (typically `FetchNetworkCommand`
 * subclasses) and merged into the per-request interceptor context inside
 * `buildServiceDescriptor`. Carried on the `init` argument under the
 * `__contextSeed` key (see `ExtendedRequestInit`) so that detection is a
 * named-property lookup rather than positional arity sniffing — runtime
 * type checks beat length checks for distinguishing a seed from a vanilla
 * `RequestInit`. The seed is stripped from `init` before the underlying
 * `fetch` call, so it never reaches the network.
 */
export type FetchContextSeed = Record<string, unknown>;
/**
 * `RequestInit` plus an optional `__contextSeed` slot. Every existing
 * `RequestInit` value is assignable to this type, so today's callers
 * continue to compile and behave identically.
 */
export type ExtendedRequestInit = RequestInit & {
    __contextSeed?: FetchContextSeed;
};
export type FetchService = (input: FetchInput, init?: ExtendedRequestInit) => PromiseLike<Response>;
export type IFetchService = FetchService;
export type FetchServiceDescriptor = ServiceDescriptor<IFetchService, 'fetch', '1.0'>;
export type NamedFetchService<Name extends string = 'fetch'> = NamedService<Name, IFetchService>;
export type RequestInterceptor<Context = unknown> = (fetchArgs: FetchParameters, context?: Context) => PromiseLike<FetchParameters>;
export type RetryInterceptor<Context = unknown> = (fetchArgs: FetchParameters, retryService?: RetryService<Response>, context?: Context) => PromiseLike<Response>;
export type ResponseInterceptor<Context = unknown> = (response: Response, context?: Context) => PromiseLike<Response>;
export type FinallyInterceptor<Context = unknown> = (context?: Context) => PromiseLike<void> | void;
export type Interceptors<Context = unknown> = {
    createContext?: () => Context;
    request?: RequestInterceptor<Context>[];
    retry?: RetryInterceptor<Context>;
    response?: ResponseInterceptor<Context>[];
    finally?: FinallyInterceptor<Context>[];
};
export declare function buildServiceDescriptor<Context = unknown>(interceptors?: Interceptors<Context>, retryService?: RetryService<Response>): FetchServiceDescriptor;