conductor-node 7.4.5 → 7.4.7

package/README.md

@@ -120,11 +120,13 @@ The response includes the following:
 
 ```ts
 {
-  // Whether we can connect to the end-user's QBD.
-  isConnected: false
-  // If `isConnected=false`, the corresponding error message for the developer.
-  devErrorMessage: "The end-user's computer is likely off",
-  // If `isConnected=false`, the corresponding error message for the end-user.
-  endUserErrorMessage: "Please ensure your computer is on and QuickBooks Desktop is open",
+  // Whether we can connect to the end-user's QuickBooks Desktop.
+  isConnected: false,
+  // If `isConnected=false`, an `error` like the following will exist:
+  error: {
+    code: "QBWC_CONNECTION_ERROR",
+    developerMessage: "QBWC Error 0x80040408: Could not start QuickBooks.",
+    endUserMessage: "An error occurred while connecting to QuickBooks Desktop. Please ensure QuickBooks Desktop is running and the correct company file is open, then try again.",
+  }
 }
 ```

package/dist/package.json

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

@@ -115,12 +115,16 @@ class Client {
             if (error instanceof graphql_request_1.ClientError) {
                 const { response } = error;
                 if ([404, 502, 503].includes(response.status)) {
-                    throw new Error(`The server returned a ${response.status} error, which may indicate that the server is down. Please alert the Conductor team if this error persists.`);
+                    throw new Error(`The Conductor server returned a ${response.status} error, which may indicate that the server is down. Please alert the Conductor team if this error persists.`);
                 }
-                const errorMessage = response.errors?.[0]?.message ??
-                    // Though the property `ClientError.response.error` does *not* exist,
-                    // we've seen it occur (e.g., attempting to access `development`
-                    // environment when `ngrok` is not running locally).
+                const nestedError = response.errors?.[0];
+                if (nestedError?.extensions["code"] === "GRAPHQL_VALIDATION_FAILED") {
+                    throw new Error(`The Conductor server is no longer compatible with your version of "${package_json_1.default.name}". Please run "yarn upgrade ${package_json_1.default.name}@latest --latest" to update.`);
+                }
+                const errorMessage = nestedError?.message ??
+                    // Though `ClientError.response.error` is *not* defined in the type
+                    // definition, we've seen it occur (e.g., attempting to access the
+                    // `development` environment when `ngrok` is not running locally).
                     response["error"];
                 if (errorMessage !== undefined) {
                     throw new Error(errorMessage);
@@ -138,7 +142,7 @@ class Client {
             .toString()
             .trim();
         if (currentVersion !== latestVersion) {
-            console.warn(chalk_1.default.yellow(`⚠️ A new version of Conductor is available! You are using ${package_json_1.default.name} version ${currentVersion} but the latest version is ${latestVersion}. Please run "yarn add ${package_json_1.default.name}@latest" to update.`));
+            console.warn(chalk_1.default.yellow(`⚠️ A new version of Conductor is available! You are using "${package_json_1.default.name}" version ${currentVersion} but the latest version is ${latestVersion}. Please run "yarn upgrade ${package_json_1.default.name} --latest" to update.`));
         }
     }
 }

package/package.json

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