docs: add documentation for the global transaction id (watson-develop…

…er-cloud#1022)

* add code examples showing how to extract the ID

README.md

@@ -253,7 +253,7 @@ The SDK now returns the full HTTP response by default for each method.
 Here is an example of how to access the response headers for Watson Assistant:
 
 ```js
-const assistant = new watson.AssistantV1({
+const assistant = new AssistantV1({
 /* authenticator, version, url, etc... */
 });
 
@@ -262,11 +262,52 @@ assistant.message(params).then(
     console.log(response.headers);
   },
   err => {
-    console.log('error: ', err);
+    console.log(err);
+    /*
+      `err` is an Error object. It will always have a `message` field
+      and depending on the type of error, it may also have the following fields:
+      - body
+      - headers
+      - name
+      - code
+    */
   }
 );
 ```
 
+### Global Transaction ID
+Every SDK call returns a response with a transaction ID in the x-global-transaction-id header. This transaction ID is useful for troubleshooting and accessing relevant logs from your service instance.
+
+#### HTTP Example
+```js
+const assistant = new AssistantV1({
+/* authenticator, version, url, etc... */
+});
+
+assistant.message(params).then(
+  response => {
+    console.log(response.headers['x-global-transaction-id']);
+  },
+  err => {
+    console.log(err);
+  }
+);
+```
+
+#### WebSocket Example
+```js
+const speechToText = new SpeechToTextV1({
+/* authenticator, version, url, etc... */
+});
+const recognizeStream = recognizeUsingWebSocket(params);
+
+// getTransactionId returns a Promise that resolves to the ID
+recognizeStream.getTransactionId().then(
+  globalTransactionId => console.log(globalTransactionId),
+  err => console.log(err),
+);
+```
+
 ## Data collection opt-out
 
 By default, [all requests are logged](https://cloud.ibm.com/docs/services/watson/getting-started-logging.html). This can be disabled of by setting the `X-Watson-Learning-Opt-Out` header when creating the service instance:

scripts/report_integration_test.js

@@ -50,9 +50,7 @@ if (process.env.TRAVIS_PULL_REQUEST && process.env.TRAVIS_PULL_REQUEST !== 'fals
   // Send the result to the pull request if it is a pull request.
   axios
     .post(
-      `https://api.github.com/repos/${process.env.TRAVIS_REPO_SLUG}/issues/${
-        process.env.TRAVIS_PULL_REQUEST
-      }/comments`,
+      `https://api.github.com/repos/${process.env.TRAVIS_REPO_SLUG}/issues/${process.env.TRAVIS_PULL_REQUEST}/comments`,
       {
         body: body,
       },

test/integration/compare-comply.test.js

@@ -189,7 +189,7 @@ describe('compare comply integration', () => {
         expect(result.feedback_data).toBeDefined();
         done();
       });
-    }, 15000);
+    }, 25000);
 
     test('getFeedback', done => {
       if (!feedbackId) {
@@ -214,7 +214,7 @@ describe('compare comply integration', () => {
         expect(result.feedback_data).toBeDefined();
         done();
       });
-    }, 10000);
+    }, 20000);
 
     test('listFeedback', done => {
       compareComply.listFeedback((err, res) => {

test/integration/speech-to-text.test.js

@@ -105,15 +105,12 @@ describe('speech to text integration', () => {
     function waitUntilReady(test) {
       return done => {
         jest.setTimeout(TWO_MINUTES);
-        speechToText.whenCustomizationReady(
-          { customizationId, interval: 250, times: 400 },
-          err => {
-            if (err && err.code !== SpeechToTextV1.ERR_NO_CORPORA) {
-              return done(err);
-            }
-            test(done);
+        speechToText.whenCustomizationReady({ customizationId, interval: 250, times: 400 }, err => {
+          if (err && err.code !== SpeechToTextV1.ERR_NO_CORPORA) {
+            return done(err);
           }
-        );
+          test(done);
+        });
       };
     }