@metronome/sdk 0.3.0 → 2.0.0

package/src/resources/v1/customers/customers.ts

@@ -1,48 +1,44 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from "../../../resource.js";
-import { isRequestOptions } from "../../../core.js";
-import * as Core from "../../../core.js";
-import * as Shared from "../../shared.js";
-import * as AlertsAPI from "./alerts.js";
+import { APIResource } from '../../../core/resource';
+import * as Shared from '../../shared';
+import * as AlertsAPI from './alerts';
 import {
   AlertListParams,
-  AlertListResponse,
   AlertResetParams,
   AlertRetrieveParams,
   AlertRetrieveResponse,
   Alerts,
   CustomerAlert,
-} from "./alerts.js";
-import * as BillingConfigAPI from "./billing-config.js";
+  CustomerAlertsCursorPageWithoutLimit,
+} from './alerts';
+import * as BillingConfigAPI from './billing-config';
 import {
   BillingConfig as BillingConfigAPIBillingConfig,
   BillingConfigCreateParams,
   BillingConfigDeleteParams,
   BillingConfigRetrieveParams,
   BillingConfigRetrieveResponse,
-} from "./billing-config.js";
-import * as CommitsAPI from "./commits.js";
+} from './billing-config';
+import * as CommitsAPI from './commits';
 import {
   CommitCreateParams,
   CommitCreateResponse,
   CommitListParams,
-  CommitListResponse,
   CommitUpdateEndDateParams,
   CommitUpdateEndDateResponse,
   Commits,
-} from "./commits.js";
-import * as CreditsAPI from "./credits.js";
+} from './commits';
+import * as CreditsAPI from './credits';
 import {
   CreditCreateParams,
   CreditCreateResponse,
   CreditListParams,
-  CreditListResponse,
   CreditUpdateEndDateParams,
   CreditUpdateEndDateResponse,
   Credits,
-} from "./credits.js";
-import * as InvoicesAPI from "./invoices.js";
+} from './credits';
+import * as InvoicesAPI from './invoices';
 import {
   Invoice,
   InvoiceAddChargeParams,
@@ -52,18 +48,19 @@ import {
   InvoiceListBreakdownsResponsesCursorPage,
   InvoiceListParams,
   InvoiceRetrieveParams,
+  InvoiceRetrievePdfParams,
   InvoiceRetrieveResponse,
   Invoices,
   InvoicesCursorPage,
-} from "./invoices.js";
-import * as NamedSchedulesAPI from "./named-schedules.js";
+} from './invoices';
+import * as NamedSchedulesAPI from './named-schedules';
 import {
   NamedScheduleRetrieveParams,
   NamedScheduleRetrieveResponse,
   NamedScheduleUpdateParams,
   NamedSchedules,
-} from "./named-schedules.js";
-import * as PlansAPI from "./plans.js";
+} from './named-schedules';
+import * as PlansAPI from './plans';
 import {
   PlanAddParams,
   PlanAddResponse,
@@ -76,8 +73,12 @@ import {
   PlanListResponse,
   PlanListResponsesCursorPage,
   Plans,
-} from "./plans.js";
-import { CursorPage, type CursorPageParams } from "../../../pagination.js";
+} from './plans';
+import { APIPromise } from '../../../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
 
 export class Customers extends APIResource {
   alerts: AlertsAPI.Alerts = new AlertsAPI.Alerts(this._client);
@@ -89,7 +90,40 @@ export class Customers extends APIResource {
   namedSchedules: NamedSchedulesAPI.NamedSchedules = new NamedSchedulesAPI.NamedSchedules(this._client);
 
   /**
-   * Create a new customer
+   * Create a new customer in Metronome and optionally the billing configuration
+   * (recommended) which dictates where invoices for the customer will be sent or
+   * where payment will be collected.
+   *
+   * ### Use this endpoint to:
+   *
+   * Execute your customer provisioning workflows for either PLG motions, where
+   * customers originate in your platform, or SLG motions, where customers originate
+   * in your sales system.
+   *
+   * ### Key response fields:
+   *
+   * This end-point returns the `customer_id` created by the request. This id can be
+   * used to fetch relevant billing configurations and create contracts.
+   *
+   * ### Example workflow:
+   *
+   * - Generally, Metronome recommends first creating the customer in the downstream
+   *   payment / ERP system when payment method is collected and then creating the
+   *   customer in Metronome using the response (i.e. `customer_id`) from the
+   *   downstream system. If you do not create a billing configuration on customer
+   *   creation, you can add it later.
+   * - Once a customer is created, you can then create a contract for the customer.
+   *   In the contract creation process, you will need to add the customer billing
+   *   configuration to the contract to ensure Metronome invoices the customer
+   *   correctly. This is because a customer can have multiple configurations.
+   * - As part of the customer creation process, set the ingest alias for the
+   *   customer which will ensure usage is accurately mapped to the customer. Ingest
+   *   aliases can be added or changed after the creation process as well.
+   *
+   * ### Usage guidelines:
+   *
+   * For details on different billing configurations for different systems, review
+   * the `/setCustomerBillingConfiguration` end-point.
    *
    * @example
    * ```ts
@@ -109,12 +143,18 @@ export class Customers extends APIResource {
    * });
    * ```
    */
-  create(body: CustomerCreateParams, options?: Core.RequestOptions): Core.APIPromise<CustomerCreateResponse> {
+  create(body: CustomerCreateParams, options?: RequestOptions): APIPromise<CustomerCreateResponse> {
     return this._client.post('/v1/customers', { body, ...options });
   }
 
   /**
-   * Get a customer by Metronome ID.
+   * Get detailed information for a specific customer by their Metronome ID. Returns
+   * customer profile data including name, creation date, ingest aliases,
+   * configuration settings, and custom fields. Use this endpoint to fetch complete
+   * customer details for billing operations or account management.
+   *
+   * Note: If searching for a customer billing configuration, use the
+   * `/getCustomerBillingConfigurations` endpoint.
    *
    * @example
    * ```ts
@@ -123,16 +163,17 @@ export class Customers extends APIResource {
    * });
    * ```
    */
-  retrieve(
-    params: CustomerRetrieveParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<CustomerRetrieveResponse> {
+  retrieve(params: CustomerRetrieveParams, options?: RequestOptions): APIPromise<CustomerRetrieveResponse> {
     const { customer_id } = params;
-    return this._client.get(`/v1/customers/${customer_id}`, options);
+    return this._client.get(path`/v1/customers/${customer_id}`, options);
   }
 
   /**
-   * List all customers.
+   * Gets a paginated list of all customers in your Metronome account. Use this
+   * endpoint to browse your customer base, implement customer search functionality,
+   * or sync customer data with external systems. Returns customer details including
+   * IDs, names, and configuration settings. Supports filtering and pagination
+   * parameters for efficient data retrieval.
    *
    * @example
    * ```ts
@@ -143,23 +184,27 @@ export class Customers extends APIResource {
    * ```
    */
   list(
-    query?: CustomerListParams,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<CustomerDetailsCursorPage, CustomerDetail>;
-  list(options?: Core.RequestOptions): Core.PagePromise<CustomerDetailsCursorPage, CustomerDetail>;
-  list(
-    query: CustomerListParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<CustomerDetailsCursorPage, CustomerDetail> {
-    if (isRequestOptions(query)) {
-      return this.list({}, query);
-    }
-    return this._client.getAPIList('/v1/customers', CustomerDetailsCursorPage, { query, ...options });
+    query: CustomerListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<CustomerDetailsCursorPage, CustomerDetail> {
+    return this._client.getAPIList('/v1/customers', CursorPage<CustomerDetail>, { query, ...options });
   }
 
   /**
-   * Archive a customer Note: any alerts associated with the customer will not be
-   * triggered.
+   * Use this endpoint to archive a customer while preserving auditability. Archiving
+   * a customer will automatically archive all contracts as of the current date and
+   * void all corresponding invoices. Use this endpoint if a customer is onboarded by
+   * mistake.
+   *
+   * ### Usage guidelines:
+   *
+   * - Once a customer is archived, it cannot be unarchived.
+   * - Archived customers can still be viewed through the API or the UI for audit
+   *   purposes.
+   * - Ingest aliases remain idempotent for archived customers. In order to reuse an
+   *   ingest alias, first remove the ingest alias from the customer prior to
+   *   archiving.
+   * - Any notifications associated with the customer will no longer be triggered.
    *
    * @example
    * ```ts
@@ -168,15 +213,15 @@ export class Customers extends APIResource {
    * });
    * ```
    */
-  archive(
-    body: CustomerArchiveParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<CustomerArchiveResponse> {
+  archive(body: CustomerArchiveParams, options?: RequestOptions): APIPromise<CustomerArchiveResponse> {
     return this._client.post('/v1/customers/archive', { body, ...options });
   }
 
   /**
-   * Get all billable metrics for a given customer.
+   * Get all billable metrics available for a specific customer. Supports pagination
+   * and filtering by current plan status or archived metrics. Use this endpoint to
+   * see which metrics are being tracked for billing calculations for a given
+   * customer.
    *
    * @example
    * ```ts
@@ -190,12 +235,12 @@ export class Customers extends APIResource {
    */
   listBillableMetrics(
     params: CustomerListBillableMetricsParams,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<CustomerListBillableMetricsResponsesCursorPage, CustomerListBillableMetricsResponse> {
+    options?: RequestOptions,
+  ): PagePromise<CustomerListBillableMetricsResponsesCursorPage, CustomerListBillableMetricsResponse> {
     const { customer_id, ...query } = params;
     return this._client.getAPIList(
-      `/v1/customers/${customer_id}/billable-metrics`,
-      CustomerListBillableMetricsResponsesCursorPage,
+      path`/v1/customers/${customer_id}/billable-metrics`,
+      CursorPage<CustomerListBillableMetricsResponse>,
       { query, ...options },
     );
   }
@@ -221,21 +266,21 @@ export class Customers extends APIResource {
    */
   listCosts(
     params: CustomerListCostsParams,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<CustomerListCostsResponsesCursorPage, CustomerListCostsResponse> {
+    options?: RequestOptions,
+  ): PagePromise<CustomerListCostsResponsesCursorPage, CustomerListCostsResponse> {
     const { customer_id, ...query } = params;
     return this._client.getAPIList(
-      `/v1/customers/${customer_id}/costs`,
-      CustomerListCostsResponsesCursorPage,
+      path`/v1/customers/${customer_id}/costs`,
+      CursorPage<CustomerListCostsResponse>,
       { query, ...options },
     );
   }
 
   /**
-   * Preview how a set of events will affect a customer's invoice. Generates a draft
-   * invoice for a customer using their current contract configuration and the
+   * Preview how a set of events will affect a customer's invoices. Generates draft
+   * invoices for a customer using their current contract configuration and the
    * provided events. This is useful for testing how new events will affect the
-   * customer's invoice before they are actually processed.
+   * customer's invoices before they are actually processed.
    *
    * @example
    * ```ts
@@ -253,16 +298,132 @@ export class Customers extends APIResource {
    */
   previewEvents(
     params: CustomerPreviewEventsParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<CustomerPreviewEventsResponse> {
+    options?: RequestOptions,
+  ): APIPromise<CustomerPreviewEventsResponse> {
     const { customer_id, ...body } = params;
-    return this._client.post(`/v1/customers/${customer_id}/previewEvents`, { body, ...options });
+    return this._client.post(path`/v1/customers/${customer_id}/previewEvents`, { body, ...options });
+  }
+
+  /**
+   * Returns all billing configurations previously set for the customer. Use during
+   * the contract provisioning process to fetch the
+   * `billing_provider_configuration_id` needed to set the contract billing
+   * configuration.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v1.customers.retrieveBillingConfigurations({
+   *     customer_id: '6a37bb88-8538-48c5-b37b-a41c836328bd',
+   *   });
+   * ```
+   */
+  retrieveBillingConfigurations(
+    body: CustomerRetrieveBillingConfigurationsParams,
+    options?: RequestOptions,
+  ): APIPromise<CustomerRetrieveBillingConfigurationsResponse> {
+    return this._client.post('/v1/getCustomerBillingProviderConfigurations', { body, ...options });
   }
 
   /**
-   * Sets the ingest aliases for a customer. Ingest aliases can be used in the
-   * `customer_id` field when sending usage events to Metronome. This call is
-   * idempotent. It fully replaces the set of ingest aliases for the given customer.
+   * Create a billing configuration for a customer. Once created, these
+   * configurations are available to associate to a contract and dictates which
+   * downstream system to collect payment in or send the invoice to. You can create
+   * multiple configurations per customer. The configuration formats are distinct for
+   * each downstream provider.
+   *
+   * ### Use this endpoint to:
+   *
+   * - Add the initial configuration to an existing customer. Once created, the
+   *   billing configuration can then be associated to the customer's contract.
+   * - Add a new configuration to an existing customer. This might be used as part of
+   *   an upgrade or downgrade workflow where the customer was previously billed
+   *   through system A (e.g. Stripe) but will now be billed through system B (e.g.
+   *   AWS). Once created, the new configuration can then be associated to the
+   *   customer's contract.
+   * - Multiple configurations can be added per destination. For example, you can
+   *   create two Stripe billing configurations for a Metronome customer that each
+   *   have a distinct `collection_method`.
+   *
+   * ### Delivery method options:
+   *
+   * - `direct_to_billing_provider`: Use when Metronome should send invoices directly
+   *   to the billing provider's API (e.g., Stripe, NetSuite). This is the most
+   *   common method for automated billing workflows.
+   * - `tackle`: Use specifically for AWS Marketplace transactions that require
+   *   Tackle's co-selling platform for partner attribution and commission tracking.
+   * - `aws_sqs`: Use when you want invoice data delivered to an AWS SQS queue for
+   *   custom processing before sending to your billing system.
+   * - `aws_sns`: Use when you want invoice notifications published to an AWS SNS
+   *   topic for event-driven billing workflows.
+   *
+   * ### Key response fields:
+   *
+   * The id for the customer billing configuration. This id can be used to associate
+   * the billing configuration to a contract.
+   *
+   * ### Usage guidelines:
+   *
+   * Must use the `delivery_method_id` if you have multiple Stripe accounts connected
+   * to Metronome.
+   *
+   * @example
+   * ```ts
+   * await client.v1.customers.setBillingConfigurations({
+   *   data: [
+   *     {
+   *       customer_id: '4db51251-61de-4bfe-b9ce-495e244f3491',
+   *       billing_provider: 'stripe',
+   *       configuration: { ... },
+   *       delivery_method: 'direct_to_billing_provider',
+   *     },
+   *     {
+   *       customer_id: '4db51251-61de-4bfe-b9ce-495e244f3491',
+   *       billing_provider: 'aws_marketplace',
+   *       configuration: { ... },
+   *       delivery_method: 'direct_to_billing_provider',
+   *     },
+   *     {
+   *       customer_id: '4db51251-61de-4bfe-b9ce-495e244f3491',
+   *       billing_provider: 'azure_marketplace',
+   *       configuration: { ... },
+   *       delivery_method_id: '5b9e3072-415b-4842-94f0-0b6700c8b6be',
+   *     },
+   *     {
+   *       customer_id: '4db51251-61de-4bfe-b9ce-495e244f3491',
+   *       billing_provider: 'aws_marketplace',
+   *       configuration: { ... },
+   *       delivery_method: 'direct_to_billing_provider',
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  setBillingConfigurations(
+    body: CustomerSetBillingConfigurationsParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.post('/v1/setCustomerBillingProviderConfigurations', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Sets the ingest aliases for a customer. Use this endpoint to associate a
+   * Metronome customer with an internal ID for easier tracking between systems.
+   * Ingest aliases can be used in the `customer_id` field when sending usage events
+   * to Metronome.
+   *
+   * ### Usage guidelines:
+   *
+   * - This call is idempotent and fully replaces the set of ingest aliases for the
+   *   given customer.
+   * - Switching an ingest alias from one customer to another will associate all
+   *   corresponding usage to the new customer.
+   * - Use multiple ingest aliases to model child organizations within a single
+   *   Metronome customer.
    *
    * @example
    * ```ts
@@ -272,20 +433,21 @@ export class Customers extends APIResource {
    * });
    * ```
    */
-  setIngestAliases(
-    params: CustomerSetIngestAliasesParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<void> {
+  setIngestAliases(params: CustomerSetIngestAliasesParams, options?: RequestOptions): APIPromise<void> {
     const { customer_id, ...body } = params;
-    return this._client.post(`/v1/customers/${customer_id}/setIngestAliases`, {
+    return this._client.post(path`/v1/customers/${customer_id}/setIngestAliases`, {
       body,
       ...options,
-      headers: { Accept: '*/*', ...options?.headers },
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
   /**
-   * Updates the specified customer's name.
+   * Updates the display name for a customer record. Use this to correct customer
+   * names, update business names after rebranding, or maintain accurate customer
+   * information for invoicing and reporting. Returns the updated customer object
+   * with the new name applied immediately across all billing documents and
+   * interfaces.
    *
    * @example
    * ```ts
@@ -295,16 +457,16 @@ export class Customers extends APIResource {
    * });
    * ```
    */
-  setName(
-    params: CustomerSetNameParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<CustomerSetNameResponse> {
+  setName(params: CustomerSetNameParams, options?: RequestOptions): APIPromise<CustomerSetNameResponse> {
     const { customer_id, ...body } = params;
-    return this._client.post(`/v1/customers/${customer_id}/setName`, { body, ...options });
+    return this._client.post(path`/v1/customers/${customer_id}/setName`, { body, ...options });
   }
 
   /**
-   * Updates the specified customer's config.
+   * Update configuration settings for a specific customer, such as external system
+   * integrations (e.g., Salesforce account ID) and other customer-specific billing
+   * parameters. Use this endpoint to modify customer configurations without
+   * affecting core customer data like name or ingest aliases.
    *
    * @example
    * ```ts
@@ -314,21 +476,21 @@ export class Customers extends APIResource {
    * });
    * ```
    */
-  updateConfig(params: CustomerUpdateConfigParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+  updateConfig(params: CustomerUpdateConfigParams, options?: RequestOptions): APIPromise<void> {
     const { customer_id, ...body } = params;
-    return this._client.post(`/v1/customers/${customer_id}/updateConfig`, {
+    return this._client.post(path`/v1/customers/${customer_id}/updateConfig`, {
       body,
       ...options,
-      headers: { Accept: '*/*', ...options?.headers },
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 }
 
-export class CustomerDetailsCursorPage extends CursorPage<CustomerDetail> {}
+export type CustomerDetailsCursorPage = CursorPage<CustomerDetail>;
 
-export class CustomerListBillableMetricsResponsesCursorPage extends CursorPage<CustomerListBillableMetricsResponse> {}
+export type CustomerListBillableMetricsResponsesCursorPage = CursorPage<CustomerListBillableMetricsResponse>;
 
-export class CustomerListCostsResponsesCursorPage extends CursorPage<CustomerListCostsResponse> {}
+export type CustomerListCostsResponsesCursorPage = CursorPage<CustomerListCostsResponse>;
 
 export interface Customer {
   /**
@@ -350,6 +512,9 @@ export interface Customer {
 
   name: string;
 
+  /**
+   * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+   */
   custom_fields?: { [key: string]: string };
 }
 
@@ -364,6 +529,9 @@ export interface CustomerDetail {
    */
   created_at: string;
 
+  /**
+   * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+   */
   custom_fields: { [key: string]: string };
 
   customer_config: CustomerDetail.CustomerConfig;
@@ -382,6 +550,11 @@ export interface CustomerDetail {
 
   name: string;
 
+  /**
+   * RFC 3339 timestamp indicating when the customer was last updated.
+   */
+  updated_at: string;
+
   /**
    * RFC 3339 timestamp indicating when the customer was archived. Null if the
    * customer is active.
@@ -457,6 +630,9 @@ export interface CustomerListBillableMetricsResponse {
    */
   archived_at?: string;
 
+  /**
+   * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+   */
   custom_fields?: { [key: string]: string };
 
   /**
@@ -524,7 +700,60 @@ export namespace CustomerListCostsResponse {
 }
 
 export interface CustomerPreviewEventsResponse {
-  data: InvoicesAPI.Invoice;
+  data: Array<InvoicesAPI.Invoice>;
+}
+
+export interface CustomerRetrieveBillingConfigurationsResponse {
+  data: Array<CustomerRetrieveBillingConfigurationsResponse.Data>;
+}
+
+export namespace CustomerRetrieveBillingConfigurationsResponse {
+  export interface Data {
+    /**
+     * ID of this configuration; can be provided as the
+     * billing_provider_configuration_id when creating a contract.
+     */
+    id: string;
+
+    archived_at: string | null;
+
+    /**
+     * The billing provider set for this configuration.
+     */
+    billing_provider:
+      | 'aws_marketplace'
+      | 'stripe'
+      | 'netsuite'
+      | 'custom'
+      | 'azure_marketplace'
+      | 'quickbooks_online'
+      | 'workday'
+      | 'gcp_marketplace';
+
+    /**
+     * Configuration for the billing provider. The structure of this object is specific
+     * to the billing provider.
+     */
+    configuration: { [key: string]: unknown };
+
+    customer_id: string;
+
+    /**
+     * The method to use for delivering invoices to this customer.
+     */
+    delivery_method: 'direct_to_billing_provider' | 'aws_sqs' | 'tackle' | 'aws_sns';
+
+    /**
+     * Configuration for the delivery method. The structure of this object is specific
+     * to the delivery method.
+     */
+    delivery_method_configuration: { [key: string]: unknown };
+
+    /**
+     * ID of the delivery method to use for this customer.
+     */
+    delivery_method_id: string;
+  }
 }
 
 export interface CustomerSetNameResponse {
@@ -539,6 +768,9 @@ export interface CustomerCreateParams {
 
   billing_config?: CustomerCreateParams.BillingConfig;
 
+  /**
+   * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+   */
   custom_fields?: { [key: string]: string };
 
   customer_billing_provider_configurations?: Array<CustomerCreateParams.CustomerBillingProviderConfiguration>;
@@ -603,7 +835,11 @@ export namespace CustomerCreateParams {
       | 'us-west-1'
       | 'us-west-2';
 
-    stripe_collection_method?: 'charge_automatically' | 'send_invoice';
+    stripe_collection_method?:
+      | 'charge_automatically'
+      | 'send_invoice'
+      | 'auto_charge_payment_intent'
+      | 'manually_charge_payment_intent';
   }
 
   export interface CustomerBillingProviderConfiguration {
@@ -631,6 +867,14 @@ export namespace CustomerCreateParams {
      * `delivery_method` must be provided.
      */
     delivery_method_id?: string;
+
+    /**
+     * Specifies which tax provider Metronome should use for tax calculation when
+     * billing through Stripe. This is only supported for Stripe billing provider
+     * configurations with auto_charge_payment_intent or manual_charge_payment_intent
+     * collection methods.
+     */
+    tax_provider?: 'anrok' | 'avalara' | 'stripe';
   }
 }
 
@@ -731,13 +975,6 @@ export namespace CustomerPreviewEventsParams {
   export interface Event {
     event_type: string;
 
-    /**
-     * This has no effect for preview events, but may be set for consistency with Event
-     * objects. They will be processed even if they do not match the customer's ID or
-     * ingest aliases.
-     */
-    customer_id?: string;
-
     properties?: { [key: string]: unknown };
 
     /**
@@ -746,14 +983,74 @@ export namespace CustomerPreviewEventsParams {
     timestamp?: string;
 
     /**
-     * This has no effect for preview events, but may be set for consistency with Event
-     * objects. Duplicate transaction_ids are NOT filtered out, even within the same
-     * request.
+     * Optional unique identifier for event deduplication. When provided, preview
+     * events are automatically deduplicated against historical events from the past 34
+     * days. Duplicate transaction IDs within the same request will return an error.
      */
     transaction_id?: string;
   }
 }
 
+export interface CustomerRetrieveBillingConfigurationsParams {
+  customer_id: string;
+
+  include_archived?: boolean;
+}
+
+export interface CustomerSetBillingConfigurationsParams {
+  data: Array<CustomerSetBillingConfigurationsParams.Data>;
+}
+
+export namespace CustomerSetBillingConfigurationsParams {
+  export interface Data {
+    /**
+     * The billing provider set for this configuration.
+     */
+    billing_provider:
+      | 'aws_marketplace'
+      | 'stripe'
+      | 'netsuite'
+      | 'custom'
+      | 'azure_marketplace'
+      | 'quickbooks_online'
+      | 'workday'
+      | 'gcp_marketplace';
+
+    customer_id: string;
+
+    /**
+     * Configuration for the billing provider. The structure of this object is specific
+     * to the billing provider and delivery method combination. Defaults to an empty
+     * object, however, for most billing provider + delivery method combinations, it
+     * will not be a valid configuration. For AWS marketplace configurations, the
+     * aws_is_subscription_product flag can be used to indicate a product with
+     * usage-based pricing. More information can be found
+     * [here](https://docs.metronome.com/invoice-customers/solutions/marketplaces/invoice-aws/#provision-aws-marketplace-customers-in-metronome).
+     */
+    configuration?: { [key: string]: unknown };
+
+    /**
+     * The method to use for delivering invoices to this customer. If not provided, the
+     * `delivery_method_id` must be provided.
+     */
+    delivery_method?: 'direct_to_billing_provider' | 'aws_sqs' | 'tackle' | 'aws_sns';
+
+    /**
+     * ID of the delivery method to use for this customer. If not provided, the
+     * `delivery_method` must be provided.
+     */
+    delivery_method_id?: string;
+
+    /**
+     * Specifies which tax provider Metronome should use for tax calculation when
+     * billing through Stripe. This is only supported for Stripe billing provider
+     * configurations with auto_charge_payment_intent or manual_charge_payment_intent
+     * collection methods.
+     */
+    tax_provider?: 'anrok' | 'avalara' | 'stripe';
+  }
+}
+
 export interface CustomerSetIngestAliasesParams {
   /**
    * Path param:
@@ -797,16 +1094,9 @@ export interface CustomerUpdateConfigParams {
   salesforce_account_id?: string | null;
 }
 
-Customers.CustomerDetailsCursorPage = CustomerDetailsCursorPage;
-Customers.CustomerListBillableMetricsResponsesCursorPage = CustomerListBillableMetricsResponsesCursorPage;
-Customers.CustomerListCostsResponsesCursorPage = CustomerListCostsResponsesCursorPage;
 Customers.Alerts = Alerts;
 Customers.Plans = Plans;
-Customers.PlanListResponsesCursorPage = PlanListResponsesCursorPage;
-Customers.PlanListPriceAdjustmentsResponsesCursorPage = PlanListPriceAdjustmentsResponsesCursorPage;
 Customers.Invoices = Invoices;
-Customers.InvoicesCursorPage = InvoicesCursorPage;
-Customers.InvoiceListBreakdownsResponsesCursorPage = InvoiceListBreakdownsResponsesCursorPage;
 Customers.BillingConfig = BillingConfigAPIBillingConfig;
 Customers.Commits = Commits;
 Customers.Credits = Credits;
@@ -822,10 +1112,11 @@ export declare namespace Customers {
     type CustomerListBillableMetricsResponse as CustomerListBillableMetricsResponse,
     type CustomerListCostsResponse as CustomerListCostsResponse,
     type CustomerPreviewEventsResponse as CustomerPreviewEventsResponse,
+    type CustomerRetrieveBillingConfigurationsResponse as CustomerRetrieveBillingConfigurationsResponse,
     type CustomerSetNameResponse as CustomerSetNameResponse,
-    CustomerDetailsCursorPage as CustomerDetailsCursorPage,
-    CustomerListBillableMetricsResponsesCursorPage as CustomerListBillableMetricsResponsesCursorPage,
-    CustomerListCostsResponsesCursorPage as CustomerListCostsResponsesCursorPage,
+    type CustomerDetailsCursorPage as CustomerDetailsCursorPage,
+    type CustomerListBillableMetricsResponsesCursorPage as CustomerListBillableMetricsResponsesCursorPage,
+    type CustomerListCostsResponsesCursorPage as CustomerListCostsResponsesCursorPage,
     type CustomerCreateParams as CustomerCreateParams,
     type CustomerRetrieveParams as CustomerRetrieveParams,
     type CustomerListParams as CustomerListParams,
@@ -833,6 +1124,8 @@ export declare namespace Customers {
     type CustomerListBillableMetricsParams as CustomerListBillableMetricsParams,
     type CustomerListCostsParams as CustomerListCostsParams,
     type CustomerPreviewEventsParams as CustomerPreviewEventsParams,
+    type CustomerRetrieveBillingConfigurationsParams as CustomerRetrieveBillingConfigurationsParams,
+    type CustomerSetBillingConfigurationsParams as CustomerSetBillingConfigurationsParams,
     type CustomerSetIngestAliasesParams as CustomerSetIngestAliasesParams,
     type CustomerSetNameParams as CustomerSetNameParams,
     type CustomerUpdateConfigParams as CustomerUpdateConfigParams,
@@ -842,7 +1135,7 @@ export declare namespace Customers {
     Alerts as Alerts,
     type CustomerAlert as CustomerAlert,
     type AlertRetrieveResponse as AlertRetrieveResponse,
-    type AlertListResponse as AlertListResponse,
+    type CustomerAlertsCursorPageWithoutLimit as CustomerAlertsCursorPageWithoutLimit,
     type AlertRetrieveParams as AlertRetrieveParams,
     type AlertListParams as AlertListParams,
     type AlertResetParams as AlertResetParams,
@@ -854,8 +1147,8 @@ export declare namespace Customers {
     type PlanAddResponse as PlanAddResponse,
     type PlanEndResponse as PlanEndResponse,
     type PlanListPriceAdjustmentsResponse as PlanListPriceAdjustmentsResponse,
-    PlanListResponsesCursorPage as PlanListResponsesCursorPage,
-    PlanListPriceAdjustmentsResponsesCursorPage as PlanListPriceAdjustmentsResponsesCursorPage,
+    type PlanListResponsesCursorPage as PlanListResponsesCursorPage,
+    type PlanListPriceAdjustmentsResponsesCursorPage as PlanListPriceAdjustmentsResponsesCursorPage,
     type PlanListParams as PlanListParams,
     type PlanAddParams as PlanAddParams,
     type PlanEndParams as PlanEndParams,
@@ -868,12 +1161,13 @@ export declare namespace Customers {
     type InvoiceRetrieveResponse as InvoiceRetrieveResponse,
     type InvoiceAddChargeResponse as InvoiceAddChargeResponse,
     type InvoiceListBreakdownsResponse as InvoiceListBreakdownsResponse,
-    InvoicesCursorPage as InvoicesCursorPage,
-    InvoiceListBreakdownsResponsesCursorPage as InvoiceListBreakdownsResponsesCursorPage,
+    type InvoicesCursorPage as InvoicesCursorPage,
+    type InvoiceListBreakdownsResponsesCursorPage as InvoiceListBreakdownsResponsesCursorPage,
     type InvoiceRetrieveParams as InvoiceRetrieveParams,
     type InvoiceListParams as InvoiceListParams,
     type InvoiceAddChargeParams as InvoiceAddChargeParams,
     type InvoiceListBreakdownsParams as InvoiceListBreakdownsParams,
+    type InvoiceRetrievePdfParams as InvoiceRetrievePdfParams,
   };
 
   export {
@@ -887,7 +1181,6 @@ export declare namespace Customers {
   export {
     Commits as Commits,
     type CommitCreateResponse as CommitCreateResponse,
-    type CommitListResponse as CommitListResponse,
     type CommitUpdateEndDateResponse as CommitUpdateEndDateResponse,
     type CommitCreateParams as CommitCreateParams,
     type CommitListParams as CommitListParams,
@@ -897,7 +1190,6 @@ export declare namespace Customers {
   export {
     Credits as Credits,
     type CreditCreateResponse as CreditCreateResponse,
-    type CreditListResponse as CreditListResponse,
     type CreditUpdateEndDateResponse as CreditUpdateEndDateResponse,
     type CreditCreateParams as CreditCreateParams,
     type CreditListParams as CreditListParams,