conductor-node 11.2.3 → 11.2.5

package/README.md

@@ -5,6 +5,52 @@ Execute _any_ read or write QuickBooks Desktop API through async TypeScript and
 <!-- markdownlint-disable MD033 -->
 <img src="https://user-images.githubusercontent.com/170023/213273732-83dd6881-0b36-4787-820b-bd55cdc8444f.jpg" alt="QuickBooks Desktop autocomplete" width="700"/>
 
+## Requirements
+
+1. A Conductor API key pair: one secret key, one publishable key. Please [email us](mailto:hello@conductor.is?subject=Conductor%20Beta) to join the private beta.
+2. Node.js v16 or later.
+
+## Installation
+
+```sh
+npm install conductor-node
+# or
+yarn add conductor-node
+```
+
+## Usage
+
+The full API reference is available [here](https://docs.conductor.is). The code below is a quickstart example.
+
+```ts
+import Conductor from "conductor-node";
+
+const conductor = new Conductor("{{YOUR_SECRET_KEY}}");
+
+async function main() {
+  // 1. Create a new EndUser.
+  const endUser = await conductor.endUsers.create({
+    sourceId: "{{UNIQUE_ID_FROM_YOUR_DB}}",
+    email: "{{END_USER_EMAIL}}",
+    name: "{{END_USER_NAME}}",
+  });
+  console.log("Save this EndUser ID to auth future requests:", endUser.id);
+
+  // 2. Create an AuthSession to establish the QuickBooks Desktop connection.
+  const authSession = await conductor.authSessions.create({
+    publishableKey: "{{YOUR_PUBLISHABLE_KEY}}",
+    endUserId: endUser.id,
+  });
+  console.log("Complete the QuickBooks Desktop auth:", authSession.authFlowUrl);
+
+  // 3. Get a list of all Customers from QuickBooks Desktop for this EndUser.
+  const qbdCustomers = await conductor.qbd.customers.query(endUser.id);
+  console.log("QuickBooks Desktop customers:", qbdCustomers);
+}
+
+main();
+```
+
 ## [Documentation 🚀](https://docs.conductor.is)
 
 1. [Get Started](https://docs.conductor.is/overview/get-started)

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "conductor-node",
-    "version": "11.2.3",
+    "version": "11.2.5",
     "description": "Easily integrate the entire QuickBooks Desktop API using fully-typed async TypeScript",
     "keywords": [
         "QuickBooks Desktop",
@@ -14,6 +14,8 @@
         "QBD"
     ],
     "homepage": "https://conductor.is",
+    "repository": "github:conductor-is/conductor-node",
+    "author": "Conductor <support@conductor.is>",
     "license": "MIT",
     "type": "commonjs",
     "main": "dist/src/index.js",

package/dist/src/index.d.ts

@@ -1,6 +1,6 @@
 import Client from "./Client";
 /**
- * TypeScript/ESM usage:
+ * ESM support:
  *   import Conductor from "conductor-node";
  *   import { ConductorIntegrationError } from "conductor-node";
  *   import type { QbdTypes } from "conductor-node";

package/dist/src/index.js

@@ -34,16 +34,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const Client_1 = __importDefault(require("./Client"));
 const ErrorModule = __importStar(require("./utils/error"));
 /**
- * TypeScript/ESM usage:
- *   import Conductor from "conductor-node";
- *   import { ConductorIntegrationError } from "conductor-node";
- *   import type { QbdTypes } from "conductor-node";
- */
-// eslint-disable-next-line unicorn/prefer-export-from -- `Client` must be the default export, which is impossible to define with `export from`.
-exports.default = Client_1.default;
-__exportStar(require("./utils/error"), exports);
-/**
- * CommonJS usage:
+ * CommonJS support:
  *   const Conductor = require("conductor-node");
  *   const { ConductorIntegrationError } = require("conductor-node");
  */
@@ -52,3 +43,15 @@ if (module.exports !== undefined) {
     // Extend `module.exports` with the exports from `ErrorModule`.
     Object.assign(module.exports, ErrorModule);
 }
+/**
+ * ESM support:
+ *   import Conductor from "conductor-node";
+ *   import { ConductorIntegrationError } from "conductor-node";
+ *   import type { QbdTypes } from "conductor-node";
+ */
+// eslint-disable-next-line unicorn/prefer-export-from -- `Client` must be the default export, which is impossible to define with `export from`.
+exports.default = Client_1.default;
+// Must come after `module.exports` above. Otherwise, it breaks the following in
+// JavaScript ESM:
+//   const { ConductorIntegrationError } = require("conductor-node");
+__exportStar(require("./utils/error"), exports);

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

@@ -19,7 +19,9 @@ export interface AuthSession {
      */
     readonly authFlowUrl: string;
     /**
-     * The time at which the AuthSession expires.
+     * The time at which the AuthSession expires. By default, this value is 30
+     * minutes from creation. You can extend this time by setting `linkExpiryMins`
+     * when creating the AuthSession.
      */
     readonly expiresAt: string;
     /**
@@ -40,8 +42,9 @@ export interface AuthSessionCreateInput {
      */
     readonly endUserId: string;
     /**
-     * The number of minutes after which the AuthSession will expire. If not
-     * provided, defaults to 30 minutes.
+     * The number of minutes after which the AuthSession will expire. Must be at
+     * least 15 minutes and no more than 7 days. If not provided, defaults to 30
+     * minutes.
      */
     readonly linkExpiryMins?: number;
     /**

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

@@ -6,7 +6,7 @@ export interface EndUser {
      */
     readonly id: string;
     /**
-     * Your end-user's unique ID in *your* database. Must be distinct from your
+     * Your end-user's unique ID in _your_ database. Must be distinct from your
      * other end-users.
      */
     readonly sourceId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-node",
-  "version": "11.2.3",
+  "version": "11.2.5",
   "description": "Easily integrate the entire QuickBooks Desktop API using fully-typed async TypeScript",
   "keywords": [
     "QuickBooks Desktop",
@@ -14,6 +14,8 @@
     "QBD"
   ],
   "homepage": "https://conductor.is",
+  "repository": "github:conductor-is/conductor-node",
+  "author": "Conductor <support@conductor.is>",
   "license": "MIT",
   "type": "commonjs",
   "main": "dist/src/index.js",