conductor-node 10.3.2 → 10.4.0

package/README.md

@@ -1,4 +1,4 @@
-# Conductor - The best QuickBooks Desktop integration on the planet
+# [Conductor](https://conductor.is/) - The best QuickBooks Desktop integration on the planet
 
 Execute _any_ read or write [QuickBooks Desktop API](https://developer.intuit.com/app/developer/qbdesktop/docs/api-reference/qbdesktop) through async TypeScript and receive a fully-typed response.
 
@@ -16,7 +16,7 @@ Execute _any_ read or write [QuickBooks Desktop API](https://developer.intuit.co
 
 ## Requirements
 
-1. A Conductor API key. [Please email us to join the private beta.](mailto:danny@conductor.is?subject=Conductor%20--%20Early%20Access)
+1. A Conductor API key. Please visit [our website](https://conductor.is/) to join the private beta.
 
 ## Installation
 

package/dist/package.json

@@ -1,7 +1,17 @@
 {
     "name": "conductor-node",
-    "version": "10.3.2",
+    "version": "10.4.0",
     "description": "Easily integrate the entire QuickBooks Desktop API using fully-typed async TypeScript",
+    "keywords": [
+        "QuickBooks Desktop",
+        "QuickBooks",
+        "Intuit",
+        "QuickBooks Web Connector",
+        "qbXML",
+        "QBWC",
+        "QBD"
+    ],
+    "homepage": "https://conductor.is",
     "license": "MIT",
     "type": "commonjs",
     "main": "dist/src/index.js",
@@ -29,12 +39,5 @@
     "devDependencies": {
         "axios-mock-adapter": "^1.21.4",
         "tsc-alias": "^1.7.0"
-    },
-    "keywords": [
-        "conductor",
-        "qbd",
-        "qbwc",
-        "qbxml",
-        "quickbooks desktop"
-    ]
+    }
 }

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

@@ -1,5 +1,5 @@
 import type { EndUser } from "../resources/EndUsersResource";
-import type { IntegrationConnection } from "../resources/IntegrationConnectionsResource";
+import type { IntegrationConnection, IntegrationKey } from "../resources/IntegrationConnectionsResource";
 import type { AxiosInstance } from "axios";
 export default abstract class BaseIntegration {
     protected readonly httpClient: AxiosInstance;
@@ -10,5 +10,5 @@ export default abstract class BaseIntegration {
      */
     protected sendRequestDeprecated(id: IntegrationConnection["id"], payload: Record<string, unknown>): Promise<object>;
     /** Not intended for public use. */
-    protected sendRequest(endUserId: EndUser["id"], integrationKey: string, payload: Record<string, unknown>): Promise<object>;
+    protected sendRequest(endUserId: EndUser["id"], integrationKey: IntegrationKey, payload: Record<string, unknown>): Promise<object>;
 }

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

@@ -1,4 +1,5 @@
 import BaseResource from "../resources/BaseResource";
+import type { IntegrationKey } from "../resources/IntegrationConnectionsResource";
 export interface EndUser {
     /**
      * The unique identifier for the object.
@@ -23,6 +24,9 @@ export interface EndUser {
     createdAt: string;
 }
 export type EndUserCreateInput = Pick<EndUser, "email" | "name" | "sourceId">;
+export interface EndUserPingOutput {
+    duration: number;
+}
 export default class EndUsersResource extends BaseResource {
     protected readonly ROUTE = "/end-users";
     /**
@@ -37,4 +41,20 @@ export default class EndUsersResource extends BaseResource {
      * Retrieves the specified end-user.
      */
     retrieve(id: EndUser["id"]): Promise<EndUser>;
+    /**
+     * Checks whether the specified integration-connection can connect and process
+     * requests end-to-end.
+     *
+     * If the connection fails, the error we encountered will be thrown as a
+     * `ConductorError` (like any request). This information is useful for showing
+     * a "connection status" indicator in your app. If an error occurs, we
+     * recommend displaying the property `error.endUserMessage` to your end-user
+     * in your app's UI.
+     *
+     * @param endUserId The ID of the end-user to ping.
+     * @param integrationKey The integration key for the integration-connection to
+     * ping.
+     * @returns The ping result with the duration in milliseconds.
+     */
+    ping(endUserId: EndUser["id"], integrationKey: IntegrationKey): Promise<EndUserPingOutput>;
 }

package/dist/src/resources/EndUsersResource.js

@@ -27,5 +27,24 @@ class EndUsersResource extends BaseResource_1.default {
         const { data } = await this.httpClient.get(`${this.ROUTE}/${id}`);
         return data;
     }
+    /**
+     * Checks whether the specified integration-connection can connect and process
+     * requests end-to-end.
+     *
+     * If the connection fails, the error we encountered will be thrown as a
+     * `ConductorError` (like any request). This information is useful for showing
+     * a "connection status" indicator in your app. If an error occurs, we
+     * recommend displaying the property `error.endUserMessage` to your end-user
+     * in your app's UI.
+     *
+     * @param endUserId The ID of the end-user to ping.
+     * @param integrationKey The integration key for the integration-connection to
+     * ping.
+     * @returns The ping result with the duration in milliseconds.
+     */
+    async ping(endUserId, integrationKey) {
+        const { data } = await this.httpClient.get(`${this.ROUTE}/${endUserId}/ping/${integrationKey}`);
+        return data;
+    }
 }
 exports.default = EndUsersResource;

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

@@ -1,6 +1,7 @@
 import BaseResource from "../resources/BaseResource";
 import IntegrationConnectionAuthSessionsResource from "../resources/IntegrationConnectionAuthSessionsResource";
 import type { AxiosInstance } from "axios";
+export type IntegrationKey = "quickbooks-desktop";
 export interface IntegrationConnection {
     /**
      * The unique identifier for the object.
@@ -14,7 +15,7 @@ export interface IntegrationConnection {
      * The identifier of the third-party platform to integrate (e.g.,
      * "quickbooks-desktop").
      */
-    integrationKey: string;
+    integrationKey: IntegrationKey;
     /**
      * The time at which the object was created.
      */
@@ -29,7 +30,7 @@ export interface IntegrationConnectionCreateOldInput {
      * The identifier of the third-party platform to integrate (e.g.,
      * "quickbooks-desktop").
      */
-    integrationKey: string;
+    integrationKey: IntegrationKey;
     /**
      * Your end-user's unique ID in your product's database. Must be distinct from
      * your other connections for the same integration.

package/package.json

@@ -1,7 +1,17 @@
 {
   "name": "conductor-node",
-  "version": "10.3.2",
+  "version": "10.4.0",
   "description": "Easily integrate the entire QuickBooks Desktop API using fully-typed async TypeScript",
+  "keywords": [
+    "QuickBooks Desktop",
+    "QuickBooks",
+    "Intuit",
+    "QuickBooks Web Connector",
+    "qbXML",
+    "QBWC",
+    "QBD"
+  ],
+  "homepage": "https://conductor.is",
   "license": "MIT",
   "type": "commonjs",
   "main": "dist/src/index.js",
@@ -29,12 +39,5 @@
   "devDependencies": {
     "axios-mock-adapter": "^1.21.4",
     "tsc-alias": "^1.7.0"
-  },
-  "keywords": [
-    "conductor",
-    "qbd",
-    "qbwc",
-    "qbxml",
-    "quickbooks desktop"
-  ]
+  }
 }