conductor-node 11.4.0 → 11.4.2

package/README.md

@@ -1,7 +1,7 @@
 <!-- markdownlint-disable MD033 MD041 -->
 <div align="center">
   <h1><a href="https://conductor.is">Conductor</a></h1>
-  <h3>QuickBooks Desktop API for Node.js and TypeScript</h3>
+  <h3>QuickBooks Desktop API for Node.js, TypeScript, and REST</h3>
   <a href="https://npmjs.com/package/conductor-node"><img src="https://img.shields.io/npm/dm/conductor-node.svg?logo=npm" alt="NPM download count"></a>
   <a href="https://npmjs.org/package/conductor-node"><img src="https://img.shields.io/npm/v/conductor-node.svg?logo=npm" alt="Package version"></a>
   <img src="https://img.shields.io/badge/coverage-100%25-brightgreen" alt="Code coverage">
@@ -24,6 +24,8 @@
 
 Conductor is a TypeScript-first Node.js API for **QuickBooks Desktop** (also known as QuickBooks Enterprise). In just a few lines, get real-time access to fetch, create, or update [_any_ QuickBooks Desktop object type](https://docs.conductor.is/qbd/api#supported-object-types) and receive a fully-typed response. Check out [the documentation](https://docs.conductor.is) to get started.
 
+We also offer a [REST API](https://docs.conductor.is/usage/rest).
+
 Conductor, the company, is building a data integration platform for vertical SaaS companies, starting with QuickBooks Desktop. Our team has spent over a decade building companies, scaling vast software systems, and obsessing over quality.
 
 <!-- markdownlint-disable MD033 -->
@@ -41,7 +43,7 @@ Conductor, the company, is building a data integration platform for vertical Saa
 
 ## Requirements
 
-1. A Conductor API key pair: one secret key, one publishable key. Please [complete this form](https://73a5v9t55ed.typeform.com/to/VRX7rfrN) to join the beta.
+1. A Conductor API key pair: one secret key, one publishable key. Please [complete this form](https://forms.gle/1LTGXy2Hcyzw6qWa6) to join the beta.
 2. Node.js v16 or later.
 
 ## Installation

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "11.4.0",
+    "version": "11.4.2",
     "description": "QuickBooks Desktop API for Node.js and TypeScript",
     "keywords": [
         "QuickBooks",

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

@@ -993,7 +993,7 @@ export default class QbdIntegration extends BaseIntegration {
          * 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
+         * 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.
@@ -2456,14 +2456,23 @@ export default class QbdIntegration extends BaseIntegration {
      */
     timeTracking: {
         /**
-         * The time-tracking transactions that are returned in this query include
-         * time tracking information that was entered into QuickBooks manually or
-         * gathered using the QuickBooks “Timer” or “Stopwatch.” Note that the
-         * QuickBooks Timer application can run on its own without QuickBooks, but
-         * the QuickBooks SDK cannot access the Timer data directly. The Timer data
-         * must be imported into QuickBooks before it is accessible via the SDK.)
-         *
-         * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/TimeTrackingQuery
+         * This request adds a time tracking transaction to QuickBooks, mirroring
+         * the time-tracking feature available in the QuickBooks UI. The time
+         * tracking feature allows a QuickBooks user to base payroll or invoices on
+         * time worked. You can add time-tracking information to any vendor,
+         * employee, or person on the Other Names list in QuickBooks.
+         *
+         * If `IsBillable` is set to true, both `CustomerRef` and `ItemServiceRef`
+         * are required. There is no link between an invoice and the time entries.
+         * However, when you do the invoicing from QuickBooks, QuickBooks does mark
+         * the time entries as “billed.” If you don’t record the time entries as
+         * billed properly, then you get into a user workflow issue where every time
+         * the user creates an invoice for a customer, QB pops up a dialog asking if
+         * they want to bill the un-billed time (which you already billed from your
+         * app).
+         *
+         * See more:
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/TimeTrackingAdd
          */
         add: (endUserId: string, params: QbdTypes.TimeTrackingAddRq["TimeTrackingAdd"]) => Promise<NonNullable<QbdTypes.TimeTrackingAddRs["TimeTrackingRet"]>>;
         /**

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

@@ -998,7 +998,7 @@ class QbdIntegration extends BaseIntegration_1.default {
          * 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
+         * 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.
@@ -2461,14 +2461,23 @@ class QbdIntegration extends BaseIntegration_1.default {
      */
     timeTracking = {
         /**
-         * The time-tracking transactions that are returned in this query include
-         * time tracking information that was entered into QuickBooks manually or
-         * gathered using the QuickBooks “Timer” or “Stopwatch.” Note that the
-         * QuickBooks Timer application can run on its own without QuickBooks, but
-         * the QuickBooks SDK cannot access the Timer data directly. The Timer data
-         * must be imported into QuickBooks before it is accessible via the SDK.)
-         *
-         * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/TimeTrackingQuery
+         * This request adds a time tracking transaction to QuickBooks, mirroring
+         * the time-tracking feature available in the QuickBooks UI. The time
+         * tracking feature allows a QuickBooks user to base payroll or invoices on
+         * time worked. You can add time-tracking information to any vendor,
+         * employee, or person on the Other Names list in QuickBooks.
+         *
+         * If `IsBillable` is set to true, both `CustomerRef` and `ItemServiceRef`
+         * are required. There is no link between an invoice and the time entries.
+         * However, when you do the invoicing from QuickBooks, QuickBooks does mark
+         * the time entries as “billed.” If you don’t record the time entries as
+         * billed properly, then you get into a user workflow issue where every time
+         * the user creates an invoice for a customer, QB pops up a dialog asking if
+         * they want to bill the un-billed time (which you already billed from your
+         * app).
+         *
+         * See more:
+         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/TimeTrackingAdd
          */
         add: async (endUserId, params) => this.sendRequestWrapper(endUserId, { TimeTrackingAddRq: { TimeTrackingAdd: params } }, "TimeTrackingAddRs", "TimeTrackingRet"),
         /**

package/dist/src/resources/AuthSessionsResource.d.ts

@@ -29,7 +29,11 @@ export interface AuthSession {
      * after they complete the authentication flow. If `null`, their browser tab
      * will close instead.
      */
-    readonly returnUrl: string | undefined;
+    readonly redirectUrl: string | undefined;
+    /**
+     * @deprecated Use `redirectUrl` instead.
+     */
+    readonly returnUrl?: string | undefined;
 }
 export interface AuthSessionCreateInput {
     /**
@@ -52,6 +56,10 @@ export interface AuthSessionCreateInput {
      * after they complete the authentication flow. If not provided, their browser
      * tab will close instead.
      */
+    readonly redirectUrl?: string;
+    /**
+     * @deprecated Use `redirectUrl` instead.
+     */
     readonly returnUrl?: string;
 }
 export default class AuthSessionsResource extends BaseResource {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-node",
-  "version": "11.4.0",
+  "version": "11.4.2",
   "description": "QuickBooks Desktop API for Node.js and TypeScript",
   "keywords": [
     "QuickBooks",