conductor-node 11.3.1 → 11.4.0

package/README.md

@@ -41,7 +41,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 [email us](mailto:hello@conductor.is?subject=Conductor%20Beta%20Access&body=Hello!%20Tell%20us%20a%20bit%20about%20what%20you%20are%20building:%20) to join the beta.
+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.
 2. Node.js v16 or later.
 
 ## Installation

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "11.3.1",
+    "version": "11.4.0",
     "description": "QuickBooks Desktop API for Node.js and TypeScript",
     "keywords": [
         "QuickBooks",
@@ -12,6 +12,7 @@
         "QB Desktop",
         "QB Enterprise",
         "QBD",
+        "QBDT",
         "QBE",
         "Intuit"
     ],

package/dist/src/Client.js

@@ -30,11 +30,11 @@ class Client {
         this.qbd = new QbdIntegration_1.default(this.httpClient);
     }
     createHttpClient(apiKey, verbose) {
-        // Use an environment variable for overriding the server URL for testing and
-        // development instead of checking `NODE_ENV` to allow `conductor-node`
-        // users to use the production API server when their `NODE_ENV` is set to
-        // "development".
-        const apiServerUrl = process.env["CONDUCTOR__MOCK_API_SERVER_URL"] ??
+        // We use an environment variable for overriding the server URL for testing
+        // and development instead of checking `NODE_ENV` to ensure `conductor-node`
+        // users use the production API server when their `NODE_ENV` is set to
+        // "development". Only Conductor team members can use the mock API server.
+        const apiServerUrl = process.env["CONDUCTOR_MOCK_API_SERVER_URL"] ??
             "https://api.conductor.is";
         const httpClient = axios_1.default.create({
             baseURL: `${apiServerUrl}/v1`,

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

@@ -423,7 +423,7 @@ export default class QbdIntegration extends BaseIntegration {
         add: (endUserId: string, params: QbdTypes.CheckAddRq["CheckAdd"]) => Promise<NonNullable<QbdTypes.CheckAddRs["CheckRet"]>>;
         /**
          * Modifies an existing Check. Notice that you cannot use this to modify
-         * BillPaymentChecks.
+         * `BillPaymentChecks`.
          *
          * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/CheckMod
          */
@@ -1583,8 +1583,9 @@ export default class QbdIntegration extends BaseIntegration {
          * In a `TimeTracking` message, `ItemServiceRef` refers to the type of work.
          * If no `CustomerRef` is specified, then `ItemServiceRef` is not needed. If
          * `IsBillable` is set to true, then `TimeTrackingAdd` must include both
-         * `ItemServiceRef` and `CustomerRef`. See more:
-         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemServiceAdd
+         * `ItemServiceRef` and `CustomerRef`.
+         *
+         * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemServiceAdd
          */
         add: (endUserId: string, params: QbdTypes.ItemServiceAddRq["ItemServiceAdd"]) => Promise<NonNullable<QbdTypes.ItemServiceAddRs["ItemServiceRet"]>>;
         /**
@@ -1819,9 +1820,7 @@ export default class QbdIntegration extends BaseIntegration {
          *   QuickBooks Payroll Info window that provides detailed employee
          *   information employee.
          *
-         *
-         * See more:
-         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PayrollItemWageAdd
+         * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PayrollItemWageAdd
          */
         add: (endUserId: string, params: QbdTypes.PayrollItemWageAddRq["PayrollItemWageAdd"]) => Promise<NonNullable<QbdTypes.PayrollItemWageAddRs["PayrollItemWageRet"]>>;
         /**

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

@@ -428,7 +428,7 @@ class QbdIntegration extends BaseIntegration_1.default {
         add: async (endUserId, params) => this.sendRequestWrapper(endUserId, { CheckAddRq: { CheckAdd: params } }, "CheckAddRs", "CheckRet"),
         /**
          * Modifies an existing Check. Notice that you cannot use this to modify
-         * BillPaymentChecks.
+         * `BillPaymentChecks`.
          *
          * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/CheckMod
          */
@@ -1588,8 +1588,9 @@ class QbdIntegration extends BaseIntegration_1.default {
          * In a `TimeTracking` message, `ItemServiceRef` refers to the type of work.
          * If no `CustomerRef` is specified, then `ItemServiceRef` is not needed. If
          * `IsBillable` is set to true, then `TimeTrackingAdd` must include both
-         * `ItemServiceRef` and `CustomerRef`. See more:
-         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemServiceAdd
+         * `ItemServiceRef` and `CustomerRef`.
+         *
+         * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/ItemServiceAdd
          */
         add: async (endUserId, params) => this.sendRequestWrapper(endUserId, { ItemServiceAddRq: { ItemServiceAdd: params } }, "ItemServiceAddRs", "ItemServiceRet"),
         /**
@@ -1824,9 +1825,7 @@ class QbdIntegration extends BaseIntegration_1.default {
          *   QuickBooks Payroll Info window that provides detailed employee
          *   information employee.
          *
-         *
-         * See more:
-         * https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PayrollItemWageAdd
+         * See more: https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop/PayrollItemWageAdd
          */
         add: async (endUserId, params) => this.sendRequestWrapper(endUserId, { PayrollItemWageAddRq: { PayrollItemWageAdd: params } }, "PayrollItemWageAddRs", "PayrollItemWageRet"),
         /**

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

@@ -1 +1,2 @@
 export declare function checkForUpdates(): void;
+export declare function createFramedMessage(messageLines: string[]): string;

package/dist/src/utils/checkForUpdates.js

@@ -3,13 +3,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkForUpdates = void 0;
+exports.createFramedMessage = exports.checkForUpdates = void 0;
 const package_json_1 = __importDefault(require("../../package.json"));
+const env_1 = require("../utils/env");
 const node_child_process_1 = __importDefault(require("node:child_process"));
 function checkForUpdates() {
     if (process.env.NODE_ENV === "test") {
         return;
     }
+    // `CONDUCTOR_HIDE_UPDATE_MESSAGE` hides the update message that is logged
+    // when a newer version of `conductor-node` is available. It's a truthy value.
+    if ((0, env_1.isEnvironmentVariableTruthy)("CONDUCTOR_HIDE_UPDATE_MESSAGE")) {
+        return;
+    }
     // Exit early if npm is not installed.
     try {
         node_child_process_1.default.execSync("which npm");
@@ -26,7 +32,29 @@ function checkForUpdates() {
         const updateCommand = process.env["npm_execpath"]?.includes("yarn") === true
             ? "yarn add"
             : "npm install";
-        console.warn(`⚠️ Update available for Conductor: ${currentVersion} -> ${latestVersion}. To update, run: ${updateCommand} ${package_json_1.default.name}@latest`);
+        console.warn(createFramedMessage([
+            `🟡 Update available for Conductor! ${currentVersion} → ${latestVersion}`,
+            "",
+            "Run the following to update:",
+            `  ${updateCommand} ${package_json_1.default.name}@latest`,
+        ]));
     }
 }
 exports.checkForUpdates = checkForUpdates;
+function createFramedMessage(messageLines) {
+    const maxLength = Math.max(...messageLines.map((line) => line.length), 0);
+    const paddingHorizontalLength = 2;
+    return [
+        // Top border of the box.
+        `┌${"─".repeat(maxLength + paddingHorizontalLength * 2)}┐`,
+        // Print each line of the message, padded to fit the box.
+        ...messageLines.map((line) => {
+            const paddingLine = " ".repeat(maxLength - line.length);
+            const paddingHorizontal = " ".repeat(paddingHorizontalLength);
+            return `│${paddingHorizontal}${line}${paddingLine}${paddingHorizontal}│`;
+        }),
+        // Bottom border of the box.
+        `└${"─".repeat(maxLength + paddingHorizontalLength * 2)}┘`,
+    ].join("\n");
+}
+exports.createFramedMessage = createFramedMessage;

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

@@ -0,0 +1 @@
+export declare function isEnvironmentVariableTruthy(name: string): boolean;

package/dist/src/utils/env.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEnvironmentVariableTruthy = void 0;
+const FALSY_VALUES = new Set([
+    undefined,
+    "",
+    "null",
+    "undefined",
+    "false",
+    "0",
+]);
+function isEnvironmentVariableTruthy(name) {
+    const value = process.env[name]?.toLowerCase();
+    return !FALSY_VALUES.has(value);
+}
+exports.isEnvironmentVariableTruthy = isEnvironmentVariableTruthy;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-node",
-  "version": "11.3.1",
+  "version": "11.4.0",
   "description": "QuickBooks Desktop API for Node.js and TypeScript",
   "keywords": [
     "QuickBooks",
@@ -12,6 +12,7 @@
     "QB Desktop",
     "QB Enterprise",
     "QBD",
+    "QBDT",
     "QBE",
     "Intuit"
   ],