@atomist/automation-client/spi/http/httpClient.d.ts

Atomist API for software low-level client

import { WrapOptions } from "retry";
/**
 * Available HTTP request methods to use with HttpClient.
 */
export declare enum HttpMethod {
    Get = "GET",
    Post = "POST",
    Put = "PUT",
    Delete = "DELETE",
    Options = "OPTIONS",
    Patch = "PATCH"
}
/**
 * HTTP options to pass into HttpClient.exchange.
 */
export interface HttpClientOptions {
    /** Optional HTTP request method; defaults to HtppMethod.Get */
    method?: HttpMethod;
    /** Optional HTTP headers to be included in the request */
    headers?: {
        [name: string]: string;
    };
    /** Optional payload body to be sent */
    body?: any;
    /** Optional retry options */
    retry?: WrapOptions;
    /** Raw options to be passed to the underlying implementation; Please use with care */
    options?: any;
}
/**
 * HTTP response from HttpClient.exchange.
 */
export interface HttpResponse<T> {
    /** HTTP status code */
    status: number;
    /** Optional HTTP headers to server returned */
    headers?: {
        [name: string]: string;
    };
    /** Optional response body of type T */
    body?: T;
}
/**
 * HTTP request abstraction to be implemented by different frameworks and command line
 * tools.
 */
export interface HttpClient {
    /**
     * Exchange the given HTTP request with the server at url.
     * @param {string} url
     * @param {HttpClientOptions} options
     * @returns {Promise<HttpResponse<T>>}
     */
    exchange<T>(url: string, options?: HttpClientOptions): Promise<HttpResponse<T>>;
}
/**
 * Factory to construct HttpClient instances.
 */
export interface HttpClientFactory {
    /**
     * Create a HttpClient for the given url.
     * @param {string} url
     * @returns {HttpClient}
     */
    create(url?: string): HttpClient;
}
/**
 * Default HTTP client options each implementation to should use.
 * @type {{method: HttpMethod; headers: {}; retry: WrapOptions}}
 */
export declare const DefaultHttpClientOptions: HttpClientOptions;
//# sourceMappingURL=httpClient.d.ts.map