quickblox 2.17.0-beta.1 → 2.17.0-beta.2

package/src/modules/qbAI.js

@@ -12,7 +12,6 @@ function AIProxy(service) {
  * @namespace QB.ai
  **/
 AIProxy.prototype = {
-
     /**
      * Provides answer assistant functionality that helps users effortlessly send various answers considering({@link https://docs.quickblox.com/docs/js-sdk-ai-features#ai-assist-answer read more}).
      * @memberof QB.ai
@@ -24,8 +23,8 @@ AIProxy.prototype = {
      *  var history = [
      *                     {role: "user", message: "Hello"},
      *                     {role: "assistant", message: "Hi"}
-     *                 ];
-     *   var messageToAssist = 'Where is my order?';
+     *                ];
+     *  var messageToAssist = 'Where is my order?';
      *  QB.ai.answerAssist(smartChatAssistantId, messageToAssist, history, callback);
      *  // or third parameters can be null
      *  QB.ai.answerAssist(smartChatAssistantId, messageToAssist, null, callback);
@@ -38,61 +37,36 @@ AIProxy.prototype = {
          * @param {String} [response.answer] - assist answer for message
          * @callback answerAssistCallback
          * */
+        if (!callback || typeof callback !== 'function') {
+            throw new Error('Callback function is required and must be a function');
+        }
         function validateHistory(history) {
             var AIRole = {
                 user: 'user',
                 assistant: 'assistant'
             };
-            //  throw new Error('The QB.addressbook.get accept callback function is required.');
-            // isArray, isCallback
             if (history !== null && history !== undefined) {
                 if (!Array.isArray(history)) {
-                    Utils.safeCallbackCall(callback, {
-                        code: 400,
-                        message: 'History must be an array'
-                    });
-                    return false;
+                    throw new Error('History must be an array');
                 }
-
                 for (var i = 0; i < history.length; i++) {
                     var item = history[i];
                     if (typeof item !== 'object' || item === null || Array.isArray(item)) {
-                        Utils.safeCallbackCall(callback, {
-                            code: 400,
-                            message: 'Each element of history must be an object'
-                        });
-                        return false;
+                        throw new Error('Each element of history must be an object');
                     }
-
                     if (!('role' in item) || !('message' in item)) {
-                        Utils.safeCallbackCall(callback, {
-                            code: 400,
-                            message: 'Each element of history must have an role and message fields'
-                        });
-                        return false;
+                        throw new Error('Each element of history must have an role and message fields');
                     }
-
                     if (!(item.role === AIRole.user || item.role === AIRole.assistant)) {
-                        Utils.safeCallbackCall(callback, {
-                            code: 400,
-                            message: 'Invalid role in history item'
-                        });
-                        return false;
+                        throw new Error('Invalid role in history item');
                     }
-
                     if (typeof item.message !== 'string') {
-                        Utils.safeCallbackCall(callback, {
-                            code: 400,
-                            message: 'Message of history item must be a string'
-                        });
-                        return false;
+                        throw new Error('Message of history item must be a string');
                     }
                 }
             }
-
             return true;
         }
-
         if (!validateHistory(history)) {
             return;
         }
@@ -120,10 +94,11 @@ AIProxy.prototype = {
      * @memberof QB.ai
      * @param {String} smartChatAssistantId - Smart Chat Assistant id.
      * @param {String} text - Text to translate.
-     * @param {String} languageCode - Translation language code.
+     * @param {String} languageCode - Translation language code. All list see on page: {@link https://docs.quickblox.com/docs/js-sdk-ai-features#ai-translate }
      * @param {translateCallback} callback - The callback function.
+     *
      * */
-    //should add validation for callback as answerAssist + list of codes
+
     translate: function(smartChatAssistantId, text, languageCode, callback) {
         /**
          * Callback for QB.ai.translate().
@@ -131,7 +106,14 @@ AIProxy.prototype = {
          * @param {Object} response - The server response object.
          * @param {String} [response.answer] - translated message
          * @callback translateCallback
+         * @example
+         *  var textToTranslate = 'Hola!';
+         *  var languageCode = 'en';
+         *  QB.ai.translate(smartChatAssistantId, textToTranslate, languageCode, callback);
          * */
+        if (!callback || typeof callback !== 'function') {
+            throw new Error('Callback function is required and must be a function');
+        }
         var data =  {
             smart_chat_assistant_id: smartChatAssistantId,
             text: text,