modern-treasury 2.2.0 → 2.4.0

package/src/resources/invoices/line-items.ts

@@ -1,11 +1,10 @@
 // File generated from our OpenAPI spec by Stainless.
 
-import * as Core from '../../core';
-import { APIResource } from '../../resource';
-import { isRequestOptions } from '../../core';
-import * as Shared from '../shared';
-import * as API from './index';
-import { Page, PageParams } from '../../pagination';
+import * as Core from '../../core.js';
+import { APIResource } from '../../resource.js';
+import { isRequestOptions } from '../../core.js';
+import * as API from './index.js';
+import { Page, PageParams } from '../../pagination.js';
 
 export class LineItems extends APIResource {
   /**
@@ -15,23 +14,25 @@ export class LineItems extends APIResource {
     invoiceId: string,
     params: LineItemCreateParams,
     options?: Core.RequestOptions,
-  ): Promise<Core.APIResponse<InvoiceLineItem>> {
+  ): Core.APIPromise<InvoiceLineItem> {
+    // @ts-expect-error idempotency key header isn't defined anymore but is included here for back-compat
     const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+    if (idempotencyKey) {
+      console.warn(
+        "The Idempotency-Key request param is deprecated, the 'idempotencyToken' option should be set instead",
+      );
+    }
     return this.post(`/api/invoices/${invoiceId}/invoice_line_items`, {
       body,
       ...options,
-      headers: { 'Idempotency-Key': idempotencyKey || '', ...options?.headers },
+      headers: { 'Idempotency-Key': idempotencyKey, ...options?.headers },
     });
   }
 
   /**
    * get invoice_line_item
    */
-  retrieve(
-    invoiceId: string,
-    id: string,
-    options?: Core.RequestOptions,
-  ): Promise<Core.APIResponse<InvoiceLineItem>> {
+  retrieve(invoiceId: string, id: string, options?: Core.RequestOptions): Core.APIPromise<InvoiceLineItem> {
     return this.get(`/api/invoices/${invoiceId}/invoice_line_items/${id}`, options);
   }
 
@@ -43,18 +44,14 @@ export class LineItems extends APIResource {
     id: string,
     body?: LineItemUpdateParams,
     options?: Core.RequestOptions,
-  ): Promise<Core.APIResponse<InvoiceLineItem>>;
-  update(
-    invoiceId: string,
-    id: string,
-    options?: Core.RequestOptions,
-  ): Promise<Core.APIResponse<InvoiceLineItem>>;
+  ): Core.APIPromise<InvoiceLineItem>;
+  update(invoiceId: string, id: string, options?: Core.RequestOptions): Core.APIPromise<InvoiceLineItem>;
   update(
     invoiceId: string,
     id: string,
     body: LineItemUpdateParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Promise<Core.APIResponse<InvoiceLineItem>> {
+  ): Core.APIPromise<InvoiceLineItem> {
     if (isRequestOptions(body)) {
       return this.update(invoiceId, id, {}, body);
     }
@@ -68,13 +65,16 @@ export class LineItems extends APIResource {
     invoiceId: string,
     query?: LineItemListParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<InvoiceLineItemsPage>;
-  list(invoiceId: string, options?: Core.RequestOptions): Core.PagePromise<InvoiceLineItemsPage>;
+  ): Core.PagePromise<InvoiceLineItemsPage, InvoiceLineItem>;
+  list(
+    invoiceId: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<InvoiceLineItemsPage, InvoiceLineItem>;
   list(
     invoiceId: string,
     query: LineItemListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.PagePromise<InvoiceLineItemsPage> {
+  ): Core.PagePromise<InvoiceLineItemsPage, InvoiceLineItem> {
     if (isRequestOptions(query)) {
       return this.list(invoiceId, {}, query);
     }
@@ -87,11 +87,7 @@ export class LineItems extends APIResource {
   /**
    * delete invoice_line_item
    */
-  del(
-    invoiceId: string,
-    id: string,
-    options?: Core.RequestOptions,
-  ): Promise<Core.APIResponse<InvoiceLineItem>> {
+  del(invoiceId: string, id: string, options?: Core.RequestOptions): Core.APIPromise<InvoiceLineItem> {
     return this.delete(`/api/invoices/${invoiceId}/invoice_line_items/${id}`, options);
   }
 }
@@ -153,242 +149,64 @@ export interface InvoiceLineItem {
 
 export interface LineItemCreateParams {
   /**
-   * Body param: The name of the line item, typically a product or SKU name.
+   * The name of the line item, typically a product or SKU name.
    */
   name: string;
 
   /**
-   * Body param: The cost per unit of the product or service that this line item is
-   * for, specified in the invoice currency's smallest unit.
+   * The cost per unit of the product or service that this line item is for,
+   * specified in the invoice currency's smallest unit.
    */
   unit_amount: number;
 
   /**
-   * Body param: An optional free-form description of the line item.
+   * An optional free-form description of the line item.
    */
   description?: string;
 
   /**
-   * Body param: Either `debit` or `credit`. `debit` indicates that a client owes the
-   * business money and increases the invoice's `total_amount` due. `credit` has the
-   * opposite intention and effect.
+   * Either `debit` or `credit`. `debit` indicates that a client owes the business
+   * money and increases the invoice's `total_amount` due. `credit` has the opposite
+   * intention and effect.
    */
   direction?: string;
 
   /**
-   * Body param: The number of units of a product or service that this line item is
-   * for. Must be a whole number. Defaults to 1 if not provided.
+   * The number of units of a product or service that this line item is for. Must be
+   * a whole number. Defaults to 1 if not provided.
    */
   quantity?: number;
-
-  /**
-   * Header param: This key should be something unique, preferably something like an
-   * UUID.
-   */
-  'Idempotency-Key'?: string;
 }
 
 export interface LineItemUpdateParams {
   /**
-   * The invoicer's contact details displayed at the top of the invoice.
-   */
-  contact_details?: Array<LineItemUpdateParams.ContactDetail>;
-
-  /**
-   * The counterparty's billing address.
-   */
-  counterparty_billing_address?: LineItemUpdateParams.CounterpartyBillingAddress | null;
-
-  /**
-   * The ID of the counterparty receiving the invoice.
-   */
-  counterparty_id?: string;
-
-  /**
-   * The counterparty's shipping address where physical goods should be delivered.
-   */
-  counterparty_shipping_address?: LineItemUpdateParams.CounterpartyShippingAddress | null;
-
-  /**
-   * Currency that the invoice is denominated in. Defaults to `USD` if not provided.
-   */
-  currency?: Shared.Currency | null;
-
-  /**
-   * A free-form description of the invoice.
+   * An optional free-form description of the line item.
    */
   description?: string;
 
   /**
-   * A future date by when the invoice needs to be paid.
-   */
-  due_date?: string;
-
-  /**
-   * The invoice issuer's business address.
-   */
-  invoicer_address?: LineItemUpdateParams.InvoicerAddress | null;
-
-  /**
-   * The ID of the internal account the invoice should be paid to.
-   */
-  originating_account_id?: string;
-
-  /**
-   * Date transactions are to be posted to the participants' account. Defaults to the
-   * current business day or the next business day if the current day is a bank
-   * holiday or weekend. Format: yyyy-mm-dd.
-   */
-  payment_effective_date?: string;
-
-  /**
-   * The method by which the invoice can be paid. `ui` will show the embedded payment
-   * collection flow. `automatic` will automatically initiate payment based upon the
-   * account details of the receiving_account id.\nIf the invoice amount is positive,
-   * the automatically initiated payment order's direction will be debit. If the
-   * invoice amount is negative, the automatically initiated payment order's
-   * direction will be credit. One of `manual`, `ui`, or `automatic`.
-   */
-  payment_method?: 'ui' | 'manual' | 'automatic';
-
-  /**
-   * One of `ach`, `eft`, `wire`, `check`, `sen`, `book`, `rtp`, `sepa`, `bacs`,
-   * `au_becs`, `interac`, `signet`, `provexchange`.
-   */
-  payment_type?:
-    | 'ach'
-    | 'au_becs'
-    | 'bacs'
-    | 'book'
-    | 'card'
-    | 'check'
-    | 'eft'
-    | 'cross_border'
-    | 'interac'
-    | 'masav'
-    | 'neft'
-    | 'provxchange'
-    | 'rtp'
-    | 'sen'
-    | 'sepa'
-    | 'signet'
-    | 'wire';
-
-  /**
-   * The receiving account ID. Can be an `external_account`.
+   * Either `debit` or `credit`. `debit` indicates that a client owes the business
+   * money and increases the invoice's `total_amount` due. `credit` has the opposite
+   * intention and effect.
    */
-  receiving_account_id?: string;
-}
-
-export namespace LineItemUpdateParams {
-  export interface ContactDetail {
-    id: string;
-
-    contact_identifier: string;
-
-    contact_identifier_type: 'email' | 'phone_number' | 'website';
-
-    created_at: string;
-
-    discarded_at: string | null;
-
-    /**
-     * This field will be true if this object exists in the live environment or false
-     * if it exists in the test environment.
-     */
-    live_mode: boolean;
-
-    object: string;
-
-    updated_at: string;
-  }
+  direction?: string;
 
   /**
-   * The counterparty's billing address.
+   * The name of the line item, typically a product or SKU name.
    */
-  export interface CounterpartyBillingAddress {
-    /**
-     * Country code conforms to [ISO 3166-1 alpha-2]
-     */
-    country: string;
-
-    line1: string;
-
-    /**
-     * Locality or City.
-     */
-    locality: string;
-
-    /**
-     * The postal code of the address.
-     */
-    postal_code: string;
-
-    /**
-     * Region or State.
-     */
-    region: string;
-
-    line2?: string;
-  }
+  name?: string;
 
   /**
-   * The counterparty's shipping address where physical goods should be delivered.
+   * The number of units of a product or service that this line item is for. Must be
+   * a whole number. Defaults to 1 if not provided.
    */
-  export interface CounterpartyShippingAddress {
-    /**
-     * Country code conforms to [ISO 3166-1 alpha-2]
-     */
-    country: string;
-
-    line1: string;
-
-    /**
-     * Locality or City.
-     */
-    locality: string;
-
-    /**
-     * The postal code of the address.
-     */
-    postal_code: string;
-
-    /**
-     * Region or State.
-     */
-    region: string;
-
-    line2?: string;
-  }
+  quantity?: number;
 
   /**
-   * The invoice issuer's business address.
+   * The cost per unit of the product or service that this line item is for,
+   * specified in the invoice currency's smallest unit.
    */
-  export interface InvoicerAddress {
-    /**
-     * Country code conforms to [ISO 3166-1 alpha-2]
-     */
-    country: string;
-
-    line1: string;
-
-    /**
-     * Locality or City.
-     */
-    locality: string;
-
-    /**
-     * The postal code of the address.
-     */
-    postal_code: string;
-
-    /**
-     * Region or State.
-     */
-    region: string;
-
-    line2?: string;
-  }
+  unit_amount?: number;
 }
 
 export interface LineItemListParams extends PageParams {}