comprodls-sdk 2.16.0 → 2.19.1

package/lib/config/index.js

@@ -197,6 +197,7 @@ exports.AUTH_API_URLS = {
     getInvitationsByEmail: '/accounts/{accountid}/invitations-by-email',
     generateSpaceCode: '/accounts/{accountid}/space-code/generate',
     changeSpaceCode: '/accounts/{accountid}/space-code/{spacecode}/change',
+    updateInstituteTitle: '/accounts/{accountId}/institute-spaces/{instituteSpaceCode}',
 
     //Superuser related API
     getAllInstitutions: '/su/accounts/{accountid}/spaces',
@@ -304,7 +305,8 @@ exports.PRODUCT_API_URLS = {
 
 exports.XAPI_API_URLS = {
     postMultiStatements: '/{orgId}/statements/multi',
-    postExternalMultiStatements: '/{orgId}/external/statements/multi'
+    postExternalMultiStatements: '/{orgId}/external/statements/multi',
+    resetUserProductProgress: '/accounts/{accountId}/progress/user/product/reset'
 };
 
 exports.ATTEMPTS_API_URLS = {

package/lib/services/analytics/index.js

@@ -29,12 +29,18 @@
 
 var q = require('q');
 var request = require('superagent');
+var Agent = require('agentkeepalive');
 
 var helpers = require('../../helpers');
 var DLSError = helpers.errors.DLSError;
 
 module.exports = analytics;
 
+var keepaliveAgent = new Agent({
+  timeout: 60000,
+  keepAliveTimeout: 30000
+});
+
 /*********************************
  * Public Function definitions
  **********************************/
@@ -1582,13 +1588,15 @@ function getTimeseriesAnalytics(options) {
 
     if(self.traceid) { requestAPI.set('X-Amzn-Trace-Id', self.traceid); }
 
-    requestAPI.end(function (error, response) {
-      if(error) {
-        err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
-        dfd.reject(err);
-      }
-      else { dfd.resolve(response.body); }
-    });
+    requestAPI
+      .agent(keepaliveAgent)
+      .end(function (error, response) {
+        if(error) {
+          err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
+          dfd.reject(err);
+        }
+        else { dfd.resolve(response.body); }
+      });
   }
   else {
     err = {};

package/lib/services/auth/index.js

@@ -25,6 +25,7 @@
 
 var q = require('q');
 var request = require('superagent');
+var Agent = require('agentkeepalive');
 
 var helpers = require('../../helpers');
 var converter = require('../../helpers/lib/api/converter');
@@ -35,6 +36,12 @@ var DLSError = helpers.errors.DLSError;
  * Setting Up Module Entry Point  
  **********************************/
 module.exports = auth;
+
+var keepaliveAgent = new Agent({
+  timeout: 60000,
+  keepAliveTimeout: 30000
+});
+
 //Auth Adaptor Contsructor
 function auth() {
   return {
@@ -491,16 +498,18 @@ function getClassUsers(options) {
       requestAPI = helpers.api.setupAPIToken(requestAPI, self.token);
 
       // Call GET ALL USER Api
-      requestAPI.end(function(err, response) {
-        if(err) {
-          err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, err);
-          dfd.reject(err);
-        }
-        else {
-          response.body.entities = converter.convertEnrollmetsResponse({data: response.body.entities}) ;
-          dfd.resolve(response.body);
-        }
-      });
+      requestAPI
+        .agent(keepaliveAgent)
+        .end(function(err, response) {
+          if(err) {
+            err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, err);
+            dfd.reject(err);
+          }
+          else {
+            response.body.entities = converter.convertEnrollmetsResponse({data: response.body.entities}) ;
+            dfd.resolve(response.body);
+          }
+        });
     } else {
       err = {};
       err.message = err.description = 'Required parameter classid is not defined.';
@@ -909,14 +918,16 @@ function getParticularClass(options) {
             //Setup token in Authorization header
             requestAPI = helpers.api.setupAPIToken(requestAPI, self.token);
 
-            requestAPI.end(function(err, response) {
-                if(err) {
-                    err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, err);
-                    dfd.reject(err);
-                } else {
-                  dfd.resolve(response.body);
-                }
-            });
+            requestAPI
+              .agent(keepaliveAgent)
+              .end(function(err, response) {
+                  if(err) {
+                      err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, err);
+                      dfd.reject(err);
+                  } else {
+                    dfd.resolve(response.body);
+                  }
+              });
         } else {
             err = {};
             err.message = err.description = 'classId not found in request options.';
@@ -1314,6 +1325,7 @@ function enrollUsertoClass(options) {
 
 //options = {
 //    classid: '', //Class Id
+//    classrole: ''
 //};
 function enrollSelftoClass(options) {
   var self = this;
@@ -1334,8 +1346,13 @@ function enrollSelftoClass(options) {
         classId: options.classid
       });
 
+      var params = { classrole: options.classrole };
       //Setup request with URL and Params
-      var requestAPI = request.post(url);
+      var requestAPI = request.post(url)
+                              .set('Content-Type', 'application/json')
+                              .set('Accept', 'application/json')
+                              .send(params);
+
       if(self.traceid) { requestAPI.set('X-Amzn-Trace-Id', self.traceid); }
 
       //Setup token in Authorization header
@@ -1538,8 +1555,9 @@ function encodeURLParameter(options) {
  * title: 'class title',
  * startdate: 'Epoch(Unix) timestamp in milliseconds',
  * enddate: 'Epoch(Unix) timestamp in milliseconds',
- * description: ''                          // Optional field
- * class_ownership: 'STRICT' / 'NO_OWNER'   // Default - STRICT, Optional field
+ * description: '',                          // Optional field
+ * class_ownership: 'STRICT' / 'NO_OWNER',   // Default - STRICT, Optional field
+ * ext_data: {}                              // Optional
  * }
  */
 function createClass(options) {
@@ -1599,7 +1617,8 @@ function createClass(options) {
 //    title: 'class title', //Optional field
 //    startdate: 'Epoch(Unix) timestamp in milliseconds', //Optional field
 //    enddate: 'Epoch(Unix) timestamp in milliseconds', //Optional field
-//    description: ''    //Optional field
+//    description: '',    //Optional field
+//    ext_data: ''        //Optional field
 //}
 function updateClass(options) {
     var self = this;
@@ -1650,13 +1669,14 @@ function updateClass(options) {
 /** options =
  *{
   "space_title": "string",
-  "classes": [ 
+  "classes": [
     {
       "title": "class tiltle",
       "startdate": 'Epoch(Unix) timestamp in milliseconds',
       "enddate": 'Epoch(Unix) timestamp in milliseconds',
       "rowId": 'string with max limit 3 characters,
       "description": "string",
+      "ext_data": {},                    // optional
       "model": "STRICT",
       "owner": {
         "userid": "string" //Mandatory if model is 'STRICT'

package/lib/services/invitations/index.js

@@ -51,9 +51,18 @@ function invitations() {
     context: 'string',  // required
     created: 'string',  // required
     space_title: 'string',
-    class_enrollment: { classid: 'string },
+    class_enrollment: {
+      classid: 'string',       // required. Correlated with context
+      class_role: 'string',    // optional
+      inviter_email: 'string'  // optional
+    },
     invitation_data: [
       {
+        class_enrollment  : {       // optional, will override the outer context
+          classid: 'string'         // required. Correlated with context
+          class_role: 'string',     // optional
+          inviter_email: 'string'   // optional
+        },
         email: 'string',   // required
         dls_account_status: 'string',
         ext_account_status: 'string',
@@ -61,6 +70,7 @@ function invitations() {
         ext_user_id: 'string',
         first_name: 'string',  // required
         last_name: 'string',   // required
+        ext_data: {},
         rowId: 'string',       // required
         role: 'string'        /// required
       },...

package/lib/services/spaces/index.js

@@ -57,7 +57,8 @@ function spaces(accountId) {
     getExtProduct: getExtProduct.bind(this),
     getSpaceDetails: getSpaceDetails.bind(this),
     updateUserInformation: updateUserInformation.bind(this),
-    getInvitationsByEmail: getInvitationsByEmail.bind(this)
+    getInvitationsByEmail: getInvitationsByEmail.bind(this),
+    updateInstituteTitle: updateInstituteTitle.bind(this)
   };
 }
 
@@ -512,6 +513,7 @@ function provisionBulkSpaces(options) {
  * "ext_class_meta" :
  *  {
  *    "description": "string",
+ *    "ext_data": {},
  *    "title": "string",       // mandatory
  *    "startdate": <epoch>,   // mandatory
  *    "enddate": <epoch>      // mandatory
@@ -985,3 +987,49 @@ function getInvitationsByEmail(options) {
 	}
 	return dfd.promise;
 }
+
+/**
+ * This API is used to update an institute's space title
+ * options = {
+ *   space_code: "",       // Mandatory, space code of institute whose title is to be updated
+ *   body : {
+ *     ext_actor_id: "",   // Mandatory
+ *     data: {
+ *       space_title: ""
+ *     }
+ *   }
+ * }
+ */
+function updateInstituteTitle(options){
+  var self = this;
+  // Initializing promise
+  var dfd = q.defer();
+  var err = {};
+  if (options && options.space_code && options.body && options.body.ext_actor_id ) {
+    // Passed all validations, Contruct API url
+    var url = self.config.DEFAULT_HOSTS.AUTH + self.config.AUTH_API_URLS.updateInstituteTitle;
+    url = helpers.api.constructAPIUrl(url,
+      { accountId: self.accountId, instituteSpaceCode: options.space_code });
+
+    // Setup request with URL and Params
+    var requestAPI = request.put(url)
+                    .set('Content-Type', 'application/json')
+                    .set('Accept', 'application/json')
+                    .send(options.body);
+    if (self.traceid) { requestAPI.set('X-Amzn-Trace-Id', self.traceid); }
+
+    requestAPI.end(function (error, response) {
+      if (error) {
+        err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
+        dfd.reject(err);
+      }
+      else { dfd.resolve(response.body); }
+    });
+  }
+  else {
+    err.message = err.description = 'space_code or ext_actor_id not found in request options.';
+    err = new DLSError(helpers.errors.ERROR_TYPES.SDK_ERROR, err);
+    dfd.reject(err);
+  }
+  return dfd.promise;
+}

package/lib/services/xapi/index.js

@@ -38,10 +38,12 @@ module.exports = xapi;
 /*********************************
  * Public Function definitions
  **********************************/
-function xapi() {
+function xapi(accountId) {
+  this.accountId = accountId;
   return {
     postStatement: postStatements.bind(this),
-    postExternalStatements: postExternalStatements.bind(this)
+    postExternalStatements: postExternalStatements.bind(this),
+    resetUserProductProgress: resetUserProductProgress.bind(this)
   };
 }
 
@@ -230,3 +232,44 @@ function postExternalStatements(options) {
   });
   return dfd.promise;
 }
+
+/*options = {
+    userid: 'string',
+    productcode: 'string',
+    actorid: 'string'
+}*/
+function resetUserProductProgress(options) {
+  var self = this;
+  // Initializing promise
+  var dfd = q.defer();
+  var err = {};
+  if(options && options.userid && options.productcode && options.actorid) {
+
+    // Passed all validations, Contruct API url
+    var url = self.config.DEFAULT_HOSTS.XAPI + self.config.XAPI_API_URLS.resetUserProductProgress;
+    url = helpers.api.constructAPIUrl(url, { accountId : self.accountId });
+
+    // Setup request with URL and Params
+    var requestAPI = request.delete(url)
+                    .set('Content-Type', 'application/json')
+                    .set('Accept', 'application/json')
+                    .send(options);
+
+    if(self.traceid) { requestAPI.set('X-Amzn-Trace-Id', self.traceid); }
+
+    requestAPI.end(function(error, response) {
+      if(error) {
+        err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
+        dfd.reject(err);
+      }
+      else { dfd.resolve(response.body); }
+    });
+  }
+  else {
+    err.message = err.description = 'userid, productcode or actorid not found in request options.';
+    err = new DLSError(helpers.errors.ERROR_TYPES.SDK_ERROR, err);
+    dfd.reject(err);
+  }
+
+  return dfd.promise;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "comprodls-sdk",
   "description": "comproDLS SDK for JavaScript",
-  "version": "2.16.0",
+  "version": "2.19.1",
   "author": {
     "name": "Compro Technologies Private Limited",
     "url": "http://www.comprotechnologies.com/"
@@ -20,7 +20,8 @@
     "tincanjs": "^0.50.0",
     "underscore": "1.8.3",
     "validate.js": "^0.9.0",
-    "pubnub": "4.24.2"
+    "pubnub": "4.24.2",
+    "agentkeepalive": "4.2.0"
   },
   "devDependencies": {
     "grunt": "^0.4.5",