feat(creditCardBills): add endpoint and missing types.

src/client.ts

@@ -29,6 +29,7 @@ import {
   PageFilters,
   InvestmentsFilters,
 } from './types'
+import { CreditCardBills } from './types/creditCardBills'
 import { ValidationResult } from './types/validation'
 
 /**
@@ -337,6 +338,26 @@ export class PluggyClient extends BaseApi {
     return await this.createGetRequest(`identity?itemId=${itemId}`)
   }
 
+  /**
+   * Fetch credit card bills from an accountId
+   * @returns {PageResponse<CreditCardBills>} an credit card bills object
+   */
+  async fetchCreditCardBills(
+    accountId: string,
+    options: PageFilters = {}
+  ): Promise<PageResponse<CreditCardBills>> {
+    return await this.createGetRequest('bills', { ...options, accountId })
+  }
+
+  /**
+   * Fetch a single credit card bill by its id
+   * @param {string} id - the credit card bill id
+   * @returns {Promise<CreditCardBills>} - credit card bill object, if found
+   */
+  async fetchCreditCardBill(id: string): Promise<CreditCardBills> {
+    return await this.createGetRequest(`bills/${id}`)
+  }
+
   /**
    * Fetch all available categories
    * @returns {Categories[]} an paging response of categories

src/types/creditCardBills.ts

@@ -0,0 +1,31 @@
+import { CurrencyCode } from './common'
+
+export const CREDIT_CARD_BILL_FINANCE_CHARGE_TYPES = [
+  'LATE_PAYMENT_REMUNERATIVE_INTEREST',
+  'LATE_PAYMENT_FEE',
+  'LATE_PAYMENT_INTEREST',
+  'IOF',
+  'OTHER',
+] as const
+
+export type CreditCardBillFinanceChargeType = typeof CREDIT_CARD_BILL_FINANCE_CHARGE_TYPES[number]
+
+export type CreditCardBills = {
+  id: string
+  dueDate: Date
+  totalAmount: number
+  totalAmountCurrencyCode: CurrencyCode
+  minimumPaymentAmount: number | null
+  allowsInstallments: boolean | null
+  financeCharges: CreditCardBillFinanceChargeResponseItem[]
+  createdAt: Date
+  updatedAt: Date
+}
+
+export type CreditCardBillFinanceChargeResponseItem = {
+  id: string
+  type: CreditCardBillFinanceChargeType
+  amount: number
+  currencyCode: CurrencyCode
+  additionalInfo: string | null
+}