conductor-node 8.0.3 → 8.2.0

package/README.md

@@ -59,7 +59,7 @@ The response looks like the following:
 {
   // ❗ Save this `id` to your database for executing requests to this
   // end-user's integration in the future.
-  id: '{UUID}',
+  id: 'int_conn_1234abcd',
   integrationKey: 'quickbooks-desktop',
   endUserSourceId: "1234-abcd",
   endUserEmail: 'danny@constructionco.com',

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "8.0.3",
+    "version": "8.2.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

@@ -1,10 +1,10 @@
-import type { GraphqlCreateIntegrationConnectionInput, GraphqlCreateIntegrationConnectionMutation, GraphqlGetConnectionStatusQuery, GraphqlGetConnectionStatusQueryVariables, GraphqlGetIntegrationConnectionQuery, GraphqlGetIntegrationConnectionQueryVariables, GraphqlGetIntegrationConnectionsQuery, GraphqlSendIntegrationRequestInput, GraphqlSendIntegrationRequestMutation } from "./graphql/__generated__/operationTypes";
+import type { GraphqlCreateIntegrationConnectionInput, GraphqlCreateIntegrationConnectionMutation, GraphqlGetConnectionStatusQuery, GraphqlGetConnectionStatusQueryVariables, GraphqlGetIntegrationConnectionQuery, GraphqlGetIntegrationConnectionQueryVariables, GraphqlGetIntegrationConnectionsQuery } from "./graphql/__generated__/operationTypes";
 import QbdIntegration from "./integrations/qbd/QbdIntegration";
-import type { Environment } from "./utils/environment";
+import { getServerUrlForEnvironment } from "./utils";
 export interface ClientOptions {
     /** Log each request and response. */
     readonly verbose?: boolean;
-    readonly serverEnvironment?: Environment;
+    readonly serverEnvironment?: Parameters<typeof getServerUrlForEnvironment>[0];
 }
 export default class Client {
     /** QuickBooks Desktop integration. */
@@ -12,7 +12,18 @@ export default class Client {
     private readonly graphqlClient;
     private readonly graphqlOperations;
     constructor(apiKey: string, { verbose, serverEnvironment }?: ClientOptions);
+    /**
+     * Fetch the specified integration-connection.
+     *
+     * @param integrationConnectionId The integration-connection ID.
+     * @returns The integration-connection.
+     */
     getIntegrationConnection(integrationConnectionId: GraphqlGetIntegrationConnectionQueryVariables["integrationConnectionId"]): Promise<GraphqlGetIntegrationConnectionQuery["integrationConnection"]>;
+    /**
+     * Fetch all integration-connections associated with your Conductor account.
+     *
+     * @returns The integration-connections.
+     */
     getIntegrationConnections(): Promise<GraphqlGetIntegrationConnectionsQuery["integrationConnections"]>;
     /**
      * Check whether we can successfully connect to the end-user's QBD instance.
@@ -22,22 +33,21 @@ export default class Client {
      * 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 the end-user's QBD.
-     * @returns result.error If `isConnected=false`, this will be an object with
-     * the following properties:
-     * @returns result.error.code The unique error code.
-     * @returns result.error.developerMessage The technical error message for the
-     * developer.
-     * @returns result.error.endUserMessage The user-friendly error message to
-     * display to the the end-user.
+     * @param integrationConnectionId The ID of the integration-connection.
+     * @returns The result object with the following properties:
+     * - isConnected - Whether we can connect to the end-user's QBD.
+     * - error - If `isConnected=false`, this will be an object with the following
+     *   properties:
+     *   - error.code - The unique error code.
+     *   - error.developerMessage - The technical error message for the developer.
+     *   - error.endUserMessage - The user-friendly error message to display to
+     *     the the end-user.
      */
     getConnectionStatus(integrationConnectionId: GraphqlGetConnectionStatusQueryVariables["integrationConnectionId"]): Promise<GraphqlGetConnectionStatusQuery["integrationConnection"]["connectionStatus"]>;
     /**
-     * Create a new integration connection.
+     * Create a new integration-connection.
      *
-     * @param input - The input object to create the integration connection.
+     * @param input - The input object to create the integration-connection.
      * @param input.integrationKey The identifier of the third-party platform to
      * integrate.
      * @param input.endUserSourceId Your end-user's unique ID in your product's
@@ -47,11 +57,10 @@ export default class Client {
      * only. No emails will be sent.
      * @param input.endUserCompanyName Your end-user's company name that will be
      * shown elsewhere in Conductor.
-     * @returns The newly created integration connection.
+     * @returns The newly created integration-connection.
      */
     createIntegrationConnection(input: GraphqlCreateIntegrationConnectionInput & {
         integrationKey: "quickbooks-desktop";
     }): Promise<GraphqlCreateIntegrationConnectionMutation["createIntegrationConnection"]["integrationConnection"]>;
-    /** Not intended for public use. */
-    sendIntegrationRequest(input: GraphqlSendIntegrationRequestInput): Promise<GraphqlSendIntegrationRequestMutation["sendIntegrationRequest"]["response"]>;
+    private createHeaders;
 }

package/dist/src/Client.js

@@ -7,8 +7,7 @@ const package_json_1 = __importDefault(require("./../package.json"));
 const graphqlOperationWrapper_1 = require("./graphql/graphqlOperationWrapper");
 const operationTypes_1 = require("./graphql/__generated__/operationTypes");
 const QbdIntegration_1 = __importDefault(require("./integrations/qbd/QbdIntegration"));
-const checkForUpdates_1 = __importDefault(require("./utils/checkForUpdates"));
-const environment_1 = require("./utils/environment");
+const utils_1 = require("./utils");
 const graphql_request_1 = require("graphql-request");
 class Client {
     /** QuickBooks Desktop integration. */
@@ -16,21 +15,27 @@ class Client {
     graphqlClient;
     graphqlOperations;
     constructor(apiKey, { verbose = false, serverEnvironment = "production" } = {}) {
-        (0, checkForUpdates_1.default)();
-        this.graphqlClient = new graphql_request_1.GraphQLClient(`${(0, environment_1.getServerUrlForEnvironment)(serverEnvironment)}/graphql`, {
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-                "User-Agent": `${package_json_1.default.name}/${package_json_1.default.version} (Node.js ${process.version}; ${process.platform} ${process.arch})`,
-            },
-        });
+        (0, utils_1.checkForUpdates)();
+        this.graphqlClient = new graphql_request_1.GraphQLClient(`${(0, utils_1.getServerUrlForEnvironment)(serverEnvironment)}/graphql`, { headers: this.createHeaders(apiKey) });
         this.graphqlOperations = (0, graphqlOperationWrapper_1.wrapGraphqlOperations)((0, operationTypes_1.getSdk)(this.graphqlClient), verbose);
-        this.qbd = new QbdIntegration_1.default(this);
+        this.qbd = new QbdIntegration_1.default(this.graphqlOperations);
     }
+    /**
+     * Fetch the specified integration-connection.
+     *
+     * @param integrationConnectionId The integration-connection ID.
+     * @returns The integration-connection.
+     */
     async getIntegrationConnection(integrationConnectionId) {
         return this.graphqlOperations
             .getIntegrationConnection({ integrationConnectionId })
             .then((result) => result.integrationConnection);
     }
+    /**
+     * Fetch all integration-connections associated with your Conductor account.
+     *
+     * @returns The integration-connections.
+     */
     async getIntegrationConnections() {
         return this.graphqlOperations
             .getIntegrationConnections()
@@ -44,16 +49,15 @@ class Client {
      * 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 the end-user's QBD.
-     * @returns result.error If `isConnected=false`, this will be an object with
-     * the following properties:
-     * @returns result.error.code The unique error code.
-     * @returns result.error.developerMessage The technical error message for the
-     * developer.
-     * @returns result.error.endUserMessage The user-friendly error message to
-     * display to the the end-user.
+     * @param integrationConnectionId The ID of the integration-connection.
+     * @returns The result object with the following properties:
+     * - isConnected - Whether we can connect to the end-user's QBD.
+     * - error - If `isConnected=false`, this will be an object with the following
+     *   properties:
+     *   - error.code - The unique error code.
+     *   - error.developerMessage - The technical error message for the developer.
+     *   - error.endUserMessage - The user-friendly error message to display to
+     *     the the end-user.
      */
     async getConnectionStatus(integrationConnectionId) {
         return this.graphqlOperations
@@ -61,9 +65,9 @@ class Client {
             .then((result) => result.integrationConnection.connectionStatus);
     }
     /**
-     * Create a new integration connection.
+     * Create a new integration-connection.
      *
-     * @param input - The input object to create the integration connection.
+     * @param input - The input object to create the integration-connection.
      * @param input.integrationKey The identifier of the third-party platform to
      * integrate.
      * @param input.endUserSourceId Your end-user's unique ID in your product's
@@ -73,19 +77,18 @@ class Client {
      * only. No emails will be sent.
      * @param input.endUserCompanyName Your end-user's company name that will be
      * shown elsewhere in Conductor.
-     * @returns The newly created integration connection.
+     * @returns The newly created integration-connection.
      */
     async createIntegrationConnection(input) {
         return this.graphqlOperations
             .createIntegrationConnection({ input })
             .then((result) => result.createIntegrationConnection.integrationConnection);
     }
-    // TODO: Find a way to make this private.
-    /** Not intended for public use. */
-    async sendIntegrationRequest(input) {
-        return this.graphqlOperations
-            .sendIntegrationRequest({ input })
-            .then((result) => result.sendIntegrationRequest.response);
+    createHeaders(apiKey) {
+        return {
+            Authorization: `Bearer ${apiKey}`,
+            "User-Agent": `${package_json_1.default.name}/${package_json_1.default.version} (Node.js ${process.version}; ${process.platform} ${process.arch})`,
+        };
     }
 }
 exports.default = Client;

package/dist/src/graphql/graphqlOperationWrapper.d.ts

@@ -3,4 +3,4 @@ export declare function wrapGraphqlOperations<T extends ReturnType<typeof getSdk
 export declare function graphqlOperationWrapper<V extends {
     [key: string]: unknown;
 }, R>(operationName: string, variables: V | undefined, operation: (variables: V | undefined) => Promise<R>, verbose: boolean): Promise<R>;
-export declare function formatGraphqlError(error: Error): Error;
+export declare function formatError(error: Error): Error;

package/dist/src/graphql/graphqlOperationWrapper.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatGraphqlError = exports.graphqlOperationWrapper = exports.wrapGraphqlOperations = void 0;
+exports.formatError = exports.graphqlOperationWrapper = exports.wrapGraphqlOperations = void 0;
 const package_json_1 = __importDefault(require("../../package.json"));
 const graphql_request_1 = require("graphql-request");
 const node_util_1 = __importDefault(require("node:util"));
@@ -44,7 +44,7 @@ async function graphqlOperationWrapper(operationName, variables, operation, verb
         return result;
     }
     catch (error) {
-        const formattedError = formatGraphqlError(error);
+        const formattedError = formatError(error);
         if (verbose) {
             const errorInfo = {
                 duration: getDurationString(startTime),
@@ -58,7 +58,7 @@ async function graphqlOperationWrapper(operationName, variables, operation, verb
     }
 }
 exports.graphqlOperationWrapper = graphqlOperationWrapper;
-function formatGraphqlError(error) {
+function formatError(error) {
     if (error instanceof graphql_request_1.ClientError) {
         const { response } = error;
         if ([404, 502, 503].includes(response.status)) {
@@ -79,7 +79,7 @@ function formatGraphqlError(error) {
     }
     return error;
 }
-exports.formatGraphqlError = formatGraphqlError;
+exports.formatError = formatError;
 function getDurationString(startTime) {
     const duration = Date.now() - startTime;
     return `${Math.round(duration / 10) / 100}s`;

package/dist/src/integrations/BaseIntegration.d.ts

@@ -1,5 +1,8 @@
 import type Client from "../Client";
+import type { GraphqlSendIntegrationRequestInput, GraphqlSendIntegrationRequestMutation } from "../graphql/__generated__/operationTypes";
 export default class BaseIntegration {
-    protected readonly client: Client;
-    constructor(client: Client);
+    private readonly graphqlOperations;
+    constructor(graphqlOperations: Client["graphqlOperations"]);
+    /** Not intended for public use. */
+    protected sendIntegrationRequest(input: GraphqlSendIntegrationRequestInput): Promise<GraphqlSendIntegrationRequestMutation["sendIntegrationRequest"]["response"]>;
 }

package/dist/src/integrations/BaseIntegration.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 class BaseIntegration {
-    client;
-    constructor(client) {
-        this.client = client;
+    graphqlOperations;
+    constructor(graphqlOperations) {
+        this.graphqlOperations = graphqlOperations;
+    }
+    /** Not intended for public use. */
+    async sendIntegrationRequest(input) {
+        return this.graphqlOperations
+            .sendIntegrationRequest({ input })
+            .then((result) => result.sendIntegrationRequest.response);
     }
 }
 exports.default = BaseIntegration;

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

@@ -283,6 +283,40 @@ export default class QbdIntegration extends BaseIntegration {
          */
         query: (integrationConnectionId: string, params: QbdTypes.BillPaymentCheckQueryRq) => Promise<NonNullable<QbdTypes.BillPaymentCheckQueryRs["BillPaymentCheckRet"]>>;
     };
+    charge: {
+        /**
+         * Adds a customer charge. A `Charge` contains information about a statement
+         * charge. (A `CreditCardCharge` object, on the other hand, refers to a
+         * credit card charge incurred by the QuickBooks user.)
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ChargeAdd
+         */
+        add: (integrationConnectionId: string, params: QbdTypes.ChargeAddRq["ChargeAdd"]) => Promise<NonNullable<QbdTypes.ChargeAddRs["ChargeRet"]>>;
+        /**
+         * Modifies the specified charge.
+         *
+         * Some fields in a `ChargeMod` request cannot be cleared. If any of the
+         * following fields is included in a charge modify request, it must contain
+         * a value:
+         * - `CustomerRef`
+         * - `TxnDate`
+         * - `ItemRef`
+         * - `Quantity`
+         * - `Rate`
+         * - `Amount`
+         * - `ARAccountRef`
+         * - `OverrideItemAccountRef`
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ChargeMod
+         */
+        mod: (integrationConnectionId: string, params: QbdTypes.ChargeModRq["ChargeMod"]) => Promise<NonNullable<QbdTypes.ChargeModRs["ChargeRet"]>>;
+        /**
+         * Returns information about statement charges.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ChargeQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.ChargeQueryRq) => Promise<NonNullable<QbdTypes.ChargeQueryRs["ChargeRet"]>>;
+    };
     check: {
         /**
          * The amount of a check is the total of the amounts assigned to expense
@@ -454,6 +488,211 @@ export default class QbdIntegration extends BaseIntegration {
          */
         query: (integrationConnectionId: string, params: QbdTypes.EmployeeQueryRq) => Promise<NonNullable<QbdTypes.EmployeeQueryRs["EmployeeRet"]>>;
     };
+    estimate: {
+        /**
+         * Adds an estimate. A QuickBooks estimate is a description of a sale that
+         * the QuickBooks user proposes to make to a current or prospective
+         * customer. An estimate might also be called a “bid” or a “proposal.” In
+         * QuickBooks, estimates and invoices use similar fields, and an estimate
+         * can be converted into an invoice after the customer accepts the estimate.
+         *
+         * An estimate is a non-posting transaction, so it does not affect a
+         * company’s balance sheet or income statement.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/EstimateAdd
+         */
+        add: (integrationConnectionId: string, params: QbdTypes.EstimateAddRq["EstimateAdd"]) => Promise<NonNullable<QbdTypes.EstimateAddRs["EstimateRet"]>>;
+        /**
+         * Modifies the specified estimate.
+         *
+         * Some fields in an `EstimateMod` request cannot be cleared. If any of the
+         * following fields is included in an estimate modify request, it must
+         * contain a value:
+         * - `CustomerRef`
+         * - `TemplateRef`
+         * - `TxnDate`
+         * - `IsActive`
+         * - `CreateChangeOrder`
+         * - `DueDate`
+         * - `ItemSalesTaxRef`
+         *
+         * Within `EstimateLineMod` or `EstimateLineGroupMod`:
+         * - `ItemRef`
+         * - `Quantity`
+         * - `Rate`
+         * - `Amount`>
+         * - `SalesTaxCodeRef`
+         * - `Markup`
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/EstimateMod
+         */
+        mod: (integrationConnectionId: string, params: QbdTypes.EstimateModRq["EstimateMod"]) => Promise<NonNullable<QbdTypes.EstimateModRs["EstimateRet"]>>;
+        /**
+         * Queries for the specified estimate or set of estimates.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/EstimateQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.EstimateQueryRq) => Promise<NonNullable<QbdTypes.EstimateQueryRs["EstimateRet"]>>;
+    };
+    invoice: {
+        /**
+         * Adds an invoice.
+         *
+         * An invoice records the amount owed by a customer who purchased goods or
+         * services but did not pay in full at the time of the sale. If full payment
+         * is received at the time of the sale, it is recorded as a sales receipt,
+         * not an invoice.
+         *
+         * In QuickBooks, invoices and estimates use similar fields, and an estimate
+         * can be converted into an invoice after the customer accepts the estimate.
+         * However, in the SDK, there is currently no ability to create an invoice
+         * directly from an estimate (you cannot link an invoice to an estimate).
+         *
+         * If you Add an invoice that has an inventory item on it, QB will
+         * automatically calculate COGS and post it to the COGS account. (The
+         * inventory item will need to be setup to post to the COGS account and must
+         * have a unit cost in it.) However, notice that such an InvoiceAdd has
+         * sales prices, not cost, so the Add is not impacting the cost of the item.
+         * The cost of the item is only affected by purchases (bills and item
+         * receipts) sales and inventory adjustments.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/InvoiceAdd
+         */
+        add: (integrationConnectionId: string, params: QbdTypes.InvoiceAddRq["InvoiceAdd"]) => Promise<NonNullable<QbdTypes.InvoiceAddRs["InvoiceRet"]>>;
+        /**
+         * Modifies an existing invoice. If you are modifying existing line items,
+         * supply an `InvoiceLineMod` and `TxnLineID` for each line you want to
+         * modify. If you want to add a new line, supply an `InvoiceLineMod` with
+         * its `TxnLineID` value set to -1.
+         *
+         * Some fields in an `InvoiceMod` request cannot be cleared. If any of the
+         * following fields is included in an invoice modify request, it must
+         * contain a value:
+         * - `CustomerRef`
+         * - `ARAccountRef`
+         * - `TemplateRef`
+         * - `TxnDate`
+         * - `IsPending`
+         * - `DueDate`
+         * - `ItemSalesTaxRef`
+         * - `ShipDate`
+         * - `IsToBePrinted`
+         *
+         * Within `InvoiceLineMod` or `InvoiceLineGroupMod`:
+         * - `ItemRef`
+         * - `Quantity`
+         * - `Rate`
+         * - `Amount`
+         * - `SalesTaxCodeRef`
+         * - `OverrideItemAccountRef`
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/InvoiceMod
+         */
+        mod: (integrationConnectionId: string, params: QbdTypes.InvoiceModRq["InvoiceMod"]) => Promise<NonNullable<QbdTypes.InvoiceModRs["InvoiceRet"]>>;
+        /**
+         * Returns invoice data.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/InvoiceQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.InvoiceQueryRq) => Promise<NonNullable<QbdTypes.InvoiceQueryRs["InvoiceRet"]>>;
+    };
+    itemInventory: {
+        /**
+         * Adds an inventory item. An inventory item is any merchandise or part that
+         * a business purchases, tracks as inventory, and then resells. In
+         * QuickBooks, information about an inventory item is grouped into three
+         * categories:
+         * 1. Purchase Information includes `PurchaseDesc`, `PurchaseCost`,
+         *    `COGSAccountRef`, and `PrefVendorRef`.
+         * 2. Sales Information includes `SalesDesc`, `SalesPrice`, and
+         *    `SalesTaxCodeRef`.
+         * 3. Inventory Information includes `AssetAccountRef`, `ReorderPoint`,
+         *    `QuantityOnHand`, `TotalValue`, and `InventoryDate`.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemInventoryAdd
+         */
+        add: (integrationConnectionId: string, params: QbdTypes.ItemInventoryAddRq["ItemInventoryAdd"]) => Promise<NonNullable<QbdTypes.ItemInventoryAddRs["ItemInventoryRet"]>>;
+        /**
+         * Modifies an inventory item.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemInventoryMod
+         */
+        mod: (integrationConnectionId: string, params: QbdTypes.ItemInventoryModRq["ItemInventoryMod"]) => Promise<NonNullable<QbdTypes.ItemInventoryModRs["ItemInventoryRet"]>>;
+        /**
+         * Queries for the specified inventory item or set of items.
+         *
+         * Notice that certain modifications to the item can be caused by other
+         * transactions, such as `ItemReceipts` where the item’s on hand quantity is
+         * increased. Modifications through these transactions do not result in
+         * changing the `TimeModified` stamp (only the `Mod` operation will do
+         * that), but those changes will be detected when you use the
+         * `FromModifiedDate`/`ToModifiedDate` filters in your query. Notice that
+         * you cannot get an inventory asset value from QuickBooks using this query.
+         * Instead, you need to use the General Summary Report query (which
+         * currently doesn’t include Assembly Items). Suppose you needed a way to
+         * search for the amount on hand of items that have had their amount changed
+         * since a certain date. Again, you would not use this query, but a
+         * `GeneralDetailReportQuery` that has its `GeneralDetailReportType` set to
+         * “InventoryValuationDetail”. This will tell you which items changed by how
+         * much. Also, suppose you wanted the on-hand quantity from QB as of a
+         * specific date. You would use a General Summary Report of the type
+         * Inventory Valuation Summary. (Again, this report doesn’t include
+         * Inventory Assemblies.)
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemInventoryQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.ItemInventoryQueryRq) => Promise<NonNullable<QbdTypes.ItemInventoryQueryRs["ItemInventoryRet"]>>;
+    };
+    itemNonInventory: {
+        /**
+         * Adds a non-inventory item, which is any material or part that a business
+         * buys but does not keep on hand as inventory. There are two types of
+         * non-inventory items:
+         * 1. Materials or parts that are part of the business’s overhead (for
+         *    example, office supplies
+         * 2. Materials or parts that the business buys to finish a specific job and
+         *    then charges back to the customer.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemNonInventoryAdd
+         */
+        add: (integrationConnectionId: string, params: QbdTypes.ItemNonInventoryAddRq["ItemNonInventoryAdd"]) => Promise<NonNullable<QbdTypes.ItemNonInventoryAddRs["ItemNonInventoryRet"]>>;
+        /**
+         * Modifies a non inventory item.
+         *
+         * About `SalesOrPurchaseMod` versus `SalesAndPurchaseMod` in an
+         * `ItemNonInventoryMod` request: You cannot change the reimbursable status
+         * of a non-inventory item through the SDK. For example, if a non-inventory
+         * item is marked as non-reimbursable in QuickBooks, you cannot send a
+         * modify request that includes a `SalesAndPurchaseMod` aggregate.
+         * Similarly, if you send an `ItemNonInventoryAdd` request that includes a
+         * `SalesOrPurchase` aggregate, you cannot later modify that item using a
+         * `SalesAndPurchaseMod` aggregate.
+         *
+         * You can modify the various account references using the appropriate
+         * account reference aggregate and the matching Apply Account
+         * `RefToExistingTxns` boolean. You need to use the boolean when you change
+         * an account ref because the QuickBooks UI displays a prompt asking whether
+         * the change should apply to existing transactions or not. Specifying True
+         * for the boolean basically dismisses this with a “Yes” answer, allowing
+         * your changes to be made and changes any existing transactions that use
+         * the item with that `AccountRef`. Specifying “False” means that the mod will
+         * not take affect if there are existing transactions. Setting this to
+         * “True” should be used with caution and normally only after some user has
+         * indicated that they want those changes made to all those existing
+         * transactions! If any affected transactions are protected by a closing
+         * date and password, the `AccountRef` changes will not be made and so the Mod
+         * request will return an error without making the requested Mod.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemNonInventoryMod
+         */
+        mod: (integrationConnectionId: string, params: QbdTypes.ItemNonInventoryModRq["ItemNonInventoryMod"]) => Promise<NonNullable<QbdTypes.ItemNonInventoryModRs["ItemNonInventoryRet"]>>;
+        /**
+         * Queries for the specified non-inventory item or set of items.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemNonInventoryQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.ItemNonInventoryQueryRq) => Promise<NonNullable<QbdTypes.ItemNonInventoryQueryRs["ItemNonInventoryRet"]>>;
+    };
     itemService: {
         /**
          * Adds a service item, which is an item that refers to services that a
@@ -629,6 +868,47 @@ export default class QbdIntegration extends BaseIntegration {
          */
         query: (integrationConnectionId: string, params: QbdTypes.TimeTrackingQueryRq) => Promise<NonNullable<QbdTypes.TimeTrackingQueryRs["TimeTrackingRet"]>>;
     };
+    purchaseOrder: {
+        /**
+         * Adds a purchase order, which is an order submitted to a vendor. You can
+         * use ItemReceiptAdd to receive items against a purchase order as items
+         * arrive from the vendor. A purchase order is a non-posting transaction, so
+         * it does not affect a company’s balance sheet or income statement.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PurchaseOrderQuery
+         */
+        add: (integrationConnectionId: string, params: QbdTypes.PurchaseOrderAddRq["PurchaseOrderAdd"]) => Promise<NonNullable<QbdTypes.PurchaseOrderAddRs["PurchaseOrderRet"]>>;
+        /**
+         * Modifies a purchase order.
+         *
+         * Some fields in a `PurchaseOrderMod` request cannot be cleared. If any of
+         * the following fields is included in a purchase order modify request, it
+         * must contain a value:
+         * - `TemplateRef`
+         * - `TxnDate`
+         * - `DueDate`
+         * - `ExpectedDate`
+         * - `IsManuallyClosed`
+         * - `IsToBePrinted`
+         *
+         * Within `PurchaseOrderLineMod` or `PurchaseOrderLineGroupMod`:
+         * - `ItemRef`
+         * - `Quantity`
+         * - `Rate`
+         * - `Amount`
+         * - `IsManuallyClosed`
+         * - `OverrideItemAccountRef`
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PurchaseOrderMod
+         */
+        mod: (integrationConnectionId: string, params: QbdTypes.PurchaseOrderModRq["PurchaseOrderMod"]) => Promise<NonNullable<QbdTypes.PurchaseOrderModRs["PurchaseOrderRet"]>>;
+        /**
+         * Queries for the specified purchase order or set of orders.
+         *
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PurchaseOrderQuery
+         */
+        query: (integrationConnectionId: string, params: QbdTypes.PurchaseOrderQueryRq) => Promise<NonNullable<QbdTypes.PurchaseOrderQueryRs["PurchaseOrderRet"]>>;
+    };
     vendor: {
         /**
          * Adds a vendor.