orb-billing 4.33.0 → 4.47.1

package/src/resources/invoices.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../resource';
 import { isRequestOptions } from '../core';
 import * as Core from '../core';
-import * as InvoicesAPI from './invoices';
 import * as Shared from './shared';
 import * as PricesAPI from './prices/prices';
 import { Page, type PageParams } from '../pagination';
@@ -115,6 +114,14 @@ export class Invoices extends APIResource {
     return this._client.post(`/invoices/${invoiceId}/mark_paid`, { body, ...options });
   }
 
+  /**
+   * This endpoint collects payment for an invoice using the customer's default
+   * payment method. This action can only be taken on invoices with status "issued".
+   */
+  pay(invoiceId: string, options?: Core.RequestOptions): Core.APIPromise<Invoice> {
+    return this._client.post(`/invoices/${invoiceId}/pay`, options);
+  }
+
   /**
    * This endpoint allows an invoice's status to be set the `void` status. This can
    * only be done to invoices that are in the `issued` status.
@@ -284,7 +291,7 @@ export interface Invoice {
    * list is provided, the first discount in the list will be returned. If the list
    * is empty, `None` will be returned.
    */
-  discount: unknown | null;
+  discount: unknown;
 
   discounts: Array<Shared.InvoiceLevelDiscount>;
 
