import { APIResource } from "../../../core/resource.mjs";
import { APIPromise } from "../../../core/api-promise.mjs";
import { RequestOptions } from "../../../internal/request-options.mjs";
export declare class BaseOutages extends APIResource {
    static readonly _key: readonly ['radar', 'annotations', 'outages'];
    /**
     * Retrieves the latest Internet outages and anomalies.
     *
     * @example
     * ```ts
     * const outage = await client.radar.annotations.outages.get();
     * ```
     */
    get(query?: OutageGetParams | null | undefined, options?: RequestOptions): APIPromise<OutageGetResponse>;
    /**
     * Retrieves the number of outages by location.
     *
     * @example
     * ```ts
     * const response =
     *   await client.radar.annotations.outages.locations();
     * ```
     */
    locations(query?: OutageLocationsParams | null | undefined, options?: RequestOptions): APIPromise<OutageLocationsResponse>;
}
export declare class Outages extends BaseOutages {
}
export interface OutageGetResponse {
    annotations: Array<OutageGetResponse.Annotation>;
}
export declare namespace OutageGetResponse {
    interface Annotation {
        id: string;
        asns: Array<number>;
        asnsDetails: Array<Annotation.ASNsDetail>;
        dataSource: string;
        eventType: string;
        locations: Array<string>;
        locationsDetails: Array<Annotation.LocationsDetail>;
        origins: Array<string>;
        originsDetails: Array<Annotation.OriginsDetail>;
        outage: Annotation.Outage;
        startDate: string;
        description?: string;
        endDate?: string;
        linkedUrl?: string;
        scope?: string;
    }
    namespace Annotation {
        interface ASNsDetail {
            asn: string;
            name: string;
            locations?: ASNsDetail.Locations;
        }
        namespace ASNsDetail {
            interface Locations {
                code: string;
                name: string;
            }
        }
        interface LocationsDetail {
            code: string;
            name: string;
        }
        interface OriginsDetail {
            name: string;
            origin: string;
        }
        interface Outage {
            outageCause: string;
            outageType: string;
        }
    }
}
export interface OutageLocationsResponse {
    annotations: Array<OutageLocationsResponse.Annotation>;
}
export declare namespace OutageLocationsResponse {
    interface Annotation {
        clientCountryAlpha2: string;
        clientCountryName: string;
        /**
         * A numeric string.
         */
        value: string;
    }
}
export interface OutageGetParams {
    /**
     * Filters results by Autonomous System. Specify a single Autonomous System Number
     * (ASN) as integer.
     */
    asn?: number;
    /**
     * End of the date range (inclusive). Alternative to `dateRange`; provide together
     * with `dateStart`.
     */
    dateEnd?: string;
    /**
     * Filters results by a relative date range ending at the current time. Use `<n>d`
     * for days (up to `364d`) or `<n>w` for weeks (up to `52w`), e.g. `7d`. Append
     * `control` to request the equivalent previous period for comparison: the
     * comparison window is shifted back by the current window's length rounded up to a
     * whole number of weeks, so it keeps the same weekday alignment and does not
     * overlap the current window (e.g. `3dcontrol` covers days -10 to -7, `7dcontrol`
     * covers days -14 to -7, `28dcontrol` covers days -56 to -28, and `10dcontrol`
     * covers days -24 to -14). Mutually exclusive with `dateStart`/`dateEnd`.
     */
    dateRange?: string;
    /**
     * Start of the date range (inclusive). Alternative to `dateRange`; provide
     * together with `dateEnd`.
     */
    dateStart?: string;
    /**
     * Format in which results will be returned.
     */
    format?: 'JSON' | 'CSV';
    /**
     * Limits the number of objects returned in the response.
     */
    limit?: number;
    /**
     * Filters results by location. Specify an alpha-2 location code.
     */
    location?: string;
    /**
     * Skips the specified number of objects before fetching the results.
     */
    offset?: number;
    /**
     * Filters results by origin.
     */
    origin?: string;
}
export interface OutageLocationsParams {
    /**
     * End of the date range (inclusive). Alternative to `dateRange`; provide together
     * with `dateStart`.
     */
    dateEnd?: string;
    /**
     * Filters results by a relative date range ending at the current time. Use `<n>d`
     * for days (up to `364d`) or `<n>w` for weeks (up to `52w`), e.g. `7d`. Append
     * `control` to request the equivalent previous period for comparison: the
     * comparison window is shifted back by the current window's length rounded up to a
     * whole number of weeks, so it keeps the same weekday alignment and does not
     * overlap the current window (e.g. `3dcontrol` covers days -10 to -7, `7dcontrol`
     * covers days -14 to -7, `28dcontrol` covers days -56 to -28, and `10dcontrol`
     * covers days -24 to -14). Mutually exclusive with `dateStart`/`dateEnd`.
     */
    dateRange?: string;
    /**
     * Start of the date range (inclusive). Alternative to `dateRange`; provide
     * together with `dateEnd`.
     */
    dateStart?: string;
    /**
     * Format in which results will be returned.
     */
    format?: 'JSON' | 'CSV';
    /**
     * Limits the number of objects returned in the response.
     */
    limit?: number;
}
export declare namespace Outages {
    export { type OutageGetResponse as OutageGetResponse, type OutageLocationsResponse as OutageLocationsResponse, type OutageGetParams as OutageGetParams, type OutageLocationsParams as OutageLocationsParams, };
}
//# sourceMappingURL=outages.d.mts.map