@metronome/sdk 1.0.0 → 2.0.0

package/resources/v1/alerts.d.ts

@@ -4,16 +4,15 @@ import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Alerts extends APIResource {
     /**
-     * Create a new alert to monitor customer spending, balances, and billing metrics
-     * in real-time. Metronome's alert system provides industry-leading speed with
-     * immediate evaluation capabilities, enabling you to proactively manage customer
-     * accounts and prevent revenue leakage.
+     * Create a new threshold notification to monitor customer spending, balances, and
+     * billing metrics in real-time. Metronome's notification system provides
+     * industry-leading speed with immediate evaluation capabilities, enabling you to
+     * proactively manage customer accounts and prevent revenue leakage.
      *
-     * This endpoint creates configurable alerts that continuously monitor various
-     * billing thresholds including spend limits, credit balances, commitment
-     * utilization, and invoice totals. Alerts can be configured globally for all
-     * customers or targeted to specific customer accounts. Custom fields can be used
-     * on certain alert types to further target alerts to groups of customers.
+     * This endpoint creates configurable threshold notifications that continuously
+     * monitor various billing thresholds including spend limits, credit balances,
+     * commitment utilization, and invoice totals. Threshold notifications can be
+     * configured globally for all customers or targeted to specific customer accounts.
      *
      * ### Use this endpoint to:
      *
@@ -29,26 +28,27 @@ export declare class Alerts extends APIResource {
      *
      * A successful response returns a CustomerAlert object containing:
      *
-     * - The alert configuration with its unique ID and current status
+     * - The threshold notification configuration with its unique ID and current status
      * - The customer's evaluation status (ok, in_alarm, or evaluating)
-     * - Alert metadata including type, threshold values, and update timestamps
+     * - Threshold notification metadata including type, threshold values, and update
+     *   timestamps
      *
      * ### Usage guidelines:
      *
      * - Immediate evaluation: Set `evaluate_on_create` : `true` (default) for instant
      *   evaluation against existing customers
-     * - Uniqueness constraints: Each alert must have a unique `uniqueness_key` within
-     *   your organization. Use `release_uniqueness_key` : `true` when archiving to
-     *   reuse keys
-     * - Alert type requirements: Different alert types require specific fields (e.g.,
-     *   `billable_metric_id` for usage alerts, `credit_type_id` for credit-based
-     *   alerts)
-     * - Webhook delivery: Alerts trigger webhook notifications for real-time
-     *   integration with your systems. Configure webhook endpoints before creating
-     *   alerts
-     * - Performance at scale: Metronome's event-driven architecture processes alert
-     *   evaluations in real-time as usage events stream in, unlike competitors who
-     *   rely on periodic polling or batch evaluation cycles
+     * - Uniqueness constraints: Each threshold notification must have a unique
+     *   `uniqueness_key` within your organization. Use `release_uniqueness_key` :
+     *   `true` when archiving to reuse keys
+     * - Notification type requirements: Different threshold notification types require
+     *   specific fields (e.g., `billable_metric_id` for usage notifications,
+     *   `credit_type_id` for credit-based threshold notifications)
+     * - Webhook delivery: Threshold notifications trigger webhook notifications for
+     *   real-time integration with your systems. Configure webhook endpoints before
+     *   creating threshold notifications
+     * - Performance at scale: Metronome's event-driven architecture processes
+     *   threshold notification evaluations in real-time as usage events stream in,
+     *   unlike competitors who rely on periodic polling or batch evaluation cycles
      *
      * @example
      * ```ts
@@ -64,33 +64,34 @@ export declare class Alerts extends APIResource {
      */
     create(body: AlertCreateParams, options?: RequestOptions): APIPromise<AlertCreateResponse>;
     /**
-     * Permanently disable an alert and remove it from active monitoring across all
-     * customers. Archived alerts stop evaluating immediately and can optionally
-     * release their uniqueness key for reuse in future alert configurations.
+     * Permanently disable a threshold notification and remove it from active
+     * monitoring across all customers. Archived threshold notifications stop
+     * evaluating immediately and can optionally release their uniqueness key for reuse
+     * in future threshold notification configurations.
      *
      * ### Use this endpoint to:
      *
-     * - Decommission alerts that are no longer needed
-     * - Clean up test or deprecated alert configurations
-     * - Free up uniqueness keys for reuse with new alerts
-     * - Stop alert evaluations without losing historical configuration data
+     * - Decommission threshold notifications that are no longer needed
+     * - Clean up test or deprecated threshold notification configurations
+     * - Free up uniqueness keys for reuse with new threshold notifications
+     * - Stop threshold notification evaluations without losing historical
+     *   configuration data
      * - Disable outdated monitoring rules during pricing model transitions
      *
      * ### Key response fields:
      *
-     * - data: Object containing the archived alert's ID
-     * - Alert evaluation stops immediately for all affected customers
-     * - Historical alert data and configurations remain accessible for audit purposes
+     * - data: Object containing the archived threshold notification's ID
      *
      * ### Usage guidelines:
      *
-     * - Irreversible for evaluation: Archived alerts cannot be re-enabled; create a
-     *   new alert to resume monitoring
+     * - Irreversible for evaluation: Archived threshold notifications cannot be
+     *   re-enabled; create a new threshold notification to resume monitoring
      * - Uniqueness key handling: Set `release_uniqueness_key` : `true` to reuse the
-     *   key in future alerts
-     * - Immediate effect: Alert evaluation stops instantly across all customers
-     * - Historical preservation: Archive operation maintains alert history and
-     *   configuration for compliance and auditing
+     *   key in future threshold notifications
+     * - Immediate effect: Threshold notification evaluation stops instantly across all
+     *   customers
+     * - Historical preservation: Archive operation maintains threshold notification
+     *   history and configuration for compliance and auditing
      *
      * @example
      * ```ts
@@ -109,64 +110,66 @@ export interface AlertArchiveResponse {
 }
 export interface AlertCreateParams {
     /**
-     * Type of the alert
+     * Type of the threshold notification
      */
     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';
     /**
-     * Name of the alert
+     * Name of the threshold notification
      */
     name: string;
     /**
-     * Threshold value of the alert policy. Depending upon the alert type, this number
-     * may represent a financial amount, the days remaining, or a percentage reached.
+     * Threshold value of the notification policy. Depending upon the notification
+     * type, this number may represent a financial amount, the days remaining, or a
+     * percentage reached.
      */
     threshold: number;
     /**
-     * For alerts of type `usage_threshold_reached`, specifies which billable metric to
-     * track the usage for.
+     * For threshold notifications of type `usage_threshold_reached`, specifies which
+     * billable metric to track the usage for.
      */
     billable_metric_id?: 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
+     * An array of strings, representing a way to filter the credit grant this
+     * threshold notification applies to, by looking at the credit_grant_type field on
+     * the credit grant. This field is only defined for CreditPercentage and
+     * CreditBalance notifications
      */
     credit_grant_type_filters?: Array<string>;
     /**
-     * ID of the credit's currency, defaults to USD. If the specific alert type
+     * ID of the credit's currency, defaults to USD. If the specific notification type
      * requires a pricing unit/currency, find the ID in the
      * [Metronome app](https://app.metronome.com/offering/pricing-units).
      */
     credit_type_id?: string;
     /**
-     * A list of custom field filters for alert types that support advanced filtering.
-     * Only present for contract invoices.
+     * A list of custom field filters for threshold notification types that support
+     * advanced filtering. Only present for contract invoices.
      */
     custom_field_filters?: Array<AlertCreateParams.CustomFieldFilter>;
     /**
-     * If provided, will create this alert for this specific customer. To create an
-     * alert for all customers, do not specify a `customer_id`.
+     * If provided, will create this threshold notification for this specific customer.
+     * To create a notification for all customers, do not specify a `customer_id`.
      */
     customer_id?: string;
     /**
-     * If true, the alert will evaluate immediately on customers that already meet the
-     * alert threshold. If false, it will only evaluate on future customers that
-     * trigger the alert threshold. Defaults to true.
+     * If true, the threshold notification will evaluate immediately on customers that
+     * already meet the notification threshold. If false, it will only evaluate on
+     * future customers that trigger the threshold. Defaults to true.
      */
     evaluate_on_create?: boolean;
     /**
-     * Only present for `spend_threshold_reached` alerts. Scope alert to a specific
-     * group key on individual line items.
+     * Only present for `spend_threshold_reached` notifications. Scope notification to
+     * a specific group key on individual line items.
      */
     group_values?: Array<AlertCreateParams.GroupValue>;
     /**
-     * Only supported for invoice_total_reached alerts. A list of invoice types to
-     * evaluate.
+     * Only supported for invoice_total_reached threshold notifications. A list of
+     * invoice types to evaluate.
      */
     invoice_types_filter?: Array<string>;
     /**
-     * If provided, will create this alert for this specific plan. To create an alert
-     * for all customers, do not specify a `plan_id`.
+     * If provided, will create this threshold notification for this specific plan. To
+     * create a notification for all customers, do not specify a `plan_id`.
      */
     plan_id?: string;
     /**
@@ -189,11 +192,12 @@ export declare namespace AlertCreateParams {
 }
 export interface AlertArchiveParams {
     /**
-     * The Metronome ID of the alert
+     * The Metronome ID of the threshold notification
      */
     id: string;
     /**
-     * If true, resets the uniqueness key on this alert so it can be re-used
+     * If true, resets the uniqueness key on this threshold notification so it can be
+     * re-used
      */
     release_uniqueness_key?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/resources/v1/alerts.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAI1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG9F;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,EACN,4BAA4B,GAC5B,yBAAyB,GACzB,+CAA+C,GAC/C,oCAAoC,GACpC,yCAAyC,GACzC,yBAAyB,GACzB,+CAA+C,GAC/C,sCAAsC,GACtC,yCAAyC,GACzC,wDAAwD,GACxD,+CAA+C,GAC/C,kDAAkD,GAClD,0DAA0D,GAC1D,uBAAuB,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAElE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEnD;;;OAGG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAErC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,iBAAiB;QAChC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,gBAAgB,CAAC;QAEjD,GAAG,EAAE,MAAM,CAAC;QAEZ,KAAK,EAAE,MAAM,CAAC;KACf;IAED,UAAiB,UAAU;QACzB,GAAG,EAAE,MAAM,CAAC;QAEZ,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/resources/v1/alerts.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAI1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG9F;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,EACN,4BAA4B,GAC5B,yBAAyB,GACzB,+CAA+C,GAC/C,oCAAoC,GACpC,yCAAyC,GACzC,yBAAyB,GACzB,+CAA+C,GAC/C,sCAAsC,GACtC,yCAAyC,GACzC,wDAAwD,GACxD,+CAA+C,GAC/C,kDAAkD,GAClD,0DAA0D,GAC1D,uBAAuB,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAElE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEnD;;;OAGG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAErC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,iBAAiB;QAChC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,gBAAgB,CAAC;QAEjD,GAAG,EAAE,MAAM,CAAC;QAEZ,KAAK,EAAE,MAAM,CAAC;KACf;IAED,UAAiB,UAAU;QACzB,GAAG,EAAE,MAAM,CAAC;QAEZ,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/v1/alerts.js

@@ -5,16 +5,15 @@ exports.Alerts = void 0;
 const resource_1 = require("../../core/resource.js");
 class Alerts extends resource_1.APIResource {
     /**
-     * Create a new alert to monitor customer spending, balances, and billing metrics
-     * in real-time. Metronome's alert system provides industry-leading speed with
-     * immediate evaluation capabilities, enabling you to proactively manage customer
-     * accounts and prevent revenue leakage.
+     * Create a new threshold notification to monitor customer spending, balances, and
+     * billing metrics in real-time. Metronome's notification system provides
+     * industry-leading speed with immediate evaluation capabilities, enabling you to
+     * proactively manage customer accounts and prevent revenue leakage.
      *
-     * This endpoint creates configurable alerts that continuously monitor various
-     * billing thresholds including spend limits, credit balances, commitment
-     * utilization, and invoice totals. Alerts can be configured globally for all
-     * customers or targeted to specific customer accounts. Custom fields can be used
-     * on certain alert types to further target alerts to groups of customers.
+     * This endpoint creates configurable threshold notifications that continuously
+     * monitor various billing thresholds including spend limits, credit balances,
+     * commitment utilization, and invoice totals. Threshold notifications can be
+     * configured globally for all customers or targeted to specific customer accounts.
      *
      * ### Use this endpoint to:
      *
@@ -30,26 +29,27 @@ class Alerts extends resource_1.APIResource {
      *
      * A successful response returns a CustomerAlert object containing:
      *
-     * - The alert configuration with its unique ID and current status
+     * - The threshold notification configuration with its unique ID and current status
      * - The customer's evaluation status (ok, in_alarm, or evaluating)
-     * - Alert metadata including type, threshold values, and update timestamps
+     * - Threshold notification metadata including type, threshold values, and update
+     *   timestamps
      *
      * ### Usage guidelines:
      *
      * - Immediate evaluation: Set `evaluate_on_create` : `true` (default) for instant
      *   evaluation against existing customers
-     * - Uniqueness constraints: Each alert must have a unique `uniqueness_key` within
-     *   your organization. Use `release_uniqueness_key` : `true` when archiving to
-     *   reuse keys
-     * - Alert type requirements: Different alert types require specific fields (e.g.,
-     *   `billable_metric_id` for usage alerts, `credit_type_id` for credit-based
-     *   alerts)
-     * - Webhook delivery: Alerts trigger webhook notifications for real-time
-     *   integration with your systems. Configure webhook endpoints before creating
-     *   alerts
-     * - Performance at scale: Metronome's event-driven architecture processes alert
-     *   evaluations in real-time as usage events stream in, unlike competitors who
-     *   rely on periodic polling or batch evaluation cycles
+     * - Uniqueness constraints: Each threshold notification must have a unique
+     *   `uniqueness_key` within your organization. Use `release_uniqueness_key` :
+     *   `true` when archiving to reuse keys
+     * - Notification type requirements: Different threshold notification types require
+     *   specific fields (e.g., `billable_metric_id` for usage notifications,
+     *   `credit_type_id` for credit-based threshold notifications)
+     * - Webhook delivery: Threshold notifications trigger webhook notifications for
+     *   real-time integration with your systems. Configure webhook endpoints before
+     *   creating threshold notifications
+     * - Performance at scale: Metronome's event-driven architecture processes
+     *   threshold notification evaluations in real-time as usage events stream in,
+     *   unlike competitors who rely on periodic polling or batch evaluation cycles
      *
      * @example
      * ```ts
@@ -67,33 +67,34 @@ class Alerts extends resource_1.APIResource {
         return this._client.post('/v1/alerts/create', { body, ...options });
     }
     /**
-     * Permanently disable an alert and remove it from active monitoring across all
-     * customers. Archived alerts stop evaluating immediately and can optionally
-     * release their uniqueness key for reuse in future alert configurations.
+     * Permanently disable a threshold notification and remove it from active
+     * monitoring across all customers. Archived threshold notifications stop
+     * evaluating immediately and can optionally release their uniqueness key for reuse
+     * in future threshold notification configurations.
      *
      * ### Use this endpoint to:
      *
-     * - Decommission alerts that are no longer needed
-     * - Clean up test or deprecated alert configurations
-     * - Free up uniqueness keys for reuse with new alerts
-     * - Stop alert evaluations without losing historical configuration data
+     * - Decommission threshold notifications that are no longer needed
+     * - Clean up test or deprecated threshold notification configurations
+     * - Free up uniqueness keys for reuse with new threshold notifications
+     * - Stop threshold notification evaluations without losing historical
+     *   configuration data
      * - Disable outdated monitoring rules during pricing model transitions
      *
      * ### Key response fields:
      *
-     * - data: Object containing the archived alert's ID
-     * - Alert evaluation stops immediately for all affected customers
-     * - Historical alert data and configurations remain accessible for audit purposes
+     * - data: Object containing the archived threshold notification's ID
      *
      * ### Usage guidelines:
      *
-     * - Irreversible for evaluation: Archived alerts cannot be re-enabled; create a
-     *   new alert to resume monitoring
+     * - Irreversible for evaluation: Archived threshold notifications cannot be
+     *   re-enabled; create a new threshold notification to resume monitoring
      * - Uniqueness key handling: Set `release_uniqueness_key` : `true` to reuse the
-     *   key in future alerts
-     * - Immediate effect: Alert evaluation stops instantly across all customers
-     * - Historical preservation: Archive operation maintains alert history and
-     *   configuration for compliance and auditing
+     *   key in future threshold notifications
+     * - Immediate effect: Threshold notification evaluation stops instantly across all
+     *   customers
+     * - Historical preservation: Archive operation maintains threshold notification
+     *   history and configuration for compliance and auditing
      *
      * @example
      * ```ts

package/resources/v1/alerts.js.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/resources/v1/alerts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAKlD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AAvGD,wBAuGC"}
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/resources/v1/alerts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAKlD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AAxGD,wBAwGC"}

package/resources/v1/alerts.mjs

@@ -2,16 +2,15 @@
 import { APIResource } from "../../core/resource.mjs";
 export class Alerts extends APIResource {
     /**
-     * Create a new alert to monitor customer spending, balances, and billing metrics
-     * in real-time. Metronome's alert system provides industry-leading speed with
-     * immediate evaluation capabilities, enabling you to proactively manage customer
-     * accounts and prevent revenue leakage.
+     * Create a new threshold notification to monitor customer spending, balances, and
+     * billing metrics in real-time. Metronome's notification system provides
+     * industry-leading speed with immediate evaluation capabilities, enabling you to
+     * proactively manage customer accounts and prevent revenue leakage.
      *
-     * This endpoint creates configurable alerts that continuously monitor various
-     * billing thresholds including spend limits, credit balances, commitment
-     * utilization, and invoice totals. Alerts can be configured globally for all
-     * customers or targeted to specific customer accounts. Custom fields can be used
-     * on certain alert types to further target alerts to groups of customers.
+     * This endpoint creates configurable threshold notifications that continuously
+     * monitor various billing thresholds including spend limits, credit balances,
+     * commitment utilization, and invoice totals. Threshold notifications can be
+     * configured globally for all customers or targeted to specific customer accounts.
      *
      * ### Use this endpoint to:
      *
@@ -27,26 +26,27 @@ export class Alerts extends APIResource {
      *
      * A successful response returns a CustomerAlert object containing:
      *
-     * - The alert configuration with its unique ID and current status
+     * - The threshold notification configuration with its unique ID and current status
      * - The customer's evaluation status (ok, in_alarm, or evaluating)
-     * - Alert metadata including type, threshold values, and update timestamps
+     * - Threshold notification metadata including type, threshold values, and update
+     *   timestamps
      *
      * ### Usage guidelines:
      *
      * - Immediate evaluation: Set `evaluate_on_create` : `true` (default) for instant
      *   evaluation against existing customers
-     * - Uniqueness constraints: Each alert must have a unique `uniqueness_key` within
-     *   your organization. Use `release_uniqueness_key` : `true` when archiving to
-     *   reuse keys
-     * - Alert type requirements: Different alert types require specific fields (e.g.,
-     *   `billable_metric_id` for usage alerts, `credit_type_id` for credit-based
-     *   alerts)
-     * - Webhook delivery: Alerts trigger webhook notifications for real-time
-     *   integration with your systems. Configure webhook endpoints before creating
-     *   alerts
-     * - Performance at scale: Metronome's event-driven architecture processes alert
-     *   evaluations in real-time as usage events stream in, unlike competitors who
-     *   rely on periodic polling or batch evaluation cycles
+     * - Uniqueness constraints: Each threshold notification must have a unique
+     *   `uniqueness_key` within your organization. Use `release_uniqueness_key` :
+     *   `true` when archiving to reuse keys
+     * - Notification type requirements: Different threshold notification types require
+     *   specific fields (e.g., `billable_metric_id` for usage notifications,
+     *   `credit_type_id` for credit-based threshold notifications)
+     * - Webhook delivery: Threshold notifications trigger webhook notifications for
+     *   real-time integration with your systems. Configure webhook endpoints before
+     *   creating threshold notifications
+     * - Performance at scale: Metronome's event-driven architecture processes
+     *   threshold notification evaluations in real-time as usage events stream in,
+     *   unlike competitors who rely on periodic polling or batch evaluation cycles
      *
      * @example
      * ```ts
@@ -64,33 +64,34 @@ export class Alerts extends APIResource {
         return this._client.post('/v1/alerts/create', { body, ...options });
     }
     /**
-     * Permanently disable an alert and remove it from active monitoring across all
-     * customers. Archived alerts stop evaluating immediately and can optionally
-     * release their uniqueness key for reuse in future alert configurations.
+     * Permanently disable a threshold notification and remove it from active
+     * monitoring across all customers. Archived threshold notifications stop
+     * evaluating immediately and can optionally release their uniqueness key for reuse
+     * in future threshold notification configurations.
      *
      * ### Use this endpoint to:
      *
-     * - Decommission alerts that are no longer needed
-     * - Clean up test or deprecated alert configurations
-     * - Free up uniqueness keys for reuse with new alerts
-     * - Stop alert evaluations without losing historical configuration data
+     * - Decommission threshold notifications that are no longer needed
+     * - Clean up test or deprecated threshold notification configurations
+     * - Free up uniqueness keys for reuse with new threshold notifications
+     * - Stop threshold notification evaluations without losing historical
+     *   configuration data
      * - Disable outdated monitoring rules during pricing model transitions
      *
      * ### Key response fields:
      *
-     * - data: Object containing the archived alert's ID
-     * - Alert evaluation stops immediately for all affected customers
-     * - Historical alert data and configurations remain accessible for audit purposes
+     * - data: Object containing the archived threshold notification's ID
      *
      * ### Usage guidelines:
      *
-     * - Irreversible for evaluation: Archived alerts cannot be re-enabled; create a
-     *   new alert to resume monitoring
+     * - Irreversible for evaluation: Archived threshold notifications cannot be
+     *   re-enabled; create a new threshold notification to resume monitoring
      * - Uniqueness key handling: Set `release_uniqueness_key` : `true` to reuse the
-     *   key in future alerts
-     * - Immediate effect: Alert evaluation stops instantly across all customers
-     * - Historical preservation: Archive operation maintains alert history and
-     *   configuration for compliance and auditing
+     *   key in future threshold notifications
+     * - Immediate effect: Threshold notification evaluation stops instantly across all
+     *   customers
+     * - Historical preservation: Archive operation maintains threshold notification
+     *   history and configuration for compliance and auditing
      *
      * @example
      * ```ts

package/resources/v1/alerts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.mjs","sourceRoot":"","sources":["../../src/resources/v1/alerts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}
+{"version":3,"file":"alerts.mjs","sourceRoot":"","sources":["../../src/resources/v1/alerts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}

package/resources/v1/contracts/contracts.d.mts

@@ -462,11 +462,12 @@ export declare class Contracts extends APIResource {
      */
     setUsageFilter(body: ContractSetUsageFilterParams, options?: RequestOptions): APIPromise<void>;
     /**
-     * Update or and an end date to a contract. Ending a contract early will impact
+     * Update or add an end date to a contract. Ending a contract early will impact
      * draft usage statements, truncate any terms, and remove upcoming scheduled
      * invoices. Moving the date into the future will only extend the contract length.
-     * Terms and scheduled invoices are not extended. Use this if a contract's end date
-     * has changed or if a perpetual contract ends.
+     * Terms and scheduled invoices are not extended. In-advance subscriptions will not
+     * be extended. Use this if a contract's end date has changed or if a perpetual
+     * contract ends.
      *
      * @example
      * ```ts
@@ -897,7 +898,7 @@ export declare namespace ContractCreateParams {
              * not wish Metronome to calculate tax on your behalf. Leaving this field blank
              * will default to NONE.
              */
-            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
+            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
         }
         namespace PaymentGateConfig {
             /**
@@ -1130,13 +1131,34 @@ export declare namespace ContractCreateParams {
         }
     }
     interface HierarchyConfiguration {
-        parent: HierarchyConfiguration.Parent;
+        parent?: HierarchyConfiguration.Parent;
+        parent_behavior?: HierarchyConfiguration.ParentBehavior;
+        /**
+         * Indicates whether the parent should pay for the child's invoice charges
+         */
+        payer?: 'SELF' | 'PARENT';
+        /**
+         * Indicates the behavior of the child's invoice statements on the parent's
+         * invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
+         * consolidated invoices **SEPARATE**: Child's invoice statements will appear not
+         * appear on parent's consolidated invoices
+         */
+        usage_statement_behavior?: 'CONSOLIDATE' | 'SEPARATE';
     }
     namespace HierarchyConfiguration {
         interface Parent {
             contract_id: string;
             customer_id: string;
         }
+        interface ParentBehavior {
+            /**
+             * Indicates the desired behavior of consolidated invoices generated by the parent
+             * in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
+             * customers will be appended to the consolidated invoice **NONE**: Do not generate
+             * consolidated invoices
+             */
+            invoice_consolidation_type?: 'CONCATENATE' | 'NONE';
+        }
     }
     interface Override {
         /**
@@ -2177,7 +2199,7 @@ export declare namespace ContractAmendParams {
              * not wish Metronome to calculate tax on your behalf. Leaving this field blank
              * will default to NONE.
              */
-            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
+            tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
         }
         namespace PaymentGateConfig {
             /**