@@ -369,6 +376,11 @@ export interface Invoice {
    */
   paid_at: string | null;
 
+  /**
+   * A list of payment attempts associated with the invoice
+   */
+  payment_attempts: Array<Invoice.PaymentAttempt>;
+
   /**
    * If payment was attempted on this invoice but failed, this will be the time of
    * the most recent attempt.
@@ -1293,6 +1305,38 @@ export namespace Invoice {
     minimum_amount: string;
   }
 
+  export interface PaymentAttempt {
+    /**
+     * The ID of the payment attempt.
+     */
+    id: string;
+
+    /**
+     * The amount of the payment attempt.
+     */
+    amount: string;
+
+    /**
+     * The time at which the payment attempt was created.
+     */
+    created_at: string;
+
+    /**
+     * The payment provider that attempted to collect the payment.
+     */
+    payment_provider: 'stripe' | null;
+
+    /**
+     * The ID of the payment attempt in the payment provider.
+     */
+    payment_provider_id: string | null;
+
+    /**
+     * Whether the payment attempt succeeded.
+     */
+    succeeded: boolean;
+  }
+
   export interface ShippingAddress {
     city: string | null;
 
@@ -1458,7 +1502,7 @@ export interface InvoiceFetchUpcomingResponse {
    * list is provided, the first discount in the list will be returned. If the list
    * is empty, `None` will be returned.
    */
-  discount: unknown | null;
+  discount: unknown;
 
   discounts: Array<Shared.InvoiceLevelDiscount>;
 
@@ -1538,6 +1582,11 @@ export interface InvoiceFetchUpcomingResponse {
    */
   paid_at: string | null;
 
+  /**
+   * A list of payment attempts associated with the invoice
+   */
+  payment_attempts: Array<InvoiceFetchUpcomingResponse.PaymentAttempt>;
+
   /**
    * If payment was attempted on this invoice but failed, this will be the time of
    * the most recent attempt.
@@ -2467,6 +2516,38 @@ export namespace InvoiceFetchUpcomingResponse {
     minimum_amount: string;
   }
 
+  export interface PaymentAttempt {
+    /**
+     * The ID of the payment attempt.
+     */
+    id: string;
+
+    /**
+     * The amount of the payment attempt.
+     */
+    amount: string;
+
+    /**
+     * The time at which the payment attempt was created.
+     */
+    created_at: string;
+
+    /**
+     * The payment provider that attempted to collect the payment.
+     */
+    payment_provider: 'stripe' | null;
+
+    /**
+     * The ID of the payment attempt in the payment provider.
+     */
+    payment_provider_id: string | null;
+
+    /**
+     * Whether the payment attempt succeeded.
+     */
+    succeeded: boolean;
+  }
+
   export interface ShippingAddress {
     city: string | null;
 
@@ -2606,6 +2687,12 @@ export interface InvoiceListParams extends PageParams {
 
   due_date?: string | null;
 
+  /**
+   * Filters invoices by their due dates within a specific time range in the past.
+   * Specify the range as a number followed by 'd' (days) or 'm' (months). For
+   * example, '7d' filters invoices due in the last 7 days, and '2m' filters those
+   * due in the last 2 months.
+   */
   due_date_window?: string | null;
 
   'due_date[gt]'?: string | null;
@@ -2636,7 +2723,10 @@ export interface InvoiceFetchUpcomingParams {
 export interface InvoiceIssueParams {
   /**
    * If true, the invoice will be issued synchronously. If false, the invoice will be
-   * issued asynchronously.
+   * issued asynchronously. The synchronous option is only available for invoices
+   * containin no usage fees. If the invoice is configured to sync to an external
+   * provider, a successful response from this endpoint guarantees the invoice is
+   * present in the provider.
    */
   synchronous?: boolean;
 }
@@ -2658,14 +2748,18 @@ export interface InvoiceMarkPaidParams {
   notes?: string | null;
 }
 
-export namespace Invoices {
-  export import Invoice = InvoicesAPI.Invoice;
-  export import InvoiceFetchUpcomingResponse = InvoicesAPI.InvoiceFetchUpcomingResponse;
-  export import InvoicesPage = InvoicesAPI.InvoicesPage;
-  export import InvoiceCreateParams = InvoicesAPI.InvoiceCreateParams;
-  export import InvoiceUpdateParams = InvoicesAPI.InvoiceUpdateParams;
-  export import InvoiceListParams = InvoicesAPI.InvoiceListParams;
-  export import InvoiceFetchUpcomingParams = InvoicesAPI.InvoiceFetchUpcomingParams;
-  export import InvoiceIssueParams = InvoicesAPI.InvoiceIssueParams;
-  export import InvoiceMarkPaidParams = InvoicesAPI.InvoiceMarkPaidParams;
+Invoices.InvoicesPage = InvoicesPage;
+
+export declare namespace Invoices {
+  export {
+    type Invoice as Invoice,
+    type InvoiceFetchUpcomingResponse as InvoiceFetchUpcomingResponse,
+    InvoicesPage as InvoicesPage,
+    type InvoiceCreateParams as InvoiceCreateParams,
+    type InvoiceUpdateParams as InvoiceUpdateParams,
+    type InvoiceListParams as InvoiceListParams,
+    type InvoiceFetchUpcomingParams as InvoiceFetchUpcomingParams,
+    type InvoiceIssueParams as InvoiceIssueParams,
+    type InvoiceMarkPaidParams as InvoiceMarkPaidParams,
+  };
 }

package/src/resources/items.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../resource';
 import { isRequestOptions } from '../core';
 import * as Core from '../core';
-import * as ItemsAPI from './items';
 import { Page, type PageParams } from '../pagination';
 
 export class Items extends APIResource {
@@ -107,10 +106,14 @@ export namespace ItemUpdateParams {
 
 export interface ItemListParams extends PageParams {}
 
-export namespace Items {
-  export import Item = ItemsAPI.Item;
-  export import ItemsPage = ItemsAPI.ItemsPage;
-  export import ItemCreateParams = ItemsAPI.ItemCreateParams;
-  export import ItemUpdateParams = ItemsAPI.ItemUpdateParams;
-  export import ItemListParams = ItemsAPI.ItemListParams;
+Items.ItemsPage = ItemsPage;
+
+export declare namespace Items {
+  export {
+    type Item as Item,
+    ItemsPage as ItemsPage,
+    type ItemCreateParams as ItemCreateParams,
+    type ItemUpdateParams as ItemUpdateParams,
+    type ItemListParams as ItemListParams,
+  };
 }

package/src/resources/metrics.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../resource';
 import { isRequestOptions } from '../core';
 import * as Core from '../core';
-import * as MetricsAPI from './metrics';
 import * as ItemsAPI from './items';
 import { Page, type PageParams } from '../pagination';
 
@@ -140,10 +139,14 @@ export interface MetricListParams extends PageParams {
   'created_at[lte]'?: string | null;
 }
 
-export namespace Metrics {
-  export import BillableMetric = MetricsAPI.BillableMetric;
-  export import BillableMetricsPage = MetricsAPI.BillableMetricsPage;
-  export import MetricCreateParams = MetricsAPI.MetricCreateParams;
-  export import MetricUpdateParams = MetricsAPI.MetricUpdateParams;
-  export import MetricListParams = MetricsAPI.MetricListParams;
+Metrics.BillableMetricsPage = BillableMetricsPage;
+
+export declare namespace Metrics {
+  export {
+    type BillableMetric as BillableMetric,
+    BillableMetricsPage as BillableMetricsPage,
+    type MetricCreateParams as MetricCreateParams,
+    type MetricUpdateParams as MetricUpdateParams,
+    type MetricListParams as MetricListParams,
+  };
 }

package/src/resources/plans/external-plan-id.ts

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../../resource';
 import * as Core from '../../core';
-import * as ExternalPlanIDAPI from './external-plan-id';
 import * as PlansAPI from './plans';
 
 export class ExternalPlanID extends APIResource {
@@ -59,6 +58,6 @@ export interface ExternalPlanIDUpdateParams {
   metadata?: Record<string, string | null> | null;
 }
 
-export namespace ExternalPlanID {
-  export import ExternalPlanIDUpdateParams = ExternalPlanIDAPI.ExternalPlanIDUpdateParams;
+export declare namespace ExternalPlanID {
+  export { type ExternalPlanIDUpdateParams as ExternalPlanIDUpdateParams };
 }

package/src/resources/plans/index.ts

@@ -1,4 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { ExternalPlanIDUpdateParams, ExternalPlanID } from './external-plan-id';
-export { Plan, PlanCreateParams, PlanUpdateParams, PlanListParams, PlansPage, Plans } from './plans';
+export { ExternalPlanID, type ExternalPlanIDUpdateParams } from './external-plan-id';
+export {
+  PlansPage,
+  Plans,
+  type Plan,
+  type PlanCreateParams,
+  type PlanUpdateParams,
+  type PlanListParams,
+} from './plans';