conductor-node 7.1.2 → 7.2.0

package/README.md

@@ -40,8 +40,13 @@ Create a new integration-connection.
 
 ```ts
 const newQbdConnection = await conductor.createIntegrationConnection({
+  // The identifier of the third-party platform to integrate.
   integrationKey: "quickbooks-desktop",
+  // Your end-user's email address for identification only. No emails
+  // will be sent. Must be distinct from your other connections for the
+  // same `integrationKey`.
   endUserEmail: "danny@constructionco.com",
+  // Your end-user's name that will be shown elsewhere in Conductor.
   endUserName: "Construction Corp",
 });
 ```
@@ -76,7 +81,7 @@ The response includes the following:
 Execute any QuickBooks Desktop (QBD) API against a specific integration-connection id. See the official [QuickBooks Desktop API Reference](https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop) for a full list of available APIs.
 
 ```ts
-const newAccount = await conductor.qbd.account.add(qbdConnections[0].id, {
+const newAccount = await conductor.qbd.account.add(qbdConnectionId, {
   Name: "Test Account",
   AccountType: "Bank",
   OpenBalance: "100",
@@ -97,7 +102,7 @@ Fetch a single integration-connection by id.
 
 ```ts
 const qbdConnection = await conductor.getIntegrationConnectionById(
-  qbdConnections[0].id
+  qbdConnectionId
 );
 ```
 
@@ -106,7 +111,5 @@ const qbdConnection = await conductor.getIntegrationConnectionById(
 Check if an integration-connection is active within the last `secondsSinceLastActive` seconds (defaults to 60 seconds).
 
 ```ts
