conductor-node 8.5.0 → 8.5.1

package/README.md

@@ -167,7 +167,7 @@ The `ConductorError` and its subclasses have the following properties:
   // The unique error code. This is useful for adding special handling
   // for specific errors.
   code: string;
-  // The error message for your logs.
+  // The developer error message for your logs.
   message: string;
   // The end-user-friendly error message to display in your app.
   endUserMessage: string;
@@ -184,13 +184,13 @@ The `ConductorError` and its subclasses have the following properties:
 
 The error object you receive will have one of the following error types:
 
-| Type                           | Description                                                                                      |
-| ------------------------------ | ------------------------------------------------------------------------------------------------ |
-| `ConductorIntegrationError`    | An error occurred on the third-party integration's end while processing your end-user's request. |
-| `ConductorInvalidRequestError` | You made an API call with the wrong parameters, in the wrong state, or in an invalid way.        |
-| `ConductorAuthenticationError` | Conductor cannot authenticate you with the credentials you provided. E.g., an incorrect API key. |
-| `ConductorConnectionError`     | There was a network problem between the client (on your server) and Conductor's servers.         |
-| `ConductorInternalError`       | Something went wrong on Conductor's end. (These are rare.)                                       |
+| Type                           | Description                                                                                                                                                              |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `ConductorIntegrationError`    | An error occurred on the third-party integration's end while processing your end-user's request. E.g., cannot connect to QuickBooks Desktop on your end-user's computer. |
+| `ConductorInvalidRequestError` | You made an API call with the wrong parameters, in the wrong state, or in an invalid way.                                                                                |
+| `ConductorAuthenticationError` | Conductor cannot authenticate you with the credentials you provided. E.g., an incorrect API key.                                                                         |
+| `ConductorConnectionError`     | There was a network problem between the client (on your server) and Conductor's servers.                                                                                 |
+| `ConductorInternalError`       | Something went wrong on Conductor's end. (These are rare.)                                                                                                               |
 
 ### Example
 
@@ -205,7 +205,14 @@ try {
   });
 } catch (error) {
   if (error instanceof ConductorError) {
-    // Update your app's UI to display `error.endUserMessage`.
+    // TODO: Update your app's UI to display `error.endUserMessage`.
+
+    // RECOMMENDED: Send a *warning* to Sentry for integration-errors, which are
+    // your end-user's fault (e.g., cannot connect to QBD on your end-user's
+    // computer) or an *error* for other errors (e.g., invalid API key).
+    Sentry.captureException(error, {
+      level: error instanceof ConductorIntegrationError ? "warning" : "error",
+    });
   }
   // ...
 }
@@ -225,7 +232,8 @@ conductor.qbd.account
   })
   .catch((error) => {
     if (error instanceof ConductorError) {
-      // Update your app's UI to display `error.endUserMessage`.
+      // TODO: Update your app's UI to display `error.endUserMessage`.
+      // ...
     }
     // ...
   });

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "8.5.0",
+    "version": "8.5.1",
     "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/errors.d.ts

@@ -52,8 +52,8 @@ export declare class ConductorError extends Error {
 type ConductorErrorOptionsWithoutRawType = Omit<ConductorErrorOptions, "rawType">;
 /**
  * Raised when an error occurs on the third-party integration's end while
- * processing your end-user's request. E.g., QBWC failed to connect to
- * QuickBooks Desktop on the end-user's computer.
+ * processing your end-user's request. E.g., cannot connect to QuickBooks
+ * Desktop on the end-user's computer.
  */
 export declare class ConductorIntegrationError extends ConductorError {
     static readonly rawType: string;

package/dist/src/errors.js

@@ -66,8 +66,8 @@ class ConductorError extends Error {
 exports.ConductorError = ConductorError;
 /**
  * Raised when an error occurs on the third-party integration's end while
- * processing your end-user's request. E.g., QBWC failed to connect to
- * QuickBooks Desktop on the end-user's computer.
+ * processing your end-user's request. E.g., cannot connect to QuickBooks
+ * Desktop on the end-user's computer.
  */
 class ConductorIntegrationError extends ConductorError {
     static rawType = "INTEGRATION_ERROR";

package/package.json

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