conductor-node 9.4.1 → 9.5.0

package/README.md

@@ -100,14 +100,12 @@ Fetches all authorized integration-connections.
 const qbdConnections = await conductor.getIntegrationConnections();
 ```
 
-### `getIntegrationConnectionById(id: string)`
+### `getIntegrationConnection(id: string)`
 
 Fetches a single integration-connection by id.
 
 ```ts
-const qbdConnection = await conductor.getIntegrationConnectionById(
-  qbdConnectionId
-);
+const qbdConnection = await conductor.getIntegrationConnection(qbdConnectionId);
 ```
 
 ### `pingIntegrationConnection(id: string)`
@@ -175,7 +173,7 @@ All errors thrown by the Conductor API are instances of `ConductorError` or its
 
 The error object you receive will have one of the following error types:
 
-| Type                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| Name                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `ConductorIntegrationError`           | Raised when the third-party integration encounters an error while processing the end-user's request. This often results from an issue with the request or data handling that requires your attention to resolve.<br><br>E.g., a `ListID` you provided was not found in QuickBooks Desktop, or an accounting value you supplied did not adhere to the integration's accounting rules.<br><br>Refer to `error.integrationCode` for the error code returned by the integration, if available.                                                                                                                                                                                                                         |
 | `ConductorIntegrationConnectionError` | Raised when a connection error occurs with the third-party integration on the end-user's side. This typically indicates an issue with the end-user's integration connection or configuration, which they must resolve. In other words, you cannot take action to fix these errors.<br><br>E.g., QuickBooks Web Connector (QBWC) failed to connect to QuickBooks Desktop on the end-user's computer.<br><br>Refer to `error.integrationCode` for the error code returned by the integration connector, if available.<br><br>❗ We recommend _not_ alerting your team for these errors because only the end-user can fix them. See [Centralized Error Handling](#centralized-error-handling) for an example of this. |

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "9.4.1",
+    "version": "9.5.0",
     "description": "Easily integrate with the entire QuickBooks Desktop API with fully-typed async TypeScript",
     "author": "Danny Nemer <hi@DannyNemer.com>",
     "license": "MIT",

package/dist/src/Client.d.ts

@@ -12,6 +12,12 @@ export default class Client {
     private readonly graphqlClient;
     private readonly graphqlOperations;
     constructor(apiKey: string, { verbose, serverEnvironment }?: ClientOptions);
+    /**
+     * Fetches all integration-connections associated with your Conductor account.
+     *
+     * @returns The integration-connections.
+     */
+    getIntegrationConnections(): Promise<GraphqlGetIntegrationConnectionsQuery["integrationConnections"]>;
     /**
      * Fetches the specified integration-connection.
      *
@@ -19,12 +25,6 @@ export default class Client {
      * @returns The integration-connection.
      */
     getIntegrationConnection(integrationConnectionId: GraphqlGetIntegrationConnectionQueryVariables["integrationConnectionId"]): Promise<GraphqlGetIntegrationConnectionQuery["integrationConnection"]>;
-    /**
-     * Fetches all integration-connections associated with your Conductor account.
-     *
-     * @returns The integration-connections.
-     */
-    getIntegrationConnections(): Promise<GraphqlGetIntegrationConnectionsQuery["integrationConnections"]>;
     /**
      * Creates a new integration-connection.
      *

package/dist/src/Client.js

@@ -20,6 +20,16 @@ class Client {
         this.graphqlOperations = (0, graphqlOperationWrapper_1.wrapGraphqlOperations)((0, operationTypes_1.getSdk)(this.graphqlClient), verbose);
         this.qbd = new QbdIntegration_1.default(this.graphqlOperations);
     }
+    /**
+     * Fetches all integration-connections associated with your Conductor account.
+     *
+     * @returns The integration-connections.
+     */
+    async getIntegrationConnections() {
+        return this.graphqlOperations
+            .getIntegrationConnections()
+            .then((result) => result.integrationConnections);
+    }
     /**
      * Fetches the specified integration-connection.
      *
@@ -31,16 +41,6 @@ class Client {
             .getIntegrationConnection({ integrationConnectionId })
             .then((result) => result.integrationConnection);
     }
-    /**
-     * Fetches all integration-connections associated with your Conductor account.
-     *
-     * @returns The integration-connections.
-     */
-    async getIntegrationConnections() {
-        return this.graphqlOperations
-            .getIntegrationConnections()
-            .then((result) => result.integrationConnections);
-    }
     /**
      * Creates a new integration-connection.
      *

package/dist/src/graphql/graphqlOperationWrapper.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wrapError = exports.getDurationString = exports.graphqlOperationWrapper = exports.wrapGraphqlOperations = void 0;
-const package_json_1 = __importDefault(require("../../package.json"));
 const error_1 = require("../utils/error");
 const graphql_request_1 = require("graphql-request");
 const node_util_1 = __importDefault(require("node:util"));
@@ -77,13 +76,6 @@ function wrapError(error) {
         const nestedError = response.errors?.[0];
         const errorExtensions = nestedError?.extensions;
         if (errorExtensions) {
-            if (errorExtensions["code"] === "GRAPHQL_VALIDATION_FAILED") {
-                return new error_1.ConductorInvalidRequestError({
-                    code: "CLIENT_OUTDATED",
-                    message: `Your version of "${package_json_1.default.name}" is no longer compatible with the Conductor server. Please run "yarn upgrade ${package_json_1.default.name} --latest" to update.`,
-                    httpStatusCode: response.status,
-                });
-            }
             // Do *not* bother validating if this error is a Conductor error:
             // 1. We know this is a `ClientError`, so `message` and `httpStatusCode`
             //    exist.

package/dist/src/integrations/qbd/QbdIntegration.d.ts

@@ -1344,6 +1344,17 @@ export default class QbdIntegration extends BaseIntegration {
          */
         query: (integrationConnectionId: string, params: QbdTypes.ItemSubtotalQueryRq) => Promise<NonNullable<QbdTypes.ItemSubtotalQueryRs["ItemSubtotalRet"]>>;
     };
+    jobReport: {
+        /**
+         * Queries for a job report, which includes both summary and transaction
+         * detail reports. The reports can be customized only by date range, by
+         * column summarization, and by common filters. Some job reports require a
+         * `customer:job` reference in order to work.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/JobReportQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.JobReportQueryRq) => Promise<NonNullable<QbdTypes.JobReportQueryRs["ReportRet"]>>;
+    };
     jobType: {
         /**
          * Adds a job type. A job type can be used to separate jobs into any

package/dist/src/integrations/qbd/QbdIntegration.js

@@ -1349,6 +1349,17 @@ class QbdIntegration extends BaseIntegration_1.default {
          */
         query: async (integrationConnectionId, params) => this.sendRequestWrapper(integrationConnectionId, { ItemSubtotalQueryRq: params }, "ItemSubtotalQueryRs", "ItemSubtotalRet"),
     };
+    jobReport = {
+        /**
+         * Queries for a job report, which includes both summary and transaction
+         * detail reports. The reports can be customized only by date range, by
+         * column summarization, and by common filters. Some job reports require a
+         * `customer:job` reference in order to work.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/JobReportQuery
+         */
+        query: async (integrationConnectionId, params) => this.sendRequestWrapper(integrationConnectionId, { JobReportQueryRq: params }, "JobReportQueryRs", "ReportRet"),
+    };
     jobType = {
         /**
          * Adds a job type. A job type can be used to separate jobs into any
@@ -1775,9 +1786,9 @@ class QbdIntegration extends BaseIntegration_1.default {
             requestObject,
         });
     }
-    async sendRequestWrapper(integrationConnectionId, params, responseKey, responseBodyKey) {
+    async sendRequestWrapper(integrationConnectionId, params, responseWrapperKey, responseBodyKey) {
         const response = (await this.sendRequest(integrationConnectionId, params));
-        const responseBody = response[responseKey]?.[responseBodyKey];
+        const responseBody = response[responseWrapperKey]?.[responseBodyKey];
         if (responseBody === undefined) {
             throw new error_1.ConductorIntegrationError({
                 message: "No response received from QuickBooks Desktop.",

package/dist/src/integrations/qbd/qbdTypes.d.ts

@@ -232,6 +232,7 @@ export interface AccountRet {
     DataExtRet?: DataExtRet | DataExtRet[];
 }
 export type AccountType = "AccountsPayable" | "AccountsReceivable" | "Bank" | "CostOfGoodsSold" | "CreditCard" | "Equity" | "Expense" | "FixedAsset" | "Income" | "LongTermLiability" | "NonPosting" | "OtherAsset" | "OtherCurrentAsset" | "OtherCurrentLiability" | "OtherExpense" | "OtherIncome";
+export type AccountTypeFilter = "AccountsPayable" | "AccountsReceivable" | "AllowedFor1099" | "APAndSalesTax" | "APOrCreditCard" | "ARAndAP" | "Asset" | "BalanceSheet" | "Bank" | "BankAndARAndAPAndUF" | "BankAndUF" | "CostOfSales" | "CreditCard" | "CurrentAsset" | "CurrentAssetAndExpense" | "CurrentLiability" | "Equity" | "EquityAndIncomeAndExpense" | "ExpenseAndOtherExpense" | "FixedAsset" | "IncomeAndExpense" | "IncomeAndOtherIncome" | "Liability" | "LiabilityAndEquity" | "LongTermLiability" | "NonPosting" | "OrdinaryExpense" | "OrdinaryIncome" | "OrdinaryIncomeAndCOGS" | "OrdinaryIncomeAndExpense" | "OtherAsset" | "OtherCurrentAsset" | "OtherCurrentLiability" | "OtherExpense" | "OtherIncome" | "OtherIncomeOrExpense";
 export type AccrualPeriod = "BeginningOfYear" | "EveryHourOnPaycheck" | "EveryPaycheck";
 export type AcquiredAs = "New" | "Old";
 /** @default: ActiveOnly */
@@ -1403,6 +1404,31 @@ export interface COGSAccountRef {
     /** `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
     FullName?: string;
 }
