@algolia/monitoring 5.2.4-beta.5 → 5.10.0-beta.1

package/dist/node.d.cts

@@ -1,25 +1,10 @@
 import * as _algolia_client_common from '@algolia/client-common';
-import { ClientOptions } from '@algolia/client-common';
-
-type BadRequest = {
-    reason?: string;
-};
-
-/**
- * Error.
- */
-type ErrorBase = Record<string, any> & {
-    message?: string;
-};
-
-type Forbidden = {
-    reason?: string;
-};
+import { CreateClientOptions, RequestOptions, ClientOptions } from '@algolia/client-common';
 
 /**
  * Status of the cluster.
  */
-type Status = 'degraded_performance' | 'major_outage' | 'operational' | 'partial_outage';
+type Status = 'operational' | 'degraded_performance' | 'partial_outage' | 'major_outage';
 
 /**
  * Incident details.
@@ -41,7 +26,9 @@ type IncidentEntry = {
 };
 
 type IncidentsResponse = {
-    incidents?: Record<string, IncidentEntry[]>;
+    incidents?: {
+        [key: string]: Array<IncidentEntry>;
+    };
 };
 
 type TimeEntry = {
@@ -56,7 +43,9 @@ type TimeEntry = {
 };
 
 type IndexingMetric = {
-    indexing?: Record<string, TimeEntry[]>;
+    indexing?: {
+        [key: string]: Array<TimeEntry>;
+    };
 };
 
 type IndexingTimeResponse = {
@@ -78,23 +67,33 @@ type Metrics = {
     /**
      * CPU idleness in %.
      */
-    cpu_usage?: Record<string, ProbesMetric[]>;
+    cpu_usage?: {
+        [key: string]: Array<ProbesMetric>;
+    };
     /**
      * RAM used for indexing in MB.
      */
-    ram_indexing_usage?: Record<string, ProbesMetric[]>;
+    ram_indexing_usage?: {
+        [key: string]: Array<ProbesMetric>;
+    };
     /**
      * RAM used for search in MB.
      */
-    ram_search_usage?: Record<string, ProbesMetric[]>;
+    ram_search_usage?: {
+        [key: string]: Array<ProbesMetric>;
+    };
     /**
      * Solid-state disk (SSD) usage expressed as % of RAM.  0% means no SSD usage. A value of 50% indicates 32&nbsp;GB SSD usage for a machine with 64&nbsp;RAM.
      */
-    ssd_usage?: Record<string, ProbesMetric[]>;
+    ssd_usage?: {
+        [key: string]: Array<ProbesMetric>;
+    };
     /**
      * Average build time of the indices in seconds.
      */
-    avg_build_time?: Record<string, ProbesMetric[]>;
+    avg_build_time?: {
+        [key: string]: Array<ProbesMetric>;
+    };
 };
 
 type InfrastructureResponse = {
@@ -133,28 +132,28 @@ type Server = {
 };
 
 type InventoryResponse = {
-    inventory?: Server[];
+    inventory?: Array<Server>;
 };
 
 type LatencyMetric = {
-    latency?: Record<string, TimeEntry[]>;
+    latency?: {
+        [key: string]: Array<TimeEntry>;
+    };
 };
 
 type LatencyResponse = {
     metrics?: LatencyMetric;
 };
 
-type Metric = '*' | 'avg_build_time' | 'cpu_usage' | 'ram_indexing_usage' | 'ram_search_usage' | 'ssd_usage';
-
-type Period = 'day' | 'hour' | 'minute' | 'month' | 'week';
-
 type StatusResponse = {
-    status?: Record<string, Status>;
+    status?: {
+        [key: string]: Status;
+    };
 };
 
-type Unauthorized = {
-    reason?: string;
-};
+type Metric = 'avg_build_time' | 'ssd_usage' | 'ram_search_usage' | 'ram_indexing_usage' | 'cpu_usage' | '*';
+
+type Period = 'minute' | 'hour' | 'day' | 'week' | 'month';
 
 /**
  * Properties for the `customDelete` method.
@@ -167,7 +166,9 @@ type CustomDeleteProps = {
     /**
      * Query parameters to apply to the current query.
      */
-    parameters?: Record<string, any>;
+    parameters?: {
+        [key: string]: any;
+    };
 };
 /**
  * Properties for the `customGet` method.
@@ -180,7 +181,9 @@ type CustomGetProps = {
     /**
      * Query parameters to apply to the current query.
      */
-    parameters?: Record<string, any>;
+    parameters?: {
+        [key: string]: any;
+    };
 };
 /**
  * Properties for the `customPost` method.
@@ -193,7 +196,9 @@ type CustomPostProps = {
     /**
      * Query parameters to apply to the current query.
      */
-    parameters?: Record<string, any>;
+    parameters?: {
+        [key: string]: any;
+    };
     /**
      * Parameters to send with the custom request.
      */
