@stackfactor/client-api 1.1.10 → 1.1.12-9.1

package/lib/security.ts

@@ -0,0 +1,99 @@
+import { client } from "./axiosClient.js";
+
+/**
+ * Get the enabled authentication connections for current organization.
+ * @param {String} authToken - Authorization token
+ * @returns {Promise<Object>}
+ */
+const getAuthConnections = (authToken: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const getConfigInformationRequest = client.get(
+      `api/v1/security/authconnections`,
+      { headers: { authorization: authToken } }
+    );
+    getConfigInformationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+/**
+ * Set the enabled authentication connections for current organization.
+ * @param {Object} data - the object containing the updated configuration
+ * @param {String} authToken - Authorization token
+ * @returns {Promise<Object>}
+ */
+const setAuthConnections = (
+  data: object,
+  authToken: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const setConfigInformationRequest = client.post(
+      `api/v1/security/authconnections`,
+      { data: data },
+      { headers: { authorization: authToken } }
+    );
+    setConfigInformationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+/**
+ * Reset the MFA for the user.
+ * @param {String} userId
+ * @param {String} authToken
+ * @returns {Promise<Object>}
+ */
+const resetMFA = (userId: string, authToken: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const resetMFARequest = client.post(
+      `api/v1/security/resetmfa`,
+      userId ? {} : { userId: userId },
+      { headers: { authorization: authToken } }
+    );
+    resetMFARequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+/**
+ * Synchronize the authentication connections with Auth0.
+ * @param {String} authToken
+ * @returns {Promise<Object>}
+ */
+const synchronizeWithAuth0 = (authToken: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const synchronizeRequest = client.get(
+      `api/v1/security/synchronizewithauth0`,
+      { headers: { authorization: authToken } }
+    );
+    synchronizeRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+export default {
+  getAuthConnections,
+  resetMFA,
+  setAuthConnections,
+  synchronizeWithAuth0,
+};

package/lib/{skill.js → skill.ts}

@@ -4,10 +4,10 @@ import { client } from "./axiosClient.js";
  * Create skill and set information
  * @param {Object} data
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const createSkill = (data, token) => {
-  return new Promise(function (resolve, reject) {
+const createSkill = (data: object, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.put(
       "api/v1/skills",
       { data: data },
@@ -27,12 +27,15 @@ export const createSkill = (data, token) => {
 
 /**
  * Create skills from templates
- * @param {Array<String>} templateIds,
+ * @param {Array<String>} templateIds
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const createSkillsFromTemplates = (templateIds, token) => {
-  return new Promise(function (resolve, reject) {
+const createSkillsFromTemplates = (
+  templateIds: string[],
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       templateIds: templateIds,
     };
@@ -58,11 +61,15 @@ export const createSkillsFromTemplates = (templateIds, token) => {
  * @param {String} id The id of the skill to be deleted
  * @param {String} comments The comments included with the deletion
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const deleteSkill = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    const data = {
+const deleteSkill = (
+  id: string,
+  comments: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const data: { id: string; comments?: string } = {
       id: id,
     };
     if (comments) data.comments = comments;
@@ -82,12 +89,12 @@ export const deleteSkill = (id, comments, token) => {
 
 /**
  * Discard the skill draft changes
- * @param {String} id The id of the skill to be deleted
+ * @param {String} id The id of the skill to be discarded
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const discardSkillChanges = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const discardSkillChanges = (id: string, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const data = {};
     const request = client.get(`api/v1/skills/discard/${id}`, {
       headers: { authorization: token },
@@ -105,16 +112,15 @@ export const discardSkillChanges = (id, token) => {
 
 /**
  * Get the list of imported skill templates
- * @param {String} token
- * @returns {Promise}
+ * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const getImportedSkillTemplates = (token) => {
-  return new Promise(function (resolve, reject) {
+const getImportedSkillTemplates = (token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const request = client.get(`api/v1/skills/getimportedskilltemplates`, {
       headers: { authorization: token },
     });
     request
-
       .then((response) => {
         resolve(response.data);
       })
@@ -127,13 +133,18 @@ export const getImportedSkillTemplates = (token) => {
 /**
  * Get the skill related roles
  * @param {String} id
- * @param {String} token
- * @returns {Promise}
+ * @param {String} token Authorization token
+ * @param {Boolean} includeRoleInformation
+ * @returns {Promise<Object>}
  */
-export const getSkillRelatedRoles = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const getSkillRelatedRoles = (
+  id: string,
+  token: string,
+  includeRoleInformation = false
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
-      `api/v1/skills/getskillrelatedroles/${id}`,
+      `api/v1/skills/getskillrelatedroles/${id}/${includeRoleInformation}`,
       {
         headers: { authorization: token },
       }
@@ -151,11 +162,14 @@ export const getSkillRelatedRoles = (id, token) => {
 /**
  * Get skill required assessment type
  * @param {String} id
- * @param {String} token
- * @returns {Promise}
+ * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const getSkillRequiredAssessmentType = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const getSkillRequiredAssessmentType = (
+  id: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/skills/getrequiredassessmenttype/${id}`,
       {
@@ -173,20 +187,20 @@ export const getSkillRequiredAssessmentType = (id, token) => {
 };
 
 /**
- * Get skill skill information
+ * Get skill information
  * @param {String} id The id of the skill
  * @param {String} version The version of the skill
  * @param {Boolean} returnNullIfVersionNotFound When true it will return null if the version is not found
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getSkillInformationById = (
-  id,
-  version,
-  returnNullIfVersionNotFound,
-  token
-) => {
-  return new Promise(function (resolve, reject) {
+const getSkillInformationById = (
+  id: string,
+  version: string,
+  returnNullIfVersionNotFound: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/skills/skill/${id}/${version}/${returnNullIfVersionNotFound}`,
       {
@@ -211,22 +225,23 @@ export const getSkillInformationById = (
  * @param {Boolean} returnDefaultIfVersionNotAvailable Return the default version if published not available
  * @param {Boolean} namesOnly Return only the names of the skills
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getSkillList = (
-  filter,
-  version,
-  includeDeleted,
-  returnDefaultIfVersionNotAvailable,
-  namesOnly,
-  token
-) => {
-  return new Promise(function (resolve, reject) {
+const getSkillList = (
+  filter: string[],
+  version: string,
+  includeDeleted: boolean,
+  returnDefaultIfVersionNotAvailable: boolean,
+  namesOnly: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       includeDeleted: includeDeleted,
       namesOnly: namesOnly,
       returnDefaultIfVersionNotAvailable: returnDefaultIfVersionNotAvailable,
       version: version,
+      filter: filter,
     };
     if (filter) requestData.filter = filter;
     let confirmationRequest = client.post(`api/v1/skills`, requestData, {
@@ -248,15 +263,15 @@ export const getSkillList = (
  * @param {Number} maxDepth How many levels down in the organization the skills will be loaded
  * @param {Boolean} returnNullIfVersionNotFound Return null if the version is not found
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getTeamSkillsById = (
-  teamId,
-  maxDepth,
-  returnNullIfVersionNotFound,
-  token
-) => {
-  return new Promise(function (resolve, reject) {
+const getTeamSkillsById = (
+  teamId: string,
+  maxDepth: number,
+  returnNullIfVersionNotFound: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/skills/getteambyid/${teamId}/${maxDepth}/${returnNullIfVersionNotFound}`,
       {
@@ -277,10 +292,13 @@ export const getTeamSkillsById = (
  * Get current user team skills
  * @param {Number} maxDepth How many levels down in the organization the skills will be loaded
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getCurrentUserTeamSkills = (maxDepth, token) => {
-  return new Promise(function (resolve, reject) {
+const getCurrentUserTeamSkills = (
+  maxDepth: number,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/skills/getcurrentuserteam/${maxDepth}`,
       {
@@ -300,11 +318,14 @@ export const getCurrentUserTeamSkills = (maxDepth, token) => {
 /**
  * Get skill template updates
  * @param {String} id The skill id
- * @param {String} token
- * @returns {Promise}
+ * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const getSkillTemplateUpdates = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const getSkillTemplateUpdates = (
+  id: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/skills/getskilltemplateupdates/${id}`,
       {
@@ -325,11 +346,15 @@ export const getSkillTemplateUpdates = (id, token) => {
  * Import skill templates
  * @param {Array<String>} data The list of role templates to be imported
  * @param {Boolean} publish If true the imported templates will be published
- * @param {String} token
- * @returns {Promise}
+ * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const importSkillTemplates = (data, publish, token) => {
-  return new Promise(function (resolve, reject) {
+const importSkillTemplates = (
+  data: string[],
+  publish: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
       publish: publish,
@@ -342,7 +367,6 @@ export const importSkillTemplates = (data, publish, token) => {
       }
     );
     confirmationRequest
-
       .then((response) => {
         resolve(response.data);
       })
@@ -357,11 +381,15 @@ export const importSkillTemplates = (data, publish, token) => {
  * @param {String} id The id of the skill to be published
  * @param {String} comments The comments to be include with the request
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const publishSkill = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    let data = {};
+const publishSkill = (
+  id: string,
+  comments: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    let data: { comments?: string } = {};
     if (comments) data.comments = comments;
     let confirmationRequest = client.post(`api/v1/skills/publish/${id}`, data, {
       headers: { authorization: token },
@@ -381,10 +409,14 @@ export const publishSkill = (id, comments, token) => {
  * @param {String} id The id of the skill to be updated
  * @param {Object} data Data used to update the skill
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const setSkillInformation = (id, data, token) => {
-  return new Promise(function (resolve, reject) {
+const setSkillInformation = (
+  id: string,
+  data: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
       id: id,
@@ -411,10 +443,14 @@ export const setSkillInformation = (id, data, token) => {
  * @param {String} id The id of the skill to be updated
  * @param {Object} data Data used to update the skill
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const setSkillInformationFromTemplate = (id, data, token) => {
-  return new Promise(function (resolve, reject) {
+const setSkillInformationFromTemplate = (
+  id: string,
+  data: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
       id: id,
@@ -440,10 +476,10 @@ export const setSkillInformationFromTemplate = (id, data, token) => {
  * Validate skill information
  * @param {String} id The id of the skill to be updated
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const validateSkill = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const validateSkill = (id: string, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       id: id,
     };
@@ -469,10 +505,14 @@ export const validateSkill = (id, token) => {
  * @param {String} id The id of the skill to be updated
  * @param {Boolean} watch Set to true or false
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const watchSkill = (id, watch, token) => {
-  return new Promise(function (resolve, reject) {
+const watchSkill = (
+  id: string,
+  watch: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       id: id,
       watch: watch,
@@ -490,7 +530,7 @@ export const watchSkill = (id, watch, token) => {
   });
 };
 
-const skill = {
+export default {
   createSkill,
   createSkillsFromTemplates,
   deleteSkill,
@@ -510,5 +550,3 @@ const skill = {
   validateSkill,
   watchSkill,
 };
-
-export default skill;

package/lib/{skillAssessments.js → skillAssessmentTestingSession.ts}

@@ -6,9 +6,15 @@ import { client } from "./axiosClient.js";
  * @param {Object} data
  * @param {String} comments
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const addEntry = (id, data, comments, token) => {
-  return new Promise(function (resolve, reject) {
+const addEntry = (
+  id: string,
+  data: object,
+  comments: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       comments: comments,
       data: data,
@@ -37,9 +43,15 @@ export const addEntry = (id, data, comments, token) => {
  * @param {String} comments
  * @param {String} userId
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const create = (data, comments, userId, token) => {
-  return new Promise(function (resolve, reject) {
+const create = (
+  data: object,
+  comments: string,
+  userId: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       comments: comments,
       data: data,
@@ -67,10 +79,15 @@ export const create = (data, comments, userId, token) => {
  * @param {number} id The id of the skill to be deleted
  * @param {String} comments The comments included with the deletion
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const deleteSkillAssessment = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    const data = {
+const deleteSkillAssessment = (
+  id: number,
+  comments: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const data: { id: number, comments?: string } = {
       id: id,
     };
     if (comments) data.comments = comments;
@@ -92,9 +109,10 @@ export const deleteSkillAssessment = (id, comments, token) => {
  * Get skill assessment by id
  * @param {String} id
  * @param {String} token
+ * @returns {Promise<Object>}
  */
-export const getById = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const getById = (id: string, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(`api/v1/skillassessments/${id}`, {
       headers: { authorization: token },
     });
@@ -108,14 +126,44 @@ export const getById = (id, token) => {
   });
 };
 
+/**
+ * Get skill assessment by user and skill
+ * @param {String} userId
+ * @param {String} skillId
+ * @param {String} token
+ * @returns {Promise<Object>} The skill assessment
+ */
+const getByUserAndSkill = (
+  userId: string,
+  skillId: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    let confirmationRequest = client.get(
+      `api/v1/skillassessments/getbyuserandskill/${userId}/${skillId}`,
+      {
+        headers: { authorization: token },
+      }
+    );
+    confirmationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
 /**
  * Get list
- * @param {Object} userId The user used to select the skill
+ * @param {String} userId The user used to select the skill
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const getList = (userId, token) => {
-  return new Promise(function (resolve, reject) {
-    const requestData = {};
+const getList = (userId: string, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const requestData: { userId?: string } = {};
     if (userId) requestData.userId = userId;
     let confirmationRequest = client.post(
       `api/v1/skillassessments`,
@@ -134,12 +182,11 @@ export const getList = (userId, token) => {
   });
 };
 
-const skillAssessments = {
+export default {
   addEntry,
   create,
   deleteSkillAssessment,
   getById,
+  getByUserAndSkill,
   getList,
 };
-
-export default skillAssessments;