+export interface ColData {
+    /** An identifying number that corresponds to the position of this column in the report. The columns are numbered from left to right, starting with 1. */
+    ColID: number;
+    /** The data in this cell of the report. */
+    Value: string;
+    /** The data type: IDTYPE, STRTYPE, and so on. */
+    DataType: DataType;
+}
+export interface ColDesc {
+    /** A list of `IColTitle` objects, each of which represents a title for this column. For example, if the first two rows of this column were titles, two `IColTitle` objects would be returned. */
+    ColTitle: ColTitle | ColTitle[];
+    /** The type of data that this column contains. `ColType` values are formatted types. (Returned `ctPercent` values, for example, will have digits after the decimal points, and ctAddr1 values will be strings.) */
+    ColType: ColType;
+    /** An identifying number that corresponds to the position of this column in the report. The columns are numbered from left to right, starting with 1. */
+    ColID: number;
+    /** The data type: IDTYPE, STRTYPE, and so on. */
+    DataType: DataType;
+}
+export interface ColTitle {
+    /** The number of this title row. For example, if the first three rows of a report were titles, `titleRow` of the third of these rows would be 3. */
+    TitleRow: number;
+    /** The data in this cell of the report. */
+    Value: string;
+}
+export type ColType = "Account" | "Addr1" | "Addr2" | "Addr3" | "Addr4" | "Addr5" | "Aging" | "Amount" | "AmountDifference" | "AverageCost" | "BilledDate" | "BillingStatus" | "Blank" | "CalculatedAmount" | "Class" | "ClearedStatus" | "CostPrice" | "CreateDate" | "Credit" | "CustomField" | "Date" | "Debit" | "DeliveryDate" | "DueDate" | "Duration" | "EarliestReceiptDate" | "EstimateActive" | "FOB" | "IncomeSubjectToTax" | "Invoiced" | "IsAdjustment" | "Item" | "ItemDesc" | "ItemVendor" | "Label" | "LastModifiedBy" | "LatestOrPriorState" | "Memo" | "ModifiedTime" | "Name" | "NameAccountNumber" | "NameAddress" | "NameCity" | "NameContact" | "NameEmail" | "NameFax" | "NamePhone" | "NameState" | "NameZip" | "OpenBalance" | "OriginalAmount" | "PaidAmount" | "PaidStatus" | "PaidThroughDate" | "PaymentMethod" | "PayrollItem" | "Percent" | "PercentChange" | "PercentOfTotalRetail" | "PercentOfTotalValue" | "PhysicalCount" | "PONumber" | "PrintStatus" | "ProgressAmount" | "ProgressPercent" | "Quantity" | "QuantityAvailable" | "QuantityOnHand" | "QuantityOnOrder" | "QuantityOnPendingBuild" | "QuantityOnSalesOrder" | "ReceivedQuantity" | "RefNumber" | "ReorderPoint" | "RetailValueOnHand" | "RunningBalance" | "SalesPerWeek" | "SalesRep" | "SalesTaxCode" | "ShipDate" | "ShipMethod" | "ShipToAddr1" | "ShipToAddr2" | "ShipToAddr3" | "ShipToAddr4" | "ShipToAddr5" | "SONumber" | "SourceName" | "SplitAccount" | "SSNOrTaxID" | "SuggestedReorder" | "TaxLine" | "TaxTableVersion" | "Terms" | "Total" | "TxnID" | "TxnNumber" | "TxnType" | "UnitPrice" | "UserEdit" | "ValueOnHand" | "WageBase" | "WageBaseTips";
 export interface CompanyAddressBlockForCustomer {
     /** The first line of an address. */
     Addr1?: string;
@@ -2469,6 +2495,13 @@ export interface DataExtRet {
     DataExtValue: string;
 }
 export type DataExtType = "AMTTYPE" | "DATETIMETYPE" | "INTTYPE" | "PERCENTTYPE" | "PRICETYPE" | "QUANTYPE" | "STR255TYPE" | "STR1024TYPE";
+export interface DataRow {
+    /** `RowData` describes one row in the report. */
+    RowData?: RowData;
+    /** A list of `IColData` objects, each of which describes the data in one cell of the report. */
+    ColData?: ColData | ColData[];
+}
+export type DataType = "AMTTYPE" | "BOOLTYPE" | "DATETIMETYPE" | "DATETYPE" | "ENUMTYPE" | "GUIDTYPE" | "IDTYPE" | "INTTYPE" | "PERCENTTYPE" | "PRICETYPE" | "QUANTYPE" | "STRTYPE" | "TIMEINTERVALTYPE";
 export type DateMacro = "All" | "LastCalendarQuarter" | "LastCalendarQuarterToDate" | "LastCalendarYear" | "LastCalendarYearToDate" | "LastFiscalQuarter" | "LastFiscalQuarterToDate" | "LastFiscalYear" | "LastFiscalYearToDate" | "LastMonth" | "LastMonthToDate" | "LastWeek" | "LastWeekToDate" | "NextCalendarQuarter" | "NextCalendarYear" | "NextFiscalQuarter" | "NextFiscalYear" | "NextFourWeeks" | "NextMonth" | "NextWeek" | "ThisCalendarQuarter" | "ThisCalendarQuarterToDate" | "ThisCalendarYear" | "ThisCalendarYearToDate" | "ThisFiscalQuarter" | "ThisFiscalQuarterToDate" | "ThisFiscalYear" | "ThisFiscalYearToDate" | "ThisMonth" | "ThisMonthToDate" | "ThisWeek" | "ThisWeekToDate" | "Today" | "Yesterday";
 export interface DepositAdd {
     /** The date of the transaction. In some cases, if you leave `TxnDate` out of an -Add message, QuickBooks will prefill `TxnDate` with the date of the last-saved transaction of the same type. */
@@ -3099,6 +3132,7 @@ export interface EntityRef {
     /** `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
     FullName?: string;
 }
+export type EntityTypeFilter = "Customer" | "Employee" | "OtherName" | "Vendor";
 export interface ErrorRecovery {
     /** Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
     ListID?: string;
@@ -6969,6 +7003,43 @@ export interface ItemSubtotalRet {
     /** A list of `IDataExtRet` objects, each of which represents a field that has been added to QuickBooks as a data extension. */
     DataExtRet?: DataExtRet | DataExtRet[];
 }
+export type ItemTypeFilter = "AllExceptFixedAsset" | "Assembly" | "Discount" | "FixedAsset" | "Inventory" | "InventoryAndAssembly" | "NonInventory" | "OtherCharge" | "Payment" | "Sales" | "SalesTax" | "Service";
+export interface JobReportQueryRq {
+    /** The type of job report. */
+    JobReportType: JobReportType;
+    /** Set `DisplayReport` to true to display this report within the QuickBooks UI. (Default is false.) If you want the request to display the report without returning any data to your application, set the `responseData` attribute to `includeNone`. */
+    DisplayReport?: boolean;
+    /** If you omit both `ToReportDate` and `FromReportDate`, the report will cover the current fiscal year to date. */
+    ReportPeriod?: ReportPeriod;
+    /** The time period covered by this report. */
+    ReportDateMacro?: ReportDateMacro;
+    /** Allows you to query for a specified account type or for specific list elements. */
+    ReportAccountFilter?: ReportAccountFilter;
+    /** Allows you to query for a specified name type (customer, employee, vendor, or other) or query for specific list elements. */
+    ReportEntityFilter?: ReportEntityFilter;
+    /** Allows you to query for a specified item type (for example, discount, inventory, or non-inventory) or query for specific list elements. */
+    ReportItemFilter?: ReportItemFilter;
+    /** Allows you to query for a specified class. Classes can be used to separate transactions into meaningful categories. (For example, transactions could be classified according to department, business location, or type of work.) In QuickBooks, class tracking is off by default. */
+    ReportClassFilter?: ReportClassFilter;
+    /** Allows you to report on specific transaction types (for example, charge, check, deposit, or estimate). */
+    ReportTxnTypeFilter?: ReportTxnTypeFilter;
+    /** Returns reports that were modified between these two dates (inclusive). The range of acceptable dates for both `FromReportModifiedDate` and `ToReportModifiedDate` is 1970-01-01 to 2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). */
+    ReportModifiedDateRangeFilter?: ReportModifiedDateRangeFilter;
+    /** The time period covered by this report. */
+    ReportModifiedDateRangeMacro?: ReportModifiedDateRangeMacro;
+    /** The level of detail to include in the report. */
+    ReportDetailLevelFilter?: ReportDetailLevelFilter;
+    /** Allows you to query for posting reports, non-posting reports, or reports that are either one. */
+    ReportPostingStatusFilter?: ReportPostingStatusFilter;
+    /** `SummarizeColumnsBy` determines which data the report calculates and how the columns will be labeled across the top of the report. For example, if you set the value to `scbTwoWeek`, the report’s column labels might be “Feb 10-23, 02,” “Feb 24-Mar9, 02,” and so on. */
+    SummarizeColumnsBy?: SummarizeColumnsBy;
+    /** The default value is false, which means that the report will not include any subcolumn information. To include all available types of subcolumns for this report, set `IncludeSubcolumns` to true. The SDK will not return subcolumn information for data that can be easily computed. (For example, the SDK does not return the “percent of row” column.) */
+    IncludeSubcolumns?: boolean;
+}
+export interface JobReportQueryRs {
+    ReportRet: ReportRet[];
+}
+export type JobReportType = "ItemEstimatesVsActuals" | "ItemProfitability" | "JobEstimatesVsActualsDetail" | "JobEstimatesVsActualsSummary" | "JobProfitabilityDetail" | "JobProfitabilitySummary,";
 /** @default: None */
 export type JobStatus = "Awarded" | "Closed" | "InProgress" | "None" | "NotAwarded" | "Pending";
 export interface JobTypeAdd {
@@ -7989,8 +8060,112 @@ export interface RefNumberRangeFilter {
     ToRefNumber?: string;
 }
 export type Relation = "Brother" | "Daughter" | "Father" | "Friend" | "Mother" | "Other" | "Partner" | "Sister" | "Son" | "Spouse";
+export interface ReportAccountFilter {
+    /** Allows you to report on a specific account type. */
+    AccountTypeFilter?: AccountTypeFilter;
+    /** One or more `ListID` values. Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
+    ListID?: string[] | string;
+    /** A list of one or more `FullName` values. `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
+    FullName?: string[] | string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. */
+    ListIDWithChildren?: string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. For names that do not have children, `FullNameWithChildren` is exactly the same as `FullName`. */
+    FullNameWithChildren?: string;
+}
+/** @default: None */
+export type ReportBasis = "Accrual" | "Cash" | "None";
+export interface ReportClassFilter {
+    /** One or more `ListID` values. Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
+    ListID?: string[] | string;
+    /** A list of one or more `FullName` values. `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
+    FullName?: string[] | string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. */
+    ListIDWithChildren?: string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. For names that do not have children, `FullNameWithChildren` is exactly the same as `FullName`. */
+    FullNameWithChildren?: string;
+}
+export interface ReportData {
+    /** A data row contains the actual data for each column. */
+    DataRow?: DataRow;
+    /** A text row contains only text and is used mainly for headings. */
+    TextRow?: TextRow;
+    /** A row that contains a calculated subtotal of the data in all the rows since the last `SubTotalRow` and, usually, a single underline. There can be multiple `SubTotalRow` aggregates in a report. */
+    SubtotalRow?: SubtotalRow;
+    /** A row that contains a calculated total of all the data that has come before and a double underline. There will only be one `TotalRow` per report. If `TotalRow` does not include any numerical values, the columns required to show the total values are not part of the report. These columns were not included when the report was customized. */
+    TotalRow?: TotalRow;
+}
+export type ReportDateMacro = "All" | "LastMonth" | "LastMonthToDate" | "LastQuarter" | "LastQuarterToDate" | "LastWeek" | "LastWeekToDate" | "LastYear" | "LastYearToDate" | "NextFourWeeks" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisMonthToDate" | "ThisQuarter" | "ThisQuarterToDate" | "ThisWeek" | "ThisWeekToDate" | "ThisYear" | "ThisYearToDate" | "Today" | "Yesterday";
+/** @default: All */
+export type ReportDetailLevelFilter = "All" | "AllExceptSummary" | "SummaryOnly";
+export interface ReportEntityFilter {
+    /** Allows you to report on a specific name type. */
+    EntityTypeFilter?: EntityTypeFilter;
+    /** One or more `ListID` values. Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
+    ListID?: string[] | string;
+    /** A list of one or more `FullName` values. `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
+    FullName?: string[] | string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. */
+    ListIDWithChildren?: string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. For names that do not have children, `FullNameWithChildren` is exactly the same as `FullName`. */
+    FullNameWithChildren?: string;
+}
 /** @default: Quarterly */
 export type ReportingPeriod = "Monthly" | "Quarterly";
+export interface ReportItemFilter {
+    /** Allows you to report on a specific item type. */
+    ItemTypeFilter?: ItemTypeFilter;
+    /** One or more `ListID` values. Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
+    ListID?: string[] | string;
+    /** A list of one or more `FullName` values. `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
+    FullName?: string[] | string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. */
+    ListIDWithChildren?: string;
+    /** Allows you to filter for data that relates to the specified object and its descendants. For names that do not have children, `FullNameWithChildren` is exactly the same as `FullName`. */
+    FullNameWithChildren?: string;
+}
+export interface ReportModifiedDateRangeFilter {
+    /** Selects information from this date and later. The range of acceptable dates is 1970-01-01 to 2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). */
+    FromReportModifiedDate?: string;
+    /** Selects information created on this date or earlier. The range of acceptable dates is 1970-01-01 to 2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). */
+    ToReportModifiedDate?: string;
+}
+export type ReportModifiedDateRangeMacro = "All" | "LastMonth" | "LastMonthToDate" | "LastQuarter" | "LastQuarterToDate" | "LastWeek" | "LastWeekToDate" | "LastYear" | "LastYearToDate" | "NextFourWeeks" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisMonthToDate" | "ThisQuarter" | "ThisQuarterToDate" | "ThisWeek" | "ThisWeekToDate" | "ThisYear" | "ThisYearToDate" | "Today" | "Yesterday";
+export interface ReportPeriod {
+    /** Selects information from this date and later. The range of acceptable `FromReportDate` and `ToReportDate` values depends on how the report dates are determined. If the report dates are based on the dates of transactions, the range is 01/01/1901 to 12/31/9999. If the report dates are based on modification dates, the range will be 1970-01-01 to 2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). If you omit `FromReportDate`, it will be set to 1970-01-01T00:00:00 (1969-12-31T16:00:00-08:00 PST). */
+    FromReportDate?: string;
+    /** Selects information created on this date or earlier. The range of acceptable `ToReportDate` and `FromReportDate` values depends on how the report dates are determined. If the report dates are based on the dates of transactions, the range is 01/01/1901 to 12/31/9999. If the report dates are based on modification dates, the range will be 1970-01-01 to 2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). If you omit `ToReportDate`, it will be set to 2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). */
+    ToReportDate?: string;
+}
+export type ReportPostingStatusFilter = "Either" | "NonPosting" | "Posting";
+export interface ReportRet {
+    /** The main title for this report. */
+    ReportTitle: string;
+    /** The subtitle for this report. */
+    ReportSubtitle: string;
+    /** If `ReportBasis` is `rbCash`, the report bases income and expenses on the dates when money changed hands.`rbAccrual`, the report bases income on the dates when customers were invoiced and bases expenses on the dates when bills were entered.`rbNone`, the report uses the default `ReportBasis`, which is either the QuickBooks Preference setting or the QuickBooks default for a given type of report. In a report response, the SDK returns `rbNone` for reports that do not support `ReportBasis`. (The 1099 report, for example, has its own basis for generation.) */
+    ReportBasis?: ReportBasis;
+    /** The number of rows in the report. */
+    NumRows: number;
+    /** The number of columns in the report. */
+    NumColumns: number;
+    /** The number of rows to allocate for column titles. Although this number is usually 1, with some reports it is 2 or 3. (For an example of column titles that span multiple rows, look at a `ProfitAndLossByJob` report in QuickBooks.) */
+    NumColTitleRows: number;
+    /** A list of `IColDesc` objects, each of which identifies one column in the report. Each column is identified by a `colID` (the position of the column in the report), a title, and a type. If the report contains any data, it is given row-by-row in an `IReportData` object. */
+    ColDesc: ColDesc | ColDesc[];
+    /** If the report contains any data, it is given row-by-row in a `ReportData` aggregate. */
+    ReportData?: ReportData;
+}
+export interface ReportTxnTypeFilter {
+    /** A list of the transaction types you want the report to cover. */
+    TxnTypeFilter: TxnTypeFilter | TxnTypeFilter[];
+}
+export interface RowData {
+    /** An enumerated value that shows the type of data that this row contains. Values: account class customer `customerMessage` `customerType` employee item `jobType` label `memorizedTxn` `memorizedReport` name `otherName` `paymentMethod` `payrollItem` `salesRep` `salesTaxCode` `shipMethod` state style terms `toDo` vendor `vendorType` */
+    RowType: RowType;
+    /** The data in this cell of the report. */
+    Value: string;
+}
+export type RowType = "account" | "class" | "customer" | "customerMessage" | "customerType" | "employee" | "item" | "jobType" | "label" | "memorizedReport" | "memorizedTxn" | "name" | "otherName" | "paymentMethod" | "payrollItem" | "salesRep" | "salesTaxCode" | "shipMethod" | "state" | "style" | "terms" | "toDo" | "vendor" | "vendorType";
 export interface SalesAndPurchase {
     /** Appears in the `Description` column of a sales form when the QuickBooks user sells this item. For a fixed asset, describes the sale of the asset (for accounting purposes). */
     SalesDesc?: string;
@@ -8765,6 +8940,13 @@ export interface SubscribedServices {
     /** The list of the Intuit services that the company is or has been subscribed to, for example, Intuit Payroll, QBMS. */
     Service?: Service | Service[];
 }
+export interface SubtotalRow {
+    /** `RowData` describes one row in the report. */
+    RowData?: RowData;
+    /** A list of `IColData` objects, each of which describes the data in one cell of the report. */
+    ColData?: ColData | ColData[];
+}
+export type SummarizeColumnsBy = "Account" | "BalanceSheet" | "Class" | "Customer" | "CustomerType" | "Day" | "Employee" | "FourWeek" | "HalfMonth" | "IncomeStatement" | "ItemDetail" | "ItemType" | "Month" | "Payee" | "PaymentMethod" | "PayrollItemDetail" | "PayrollYtdDetail" | "Quarter" | "SalesRep" | "SalesTaxCode" | "ShipMethod" | "Terms" | "TotalOnly" | "TwoWeek" | "Vendor" | "VendorType" | "Week" | "Year";
 export interface SupervisorRef {
     /** Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
     ListID?: string;
@@ -8808,6 +8990,12 @@ export interface TermsRef {
     /** `FullName` (along with `ListID`) is a way to identify a list object. The `FullName` is the name prefixed by the names of each ancestor, for example `Jones:Kitchen:Cabinets`. `FullName` values are not case-sensitive. */
     FullName?: string;
 }
+export interface TextRow {
+    /** The row number. Rows are numbered from top to bottom, starting with 1. */
+    RowNumber: number;
+    /** The data in this cell of the report. */
+    Value: string;
+}
 export interface TimeTrackingAdd {
     /** The date of the transaction. In some cases, if you leave `TxnDate` out of an -Add message, QuickBooks will prefill `TxnDate` with the date of the last-saved transaction of the same type. */
     TxnDate?: string;
@@ -8939,6 +9127,12 @@ export interface TotalBalanceFilter {
     /** The monetary amount to which `Operator` refers. */
     Amount: string;
 }
+export interface TotalRow {
+    /** `RowData` describes one row in the report. */
+    RowData?: RowData;
+    /** A list of `IColData` objects, each of which describes the data in one cell of the report. */
+    ColData?: ColData | ColData[];
+}
 /** @default: CardNotPresent */
 export type TransactionMode = "CardNotPresent" | "CardPresent";
 export interface TxnDateRangeFilter {
@@ -8958,6 +9152,7 @@ export interface TxnDateRangeFilter {
     DateMacro?: DateMacro;
 }
 export type TxnType = "ARRefundCreditCard" | "Bill" | "BillPaymentCheck" | "BillPaymentCreditCard" | "BuildAssembly" | "Charge" | "Check" | "CreditCardCharge" | "CreditCardCredit" | "CreditMemo" | "Deposit" | "Estimate" | "InventoryAdjustment" | "Invoice" | "ItemReceipt" | "JournalEntry" | "LiabilityAdjustment" | "Paycheck" | "PayrollLiabilityCheck" | "PurchaseOrder" | "ReceivePayment" | "SalesOrder" | "SalesReceipt" | "SalesTaxPaymentCheck" | "Transfer" | "VendorCredit" | "YTDAdjustment";
+export type TxnTypeFilter = "All" | "ARRefundCreditCard" | "Bill" | "BillPaymentCheck" | "BillPaymentCreditCard" | "BuildAssembly" | "Charge" | "Check" | "CreditCardCharge" | "CreditCardCredit" | "CreditMemo" | "Deposit" | "Estimate" | "InventoryAdjustment" | "Invoice" | "ItemReceipt" | "JournalEntry" | "LiabilityAdjustment" | "Paycheck" | "PayrollLiabilityCheck" | "PurchaseOrder" | "ReceivePayment" | "SalesOrder" | "SalesReceipt" | "SalesTaxPaymentCheck" | "Transfer" | "VendorCredit" | "YTDAdjustment";
 export interface UnitOfMeasureSetRef {
     /** Along with `FullName`, `ListID` is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a `ListID`. A `ListID` is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same `ListID`, and a customer could not have the same `ListID` as an employee (because Customer and Employee are both name lists). But a customer could have the same `ListID` as a non-inventory item. */
     ListID?: string;

package/dist/src/utils/error.js

@@ -64,7 +64,7 @@ class ConductorError extends Error {
     rawType;
     constructor(options) {
         // Do not pass `options.message` to the superclass `Error` constructor to
-        // avoid this bug: https://twitter.com/DannyNemer/status/1638997876176195584
+        // avoid this bug: https://twitter.com/DannyNemer/status/1639513810141687810
         super();
         // Set `name` to the constructor name so that the error appears in logs as
         // `[ConductorError: foo]` instead of `[Error: foo]`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-node",
-  "version": "9.4.1",
+  "version": "9.5.0",
   "description": "Easily integrate with the entire QuickBooks Desktop API with fully-typed async TypeScript",
   "author": "Danny Nemer <hi@DannyNemer.com>",
   "license": "MIT",