/** Spotlight HTTP client configuration (env-agnostic). */
export interface SpotlightClientConfig {
    serverUrl: string;
    apiKey?: string;
    projectId: string;
}
export declare class SpotlightHttpError extends Error {
    readonly status: number;
    readonly code?: string | undefined;
    readonly retryable?: boolean | undefined;
    readonly details?: unknown | undefined;
    constructor(message: string, status: number, code?: string | undefined, retryable?: boolean | undefined, details?: unknown | undefined);
}
export declare function normalizeServerUrl(url: string): string;
export declare function resolveSpotlightClientConfig(partial: Partial<SpotlightClientConfig> & Pick<SpotlightClientConfig, "projectId">): SpotlightClientConfig;
export declare function buildJsonHeaders(config: SpotlightClientConfig): Record<string, string>;
export declare function appendProjectQuery(config: SpotlightClientConfig, path: string): string;
export declare function createSpotlightHttp(config: SpotlightClientConfig): {
    config: SpotlightClientConfig;
    getBase: () => string;
    jsonHeaders: () => Record<string, string>;
    appendProjectQuery: (path: string) => string;
    getJson<T>(path: string, signal?: AbortSignal): Promise<T>;
    postJson<T>(path: string, body: unknown, signal?: AbortSignal): Promise<T>;
};
export type SpotlightHttp = ReturnType<typeof createSpotlightHttp>;
//# sourceMappingURL=http.d.ts.map