@metronome/sdk 0.2.0 → 1.0.0

package/resources/v1/customers/alerts.d.mts

@@ -0,0 +1,288 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as Shared from "../../shared.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { CursorPageWithoutLimit, type CursorPageWithoutLimitParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Alerts extends APIResource {
+    /**
+     * Retrieve the real-time evaluation status for a specific alert-customer pair.
+     * This endpoint provides instant visibility into whether a customer has triggered
+     * an alert condition, enabling you to monitor account health and take proactive
+     * action based on current alert states.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Check if a specific customer is currently violating an alert threshold
+     *   (`in_alarm` status)
+     * - Verify alert configuration details and threshold values for a customer
+     * - Integrate alert status checks into customer support tools or admin interfaces
+     *
+     * ### Key response fields:
+     *
+     * A CustomerAlert object containing:
+     *
+     * - `customer_status`: The current evaluation state
+     *
+     * - `ok` - Customer is within acceptable thresholds
+     * - `in_alarm`- Customer has breached the alert threshold
+     * - `evaluating` - Alert has yet to be evaluated (typically due to a customer or
+     *   alert having just been created)
+     * - `null` - Alert has been archived
+     * - `triggered_by`: Additional context about what caused the alert to trigger
+     *   (when applicable)
+     * - alert: Complete alert configuration including:
+     *   - Alert ID, name, and type
+     *   - Current threshold values and credit type information
+     *   - Alert status (enabled, disabled, or archived)
+     *   - Last update timestamp
+     *   - Any applied filters (credit grant types, custom fields, group values)
+     *
+     * ### Usage guidelines:
+     *
+     * - Customer status: Returns the current evaluation state, not historical data.
+     *   For alert history, use webhook notifications or event logs
+     * - Archived alerts: Returns null for customer_status if the alert has been
+     *   archived, but still includes the alert configuration details
+     * - Integration patterns: This endpoint can be used to check a customer's alert
+     *   status, but shouldn't be scraped. You should instead rely on the webhook
+     *   notification to understand when customers are moved to IN_ALARM.
+     * - Error handling: Returns 404 if either the customer or alert ID doesn't exist
+     *   or isn't accessible to your organization
+     *
+     * @example
+     * ```ts
+     * const alert = await client.v1.customers.alerts.retrieve({
+     *   alert_id: '8deed800-1b7a-495d-a207-6c52bac54dc9',
+     *   customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1',
+     * });
+     * ```
+     */
+    retrieve(body: AlertRetrieveParams, options?: RequestOptions): APIPromise<AlertRetrieveResponse>;
+    /**
+     * Retrieve all alert configurations and their current statuses for a specific
+     * customer in a single API call. This endpoint provides a comprehensive view of
+     * all alerts monitoring a customer account.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Display all active alerts for a customer in dashboards or admin panels
+     * - Quickly identify which alerts a customer is currently triggering
+     * - Audit alert coverage for specific accounts
+     * - Filter alerts by status (enabled, disabled, or archived)
+     *
+     * ### Key response fields:
+     *
+     * - data: Array of CustomerAlert objects, each containing:
+     *   - Current evaluation status (`ok`, `in_alarm`, `evaluating`, or `null`)
+     *   - Complete alert configuration and threshold details
+     *   - Alert metadata including type, name, and last update time
+     * - `next_page`: Pagination cursor for retrieving additional results
+     *
+     * ### Usage guidelines:
+     *
+     * - Default behavior: Returns only enabled alerts unless alert_statuses filter is
+     *   specified
+     * - Pagination: Use the `next_page` cursor to retrieve all results for customers
+     *   with many alerts
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const customerAlert of client.v1.customers.alerts.list(
+     *   { customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params: AlertListParams, options?: RequestOptions): PagePromise<CustomerAlertsCursorPageWithoutLimit, CustomerAlert>;
+    /**
+     * Force an immediate re-evaluation of a specific alert for a customer, clearing
+     * any previous state and triggering a fresh assessment against current thresholds.
+     * This endpoint ensures alert accuracy after configuration changes or data
+     * corrections.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Clear false positive alerts after fixing data issues
+     * - Re-evaluate alerts after adjusting customer balances or credits
+     * - Test alert behavior during development and debugging
+     * - Resolve stuck alerts that may be in an incorrect state
+     * - Trigger immediate evaluation after threshold modifications
+     *
+     * ### Key response fields:
+     *
+     * - 200 Success: Confirmation that the alert has been reset and re-evaluation
+     *   initiated
+     * - No response body is returned - the operation completes asynchronously
+     *
+     * ### Usage guidelines:
+     *
+     * - Immediate effect: Triggers re-evaluation instantly, which may result in new
+     *   webhook notifications if thresholds are breached
+     * - State clearing: Removes any cached evaluation state, ensuring a fresh
+     *   assessment
+     * - Use sparingly: Intended for exceptional cases, not routine operations
+     * - Asynchronous processing: The reset completes immediately, but re-evaluation
+     *   happens in the background
+     *
+     * @example
+     * ```ts
+     * await client.v1.customers.alerts.reset({
+     *   alert_id: '5e8691bf-b22a-4672-922d-f80eee940f01',
+     *   customer_id: '4c83caf3-8af4-44e2-9aeb-e290531726d9',
+     * });
+     * ```
+     */
+    reset(body: AlertResetParams, options?: RequestOptions): APIPromise<void>;
+}
+export type CustomerAlertsCursorPageWithoutLimit = CursorPageWithoutLimit<CustomerAlert>;
+export interface CustomerAlert {
+    alert: CustomerAlert.Alert;
+    /**
+     * The status of the customer alert. If the alert is archived, null will be
+     * returned.
+     */
+    customer_status: 'ok' | 'in_alarm' | 'evaluating' | null;
+    /**
+     * If present, indicates the reason the alert was triggered.
+     */
+    triggered_by?: string | null;
+}
+export declare namespace CustomerAlert {
+    interface Alert {
+        /**
+         * the Metronome ID of the alert
+         */
+        id: string;
+        /**
+         * Name of the alert
+         */
+        name: string;
+        /**
+         * Status of the alert
+         */
+        status: 'enabled' | 'archived' | 'disabled';
+        /**
+         * Threshold value of the alert policy
+         */
+        threshold: number;
+        /**
+         * Type of the alert
+         */
+        type: 'low_credit_balance_reached' | 'spend_threshold_reached' | 'monthly_invoice_total_spend_threshold_reached' | 'low_remaining_days_in_plan_reached' | 'low_remaining_credit_percentage_reached' | 'usage_threshold_reached' | 'low_remaining_days_for_commit_segment_reached' | 'low_remaining_commit_balance_reached' | 'low_remaining_commit_percentage_reached' | 'low_remaining_days_for_contract_credit_segment_reached' | 'low_remaining_contract_credit_balance_reached' | 'low_remaining_contract_credit_percentage_reached' | 'low_remaining_contract_credit_and_commit_balance_reached' | 'invoice_total_reached';
+        /**
+         * Timestamp for when the alert was last updated
+         */
+        updated_at: string;
+        /**
+         * An array of strings, representing a way to filter the credit grant this alert
+         * applies to, by looking at the credit_grant_type field on the credit grant. This
+         * field is only defined for CreditPercentage and CreditBalance alerts
+         */
+        credit_grant_type_filters?: Array<string>;
+        credit_type?: Shared.CreditTypeData | null;
+        /**
+         * A list of custom field filters for alert types that support advanced filtering
+         */
+        custom_field_filters?: Array<Alert.CustomFieldFilter>;
+        /**
+         * Scopes alert evaluation to a specific presentation group key on individual line
+         * items. Only present for spend alerts.
+         */
+        group_key_filter?: Alert.GroupKeyFilter;
+        /**
+         * Only present for `spend_threshold_reached` alerts. Scope alert to a specific
+         * group key on individual line items.
+         */
+        group_values?: Array<Alert.GroupValue>;
+        /**
+         * Only supported for invoice_total_reached alerts. A list of invoice types to
+         * evaluate.
+         */
+        invoice_types_filter?: Array<string>;
+        /**
+         * Prevents the creation of duplicates. If a request to create a record is made
+         * with a previously used uniqueness key, a new record will not be created and the
+         * request will fail with a 409 error.
+         */
+        uniqueness_key?: string;
+    }
+    namespace Alert {
+        interface CustomFieldFilter {
+            entity: 'Contract' | 'Commit' | 'ContractCredit';
+            key: string;
+            value: string;
+        }
+        /**
+         * Scopes alert evaluation to a specific presentation group key on individual line
+         * items. Only present for spend alerts.
+         */
+        interface GroupKeyFilter {
+            key: string;
+            value: string;
+        }
+        interface GroupValue {
+            key: string;
+            value?: string;
+        }
+    }
+}
+export interface AlertRetrieveResponse {
+    data: CustomerAlert;
+}
+export interface AlertRetrieveParams {
+    /**
+     * The Metronome ID of the alert
+     */
+    alert_id: string;
+    /**
+     * The Metronome ID of the customer
+     */
+    customer_id: string;
+    /**
+     * Only present for `spend_threshold_reached` alerts. Retrieve the alert for a
+     * specific group key-value pair.
+     */
+    group_values?: Array<AlertRetrieveParams.GroupValue>;
+    /**
+     * When parallel alerts are enabled during migration, this flag denotes whether to
+     * fetch alerts for plans or contracts.
+     */
+    plans_or_contracts?: 'PLANS' | 'CONTRACTS';
+}
+export declare namespace AlertRetrieveParams {
+    /**
+     * Scopes alert evaluation to a specific presentation group key on individual line
+     * items. Only present for spend alerts.
+     */
+    interface GroupValue {
+        key: string;
+        value: string;
+    }
+}
+export interface AlertListParams extends CursorPageWithoutLimitParams {
+    /**
+     * Body param: The Metronome ID of the customer
+     */
+    customer_id: string;
+    /**
+     * Body param: Optionally filter by alert status. If absent, only enabled alerts
+     * will be returned.
+     */
+    alert_statuses?: Array<'ENABLED' | 'DISABLED' | 'ARCHIVED'>;
+}
+export interface AlertResetParams {
+    /**
+     * The Metronome ID of the alert
+     */
+    alert_id: string;
+    /**
+     * The Metronome ID of the customer
+     */
+    customer_id: string;
+}
+export declare namespace Alerts {
+    export { type CustomerAlert as CustomerAlert, type AlertRetrieveResponse as AlertRetrieveResponse, type CustomerAlertsCursorPageWithoutLimit as CustomerAlertsCursorPageWithoutLimit, type AlertRetrieveParams as AlertRetrieveParams, type AlertListParams as AlertListParams, type AlertResetParams as AlertResetParams, };
+}
+//# sourceMappingURL=alerts.d.mts.map