-const isActive = await conductor.isIntegrationConnectionActive(
-  qbdConnections[0].id
-);
+const isActive = await conductor.isIntegrationConnectionActive(qbdConnectionId);
 ```

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "7.1.2",
+    "version": "7.2.0",
     "description": "Easily integrate with the entire QuickBooks Desktop API with fully-typed async TypeScript",
     "author": "Danny Nemer <hi@DannyNemer.com>",
     "license": "MIT",
@@ -17,7 +17,7 @@
         "postpack": "rm -rf dist",
         "clean": "rm -rf dist package conductor-node-*.tgz tsconfig.tsbuildinfo",
         "gen:graphql-types": "yarn graphql-codegen --config ./src/graphql/codegenConfig.ts",
-        "test-connections": "yarn ts-node ./bin/testConnections.ts"
+        "status": "yarn ts-node ./bin/logConnectionStatuses.ts"
     },
     "engines": {
         "node": ">=16"

package/dist/src/Client.d.ts

@@ -1,5 +1,5 @@
 import type { Environment } from "./environment";
-import type { GraphqlCreateIntegrationConnectionInput, GraphqlCreateIntegrationConnectionMutation, GraphqlGetIntegrationConnectionQuery, GraphqlGetIntegrationConnectionQueryVariables, GraphqlGetIntegrationConnectionsQuery, GraphqlIntegrationRequestInput, GraphqlIntegrationRequestQuery, GraphqlIsIntegrationConnectionActiveQuery, GraphqlIsIntegrationConnectionActiveQueryVariables } from "./graphql/__generated__/operationTypes";
+import type { GraphqlCreateIntegrationConnectionInput, GraphqlCreateIntegrationConnectionMutation, GraphqlGetConnectionStatusQuery, GraphqlGetConnectionStatusQueryVariables, GraphqlGetIntegrationConnectionQuery, GraphqlGetIntegrationConnectionQueryVariables, GraphqlGetIntegrationConnectionsQuery, GraphqlIntegrationRequestInput, GraphqlIntegrationRequestQuery, GraphqlIsIntegrationConnectionActiveQuery, GraphqlIsIntegrationConnectionActiveQueryVariables } from "./graphql/__generated__/operationTypes";
 import QbdIntegration from "./integrations/qbd/QbdIntegration";
 export interface ClientOptions {
     /** Log each request and response. */
@@ -23,16 +23,36 @@ export default class Client {
      * @param input.integrationKey The identifier of the third-party platform to
      * integrate.
      * @param input.endUserEmail Your end-user's email address for identification
-     * purposes only. No emails will be sent. Must be distinct from other
-     * connections for the same integration.
-     * @param input.endUserName Your end-user's name.
+     * only. No emails will be sent. Must be distinct from your other connections
+     * for the same integration.
+     * @param input.endUserName Your end-user's name that will be shown elsewhere
+     * in Conductor.
      * @returns The newly created integration connection.
      */
     createIntegrationConnection(input: GraphqlCreateIntegrationConnectionInput & {
         integrationKey: "quickbooks-desktop";
     }): Promise<GraphqlCreateIntegrationConnectionMutation["createIntegrationConnection"]>;
     isIntegrationConnectionActive(integrationConnectionId: GraphqlIsIntegrationConnectionActiveQueryVariables["integrationConnectionId"], secondsSinceLastActive?: GraphqlIsIntegrationConnectionActiveQueryVariables["secondsSinceLastActive"]): Promise<GraphqlIsIntegrationConnectionActiveQuery["integrationConnection"]["isActive"]>;
+    /**
+     * Check whether we can successfully connect to the end-user's QBD instance.
+     *
+     * Unlike `lastHeartbeatAt`, which only checks if QBWC is running (i.e., is
+     * the user's computer on), this check fails if the user's computer is on but
+     * QBD is not running, the wrong company file is open, or there is a modal
+     * dialog open in QBD.
+     *
+     * @param integrationConnectionId The ID of the integration connection.
+     * @returns result Object with the following properties:
+     * @returns result.isConnected Whether we can connect to QBD.
+     * @returns result.devErrorMessage If `isConnected` is `false`, a
+     * developer-friendly error message; e.g., "The end-user's computer is likely
+     * off". Else, `null`.
+     * @returns result.endUserErrorMessage  If `isConnected` is `false`, a
+     * user-friendly error message; e.g., "Please ensure your computer is on and
+     * QuickBooks Desktop is open". Else, `null`.
+     */
+    getConnectionStatus(integrationConnectionId: GraphqlGetConnectionStatusQueryVariables["integrationConnectionId"]): Promise<GraphqlGetConnectionStatusQuery["integrationConnection"]["connectionStatus"]>;
     integrationRequest(input: GraphqlIntegrationRequestInput): Promise<GraphqlIntegrationRequestQuery["integrationRequest"]>;
-    graphqlOperationWrapper<V, R>(operationName: string, variables: V, operation: (variables: V) => Promise<R>): Promise<R>;
+    private graphqlOperationWrapper;
     private checkForUpdates;
 }

package/dist/src/Client.js

@@ -54,9 +54,10 @@ class Client {
      * @param input.integrationKey The identifier of the third-party platform to
      * integrate.
      * @param input.endUserEmail Your end-user's email address for identification
-     * purposes only. No emails will be sent. Must be distinct from other
-     * connections for the same integration.
-     * @param input.endUserName Your end-user's name.
+     * only. No emails will be sent. Must be distinct from your other connections
+     * for the same integration.
+     * @param input.endUserName Your end-user's name that will be shown elsewhere
+     * in Conductor.
      * @returns The newly created integration connection.
      */
     async createIntegrationConnection(input) {
@@ -72,6 +73,29 @@ class Client {
         })
             .then((result) => result.integrationConnection.isActive);
     }
+    /**
+     * Check whether we can successfully connect to the end-user's QBD instance.
+     *
+     * Unlike `lastHeartbeatAt`, which only checks if QBWC is running (i.e., is
+     * the user's computer on), this check fails if the user's computer is on but
+     * QBD is not running, the wrong company file is open, or there is a modal
+     * dialog open in QBD.
+     *
+     * @param integrationConnectionId The ID of the integration connection.
+     * @returns result Object with the following properties:
+     * @returns result.isConnected Whether we can connect to QBD.
+     * @returns result.devErrorMessage If `isConnected` is `false`, a
+     * developer-friendly error message; e.g., "The end-user's computer is likely
+     * off". Else, `null`.
+     * @returns result.endUserErrorMessage  If `isConnected` is `false`, a
+     * user-friendly error message; e.g., "Please ensure your computer is on and
+     * QuickBooks Desktop is open". Else, `null`.
+     */
+    async getConnectionStatus(integrationConnectionId) {
+        return this.graphqlOperations
+            .getConnectionStatus({ integrationConnectionId })
+            .then((result) => result.integrationConnection.connectionStatus);
+    }
     // TODO: Hide this method from the dev-user while still allowing the
     // integration clients to access it.
     async integrationRequest(input) {

package/dist/src/environment.d.ts

@@ -1,4 +1,4 @@
-export declare type Environment = "development" | "production" | "staging" | "test";
+export type Environment = "development" | "production" | "staging" | "test";
 export declare const currentEnvironment: {
     name: Environment;
     isTest: boolean;

package/dist/src/graphql/__generated__/operationTypes.d.ts

@@ -1,20 +1,20 @@
 import { GraphQLClient } from "graphql-request";
 import * as Dom from "graphql-request/dist/types.dom";
-export declare type Maybe<T> = T | null;
-export declare type InputMaybe<T> = Maybe<T>;
-export declare type Exact<T extends {
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = Maybe<T>;
+export type Exact<T extends {
     [key: string]: unknown;
 }> = {
     [K in keyof T]: T[K];
 };
-export declare type MakeOptional<T, K extends keyof T> = Omit<T, K> & {
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & {
     [SubKey in K]?: Maybe<T[SubKey]>;
 };
-export declare type MakeMaybe<T, K extends keyof T> = Omit<T, K> & {
+export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & {
     [SubKey in K]: Maybe<T[SubKey]>;
 };
 /** All built-in and custom scalars, mapped to their actual values */
-export declare type Scalars = {
+export type Scalars = {
     ID: string;
     String: string;
     Boolean: boolean;
@@ -23,22 +23,28 @@ export declare type Scalars = {
     DateTime: Date;
     JSONObject: object;
 };
-export declare type GraphqlCreateIntegrationConnectionInput = {
+export type GraphqlConnectionStatusResult = {
+    devErrorMessage: Maybe<Scalars["String"]>;
+    endUserErrorMessage: Maybe<Scalars["String"]>;
+    isConnected: Scalars["Boolean"];
+};
+export type GraphqlCreateIntegrationConnectionInput = {
     endUserEmail: Scalars["String"];
     endUserName: Scalars["String"];
     integrationKey: Scalars["String"];
 };
-export declare type GraphqlCreateIntegrationConnectionResult = {
+export type GraphqlCreateIntegrationConnectionResult = {
     integrationConnection: GraphqlIntegrationConnection;
     qbwcPassword: Scalars["String"];
     qwcFileDownloadUrl: Scalars["String"];
 };
-export declare type GraphqlIntegration = {
+export type GraphqlIntegration = {
     id: Scalars["ID"];
     key: Scalars["String"];
     name: Scalars["String"];
 };
-export declare type GraphqlIntegrationConnection = {
+export type GraphqlIntegrationConnection = {
+    connectionStatus: GraphqlConnectionStatusResult;
     devUserId: Scalars["ID"];
     endUserEmail: Scalars["String"];
     endUserName: Scalars["String"];
@@ -49,41 +55,41 @@ export declare type GraphqlIntegrationConnection = {
     lastHeartbeatAt: Maybe<Scalars["DateTime"]>;
     qbwcPassword: Scalars["String"];
 };
-export declare type GraphqlIntegrationConnectionIsActiveArgs = {
+export type GraphqlIntegrationConnectionIsActiveArgs = {
     secondsSinceLastActive: Scalars["Int"];
 };
-export declare type GraphqlIntegrationRequestInput = {
+export type GraphqlIntegrationRequestInput = {
     integrationConnectionId: Scalars["ID"];
     requestObject: Scalars["JSONObject"];
 };
-export declare type GraphqlMutation = {
+export type GraphqlMutation = {
     createIntegrationConnection: GraphqlCreateIntegrationConnectionResult;
 };
-export declare type GraphqlMutationCreateIntegrationConnectionArgs = {
+export type GraphqlMutationCreateIntegrationConnectionArgs = {
     input: GraphqlCreateIntegrationConnectionInput;
 };
-export declare type GraphqlQuery = {
+export type GraphqlQuery = {
     integrationConnection: GraphqlIntegrationConnection;
     integrationConnections: Array<GraphqlIntegrationConnection>;
     integrationRequest: Scalars["JSONObject"];
 };
-export declare type GraphqlQueryIntegrationConnectionArgs = {
+export type GraphqlQueryIntegrationConnectionArgs = {
     id: Scalars["ID"];
 };
-export declare type GraphqlQueryIntegrationRequestArgs = {
+export type GraphqlQueryIntegrationRequestArgs = {
     input: GraphqlIntegrationRequestInput;
 };
-export declare type GraphqlIntegrationConnectionFragment = {
+export type GraphqlIntegrationConnectionFragment = {
     id: string;
     integrationKey: string;
     endUserEmail: string;
     endUserName: string;
     lastHeartbeatAt: Date | null;
 };
-export declare type GraphqlGetIntegrationConnectionQueryVariables = Exact<{
+export type GraphqlGetIntegrationConnectionQueryVariables = Exact<{
     integrationConnectionId: Scalars["ID"];
 }>;
-export declare type GraphqlGetIntegrationConnectionQuery = {
+export type GraphqlGetIntegrationConnectionQuery = {
     integrationConnection: {
         id: string;
         integrationKey: string;
@@ -92,10 +98,10 @@ export declare type GraphqlGetIntegrationConnectionQuery = {
         lastHeartbeatAt: Date | null;
     };
 };
-export declare type GraphqlGetIntegrationConnectionsQueryVariables = Exact<{
+export type GraphqlGetIntegrationConnectionsQueryVariables = Exact<{
     [key: string]: never;
 }>;
-export declare type GraphqlGetIntegrationConnectionsQuery = {
+export type GraphqlGetIntegrationConnectionsQuery = {
     integrationConnections: Array<{
         id: string;
         integrationKey: string;
@@ -104,10 +110,10 @@ export declare type GraphqlGetIntegrationConnectionsQuery = {
         lastHeartbeatAt: Date | null;
     }>;
 };
-export declare type GraphqlCreateIntegrationConnectionMutationVariables = Exact<{
+export type GraphqlCreateIntegrationConnectionMutationVariables = Exact<{
     input: GraphqlCreateIntegrationConnectionInput;
 }>;
-export declare type GraphqlCreateIntegrationConnectionMutation = {
+export type GraphqlCreateIntegrationConnectionMutation = {
     createIntegrationConnection: {
         qbwcPassword: string;
         qwcFileDownloadUrl: string;
@@ -120,19 +126,31 @@ export declare type GraphqlCreateIntegrationConnectionMutation = {
         };
     };
 };
-export declare type GraphqlIsIntegrationConnectionActiveQueryVariables = Exact<{
+export type GraphqlIsIntegrationConnectionActiveQueryVariables = Exact<{
     integrationConnectionId: Scalars["ID"];
     secondsSinceLastActive: Scalars["Int"];
 }>;
-export declare type GraphqlIsIntegrationConnectionActiveQuery = {
+export type GraphqlIsIntegrationConnectionActiveQuery = {
     integrationConnection: {
         isActive: boolean;
     };
 };
-export declare type GraphqlIntegrationRequestQueryVariables = Exact<{
+export type GraphqlGetConnectionStatusQueryVariables = Exact<{
+    integrationConnectionId: Scalars["ID"];
+}>;
+export type GraphqlGetConnectionStatusQuery = {
+    integrationConnection: {
+        connectionStatus: {
+            isConnected: boolean;
+            devErrorMessage: string | null;
+            endUserErrorMessage: string | null;
+        };
+    };
+};
+export type GraphqlIntegrationRequestQueryVariables = Exact<{
     input: GraphqlIntegrationRequestInput;
 }>;
-export declare type GraphqlIntegrationRequestQuery = {
+export type GraphqlIntegrationRequestQuery = {
     integrationRequest: object;
 };
 export declare const IntegrationConnectionFragmentDoc = "\n    fragment IntegrationConnection on IntegrationConnection {\n  id\n  integrationKey\n  endUserEmail\n  endUserName\n  lastHeartbeatAt\n}\n    ";
@@ -140,13 +158,15 @@ export declare const GetIntegrationConnectionDocument: string;
 export declare const GetIntegrationConnectionsDocument: string;
 export declare const CreateIntegrationConnectionDocument: string;
 export declare const IsIntegrationConnectionActiveDocument = "\n    query isIntegrationConnectionActive($integrationConnectionId: ID!, $secondsSinceLastActive: Int!) {\n  integrationConnection(id: $integrationConnectionId) {\n    isActive(secondsSinceLastActive: $secondsSinceLastActive)\n  }\n}\n    ";
+export declare const GetConnectionStatusDocument = "\n    query getConnectionStatus($integrationConnectionId: ID!) {\n  integrationConnection(id: $integrationConnectionId) {\n    connectionStatus {\n      isConnected\n      devErrorMessage\n      endUserErrorMessage\n    }\n  }\n}\n    ";
 export declare const IntegrationRequestDocument = "\n    query integrationRequest($input: IntegrationRequestInput!) {\n  integrationRequest(input: $input)\n}\n    ";
-export declare type SdkFunctionWrapper = <T>(action: (requestHeaders?: Record<string, string>) => Promise<T>, operationName: string, operationType?: string) => Promise<T>;
+export type SdkFunctionWrapper = <T>(action: (requestHeaders?: Record<string, string>) => Promise<T>, operationName: string, operationType?: string) => Promise<T>;
 export declare function getSdk(client: GraphQLClient, withWrapper?: SdkFunctionWrapper): {
     getIntegrationConnection(variables: GraphqlGetIntegrationConnectionQueryVariables, requestHeaders?: (Record<string, string> | Dom.Headers | string[][]) | undefined): Promise<GraphqlGetIntegrationConnectionQuery>;
     getIntegrationConnections(variables?: GraphqlGetIntegrationConnectionsQueryVariables, requestHeaders?: (Record<string, string> | Dom.Headers | string[][]) | undefined): Promise<GraphqlGetIntegrationConnectionsQuery>;
     createIntegrationConnection(variables: GraphqlCreateIntegrationConnectionMutationVariables, requestHeaders?: (Record<string, string> | Dom.Headers | string[][]) | undefined): Promise<GraphqlCreateIntegrationConnectionMutation>;
     isIntegrationConnectionActive(variables: GraphqlIsIntegrationConnectionActiveQueryVariables, requestHeaders?: (Record<string, string> | Dom.Headers | string[][]) | undefined): Promise<GraphqlIsIntegrationConnectionActiveQuery>;
+    getConnectionStatus(variables: GraphqlGetConnectionStatusQueryVariables, requestHeaders?: (Record<string, string> | Dom.Headers | string[][]) | undefined): Promise<GraphqlGetConnectionStatusQuery>;
     integrationRequest(variables: GraphqlIntegrationRequestQueryVariables, requestHeaders?: (Record<string, string> | Dom.Headers | string[][]) | undefined): Promise<GraphqlIntegrationRequestQuery>;
 };
-export declare type Sdk = ReturnType<typeof getSdk>;
+export type Sdk = ReturnType<typeof getSdk>;

package/dist/src/graphql/__generated__/operationTypes.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSdk = exports.IntegrationRequestDocument = exports.IsIntegrationConnectionActiveDocument = exports.CreateIntegrationConnectionDocument = exports.GetIntegrationConnectionsDocument = exports.GetIntegrationConnectionDocument = exports.IntegrationConnectionFragmentDoc = void 0;
+exports.getSdk = exports.IntegrationRequestDocument = exports.GetConnectionStatusDocument = exports.IsIntegrationConnectionActiveDocument = exports.CreateIntegrationConnectionDocument = exports.GetIntegrationConnectionsDocument = exports.GetIntegrationConnectionDocument = exports.IntegrationConnectionFragmentDoc = void 0;
 exports.IntegrationConnectionFragmentDoc = `
     fragment IntegrationConnection on IntegrationConnection {
   id
@@ -42,6 +42,17 @@ exports.IsIntegrationConnectionActiveDocument = `
   }
 }
     `;
+exports.GetConnectionStatusDocument = `
+    query getConnectionStatus($integrationConnectionId: ID!) {
+  integrationConnection(id: $integrationConnectionId) {
+    connectionStatus {
+      isConnected
+      devErrorMessage
+      endUserErrorMessage
+    }
+  }
+}
+    `;
 exports.IntegrationRequestDocument = `
     query integrationRequest($input: IntegrationRequestInput!) {
   integrationRequest(input: $input)
@@ -62,6 +73,9 @@ function getSdk(client, withWrapper = defaultWrapper) {
         isIntegrationConnectionActive(variables, requestHeaders) {
             return withWrapper((wrappedRequestHeaders) => client.request(exports.IsIntegrationConnectionActiveDocument, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "isIntegrationConnectionActive", "query");
         },
+        getConnectionStatus(variables, requestHeaders) {
+            return withWrapper((wrappedRequestHeaders) => client.request(exports.GetConnectionStatusDocument, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "getConnectionStatus", "query");
+        },
         integrationRequest(variables, requestHeaders) {
             return withWrapper((wrappedRequestHeaders) => client.request(exports.IntegrationRequestDocument, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "integrationRequest", "query");
         },

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

@@ -352,6 +352,20 @@ export default class QbdIntegration extends BaseIntegration {
          */
         query: (integrationConnectionId: string, params: QbdTypes.ClassQueryRq) => Promise<NonNullable<QbdTypes.ClassQueryRs["ClassRet"]>>;
     };
+    company: {
+        /**
+         * Returns detailed information about a QuickBooks company file, such as the
+         * company’s address and legal name, certain preferences that are set, and
+         * any services that the company is subscribed to, such as payroll,
+         * QuickBooks Merchant Services, and so forth.
+         *
+         * Company information cannot be added or modified through the SDK, only
+         * through the QuickBooks user interface
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/CompanyQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.CompanyQueryRq) => Promise<NonNullable<QbdTypes.CompanyQueryRs["CompanyRet"]>>;
+    };
     customer: {
         /**
          * The customer list includes information about the QuickBooks user’s

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

@@ -356,6 +356,20 @@ class QbdIntegration extends BaseIntegration_1.default {
          */
         query: async (integrationConnectionId, params) => this.sendRequestBase(integrationConnectionId, { ClassQueryRq: params }, "ClassQueryRs", "ClassRet"),
     };
+    company = {
+        /**
+         * Returns detailed information about a QuickBooks company file, such as the
+         * company’s address and legal name, certain preferences that are set, and
+         * any services that the company is subscribed to, such as payroll,
+         * QuickBooks Merchant Services, and so forth.
+         *
+         * Company information cannot be added or modified through the SDK, only
+         * through the QuickBooks user interface
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/CompanyQuery
+         */
+        query: async (integrationConnectionId, params) => this.sendRequestBase(integrationConnectionId, { CompanyQueryRq: params }, "CompanyQueryRs", "CompanyRet"),
+    };
     customer = {
         /**
          * The customer list includes information about the QuickBooks user’s

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

@@ -47,6 +47,12 @@ export interface AccountAddRs {
     AccountRet?: AccountRet;
     ErrorRecovery?: ErrorRecovery;
 }
+export interface AccountantCopy {
+    /** Indicates whether an accountant copy has been made for this company file, with a value of true meaning a copy has been made and a value of false meaning there is no accountant copy. */
+    AccountantCopyExists: boolean;
+    /** The dividing date indicates the fiscal period within which the accountant is working. This date is key because as long as the accountant copy exists, no transactions can be modified or created within that period. You can add new accounts, but you cannot add new subaccounts to existing accounts, and you cannot edit, merge, or make an existing account inactive. Finally, you cannot delete or merge list items. */
+    DividingDate?: string;
+}
 export interface AccountFilter {
     /** 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`.
   
@@ -225,10 +231,10 @@ export interface AccountRet {
     /** 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 declare type AccountType = "AccountsPayable" | "AccountsReceivable" | "Bank" | "CostOfGoodsSold" | "CreditCard" | "Equity" | "Expense" | "FixedAsset" | "Income" | "LongTermLiability" | "NonPosting" | "OtherAsset" | "OtherCurrentAsset" | "OtherCurrentLiability" | "OtherExpense" | "OtherIncome";
-export declare type AccrualPeriod = "BeginningOfYear" | "EveryHourOnPaycheck" | "EveryPaycheck";
+export type AccountType = "AccountsPayable" | "AccountsReceivable" | "Bank" | "CostOfGoodsSold" | "CreditCard" | "Equity" | "Expense" | "FixedAsset" | "Income" | "LongTermLiability" | "NonPosting" | "OtherAsset" | "OtherCurrentAsset" | "OtherCurrentLiability" | "OtherExpense" | "OtherIncome";
+export type AccrualPeriod = "BeginningOfYear" | "EveryHourOnPaycheck" | "EveryPaycheck";
 /** @default: ActiveOnly */
-export declare type ActiveStatus = "ActiveOnly" | "All" | "InactiveOnly";
+export type ActiveStatus = "ActiveOnly" | "All" | "InactiveOnly";
 export interface AdditionalContactRef {
     /** The name of the contact. */
     ContactName: string;
@@ -369,7 +375,7 @@ export interface BarCode {
     /** Allows for barcode to be overridden for an item. */
     AllowOverride?: boolean;
 }
-export declare type BillableStatus = "Billable" | "HasBeenBilled" | "NotBillable";
+export type BillableStatus = "Billable" | "HasBeenBilled" | "NotBillable";
 export interface BillAdd {
     /** A vendor is any person or company from whom a small business owner buys goods and services. (Banks and tax agencies usually are included on the vendor list.) A company’s vendor list contains information such as account balance and contact information about each vendor. A `VendorRef` aggregate refers to one of the vendors on the list. In a request, if a `VendorRef` aggregate includes both `FullName` and `ListID`, `FullName` will be ignored. */
     VendorRef: VendorRef;
@@ -832,7 +838,7 @@ export interface CashBackInfoRet {
     /** A monetary amount. */
     Amount?: string;
 }
-export declare type CashFlowClassification = "Financing" | "Investing" | "None" | "NotApplicable" | "Operating";
+export type CashFlowClassification = "Financing" | "Investing" | "None" | "NotApplicable" | "Operating";
 export interface CheckAdd {
     /** The Account list is the company file’s list of accounts. An `AccountRef` aggregate refers to one of these accounts. (If an `AccountRef` aggregate includes both `FullName` and `ListID`, `FullName` will be ignored.)Special cases to note:In a Check message, `AccountRef` refers to the account from which the funds are being drawn for this check, for example, Checking or Savings.In an `ExpenseLineAdd` message, you must include `AccountRef` if the “Require accounts” check box is selected in the QuickBooks Accounting preferences. (It is selected by default.) In a `CreditCardCredit` message, `AccountRef` refers to the bank account or credit card account to which the credit is applied.In a `CreditCardCharge` message, `AccountRef` refers to the bank or credit card company to whom money is owed. How do you increase and decrease amounts in bank accounts?The following requests increase the balance in a bank account:Deposit Add `ReceivePaymentAdd` Journal Entry Add Sales `ReceiptAdd` The following requests decrease the balance in a bank account:`CheckAdd` Bill `PaymentCheckAdd` `JournalEntryAdd` */
     AccountRef: AccountRef;
@@ -1105,6 +1111,93 @@ export interface ClassRet {
     /** The number of ancestors. For example, The customer job with `Name` = carpets and `FullName` = Jones:Building2:carpets would have a sublevel of 2. */
     Sublevel: number;
 }
+export interface CompanyAddressBlockForCustomer {
+    /** The first line of an address. */
+    Addr1?: string;
+    /** The second line of an address (if a second line is needed). */
+    Addr2?: string;
+    /** The third line of an address (if a third line is needed). */
+    Addr3?: string;
+    /** The fourth line of an address (if a fourth line is needed). */
+    Addr4?: string;
+    /** The fifth line of an address (if a fifth line is needed). */
+    Addr5?: string;
+}
+export interface CompanyAddressForCustomer {
+    /** The first line of an address. */
+    Addr1?: string;
+    /** The second line of an address (if a second line is needed). */
+    Addr2?: string;
+    /** The third line of an address (if a third line is needed). */
+    Addr3?: string;
+    /** The fourth line of an address (if a fourth line is needed). */
+    Addr4?: string;
+    /** The fifth line of an address (if a fifth line is needed). */
+    Addr5?: string;
+    /** The city name in an address. */
+    City?: string;
+    /** The state name in an address. */
+    State?: string;
+    /** The postal code in an address. */
+    PostalCode?: string;
+    /** The country name in an address, or, in returned Host information (`HostRet` or `HostInfo`), the country for which this edition of QuickBooks was designed. (Possible values are US, CA, UK, and AU.) */
+    Country?: string;
+    /** In a `BillAddress` or `ShipAddress` aggregate, the `Note` field value is written at the bottom of the address in the form in which it appears, such as the invoice form. */
+    Note?: string;
+}
+export interface CompanyQueryRq {
+    /** You use this if you want to limit the data that will be returned in the response. In this list, you specify the name of each top-level element or aggregate that you want to be returned in the response to the request. You cannot specify fields within an aggregate, for example, you cannot specify a `City` within an `Address`: you must specify `Address` and will get the entire address. The names specified in the list are not parsed, so you must be especially careful to supply valid names, properly cased. No error is returned in the status code if you specify an invalid name. Notice that if you want to return custom data or private data extensions, you must specify the `DataExtRet` element and you must supply the `OwnerID` set to either a value of 0 (custom data) or the GUID for the private data. */
+    IncludeRetElement?: string[] | string;
+    /** Zero or more `OwnerID` values. `OwnerID` refers to the owner of a data extension:If `OwnerID` is 0, this is a public data extension, also known as a custom field. Custom fields appear in the QuickBooks UI.If `OwnerID` is a GUID, for example `{6B063959-81B0-4622-85D6-F548C8CCB517}`, this field is a private data extension defined by an integrated application. Private data extensions do not appear in the QuickBooks UI. Note that `OwnerID` values are not case-sensitive, meaning that if you enter an `OwnerID` value with lower-case letters, the value will be saved and returned with upper-case letters. When you share a private data extension with another application, the other application must know both the `OwnerID` and the `DataExtName`, as these together form a data extension’s unique name. */
+    OwnerID?: string[] | string;
+}
+export interface CompanyQueryRs {
+    CompanyRet: CompanyRet[];
+}
+export interface CompanyRet {
+    /** Indicates whether this company file is a QuickBooks “sample file.” */
+    IsSampleCompany: boolean;
+    /** The name of the QuickBooks user’s business, as specified in QuickBooks. `CompanyName` and `Address` are used on invoices, checks, and other forms. (`LegalCompanyName` and `LegalAddress`, on the other hand, are used on a company’s tax forms and pay stubs.) */
+    CompanyName?: string;
+    /** `LegalCompanyName` and `LegalAddress` are used on a company’s tax forms and pay stubs. (`CompanyName` and `Address`, on the other hand, are used on invoices, checks, and other forms.) */
+    LegalCompanyName?: string;
+    /** If an address request fails, some combination of address fields might be too long. In a Check, `BillPaymentCheck`, or `SalesTaxPaymentCheck` message, `Address` is the address that will print on the check. */
+    Address?: Address;
+    /** The address expressed as an address block of `Addr1` through `Addr5`, depending on the number of lines in the original request that created the address. */
+    AddressBlock?: AddressBlock;
+    /** `LegalAddress` and `LegalCompanyName` are used on a company’s tax forms and pay stubs. (Address and `CompanyName`, on the other hand, are used on invoices, checks, and other forms.) If an address request fails, some combination of address fields might be too long. */
+    LegalAddress?: LegalAddress;
+    /** The address where a QuickBooks company receives mail from its customers. If an address request fails, some combination of address fields might be too long. */
+    CompanyAddressForCustomer?: CompanyAddressForCustomer;
+    /** The company address for customers expressed as an address block of `Addr1` through `Addr5`. */
+    CompanyAddressBlockForCustomer?: CompanyAddressBlockForCustomer;
+    /** The telephone number. */
+    Phone?: string;
+    /** Fax number. */
+    Fax?: string;
+    /** E-mail address. */
+    Email?: string;
+    /** The company’s public Web address. */
+    CompanyWebSite?: string;
+    /** The first month in the 12-month period over which a company tracks its finances. The QuickBooks user sets this value. In QuickBooks, `FirstMonthFiscalYear` determines the default date range for some reports and graphs. */
+    FirstMonthFiscalYear?: FirstMonthFiscalYear;
+    /** In QuickBooks, `FirstMonthIncomeTaxYear` determines the default date range for income tax summary and detail reports. The QuickBooks user sets this value. */
+    FirstMonthIncomeTaxYear?: FirstMonthIncomeTaxYear;
+    /** The QuickBooks user selects a company type from a list when creating a company file. */
+    CompanyType?: string;
+    /** Employer Identification Number. */
+    EIN?: string;
+    /** Social security number. */
+    SSN?: string;
+    /** The tax form that the QuickBooks user expects to file for this company’s taxes. If a `TaxForm` value is assigned (that is, if it is not `OtherOrNone`), the QuickBooks user can associate each account with a tax form line. (An account’s tax form line information will show up in the response from an account query.) */
+    TaxForm?: TaxForm;
+    /** Information returned from a company query about the Intuit services that the company is currently subscribed to, for example, Intuit Payroll, QBMS, and so forth */
+    SubscribedServices?: SubscribedServices;
+    /** Aggregate containing information about accountant copy. An Accountant’s Copy is a version of your company file your accountant can use to make changes while the original company file continues to be used for most normal operations. The key part of the accountant copy “protocol” is the dividing date which defines the fiscal period within which the accountant will be working. Dividing date is key because there are enforced restrictions against certain types of operations on data that fall within the fiscal period the accountant is working on.continue to work. The restrictions are listed below: Transactions: You can work only on transactions dated after the dividing date. Accounts: You can add a new account, but you cannot add a new subaccount to an existing account. Existing accounts: You cannot edit, merge, or make an existing account inactive. New accounts: You can edit an account or make any account inactive that you created while your accountant has the Accountant’s Copy. Lists (other than Chart of Accounts): You can edit, sort, and make list items inactive. You cannot delete or merge list items. Reconciling:You can reconcile your accounts while your accountant has an Accountant’s Copy. All reconciliations that include transactions in the current period (after the dividing date) are saved and will not be undone.To prevent conflicts with your accountant’s changes, reconciliations that include transactions dated on or before the dividing date will be undone when you import your accountant’s changes. If your accountant has reconciled or undone a reconciliation for any period, any reconciliations you did will be undone when you import your accountant’s changes. */
+    AccountantCopy?: AccountantCopy;
+    /** 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 interface Contacts {
     /** A formal reference, such as Mr. or Dr., that precedes a name. */
     Salutation?: string;
@@ -1586,8 +1679,8 @@ export interface DataExtRet {
     /** The data in this field. The maximum length of `DataExtValue` will depend on the `DataExtType` of this data extension. For example, if `DataExtType` is `STR255TYPE`, the maximum length of `DataExtValue` is 255 characters. If `DataExtType` is `STR1024TYPE`, the maximum size of `DataExtValue` is `1KB`. */
     DataExtValue: string;
 }
-export declare type DataExtType = "AMTTYPE" | "DATETIMETYPE" | "INTTYPE" | "PERCENTTYPE" | "PRICETYPE" | "QUANTYPE" | "STR255TYPE" | "STR1024TYPE";
-export declare 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 type DataExtType = "AMTTYPE" | "DATETIMETYPE" | "INTTYPE" | "PERCENTTYPE" | "PRICETYPE" | "QUANTYPE" | "STR255TYPE" | "STR1024TYPE";
+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. */
     TxnDate?: string;
@@ -1787,7 +1880,7 @@ export interface DepositToAccountRef {
     /** `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 declare type Disabled = "No" | "Yes";
+export type Disabled = "No" | "Yes";
 export interface DiscountAccountRef {
     /** 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;
@@ -2198,7 +2291,7 @@ export interface EmployeeRet {
     DataExtRet?: DataExtRet | DataExtRet[];
 }
 /** @default: Regular */
-export declare type EmployeeType = "Officer" | "Owner" | "Regular" | "Statutory";
+export type EmployeeType = "Officer" | "Owner" | "Regular" | "Statutory";
 export interface EntityFilter {
     /** 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`.
   
@@ -2239,8 +2332,8 @@ export interface ErrorRecovery {
     /** Allows for the attachment of a user defined GUID value. */
     ExternalGUID?: string;
 }
-export declare type Ethnicity = "AmericianIndian" | "Asian" | "Black" | "Hawaiian" | "Hispanic" | "TwoOrMoreRaces" | "White";
-export declare type Exempt = "Exempt" | "NonExempt";
+export type Ethnicity = "AmericianIndian" | "Asian" | "Black" | "Hawaiian" | "Hispanic" | "TwoOrMoreRaces" | "White";
+export type Exempt = "Exempt" | "NonExempt";
 export interface ExpenseAccountRef {
     /** 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;
@@ -2399,7 +2492,9 @@ export interface ExpenseLineRet {
     /** 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 declare type Gender = "Female" | "Male";
+export type FirstMonthFiscalYear = "April" | "August" | "December" | "February" | "January" | "July" | "June" | "March" | "May" | "November" | "October" | "September";
+export type FirstMonthIncomeTaxYear = "April" | "August" | "December" | "February" | "January" | "July" | "June" | "March" | "May" | "November" | "October" | "September";
+export type Gender = "Female" | "Male";
 export interface IncomeAccountRef {
     /** 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;
@@ -2788,7 +2883,7 @@ export interface ItemServiceRet {
     DataExtRet?: DataExtRet | DataExtRet[];
 }
 /** @default: None */
-export declare type JobStatus = "Awarded" | "Closed" | "InProgress" | "None" | "NotAwarded" | "Pending";
+export type JobStatus = "Awarded" | "Closed" | "InProgress" | "None" | "NotAwarded" | "Pending";
 export interface JobTypeRef {
     /** 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;
@@ -2978,8 +3073,30 @@ export interface JournalLineMod {
     /** The billing status of this item line or expense line. */
     BillableStatus?: BillableStatus;
 }
-export declare type JournalLineType = "Credit" | "Debit";
-export declare type KeyEmployee = "No" | "Yes";
+export type JournalLineType = "Credit" | "Debit";
+export type KeyEmployee = "No" | "Yes";
+export interface LegalAddress {
+    /** The first line of an address. */
+    Addr1?: string;
+    /** The second line of an address (if a second line is needed). */
+    Addr2?: string;
+    /** The third line of an address (if a third line is needed). */
+    Addr3?: string;
+    /** The fourth line of an address (if a fourth line is needed). */
+    Addr4?: string;
+    /** The fifth line of an address (if a fifth line is needed). */
+    Addr5?: string;
+    /** The city name in an address. */
+    City?: string;
+    /** The state name in an address. */
+    State?: string;
+    /** The postal code in an address. */
+    PostalCode?: string;
+    /** The country name in an address, or, in returned Host information (`HostRet` or `HostInfo`), the country for which this edition of QuickBooks was designed. (Possible values are US, CA, UK, and AU.) */
+    Country?: string;
+    /** In a `BillAddress` or `ShipAddress` aggregate, the `Note` field value is written at the bottom of the address in the form in which it appears, such as the invoice form. */
+    Note?: string;
+}
 export interface LinkedTxn {
     /** QuickBooks generates a unique `TxnID` for each transaction that is added to QuickBooks. A `TxnID` returned from a request can be used to refer to the transaction in subsequent requests.
   
@@ -3010,9 +3127,9 @@ export interface LinkToTxn {
     If you need to add a new transaction line in a transaction Mod request, you can do so by setting the `TxnLineID` to -1. */
     TxnLineID: string;
 }
-export declare type LinkType = "AMTTYPE" | "QUANTYPE";
-export declare type MatchCriterion = "Contains" | "EndsWith" | "StartsWith";
-export declare type MilitaryStatus = "Active" | "Reserve";
+export type LinkType = "AMTTYPE" | "QUANTYPE";
+export type MatchCriterion = "Contains" | "EndsWith" | "StartsWith";
+export type MilitaryStatus = "Active" | "Reserve";
 export interface ModifiedDateRangeFilter {
     /** Selects objects modified on or after this date. See the note below regarding QBFC usage.
   
@@ -3043,8 +3160,8 @@ export interface NameRangeFilter {
     /** The final name or item in the search range. If `ToName` is omitted, the range will end with last name on the list. */
     ToName?: string;
 }
-export declare type OnFile = "No" | "Yes";
-export declare type Operator = "Equal" | "GreaterThan" | "GreaterThanEqual" | "LessThan" | "LessThanEqual";
+export type OnFile = "No" | "Yes";
+export type Operator = "Equal" | "GreaterThan" | "GreaterThanEqual" | "LessThan" | "LessThanEqual";
 export interface OverrideClassRef {
     /** 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;
@@ -3064,14 +3181,14 @@ export interface OverrideUOMSetRef {
     FullName?: string;
 }
 /** @default: All */
-export declare type PaidStatus = "All" | "NotPaidOnly" | "PaidOnly";
+export type PaidStatus = "All" | "NotPaidOnly" | "PaidOnly";
 export interface ParentRef {
     /** 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;
     /** `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 declare type PartOrFullTime = "FullTime" | "PartTime";
+export type PartOrFullTime = "FullTime" | "PartTime";
 export interface PayeeEntityRef {
     /** 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;
@@ -3084,7 +3201,7 @@ export interface PaymentMethodRef {
     /** `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 declare type PayPeriod = "Biweekly" | "Daily" | "Monthly" | "Quarterly" | "Semimonthly" | "Weekly" | "Yearly";
+export type PayPeriod = "Biweekly" | "Daily" | "Monthly" | "Quarterly" | "Semimonthly" | "Weekly" | "Yearly";
 export interface PayrollItemWageRef {
     /** 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;
@@ -3092,7 +3209,7 @@ export interface PayrollItemWageRef {
     FullName?: string;
 }
 /** @default: None */
-export declare type PreferredDeliveryMethod = "Email" | "Fax" | "None";
+export type PreferredDeliveryMethod = "Email" | "Fax" | "None";
 export interface PreferredPaymentMethodRef {
     /** 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;
@@ -3147,9 +3264,9 @@ export interface RefNumberRangeFilter {
     /** The final `RefNumber` in the search range. If `ToRefNumber` is omitted, the range will end with last number on the list. */
     ToRefNumber?: string;
 }
-export declare type Relation = "Brother" | "Daughter" | "Father" | "Friend" | "Mother" | "Other" | "Partner" | "Sister" | "Son" | "Spouse";
+export type Relation = "Brother" | "Daughter" | "Father" | "Friend" | "Mother" | "Other" | "Partner" | "Sister" | "Son" | "Spouse";
 /** @default: Quarterly */
-export declare type ReportingPeriod = "Monthly" | "Quarterly";
+export type ReportingPeriod = "Monthly" | "Quarterly";
 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;
@@ -3225,7 +3342,7 @@ export interface SalesTaxCodeRef {
     FullName?: string;
 }
 /** @default: Canada */
-export declare type SalesTaxCountry = "Australia" | "Canada" | "UK" | "US";
+export type SalesTaxCountry = "Australia" | "Canada" | "UK" | "US";
 export interface SalesTaxReturnRef {
     /** 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;
@@ -3240,6 +3357,15 @@ export interface SecondaryContact {
     /** Relationship of emergency contact information to the employee. */
     Relation?: Relation;
 }
+export interface Service {
+    /** The case-insensitive name of a list object, not including the names of its ancestors. `Name` must be unique, unless it is the `Name` of a “hierarchical” list object. List objects in different hierarchies can have duplicate names because their `FullNames` will still be unique. For example, two objects could both have the `Name` kitchen, but they could have unique `FullNames`, such as Job12:kitchen and Baker:kitchen. For built-in currencies, `Name` is the internationally accepted currency name and is not editable. */
+    Name: string;
+    /** Indicates the provider of the subscribed service, for example, Intuit. */
+    Domain: string;
+    /** The status of the Intuit services that the company is or has been subscribed to, for example, Intuit Payroll, QBMS. */
+    ServiceStatus: ServiceStatus;
+}
+export type ServiceStatus = "Active" | "Expired" | "Never" | "Pending" | "Suspended" | "Terminated" | "Trial";
 export interface SetCredit {
     /** The ID of the credit memo that you are applying to this invoice or bill. */
     CreditTxnID: string;
@@ -3324,13 +3450,18 @@ export interface SickHours {
     /** When used in the `SickHours` or `VacationHours` aggregates, refers to the date on which sick leave or vacation hours in the current year began to accrue. */
     AccrualStartDate?: string;
 }
-export declare type SpecialAccountType = "AccountsPayable" | "AccountsReceivable" | "CondenseItemAdjustmentExpenses" | "CostOfGoodsSold" | "DirectDepositLiabilities" | "Estimates" | "ExchangeGainLoss" | "InventoryAssets" | "ItemReceiptAccount" | "OpeningBalanceEquity" | "PayrollExpenses" | "PayrollLiabilities" | "PettyCash" | "PurchaseOrders" | "ReconciliationDifferences" | "RetainedEarnings" | "SalesOrders" | "SalesTaxPayable" | "UncategorizedExpenses" | "UncategorizedIncome" | "UndepositedFunds";
+export type SpecialAccountType = "AccountsPayable" | "AccountsReceivable" | "CondenseItemAdjustmentExpenses" | "CostOfGoodsSold" | "DirectDepositLiabilities" | "Estimates" | "ExchangeGainLoss" | "InventoryAssets" | "ItemReceiptAccount" | "OpeningBalanceEquity" | "PayrollExpenses" | "PayrollLiabilities" | "PettyCash" | "PurchaseOrders" | "ReconciliationDifferences" | "RetainedEarnings" | "SalesOrders" | "SalesTaxPayable" | "UncategorizedExpenses" | "UncategorizedIncome" | "UndepositedFunds";
+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 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;
     /** `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 TaxForm = "Form990" | "Form990PF" | "Form990T" | "Form1040" | "Form1065" | "Form1120" | "Form1120S" | "OtherOrNone";
 export interface TaxLineInfoRet {
     /** An internal representation of the tax line associated with this account. */
     TaxLineID: number;
@@ -3502,16 +3633,16 @@ export interface TxnDateRangeFilter {
     The list given when you click `IQBENDateMacroType` shows the complete list of valid version 3.0 values. */
     DateMacro?: DateMacro;
 }
-export declare 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 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 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;
     /** `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 declare type USCitizen = "No" | "Yes";
-export declare type UseTimeDataToCreatePaychecks = "DoNotUseTimeData" | "NotSet" | "UseTimeData";
-export declare type USVeteran = "No" | "Yes";
+export type USCitizen = "No" | "Yes";
+export type UseTimeDataToCreatePaychecks = "DoNotUseTimeData" | "NotSet" | "UseTimeData";
+export type USVeteran = "No" | "Yes";
 export interface VacationHours {
     /** The total number of hours currently available for the employee to use. If this value is empty, it will default to 0. */
     HoursAvailable?: string;

package/dist/src/utils/testing.d.ts

@@ -1,2 +1,2 @@
-export declare const MITER_API_KEY = "sk_test_miter";
-export declare const TEST_QBD_CONNECTION_ID = "a826e788-deaa-4e2a-bb6a-2165f841b159";
+export declare const CONDUCTOR_TEST_API_KEY = "063d95bc-a6f7-4b4b-841d-8007648a3112";
+export declare const CONDUCTOR_TEST_QBD_CONNECTION_ID = "49ee2e46-ec5a-40a0-8c37-43913994b2a9";

package/dist/src/utils/testing.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEST_QBD_CONNECTION_ID = exports.MITER_API_KEY = void 0;
-exports.MITER_API_KEY = "sk_test_miter";
-exports.TEST_QBD_CONNECTION_ID = "a826e788-deaa-4e2a-bb6a-2165f841b159";
+exports.CONDUCTOR_TEST_QBD_CONNECTION_ID = exports.CONDUCTOR_TEST_API_KEY = void 0;
+exports.CONDUCTOR_TEST_API_KEY = "063d95bc-a6f7-4b4b-841d-8007648a3112";
+exports.CONDUCTOR_TEST_QBD_CONNECTION_ID = "49ee2e46-ec5a-40a0-8c37-43913994b2a9";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-node",
-  "version": "7.1.2",
+  "version": "7.2.0",
   "description": "Easily integrate with the entire QuickBooks Desktop API with fully-typed async TypeScript",
   "author": "Danny Nemer <hi@DannyNemer.com>",
   "license": "MIT",
@@ -17,7 +17,7 @@
     "postpack": "rm -rf dist",
     "clean": "rm -rf dist package conductor-node-*.tgz tsconfig.tsbuildinfo",
     "gen:graphql-types": "yarn graphql-codegen --config ./src/graphql/codegenConfig.ts",
-    "test-connections": "yarn ts-node ./bin/testConnections.ts"
+    "status": "yarn ts-node ./bin/logConnectionStatuses.ts"
   },
   "engines": {
     "node": ">=16"