Merge pull request watson-developer-cloud#278 from watson-developer-cloud/conversation-v1

Conversation v1

Author: nfriedly

README.md

@@ -23,6 +23,7 @@ APIs and SDKs that use cognitive computing to solve complex problems.
     * [Alchemy Data News](#alchemy-data-news)
     * [Authorization](#authorization)
     * [Concept Insights](#concept-insights)
+    * [Conversation](#conversation)
     * [Dialog](#dialog)
     * [Document Conversion](#document-conversion)
     * [Language Translator](#language-translator)
@@ -239,6 +240,34 @@ concept_insights.graphs.annotateText(params, function(err, res) {
 });
 ```
 
+### Conversation
+
+Use the [Conversation](http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/conversation.html) service to determine the intent of a message.
+
+Note: you must first create a workspace via Bluemix. See [the documentation](http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/doc/conversation/overview.shtml) for details.
+
+```js
+var watson = require('watson-developer-cloud');
+
+var conversation = watson.conversation({
+  username: '<username>',
+  password: '<password>',
+  version: 'v1',
+  version_date: '2016-07-01'
+});
+
+conversation.message({
+  input: 'What\'s the weather?',
+  workspace_id: '<workspace id>'
+ }, function(err, response) {
+     if (err) {
+       console.error(err);
+     } else {
+       console.log(JSON.stringify(response, null, 2));
+     }
+});
+```
+
 ### Dialog
 Use the Dialog service to list all the dialogs you have.
 
@@ -248,7 +277,8 @@ var watson = require('watson-developer-cloud');
 var dialog = watson.dialog({
   username: '<username>',
   password: '<password>',
-  version: 'v1'
+  version: 'v1',
+  version_date: '2015-12-01'
 });
 
 dialog.getDialogs({}, function (err, dialogs) {

services/conversation/v1-experimental.js

@@ -31,6 +31,11 @@ function Conversation(options) {
   if (typeof options.version_date === 'undefined') {
     throw new Error('Argument error: version_date was not specified, use 2016-05-19');
   }
+  
+  if (!options.silent) {
+    // eslint-disable-next-line no-console
+    console.warn(new Error("Watson Conversation v1-experimental is sunset as of 2016-08-01. Please upgrade to v1. Set {silent: true} to disable this message.").stack);
+  }
 
   // Default URL
   var serviceDefaults = {

services/conversation/v1.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright 2015 IBM Corp. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+var extend         = require('extend');
+var requestFactory = require('../../lib/requestwrapper');
+var pick           = require('object.pick');
+
+/**
+ *
+ * @param options
+ * @constructor
+ */
+function Conversation(options) {
+
+  // Check if 'version_date' was provided
+  if (typeof options.version_date === 'undefined') {
+    throw new Error('Argument error: version_date was not specified, use 2016-07-01');
+  }
+
+  // Default URL
+  var serviceDefaults = {
+    url: 'https://gateway.watsonplatform.net/conversation/api',
+    qs: {
+      version: options.version_date
+    }
+  };
+
+  // Replace default options with user provided
+  this._options = extend(serviceDefaults, options);
+}
+
+/**
+ * Returns a response to a user utterance.
+ * @param  {Object}   params   { workspace_id: '',  }
+ */
+Conversation.prototype.message = function(params, callback) {
+  params = params || {};
+
+  var parameters = {
+    options: {
+      url: '/v1/workspaces/{workspace_id}/message',
+      method: 'POST',
+      json: true,
+      body: pick(params, ['input', 'context']),
+      path: pick(params, ['workspace_id'])
+    },
+    requiredParams: ['workspace_id'],
+    defaultOptions: this._options
+  };
+  return requestFactory(parameters, callback);
+};
+
+module.exports = Conversation;

test/test.integration-all-services.js

@@ -86,7 +86,7 @@ describe('integration-all-services', function() {
   describe('functional_visual_recognition', function() {
 
     describe('v3', function() {
-      this.timeout(TWENTY_SECONDS);
+      this.timeout(THIRTY_SECONDS * 2);
       var visual_recognition = watson.visual_recognition(auth.visual_recognition.v3);
 
       it('should return error when invalid api_key', function(done) {