quickbooks-api/dist/packages/api/bill/bill-api.js

A modular TypeScript SDK for seamless integration with Intuit QuickBooks APIs. Provides robust authentication handling and future-ready foundation for accounting, payments, and commerce operations.

import { ApiClient } from '../api-client.js';
import { Environment, Query, QuickbooksError } from '../../../types/types.js';
import { BillQueryBuilder } from './bill-query-builder.js';
import path from 'path';
// Import the Services
import { getAllBills } from './services/get-all-bills.js';
import { getBillById } from './services/get-bill-by-id.js';
import { getBillsForDateRange } from './services/get-bills-for-date-range.js';
import { getUpdatedBills } from './services/get-updated-bills.js';
import { rawBillQuery } from './services/raw-bill-query.js';
/**
 * Bill API Client
 */
export class BillAPI {
    apiClient;
    // The List of Bill Services
    getAllBills = getAllBills.bind(this);
    getBillById = getBillById.bind(this);
    getBillsForDateRange = getBillsForDateRange.bind(this);
    getUpdatedBills = getUpdatedBills.bind(this);
    rawBillQuery = rawBillQuery.bind(this);
    /**
     * Constructor
     * @param apiClient - The API Client
     */
    constructor(apiClient) {
        this.apiClient = apiClient;
    }
    /**
     * Get the Company Endpoint
     * @returns The Company Endpoint
     */
    async getCompanyEndpoint() {
        // Get the Token
        const token = await this.apiClient.authProvider.getToken();
        // Get the Environment URL
        const environmentUrl = this.apiClient.environment === Environment.Production ? 'quickbooks.api.intuit.com' : 'sandbox-quickbooks.api.intuit.com';
        // Return the Company Endpoint
        return `https://${environmentUrl}/v3/company/${token.realmId}`;
    }
    /**
     * Format the Response
     * @param response - The Response
     * @returns The Bills
     */
    async formatResponse(response) {
        // Check if the Response is invalid
        if (!response?.QueryResponse) {
            // Get the Intuit Error Details
            const errorDetails = await ApiClient.getIntuitErrorDetails(response);
            // Throw the Quickbooks Error
            throw new QuickbooksError('Unable to format Bills', errorDetails);
        }
        // Check if the Length is Less than 1 and if it is, set the Bill to an empty array
        if (!response.QueryResponse.Bill)
            response.QueryResponse.Bill = new Array();
        // Get the Bills
        const queryResponse = response.QueryResponse;
        // Return the Bills
        return queryResponse.Bill;
    }
    // Returns the Bill URL
    async getUrl() {
        // Setup the URL
        const url = new URL(await this.getCompanyEndpoint());
        // Set the Bill Endpoint
        url.pathname = path.join(url.pathname, 'bill');
        // Return the URL
        return url;
    }
    /**
     * Get the Query Builder
     * @returns The Query Builder
     */
    async getQueryBuilder() {
        // Get the Company Endpoint
        const companyEndpoint = await this.getCompanyEndpoint();
        // Setup the New Query Builder
        const queryBuilder = new BillQueryBuilder(companyEndpoint, Query.Bill);
        // Return the Query Builder
        return queryBuilder;
    }
    /**
     * Checks if there is a next page
     * @param queryBuilder - The Query Builder
     * @returns True if there is a next page
     */
    async hasNextPage(queryBuilder) {
        // Check if Auto Check Next Page is Disabled
        if (!this.apiClient.autoCheckNextPage)
            return false;
        // Get the Page Number
        const page = (queryBuilder.searchOptions.page || 1) + 1;
        // Update the Page Number
        queryBuilder.searchOptions.page = page;
        // Get the URL
        const url = queryBuilder.build();
        // Run the Request
        const result = await this.apiClient.runRequest(url, { method: 'GET' }).catch((error) => {
            console.error(`Failed to check if there is a next page: ${error}`);
            return null;
        });
        // Check if the Response is Invalid
        if (!result?.responseData || !result.responseData?.QueryResponse?.Bill)
            return false;
        // Check if the Response has no Bills
        if (result.responseData.QueryResponse.Bill.length < 1)
            return false;
        // Return True
        return true;
    }
}