@@ -210,7 +215,9 @@ type CustomPutProps = {
     /**
      * Query parameters to apply to the current query.
      */
-    parameters?: Record<string, any>;
+    parameters?: {
+        [key: string]: any;
+    };
     /**
      * Parameters to send with the custom request.
      */
@@ -221,7 +228,7 @@ type CustomPutProps = {
  */
 type GetClusterIncidentsProps = {
     /**
-     * Subset of clusters, separated by comma.
+     * Subset of clusters, separated by commas.
      */
     clusters: string;
 };
@@ -230,7 +237,7 @@ type GetClusterIncidentsProps = {
  */
 type GetClusterStatusProps = {
     /**
-     * Subset of clusters, separated by comma.
+     * Subset of clusters, separated by commas.
      */
     clusters: string;
 };
@@ -239,7 +246,7 @@ type GetClusterStatusProps = {
  */
 type GetIndexingTimeProps = {
     /**
-     * Subset of clusters, separated by comma.
+     * Subset of clusters, separated by commas.
      */
     clusters: string;
 };
@@ -248,7 +255,7 @@ type GetIndexingTimeProps = {
  */
 type GetLatencyProps = {
     /**
-     * Subset of clusters, separated by comma.
+     * Subset of clusters, separated by commas.
      */
     clusters: string;
 };
@@ -270,36 +277,161 @@ type GetMetricsProps = {
  */
 type GetReachabilityProps = {
     /**
-     * Subset of clusters, separated by comma.
+     * Subset of clusters, separated by commas.
      */
     clusters: string;
 };
 
-declare const apiClientVersion = "1.2.4";
-
-/**
- * The client type.
- */
-type MonitoringClient = ReturnType<typeof monitoringClient>;
-declare function monitoringClient(appId: string, apiKey: string, options?: ClientOptions): {
+declare const apiClientVersion = "1.10.0";
+declare function createMonitoringClient({ appId: appIdOption, apiKey: apiKeyOption, authMode, algoliaAgents, ...options }: CreateClientOptions): {
     transporter: _algolia_client_common.Transporter;
+    /**
+     * The `appId` currently in use.
+     */
     appId: string;
+    /**
+     * Clears the cache of the transporter for the `requestsCache` and `responsesCache` properties.
+     */
     clearCache(): Promise<void>;
-    _ua: string;
+    /**
+     * Get the value of the `algoliaAgent`, used by our libraries internally and telemetry system.
+     */
+    readonly _ua: string;
+    /**
+     * Adds a `segment` to the `x-algolia-agent` sent with every requests.
+     *
+     * @param segment - The algolia agent (user-agent) segment to add.
+     * @param version - The version of the agent.
+     */
     addAlgoliaAgent(segment: string, version?: string): void;
-    customDelete({ path, parameters }: CustomDeleteProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<Record<string, unknown>>;
-    customGet({ path, parameters }: CustomGetProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<Record<string, unknown>>;
-    customPost({ path, parameters, body }: CustomPostProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<Record<string, unknown>>;
-    customPut({ path, parameters, body }: CustomPutProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<Record<string, unknown>>;
-    getClusterIncidents({ clusters }: GetClusterIncidentsProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<IncidentsResponse>;
-    getClusterStatus({ clusters }: GetClusterStatusProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<StatusResponse>;
-    getIncidents(requestOptions?: _algolia_client_common.RequestOptions): Promise<IncidentsResponse>;
-    getIndexingTime({ clusters }: GetIndexingTimeProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<IndexingTimeResponse>;
-    getLatency({ clusters }: GetLatencyProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<LatencyResponse>;
-    getMetrics({ metric, period }: GetMetricsProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<InfrastructureResponse>;
-    getReachability({ clusters }: GetReachabilityProps, requestOptions?: _algolia_client_common.RequestOptions): Promise<Record<string, Record<string, boolean>>>;
-    getServers(requestOptions?: _algolia_client_common.RequestOptions): Promise<InventoryResponse>;
-    getStatus(requestOptions?: _algolia_client_common.RequestOptions): Promise<StatusResponse>;
+    /**
+     * Helper method to switch the API key used to authenticate the requests.
+     *
+     * @param params - Method params.
+     * @param params.apiKey - The new API Key to use.
+     */
+    setClientApiKey({ apiKey }: {
+        apiKey: string;
+    }): void;
+    /**
+     * This method allow you to send requests to the Algolia REST API.
+     * @param customDelete - The customDelete object.
+     * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
+     * @param customDelete.parameters - Query parameters to apply to the current query.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    customDelete({ path, parameters }: CustomDeleteProps, requestOptions?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * This method allow you to send requests to the Algolia REST API.
+     * @param customGet - The customGet object.
+     * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
+     * @param customGet.parameters - Query parameters to apply to the current query.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    customGet({ path, parameters }: CustomGetProps, requestOptions?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * This method allow you to send requests to the Algolia REST API.
+     * @param customPost - The customPost object.
+     * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
+     * @param customPost.parameters - Query parameters to apply to the current query.
+     * @param customPost.body - Parameters to send with the custom request.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    customPost({ path, parameters, body }: CustomPostProps, requestOptions?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * This method allow you to send requests to the Algolia REST API.
+     * @param customPut - The customPut object.
+     * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
+     * @param customPut.parameters - Query parameters to apply to the current query.
+     * @param customPut.body - Parameters to send with the custom request.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    customPut({ path, parameters, body }: CustomPutProps, requestOptions?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * Retrieves known incidents for the selected clusters.
+     * @param getClusterIncidents - The getClusterIncidents object.
+     * @param getClusterIncidents.clusters - Subset of clusters, separated by commas.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getClusterIncidents({ clusters }: GetClusterIncidentsProps, requestOptions?: RequestOptions): Promise<IncidentsResponse>;
+    /**
+     * Retrieves the status of selected clusters.
+     * @param getClusterStatus - The getClusterStatus object.
+     * @param getClusterStatus.clusters - Subset of clusters, separated by commas.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getClusterStatus({ clusters }: GetClusterStatusProps, requestOptions?: RequestOptions): Promise<StatusResponse>;
+    /**
+     * Retrieves known incidents for all clusters.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getIncidents(requestOptions?: RequestOptions): Promise<IncidentsResponse>;
+    /**
+     * Retrieves average times for indexing operations for selected clusters.
+     * @param getIndexingTime - The getIndexingTime object.
+     * @param getIndexingTime.clusters - Subset of clusters, separated by commas.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getIndexingTime({ clusters }: GetIndexingTimeProps, requestOptions?: RequestOptions): Promise<IndexingTimeResponse>;
+    /**
+     * Retrieves the average latency for search requests for selected clusters.
+     * @param getLatency - The getLatency object.
+     * @param getLatency.clusters - Subset of clusters, separated by commas.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getLatency({ clusters }: GetLatencyProps, requestOptions?: RequestOptions): Promise<LatencyResponse>;
+    /**
+     * Retrieves metrics related to your Algolia infrastructure, aggregated over a selected time window.  Access to this API is available as part of the [Premium or Elevate plans](https://www.algolia.com/pricing). You must authenticate requests with the `x-algolia-application-id` and `x-algolia-api-key` headers (using the Monitoring API key).
+     * @param getMetrics - The getMetrics object.
+     * @param getMetrics.metric - Metric to report.  For more information about the individual metrics, see the description of the API response. To include all metrics, use `*`.
+     * @param getMetrics.period - Period over which to aggregate the metrics:  - `minute`. Aggregate the last minute. 1 data point per 10 seconds. - `hour`. Aggregate the last hour. 1 data point per minute. - `day`. Aggregate the last day. 1 data point per 10 minutes. - `week`. Aggregate the last week. 1 data point per hour. - `month`. Aggregate the last month. 1 data point per day.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getMetrics({ metric, period }: GetMetricsProps, requestOptions?: RequestOptions): Promise<InfrastructureResponse>;
+    /**
+     * Test whether clusters are reachable or not.
+     * @param getReachability - The getReachability object.
+     * @param getReachability.clusters - Subset of clusters, separated by commas.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getReachability({ clusters }: GetReachabilityProps, requestOptions?: RequestOptions): Promise<{
+        [key: string]: {
+            [key: string]: boolean;
+        };
+    }>;
+    /**
+     * Retrieves the servers that belong to clusters.  The response depends on whether you authenticate your API request:  - With authentication, the response lists the servers assigned to your Algolia application\'s cluster.  - Without authentication, the response lists the servers for all Algolia clusters.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getServers(requestOptions?: RequestOptions): Promise<InventoryResponse>;
+    /**
+     * Retrieves the status of all Algolia clusters and instances.
+     * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+     */
+    getStatus(requestOptions?: RequestOptions): Promise<StatusResponse>;
+};
+
+type BadRequest = {
+    reason?: string;
+};
+
+/**
+ * Error.
+ */
+type ErrorBase = Record<string, any> & {
+    message?: string;
 };
 
+type Forbidden = {
+    reason?: string;
+};
+
+type Unauthorized = {
+    reason?: string;
+};
+
+type MonitoringClient = ReturnType<typeof createMonitoringClient>;
+
+declare function monitoringClient(appId: string, apiKey: string, options?: ClientOptions): MonitoringClient;
+
 export { type BadRequest, type CustomDeleteProps, type CustomGetProps, type CustomPostProps, type CustomPutProps, type ErrorBase, type Forbidden, type GetClusterIncidentsProps, type GetClusterStatusProps, type GetIndexingTimeProps, type GetLatencyProps, type GetMetricsProps, type GetReachabilityProps, type Incident, type IncidentEntry, type IncidentsResponse, type IndexingMetric, type IndexingTimeResponse, type InfrastructureResponse, type InventoryResponse, type LatencyMetric, type LatencyResponse, type Metric, type Metrics, type MonitoringClient, type Period, type ProbesMetric, type Region, type Server, type ServerStatus, type Status, type StatusResponse, type TimeEntry, type Type, type Unauthorized, apiClientVersion, monitoringClient };