Merge branch 'master' of https://github.com/docusign/code-examples-node-private

Author: nianiB9

README.md

@@ -6,6 +6,14 @@
 >
 ### GitHub repo: [code-examples-node](./README.md)
 
+If you downloaded this project using the [Quickstart](https://developers.docusign.com/docs/esign-rest-api/quickstart/) tool, it may be configured in one of three ways:
+
+* **[JWT Grant remote signing example](#jwt-grant-remote-signing-example)**–demonstrates how to implement JSON Web Token authentication. It includes a single remote signing workflow.
+* **[Authorization Code Grant embedded signing example](#authorization-code-grant-embedded-signing-example)**–demonstrates how to implement Authorization Code Grant authentication. It includes a single embedded signing workflow.
+* **[Multiple code examples, Authorization Code Grant and JWT Grant](#installation-steps)**–includes the full range of examples and authentication types.
+
+***Installation and running instructions vary depending on the configuration. Follow the link that matches your project type to get started.***
+
 This GitHub repo includes code examples for the [Web Forms API](https://developers.docusign.com/docs/web-forms-api/), [Click API](https://developers.docusign.com/docs/click-api/), [eSignature REST API](https://developers.docusign.com/docs/esign-rest-api/), [Monitor API](https://developers.docusign.com/docs/monitor-api/), and [Rooms API](https://developers.docusign.com/docs/rooms-api/). 
 
 ## Introduction
@@ -133,6 +141,24 @@ Also, in order to select JSON Web Token authentication in the launcher, in confi
 ## JWT grant remote signing and Authorization Code Grant embedded signing projects
 See [Docusign Quickstart overview](https://developers.docusign.com/docs/esign-rest-api/quickstart/overview/) on the Docusign Developer Center for more information on how to run the JWT grant remote signing project and the Authorization Code Grant embedded signing project.
 
+### Authorization Code Grant embedded signing example:
+Run in Git Bash:
+```
+$ cd <Quickstart folder>/quick_acg
+$ npm install
+$ npm start
+```
+
+Open a browser to http://localhost:3000
+
+### JWT grant remote signing example:
+Run in Windows Command Prompt (CMD):
+```
+$ cd <Quickstart folder>/jwt_console_project
+$ npm install
+$ npm start
+```
+
 ## Payments code example
 
 To use the payments code example, create a test payment gateway on the [Payments](https://admindemo.docusign.com/authenticate?goTo=payments) page in your developer account. See [Configure a payment gateway](./PAYMENTS_INSTALLATION.md) for details.

config/appsettings.example.json

@@ -30,5 +30,6 @@
   "adminAPIUrl": "https://api-d.docusign.net/management",
   "monitorApiUrl": "https://lens-d.docusign.net",
   "webformsApiUrl": "https://apps-d.docusign.com/api/webforms/v1.1",
+  "iamBasePath": "https://api-d.docusign.com/v1",
   "codeExamplesManifest": "https://raw.githubusercontent.com/docusign/code-examples-csharp/master/manifest/CodeExamplesManifest.json"
 }

index.js

@@ -59,6 +59,8 @@ const { eg001connect } = require('./lib/connect/controllers');
 const { eg001webforms } = require('./lib/webforms/controllers');
 const { eg004notary } = require('./lib/notary/controllers');
 const { eg001fields } = require('./lib/connectedFields/controllers');
+const { eg001Navigator, eg002Navigator } = require('./lib/navigator/controllers');
+const { eg001maestro, eg002maestro, eg003maestro, eg004maestro } = require('./lib/maestro/controllers');
 
 const PORT = process.env.PORT || 3000;
 const HOST = process.env.HOST || 'localhost';
@@ -293,6 +295,20 @@ app.get('/neg004', eg004notary.getController)
 app.get('/feg001', eg001fields.getController)
   .post('/feg001', eg001fields.createController);
 
+app.get('/nav001', eg001Navigator.getController)
+  .post('/nav001', eg001Navigator.createController)
+  .get('/nav002', eg002Navigator.getController)
+  .post('/nav002', eg002Navigator.createController);
+
+app.get('/mae001', eg001maestro.getController)
+  .post('/mae001', eg001maestro.createController)
+  .post('/mae001publish', eg001maestro.publishController)
+  .get('/mae002', eg002maestro.getController)
+  .post('/mae002', eg002maestro.createController)
+  .get('/mae003', eg003maestro.getController)
+  .post('/mae003', eg003maestro.createController)
+  .get('/mae004', eg004maestro.getController)
+  .post('/mae004', eg004maestro.createController);
 
 function dsLoginCB1(req, res, next) { req.dsAuthCodeGrant.oauth_callback1(req, res, next); }
 function dsLoginCB2(req, res, next) { req.dsAuthCodeGrant.oauth_callback2(req, res, next); }
@@ -347,6 +363,9 @@ const NOTARY_SCOPES = [
 const CONNECTED_FIELDS_SCOPES = [
   'signature', 'adm_store_unified_repo_read'
 ];
+const MAESTRO_SCOPES = [
+  'signature', 'aow_manage'
+];
 
 const scope = [
   ...ROOM_SCOPES,
@@ -357,6 +376,7 @@ const scope = [
   ...WEBFORMS_SCOPES,
   ...NOTARY_SCOPES,
   ...CONNECTED_FIELDS_SCOPES,
+  ...MAESTRO_SCOPES
 ];
 
 // Configure passport for DocusignStrategy

lib/connectedFields/controllers/eg001SetConnectedFields.js

@@ -5,7 +5,7 @@
  */
 
 const path = require('path');
-const { getTabGroups, sendEnvelope, extractVerificationData } = require('../examples/setConnectedFields');
+const { getTabGroups, sendEnvelope, filterData } = require('../examples/setConnectedFields');
 const validator = require('validator');
 const { getExampleByNumber } = require('../../manifestService');
 const dsConfig = require('../../../config/index.js').config;
@@ -40,12 +40,13 @@ eg001SetConnectedFields.createController = async (req, res) => {
   // Step 2. Call the worker method
   const { body } = req;
   const selectedAppId = validator.escape(body.appId);
-  const verificationData = extractVerificationData(selectedAppId, req.session.apps);
+  const selectedApp = req.session.apps.find(app => app.appId === selectedAppId);
   const envelopeArgs = {
     signerEmail: validator.escape(body.signerEmail),
     signerName: validator.escape(body.signerName),
     docFile: path.resolve(demoDocsPath, pdfFile),
-    verificationData
+    appId: selectedAppId,
+    app: selectedApp,
   };
   const args = {
     accessToken: req.user.accessToken,
@@ -93,19 +94,18 @@ eg001SetConnectedFields.createController = async (req, res) => {
 
   const args = {
     accessToken: req.user.accessToken,
-    basePath: 'https://api-d.docusign.com',
+    basePath: dsConfig.iamBasePath,
     accountId: req.session.accountId,
   };
-  const tabGroups = await getTabGroups(args);
+  let tabGroups = await getTabGroups(args);
+  tabGroups = filterData(tabGroups);
 
   const example = getExampleByNumber(res.locals.manifest, exampleNumber, api);
   if (tabGroups.length === 0) {
-    const additionalPageData = example.AdditionalPage.filter(p => p.Name === 'no_verification_app')[0];
-
-    return res.render('pages/example_done', {
-      title: example.ExampleName,
-      message: additionalPageData?.ResultsPageText,
-    });
+    const errorCode = '404';
+    const errorMessage = 'No data verification extension apps found';
+    const errorInfo = example.CustomErrorTexts[0].ErrorMessage;
+    return res.render('pages/error', { errorCode, errorMessage, errorInfo });
   }
   req.session.apps = tabGroups;