package/resources/v1/customers/alerts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.mts","sourceRoot":"","sources":["../../../src/resources/v1/customers/alerts.ts"],"names":[],"mappings":"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"}

package/resources/v1/customers/alerts.d.ts

@@ -1,10 +1,53 @@
-import { APIResource } from "../../../resource.js";
-import * as Core from "../../../core.js";
+import { APIResource } from "../../../core/resource.js";
 import * as Shared from "../../shared.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { CursorPageWithoutLimit, type CursorPageWithoutLimitParams, PagePromise } from "../../../core/pagination.js";
+import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Alerts extends APIResource {
     /**
-     * Get the customer alert status and alert information for the specified customer
-     * and alert
+     * Retrieve the real-time evaluation status for a specific alert-customer pair.
+     * This endpoint provides instant visibility into whether a customer has triggered
+     * an alert condition, enabling you to monitor account health and take proactive
+     * action based on current alert states.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Check if a specific customer is currently violating an alert threshold
+     *   (`in_alarm` status)
+     * - Verify alert configuration details and threshold values for a customer
+     * - Integrate alert status checks into customer support tools or admin interfaces
+     *
+     * ### Key response fields:
+     *
+     * A CustomerAlert object containing:
+     *
+     * - `customer_status`: The current evaluation state
+     *
+     * - `ok` - Customer is within acceptable thresholds
+     * - `in_alarm`- Customer has breached the alert threshold
+     * - `evaluating` - Alert has yet to be evaluated (typically due to a customer or
+     *   alert having just been created)
+     * - `null` - Alert has been archived
+     * - `triggered_by`: Additional context about what caused the alert to trigger
+     *   (when applicable)
+     * - alert: Complete alert configuration including:
+     *   - Alert ID, name, and type
+     *   - Current threshold values and credit type information
+     *   - Alert status (enabled, disabled, or archived)
+     *   - Last update timestamp
+     *   - Any applied filters (credit grant types, custom fields, group values)
+     *
+     * ### Usage guidelines:
+     *
+     * - Customer status: Returns the current evaluation state, not historical data.
+     *   For alert history, use webhook notifications or event logs
+     * - Archived alerts: Returns null for customer_status if the alert has been
+     *   archived, but still includes the alert configuration details
+     * - Integration patterns: This endpoint can be used to check a customer's alert
+     *   status, but shouldn't be scraped. You should instead rely on the webhook
+     *   notification to understand when customers are moved to IN_ALARM.
+     * - Error handling: Returns 404 if either the customer or alert ID doesn't exist
+     *   or isn't accessible to your organization
      *
      * @example
      * ```ts
@@ -14,20 +57,74 @@ export declare class Alerts extends APIResource {
      * });
      * ```
      */
-    retrieve(body: AlertRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<AlertRetrieveResponse>;
+    retrieve(body: AlertRetrieveParams, options?: RequestOptions): APIPromise<AlertRetrieveResponse>;
     /**
-     * Fetch all customer alert statuses and alert information for a customer
+     * Retrieve all alert configurations and their current statuses for a specific
+     * customer in a single API call. This endpoint provides a comprehensive view of
+     * all alerts monitoring a customer account.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Display all active alerts for a customer in dashboards or admin panels
+     * - Quickly identify which alerts a customer is currently triggering
+     * - Audit alert coverage for specific accounts
+     * - Filter alerts by status (enabled, disabled, or archived)
+     *
+     * ### Key response fields:
+     *
+     * - data: Array of CustomerAlert objects, each containing:
+     *   - Current evaluation status (`ok`, `in_alarm`, `evaluating`, or `null`)
+     *   - Complete alert configuration and threshold details
+     *   - Alert metadata including type, name, and last update time
+     * - `next_page`: Pagination cursor for retrieving additional results
+     *
+     * ### Usage guidelines:
+     *
+     * - Default behavior: Returns only enabled alerts unless alert_statuses filter is
+     *   specified
+     * - Pagination: Use the `next_page` cursor to retrieve all results for customers
+     *   with many alerts
      *
      * @example
      * ```ts
-     * const alerts = await client.v1.customers.alerts.list({
-     *   customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1',
-     * });
+     * // Automatically fetches more pages as needed.
+     * for await (const customerAlert of client.v1.customers.alerts.list(
+     *   { customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1' },
+     * )) {
+     *   // ...
+     * }
      * ```
      */
-    list(params: AlertListParams, options?: Core.RequestOptions): Core.APIPromise<AlertListResponse>;
+    list(params: AlertListParams, options?: RequestOptions): PagePromise<CustomerAlertsCursorPageWithoutLimit, CustomerAlert>;
     /**
-     * Reset state for an alert by customer id and force re-evaluation
+     * Force an immediate re-evaluation of a specific alert for a customer, clearing
+     * any previous state and triggering a fresh assessment against current thresholds.
+     * This endpoint ensures alert accuracy after configuration changes or data
+     * corrections.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Clear false positive alerts after fixing data issues
+     * - Re-evaluate alerts after adjusting customer balances or credits
+     * - Test alert behavior during development and debugging
+     * - Resolve stuck alerts that may be in an incorrect state
+     * - Trigger immediate evaluation after threshold modifications
+     *
+     * ### Key response fields:
+     *
+     * - 200 Success: Confirmation that the alert has been reset and re-evaluation
+     *   initiated
+     * - No response body is returned - the operation completes asynchronously
+     *
+     * ### Usage guidelines:
+     *
+     * - Immediate effect: Triggers re-evaluation instantly, which may result in new
+     *   webhook notifications if thresholds are breached
+     * - State clearing: Removes any cached evaluation state, ensuring a fresh
+     *   assessment
+     * - Use sparingly: Intended for exceptional cases, not routine operations
+     * - Asynchronous processing: The reset completes immediately, but re-evaluation
+     *   happens in the background
      *
      * @example
      * ```ts
@@ -37,8 +134,9 @@ export declare class Alerts extends APIResource {
      * });
      * ```
      */
-    reset(body: AlertResetParams, options?: Core.RequestOptions): Core.APIPromise<void>;
+    reset(body: AlertResetParams, options?: RequestOptions): APIPromise<void>;
 }
+export type CustomerAlertsCursorPageWithoutLimit = CursorPageWithoutLimit<CustomerAlert>;
 export interface CustomerAlert {
     alert: CustomerAlert.Alert;
     /**
@@ -126,17 +224,13 @@ export declare namespace CustomerAlert {
         }
         interface GroupValue {
             key: string;
-            value: string;
+            value?: string;
         }
     }
 }
 export interface AlertRetrieveResponse {
     data: CustomerAlert;
 }
-export interface AlertListResponse {
-    data: Array<CustomerAlert>;
-    next_page: string | null;
-}
 export interface AlertRetrieveParams {
     /**
      * The Metronome ID of the alert
@@ -146,21 +240,32 @@ export interface AlertRetrieveParams {
      * The Metronome ID of the customer
      */
     customer_id: string;
+    /**
+     * Only present for `spend_threshold_reached` alerts. Retrieve the alert for a
+     * specific group key-value pair.
+     */
+    group_values?: Array<AlertRetrieveParams.GroupValue>;
     /**
      * When parallel alerts are enabled during migration, this flag denotes whether to
      * fetch alerts for plans or contracts.
      */
     plans_or_contracts?: 'PLANS' | 'CONTRACTS';
 }
-export interface AlertListParams {
+export declare namespace AlertRetrieveParams {
     /**
-     * Body param: The Metronome ID of the customer
+     * Scopes alert evaluation to a specific presentation group key on individual line
+     * items. Only present for spend alerts.
      */
-    customer_id: string;
+    interface GroupValue {
+        key: string;
+        value: string;
+    }
+}
+export interface AlertListParams extends CursorPageWithoutLimitParams {
     /**
-     * Query param: Cursor that indicates where the next page of results should start.
+     * Body param: The Metronome ID of the customer
      */
-    next_page?: string;
+    customer_id: string;
     /**
      * Body param: Optionally filter by alert status. If absent, only enabled alerts
      * will be returned.
@@ -178,6 +283,6 @@ export interface AlertResetParams {
     customer_id: string;
 }
 export declare namespace Alerts {
-    export { type CustomerAlert as CustomerAlert, type AlertRetrieveResponse as AlertRetrieveResponse, type AlertListResponse as AlertListResponse, type AlertRetrieveParams as AlertRetrieveParams, type AlertListParams as AlertListParams, type AlertResetParams as AlertResetParams, };
+    export { type CustomerAlert as CustomerAlert, type AlertRetrieveResponse as AlertRetrieveResponse, type CustomerAlertsCursorPageWithoutLimit as CustomerAlertsCursorPageWithoutLimit, type AlertRetrieveParams as AlertRetrieveParams, type AlertListParams as AlertListParams, type AlertResetParams as AlertResetParams, };
 }
 //# sourceMappingURL=alerts.d.ts.map

package/resources/v1/customers/alerts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../src/resources/v1/customers/alerts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../src/resources/v1/customers/alerts.ts"],"names":[],"mappings":"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"}