gbox-sdk
    Preparing search index...

    Interface ClientOptions

    interface ClientOptions {
        apiKey?: string;
        baseURL?: null | string;
        defaultHeaders?: HeadersLike;
        defaultQuery?: Record<string, undefined | string>;
        environment?: "production" | "selfHosting" | "internal";
        fetch?: Fetch;
        fetchOptions?: MergedRequestInit;
        logger?: Logger;
        logLevel?: LogLevel;
        maxRetries?: number;
        timeout?: number;
    }
    Index

    Properties

    apiKey?: string

    Defaults to process.env['GBOX_API_KEY'].

    baseURL?: null | string

    Override the default base URL for the API, e.g., "https://api.example.com/v2/"

    Defaults to process.env['GBOX_CLIENT_BASE_URL'].

    defaultHeaders?: HeadersLike

    Default headers to include with every request to the API.

    These can be removed in individual requests by explicitly setting the header to null in request options.

    defaultQuery?: Record<string, undefined | string>

    Default query parameters to include with every request to the API.

    These can be removed in individual requests by explicitly setting the param to undefined in request options.

    environment?: "production" | "selfHosting" | "internal"

    Specifies the environment to use for the API.

    Each environment maps to a different base URL:

    • production corresponds to https://gbox.ai/api/v1/
    • selfHosting corresponds to http://localhost:28080/api/v1/
    • internal corresponds to http://gru.localhost:2080/api/v1/
    fetch?: Fetch

    Specify a custom fetch function implementation.

    If not provided, we expect that fetch is defined globally.

    fetchOptions?: MergedRequestInit

    Additional RequestInit options to be passed to fetch calls. Properties will be overridden by per-request fetchOptions.

    logger?: Logger

    Set the logger.

    Defaults to globalThis.console.

    logLevel?: LogLevel

    Set the log level.

    Defaults to process.env['GBOX_CLIENT_LOG'] or 'warn' if it isn't set.

    maxRetries?: number

    The maximum number of times that the client will retry a request in case of a temporary failure, like a network error or a 5XX error from the server.

    0
    
    timeout?: number

    The maximum amount of time (in milliseconds) that the client should wait for a response from the server before timing out a single request.

    Note that request timeouts are retried by default, so in a worst-case scenario you may wait much longer than this timeout before the promise succeeds or fails.

    milliseconds