dodopayments 2.17.2 → 2.19.0

package/src/client.ts

@@ -33,6 +33,12 @@ import {
   AddonUpdateParams,
   Addons,
 } from './resources/addons';
+import {
+  BalanceLedgerEntriesDefaultPageNumberPagination,
+  BalanceLedgerEntry,
+  BalanceRetrieveLedgerParams,
+  Balances,
+} from './resources/balances';
 import {
   Brand,
   BrandCreateParams,
@@ -42,13 +48,21 @@ import {
   Brands,
 } from './resources/brands';
 import {
+  CheckoutSessionBillingAddress,
   CheckoutSessionCreateParams,
+  CheckoutSessionCustomization,
+  CheckoutSessionFlags,
   CheckoutSessionPreviewParams,
   CheckoutSessionPreviewResponse,
   CheckoutSessionRequest,
   CheckoutSessionResponse,
   CheckoutSessionStatus,
   CheckoutSessions,
+  CustomField,
+  ProductItemReq,
+  SubscriptionData,
+  ThemeConfig,
+  ThemeModeConfig,
 } from './resources/checkout-sessions';
 import {
   Discount,
@@ -738,9 +752,14 @@ export class DodoPayments {
   getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(
     path: string,
     Page: new (...args: any[]) => PageClass,
-    opts?: RequestOptions,
+    opts?: PromiseOrValue<RequestOptions>,
   ): Pagination.PagePromise<PageClass, Item> {
-    return this.requestAPIList(Page, { method: 'get', path, ...opts });
+    return this.requestAPIList(
+      Page,
+      opts && 'then' in opts ?
+        opts.then((opts) => ({ method: 'get', path, ...opts }))
+      : { method: 'get', path, ...opts },
+    );
   }
 
   requestAPIList<
@@ -748,7 +767,7 @@ export class DodoPayments {
     PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>,
   >(
     Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass,
-    options: FinalRequestOptions,
+    options: PromiseOrValue<FinalRequestOptions>,
   ): Pagination.PagePromise<PageClass, Item> {
     const request = this.makeRequest(options, null, undefined);
     return new Pagination.PagePromise<PageClass, Item>(this as any as DodoPayments, request, Page);
@@ -761,9 +780,10 @@ export class DodoPayments {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = this._makeAbort(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||
@@ -930,6 +950,12 @@ export class DodoPayments {
     return headers.values;
   }
 
+  private _makeAbort(controller: AbortController) {
+    // note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
+    //       would capture all request options, and cause a memory leak.
+    return () => controller.abort();
+  }
+
   private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;
@@ -1006,6 +1032,7 @@ export class DodoPayments {
   webhookEvents: API.WebhookEvents = new API.WebhookEvents(this);
   usageEvents: API.UsageEvents = new API.UsageEvents(this);
   meters: API.Meters = new API.Meters(this);
+  balances: API.Balances = new API.Balances(this);
 }
 
 DodoPayments.CheckoutSessions = CheckoutSessions;
@@ -1028,6 +1055,7 @@ DodoPayments.Webhooks = Webhooks;
 DodoPayments.WebhookEvents = WebhookEvents;
 DodoPayments.UsageEvents = UsageEvents;
 DodoPayments.Meters = Meters;
+DodoPayments.Balances = Balances;
 
 export declare namespace DodoPayments {
   export type RequestOptions = Opts.RequestOptions;
@@ -1046,9 +1074,17 @@ export declare namespace DodoPayments {
 
   export {
     CheckoutSessions as CheckoutSessions,
+    type CheckoutSessionBillingAddress as CheckoutSessionBillingAddress,
+    type CheckoutSessionCustomization as CheckoutSessionCustomization,
+    type CheckoutSessionFlags as CheckoutSessionFlags,
     type CheckoutSessionRequest as CheckoutSessionRequest,
     type CheckoutSessionResponse as CheckoutSessionResponse,
     type CheckoutSessionStatus as CheckoutSessionStatus,
+    type CustomField as CustomField,
+    type ProductItemReq as ProductItemReq,
+    type SubscriptionData as SubscriptionData,
+    type ThemeConfig as ThemeConfig,
+    type ThemeModeConfig as ThemeModeConfig,
     type CheckoutSessionPreviewResponse as CheckoutSessionPreviewResponse,
     type CheckoutSessionCreateParams as CheckoutSessionCreateParams,
     type CheckoutSessionPreviewParams as CheckoutSessionPreviewParams,
@@ -1278,4 +1314,11 @@ export declare namespace DodoPayments {
     type MeterCreateParams as MeterCreateParams,
     type MeterListParams as MeterListParams,
   };
+
+  export {
+    Balances as Balances,
+    type BalanceLedgerEntry as BalanceLedgerEntry,
+    type BalanceLedgerEntriesDefaultPageNumberPagination as BalanceLedgerEntriesDefaultPageNumberPagination,
+    type BalanceRetrieveLedgerParams as BalanceRetrieveLedgerParams,
+  };
 }

package/src/internal/parse.ts

@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: DodoPayments, props: APIRe
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

package/src/resources/balances.ts

@@ -0,0 +1,271 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as MiscAPI from './misc';
+import {
+  DefaultPageNumberPagination,
+  type DefaultPageNumberPaginationParams,
+  PagePromise,
+} from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+
+export class Balances extends APIResource {
+  retrieveLedger(
+    query: BalanceRetrieveLedgerParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BalanceLedgerEntriesDefaultPageNumberPagination, BalanceLedgerEntry> {
+    return this._client.getAPIList('/balances/ledger', DefaultPageNumberPagination<BalanceLedgerEntry>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type BalanceLedgerEntriesDefaultPageNumberPagination = DefaultPageNumberPagination<BalanceLedgerEntry>;
+
+export interface BalanceLedgerEntry {
+  id: string;
+
+  amount: number;
+
+  business_id: string;
+
+  created_at: string;
+
+  currency: MiscAPI.Currency;
+
+  event_type:
+    | 'payment'
+    | 'refund'
+    | 'refund_reversal'
+    | 'dispute'
+    | 'dispute_reversal'
+    | 'tax'
+    | 'tax_reversal'
+    | 'payment_fees'
+    | 'refund_fees'
+    | 'refund_fees_reversal'
+    | 'dispute_fees'
+    | 'payout'
+    | 'payout_fees'
+    | 'payout_reversal'
+    | 'payout_fees_reversal'
+    | 'dodo_credits'
+    | 'adjustment'
+    | 'currency_conversion';
+
+  is_credit: boolean;
+
+  usd_equivalent_amount: number;
+
+  after_balance?: number | null;
+
+  before_balance?: number | null;
+
+  description?: string | null;
+
+  reference_object_id?: string | null;
+}
+
+export interface BalanceRetrieveLedgerParams extends DefaultPageNumberPaginationParams {
+  /**
+   * Get events after this created time
+   */
+  created_at_gte?: string;
+
+  /**
+   * Get events created before this time
+   */
+  created_at_lte?: string;
+
+  /**
+   * Filter by currency
+   */
+  currency?:
+    | 'AED'
+    | 'ALL'
+    | 'AMD'
+    | 'ANG'
+    | 'AOA'
+    | 'ARS'
+    | 'AUD'
+    | 'AWG'
+    | 'AZN'
+    | 'BAM'
+    | 'BBD'
+    | 'BDT'
+    | 'BGN'
+    | 'BHD'
+    | 'BIF'
+    | 'BMD'
+    | 'BND'
+    | 'BOB'
+    | 'BRL'
+    | 'BSD'
+    | 'BWP'
+    | 'BYN'
+    | 'BZD'
+    | 'CAD'
+    | 'CHF'
+    | 'CLP'
+    | 'CNY'
+    | 'COP'
+    | 'CRC'
+    | 'CUP'
+    | 'CVE'
+    | 'CZK'
+    | 'DJF'
+    | 'DKK'
+    | 'DOP'
+    | 'DZD'
+    | 'EGP'
+    | 'ETB'
+    | 'EUR'
+    | 'FJD'
+    | 'FKP'
+    | 'GBP'
+    | 'GEL'
+    | 'GHS'
+    | 'GIP'
+    | 'GMD'
+    | 'GNF'
+    | 'GTQ'
+    | 'GYD'
+    | 'HKD'
+    | 'HNL'
+    | 'HRK'
+    | 'HTG'
+    | 'HUF'
+    | 'IDR'
+    | 'ILS'
+    | 'INR'
+    | 'IQD'
+    | 'JMD'
+    | 'JOD'
+    | 'JPY'
+    | 'KES'
+    | 'KGS'
+    | 'KHR'
+    | 'KMF'
+    | 'KRW'
+    | 'KWD'
+    | 'KYD'
+    | 'KZT'
+    | 'LAK'
+    | 'LBP'
+    | 'LKR'
+    | 'LRD'
+    | 'LSL'
+    | 'LYD'
+    | 'MAD'
+    | 'MDL'
+    | 'MGA'
+    | 'MKD'
+    | 'MMK'
+    | 'MNT'
+    | 'MOP'
+    | 'MRU'
+    | 'MUR'
+    | 'MVR'
+    | 'MWK'
+    | 'MXN'
+    | 'MYR'
+    | 'MZN'
+    | 'NAD'
+    | 'NGN'
+    | 'NIO'
+    | 'NOK'
+    | 'NPR'
+    | 'NZD'
+    | 'OMR'
+    | 'PAB'
+    | 'PEN'
+    | 'PGK'
+    | 'PHP'
+    | 'PKR'
+    | 'PLN'
+    | 'PYG'
+    | 'QAR'
+    | 'RON'
+    | 'RSD'
+    | 'RUB'
+    | 'RWF'
+    | 'SAR'
+    | 'SBD'
+    | 'SCR'
+    | 'SEK'
+    | 'SGD'
+    | 'SHP'
+    | 'SLE'
+    | 'SLL'
+    | 'SOS'
+    | 'SRD'
+    | 'SSP'
+    | 'STN'
+    | 'SVC'
+    | 'SZL'
+    | 'THB'
+    | 'TND'
+    | 'TOP'
+    | 'TRY'
+    | 'TTD'
+    | 'TWD'
+    | 'TZS'
+    | 'UAH'
+    | 'UGX'
+    | 'USD'
+    | 'UYU'
+    | 'UZS'
+    | 'VES'
+    | 'VND'
+    | 'VUV'
+    | 'WST'
+    | 'XAF'
+    | 'XCD'
+    | 'XOF'
+    | 'XPF'
+    | 'YER'
+    | 'ZAR'
+    | 'ZMW';
+
+  /**
+   * Filter by Ledger Event Type
+   */
+  event_type?:
+    | 'payment'
+    | 'refund'
+    | 'refund_reversal'
+    | 'dispute'
+    | 'dispute_reversal'
+    | 'tax'
+    | 'tax_reversal'
+    | 'payment_fees'
+    | 'refund_fees'
+    | 'refund_fees_reversal'
+    | 'dispute_fees'
+    | 'payout'
+    | 'payout_fees'
+    | 'payout_reversal'
+    | 'payout_fees_reversal'
+    | 'dodo_credits'
+    | 'adjustment'
+    | 'currency_conversion';
+
+  /**
+   * Min : 1, Max : 100, default 10
+   */
+  limit?: number;
+
+  /**
+   * Get events history of a specific object like payment/subscription/refund/dispute
+   */
+  reference_object_id?: string;
+}
+
+export declare namespace Balances {
+  export {
+    type BalanceLedgerEntry as BalanceLedgerEntry,
+    type BalanceLedgerEntriesDefaultPageNumberPagination as BalanceLedgerEntriesDefaultPageNumberPagination,
+    type BalanceRetrieveLedgerParams as BalanceRetrieveLedgerParams,
+  };
+}