comprodls-sdk 2.90.3-development → 2.91.0-thor

package/lib/services/drive/index.js

@@ -23,10 +23,6 @@
  * Functions for calling Drive-service API.
  ************************************************************/
 
-/*********************************
- * Setting Up Module Entry Point
- **********************************/
-
 var q = require('q');
 var request = require('superagent');
 var Agent = require('agentkeepalive');
@@ -54,14 +50,10 @@ function documents() {
   };
 }
 
-/*
-  options = {
-    accountid : 'string', //mandatory
-    extuserid : 'string', //mandatory
-    documentid : 'string', //mandatory
-    folderid: 'string',  //mandatory
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/24_DRIVE-Adapter#getaparticulardocumentparams
+ */
 function getAParticularDocument(options) {
   var self = this;
   var dfd = q.defer();
@@ -99,18 +91,10 @@ function getAParticularDocument(options) {
   return dfd.promise;
 }
 
-/*
-  options = {
-    accountid: 'string', //mandatory
-    extuserid: 'string', //mandatory
-    folderid: 'string',  //mandatory
-    classid: 'string',
-    productcode: 'string',
-    assigned_path_id: 'string',
-    item-code: 'string',
-    cursor: 'string'
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/24_DRIVE-Adapter#getalldocumentsinafolderparams
+ */
 function getAllDocumentsInAFolder(options) {
   var self = this;
   var dfd = q.defer();
@@ -152,31 +136,10 @@ function getAllDocumentsInAFolder(options) {
   return dfd.promise;
 }
 
-/*
-  options = {
-    accountid: 'string',          // mandatory
-    extuserid: 'string',          // mandatory
-    body: {                       // mandatory
-      orgid: 'string',            // mandatory
-      classid: 'string',
-      productcode: 'string',      // mandatory
-      dls_user_id: 'string',      // mandatory
-      collaborator_id: 'string'   // optional; mandatory if some OTHER user is updating this document.
-      entities: [                 // mandatory (Min length 1)
-        {
-          item_code: 'string',
-          folderid: 'string',     // mandatory
-          documentid: 'string',   // mandatory
-          tag: 'string',
-          timestamp: <epoch>,     // mandatory
-          ttl: <number>,          // optional, default - 3 months
-          data: {}                // mandatory, state JSON
-        },
-        ...
-      ]
-    }
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/24_DRIVE-Adapter#createmultipledocumentsparams
+ */
 function createMultipleDocuments(options) {
   var self = this;
   var dfd = q.defer();
@@ -216,25 +179,10 @@ function createMultipleDocuments(options) {
   return dfd.promise;
 }
 
-/*
-  options = {
-    accountid: 'string',          // mandatory
-    extuserid: 'string',          // mandatory
-    body: {                       // mandatory
-      collaborator_id: 'string'   // optional; mandatory if some OTHER user is updating this document.
-      entities: [                 // mandatory (Min length 1)
-        {
-          folderid: 'string',     // mandatory
-          documentid: 'string',   // mandatory
-          timestamp: <epoch>,     // mandatory
-          ttl: <number>,
-          data: {}
-        },
-        ...
-      ]
-    }
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/24_DRIVE-Adapter#updatemultipledocumentsparams
+ */
 function updateMultipleDocuments(options) {
   // Initializing promise
   var deferred = q.defer();
@@ -277,21 +225,10 @@ function updateMultipleDocuments(options) {
   return deferred.promise;
 }
 
-/*
-  options = {
-    accountid: 'string',        // mandatory
-    extuserid: 'string',        // mandatory
-    body: {                     // mandatory
-      entities: [               // mandatory (Min length 1)
-        {
-          folderid: 'string',   // mandatory
-          documentid: 'string', // mandatory
-        },
-        ...
-      ]
-    }
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/24_DRIVE-Adapter#deletemultipledocumentsparams
+ */
 function deleteMultipleDocuments(options) {
   var self = this;
   var dfd = q.defer();

package/lib/services/integrations/index.js

@@ -32,9 +32,6 @@ var converter = require('../../helpers/lib/api/converter');
 
 var DLSError = helpers.errors.DLSError;
 
-/*********************************
- * Setting Up Module Entry Point
- **********************************/
 module.exports = integrations;
 
 var keepaliveAgent = new Agent({
@@ -44,22 +41,22 @@ var keepaliveAgent = new Agent({
 
 //Integrations Adaptor Constructor
 function integrations(accountId) {
-    this.accountId = accountId;
+  this.accountId = accountId;
   return {
-      getGetStreamCredentials: getGetStreamCredentials.bind(this),
-      queryDataFromSearch: queryDataFromSearch.bind(this),
-      getAuditTrailForAttempts: getAuditTrailForAttempts.bind(this),
-      getAuditTrailForEntitlements: getAuditTrailForEntitlements.bind(this),
-      getAuditTrailForMicroEntitlements: getAuditTrailForMicroEntitlements.bind(this),
-      publishCustomEvents: publishCustomEvents.bind(this),
-      createSchedule: createSchedule.bind(this),
-      getSchedule: getSchedule.bind(this),
-      updateSchedule: updateSchedule.bind(this),
-      deleteSchedule: deleteSchedule.bind(this)
+    getGetStreamCredentials: getGetStreamCredentials.bind(this),
+    queryDataFromSearch: queryDataFromSearch.bind(this),
+    getAuditTrailForAttempts: getAuditTrailForAttempts.bind(this),
+    getAuditTrailForEntitlements: getAuditTrailForEntitlements.bind(this),
+    getAuditTrailForMicroEntitlements: getAuditTrailForMicroEntitlements.bind(this),
+    publishCustomEvents: publishCustomEvents.bind(this),
+    createSchedule: createSchedule.bind(this),
+    getSchedule: getSchedule.bind(this),
+    updateSchedule: updateSchedule.bind(this),
+    deleteSchedule: deleteSchedule.bind(this)
   };
 }
 
-//params: NONE
+/** params: NONE */
 function getGetStreamCredentials() {
   var self = this;
   var dfd = q.defer(), err;
@@ -77,20 +74,18 @@ function getGetStreamCredentials() {
 
   requestAPI.end(function (error, response) {
     if(error) {
-        err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
-        dfd.reject(err);
+      err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
+      dfd.reject(err);
     }
     else {  dfd.resolve(response); }
   });
   return dfd.promise;
 }
 
-/*
-  options = {
-  index: 'string', //mandatory
-  query: 'string' //mandatory
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#querydatafromsearchparams
+ */
 function queryDataFromSearch(options) {
   var self = this;
   var dfd = q.defer();
@@ -131,17 +126,10 @@ function queryDataFromSearch(options) {
   return dfd.promise;
 }
 
-/*
-options = {
-  accountid: 'string',
-  action: 'string',
-  userid: 'string',
-  productcode: 'string',
-  item-code: 'string',
-  sortOrder: 'asc/desc', // optional
-  cursor: 'string'
-}
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#getaudittrailforattemptsparams
+ */
 function getAuditTrailForAttempts(options) {
   var self = this;
   var dfd = q.defer();
@@ -186,16 +174,10 @@ function getAuditTrailForAttempts(options) {
   return dfd.promise;
 }
 
-/*
-options = {
-  accountid: 'string',
-  action: 'string',
-  userid: 'string',
-  productcode: 'string',
-  sortOrder: 'asc/desc', // optional
-  cursor: 'string'
-}
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#getaudittrailforentitlementsparams
+ */
 function getAuditTrailForEntitlements(options) {
   var self = this;
   var dfd = q.defer();
@@ -241,17 +223,10 @@ function getAuditTrailForEntitlements(options) {
   return dfd.promise;
 }
 
-/*
-options = {
-  accountid: 'string',
-  action: 'string',
-  userid: 'string',
-  productcode: 'string',
-  sortOrder: 'asc/desc', // optional
-  context: 'string',
-  cursor: 'string'
-}
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#getaudittrailformicroentitlementsparams
+ */
 function getAuditTrailForMicroEntitlements(options) {
   var self = this;
   var dfd = q.defer();
@@ -298,17 +273,8 @@ function getAuditTrailForMicroEntitlements(options) {
 }
 
 /**
- * Publish custom events and send push notifications
- * @param {
- *   *events: [{
- *     *ext_actor_id: 'string',
- *     *category: "string",
- *     *action: 'string',
- *     *data: {...},
- *     push: <boolean, default: false
- *     ref_id: 'string'
- *   }, ...]
- * } options
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#publishcustomeventsparams
  */
 function publishCustomEvents(options) {
   var deferred = q.defer();
@@ -345,24 +311,10 @@ function publishCustomEvents(options) {
   return deferred.promise;
 }
 
-/*
-  options = {
-    accountid: "string", //mandatory
-    context: "string", //mandatory
-    body: {
-        "scheduleid": "",  //mandatory
-        "orgid": "",  // optional
-        "actorid": "",  //mandatory
-        "classid": "",  // optional
-        "assigned_path_id": "",  // optional
-        "productcode": "",  // optional
-        "userid": "", // optional
-        "category": "", //mandatory
-        "data": {}, // optional
-        "schedule_time" : ""  //mandatory
-    }
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#createscheduleparams
+ */
 function createSchedule(options) {
   var deferred = q.defer();
   // Initializing promise
@@ -401,15 +353,10 @@ function createSchedule(options) {
   return deferred.promise;
 }
 
-/*
-  options = {
-    accountid: "string", //mandatory
-    context: "string", //mandatory
-    category: "string", //optional
-    scheduleid: "string", //optional
-    cursor: "string"  //optional
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#getscheduleparams
+ */
 function getSchedule(options) {
   var deferred = q.defer();
   // Initializing promise
@@ -447,25 +394,10 @@ function getSchedule(options) {
   return deferred.promise;
 }
 
-
-/*
-  options = {
-    accountid: "string", //mandatory
-    context: "string", //mandatory
-    scheduleid: "string", //mandatory
-    body: {
-        "schedule_time" : "",  // optional
-        "category": "", //mandatory
-        "orgid": "",  // optional
-        "actorid": "",  //mandatory
-        "userid": "", // optional
-        "classid": "",  // optional
-        "assigned_path_id": "",  // optional
-        "productcode": "",  // optional
-        "data": {} // optional
-    }
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#updatescheduleparams
+ */
 function updateSchedule(options) {
   var deferred = q.defer();
   // Initializing promise
@@ -495,7 +427,7 @@ function updateSchedule(options) {
     });
   } else {
     err = {};
-    err.message = err.description = 'Mandatory param - accountid or context or scheduleid or ' + 
+    err.message = err.description = 'Mandatory param - accountid or context or scheduleid or ' +
                                     'body(category or actorid) not found in request options.';
     err = new DLSError(helpers.errors.ERROR_TYPES.SDK_ERROR, err);
     deferred.reject(err);
@@ -504,17 +436,10 @@ function updateSchedule(options) {
   return deferred.promise;
 }
 
-/*
-  options = {
-    accountid: "string",  //mandatory
-    context: "string",    //mandatory
-    scheduleid: "string", //mandatory
-    body: {
-        "category": "",   //mandatory
-        "actorid": "",    //mandatory
-    }
-  }
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/22_Integrations-Adapter#deletescheduleparams
+ */
 function deleteSchedule(options) {
   var deferred = q.defer();
   // Initializing promise
@@ -534,7 +459,7 @@ function deleteSchedule(options) {
     if (self.traceid) { requestAPI.set('X-Amzn-Trace-Id', self.traceid); }
 
     requestAPI
-      .agent(keepaliveAgent)  
+      .agent(keepaliveAgent)
       .end(function (error, response) {
         if (error) {
           err = new DLSError(helpers.errors.ERROR_TYPES.API_ERROR, error);
@@ -545,7 +470,7 @@ function deleteSchedule(options) {
       });
   } else {
     err = {};
-    err.message = err.description = 'Mandatory param - accountid or context or scheduleid or ' + 
+    err.message = err.description = 'Mandatory param - accountid or context or scheduleid or ' +
                                     'body not found in request options.';
     err = new DLSError(helpers.errors.ERROR_TYPES.SDK_ERROR, err);
     deferred.reject(err);

package/lib/services/invitations/index.js

@@ -25,19 +25,13 @@
 
 var q = require('q');
 var request = require('superagent');
-
 var helpers = require('../../helpers');
-
 var DLSError = helpers.errors.DLSError;
 
-/*********************************
- * Setting Up Module Entry Point
- **********************************/
 module.exports = invitations;
 
 //Invitations Adaptor Constructor
 function invitations() {
-
   return {
     sendInvitations: sendInvitations.bind(this),
     getMultiInvitations: getMultiInvitations.bind(this),
@@ -47,35 +41,10 @@ function invitations() {
   };
 }
 
-/*options = {
-    context: 'string',  // required
-    created: 'string',  // required
-    space_title: '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',
-        userid: 'string',
-        ext_user_id: 'string',
-        first_name: 'string',  // required
-        last_name: 'string',   // required
-        ext_data: {},
-        rowId: 'string',       // required
-        role: 'string'        /// required
-      },...
-    ]
-  }*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/20_Invitations-Adapter#sendInvitationsparams
+ */
 function sendInvitations(options) {
   var self = this;
   var dfd = q.defer();
@@ -118,13 +87,10 @@ function sendInvitations(options) {
   return dfd.promise;
 }
 
-/* options = {
-   "context_id": "string", // required
-    "context" : "string", //context for invitation e.g. class_enrollment -required
-    "status" : "string", // ['pending','complete','revoke'] -required
-    "cursor" : "string", // optional
-  };
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/20_Invitations-Adapter#getmultiinvitationsparams
+ */
 function getMultiInvitations(options) {
   var self = this;
   // Initializing promise
@@ -171,12 +137,10 @@ function getMultiInvitations(options) {
   return dfd.promise;
 }
 
-/* options = {
-    "context_id": "string", //class id to be to be revoked invitation -required
-    "invitationid" : "string", //unique invitation id which is to be fetched -required
-    "context" : "string", //context for revoking invitation e.g. class_enrollment -required
-  };
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/20_Invitations-Adapter#revokesingleinvitationparams
+ */
 function revokeSingleInvitation(options) {
   var self = this;
   // Initializing promise
@@ -220,12 +184,10 @@ function revokeSingleInvitation(options) {
   return dfd.promise;
 }
 
-/* options= {
-   "context_id": "string", //class id tocomplete an invitation -required
-    "invitationid" : "string", //unique invitation id which is to be fetched -required
-    "context" : "string", //context of the invitation to be completed e.g. class_enrollment -required
-  };
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/20_Invitations-Adapter#completesingleinvitationparams
+ */
 function completeSingleInvitation(options) {
   var self = this;
   // Initializing promise
@@ -270,13 +232,10 @@ function completeSingleInvitation(options) {
   return dfd.promise;
 }
 
-/* options =  {
-    "context_id": "string", //class id to be resent invition -required
-    "invitationid" : "string", //unique invitation id which is to be fetched -required
-    "context" : "string", //context for the invitation to be resent e.g. class_enrollment -required
-    "space_title" : "string" //optional
-  };
-*/
+/**
+ * Wiki Link for SDK params
+ * https://github.com/comprodls/comprodls-sdk-js/wiki/20_Invitations-Adapter#resendsingleinvitationparams
+ */
 function resendSingleInvitation(options) {
   var self = this;
   // Initializing promise