@stackfactor/client-api 1.1.11 → 1.1.12-9.2

package/lib/microSkillsQuizes.ts

@@ -0,0 +1,70 @@
+import { client } from "./axiosClient.js";
+
+/**
+ * Get responses for a microskill quiz
+ * @param {String} learningContentId
+ * @param {String} microSkillId
+ * @param {String} token
+ * @returns {Promise<Object>}
+ */
+const getResponses = (
+  learningContentId: string,
+  microSkillId: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    let confirmationRequest = client.get(
+      `api/v1/microskillsresponses/${learningContentId}/${microSkillId}`,
+      {
+        headers: { authorization: token },
+      }
+    );
+    confirmationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+/**
+ * Save responses for a microskill quiz
+ * @param {String} learningContentId
+ * @param {String} microSkillId
+ * @param {Array<Object>} responses
+ * @param {String} token Authorization token
+ * @returns {Promise<Object>}
+ */
+const saveResponses = (
+  learningContentId: string,
+  microSkillId: string,
+  responses: object[],
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    let data = {
+      responses: responses,
+    };
+    let confirmationRequest = client.post(
+      `api/v1/microskillsresponses/${learningContentId}/${microSkillId}`,
+      data,
+      {
+        headers: { authorization: token },
+      }
+    );
+    confirmationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+export default {
+  getResponses,
+  saveResponses,
+};

package/lib/quotas.ts

@@ -0,0 +1,59 @@
+import { client } from "./axiosClient.js";
+
+/**
+ * Get the current quota for the user and tenant
+ * @param {String} token
+ * @returns {Promise<Object>}
+ */
+const getAllQuota = (token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    let confirmationRequest = client.get(`/api/v1/quotas/getallquota`, {
+      headers: { authorization: token },
+    });
+    confirmationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+/**
+ * Increase quota utilization
+ * @param {String} quotaId
+ * @param {Number} value
+ * @param {String} token
+ * @returns {Promise<Object>}
+ */
+const increaseQuotaUtilization = (
+  quotaId: string,
+  value: number,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    let confirmationRequest = client.post(
+      `/api/v1/quotas/increaseutilization`,
+      {
+        id: quotaId,
+        value: value,
+      },
+      {
+        headers: { authorization: token },
+      }
+    );
+    confirmationRequest
+      .then((response) => {
+        resolve(response.data);
+      })
+      .catch((error) => {
+        reject(error);
+      });
+  });
+};
+
+export default {
+  getAllQuota,
+  increaseQuotaUtilization,
+};

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

@@ -4,10 +4,10 @@ import { client } from "./axiosClient.js";
  * Create role and set information
  * @param {Object} data
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const createRole = (data, token) => {
-  return new Promise(function (resolve, reject) {
+const createRole = (data: object, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.put(
       "api/v1/roles",
       { data: data },
@@ -30,13 +30,29 @@ export const createRole = (data, token) => {
  * @param {String} templateId
  * @param {Object} data
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const createRoleFromTemplate = (templateId, data, token) => {
-  return new Promise(function (resolve, reject) {
-    const requestData = {
+const createRoleFromTemplate = (
+  templateId: string,
+  data: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const requestData: { 
+      includeDeleted: boolean; 
+      includeDetailedInformation: boolean; 
+      namesOnly: boolean; 
+      returnDefaultIfVersionNotAvailable: boolean; 
+      version: string; 
+      filter?: object;
+      templateId: string;
+    } = {
       templateId: templateId,
-      data: data,
+      includeDeleted: false,
+      includeDetailedInformation: false,
+      namesOnly: false,
+      returnDefaultIfVersionNotAvailable: false,
+      version: "1.0",
     };
     let confirmationRequest = client.put(
       "api/v1/roles/createfromtemplate/",
@@ -60,11 +76,15 @@ export const createRoleFromTemplate = (templateId, data, token) => {
  * @param {String} id The id of the role to be deleted
  * @param {String} comments The comments included with the deletion
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const deleteRole = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    const data = {
+const deleteRole = (
+  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;
@@ -86,10 +106,10 @@ export const deleteRole = (id, comments, token) => {
  * Discard the role draft changes
  * @param {String} id The id of the role to be deleted
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const discardRoleChanges = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const discardRoleChanges = (id: string, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const data = {};
     const request = client.get(`api/v1/roles/discard/${id}`, {
       headers: { authorization: token },
@@ -108,15 +128,14 @@ export const discardRoleChanges = (id, token) => {
 /**
  * Get the list of imported role templates
  * @param {String} token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getImportedRoleTemplates = (token) => {
-  return new Promise(function (resolve, reject) {
+const getImportedRoleTemplates = (token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const request = client.get(`api/v1/roles/getimportedroletemplates`, {
       headers: { authorization: token },
     });
     request
-
       .then((response) => {
         resolve(response.data);
       })
@@ -132,15 +151,15 @@ export const getImportedRoleTemplates = (token) => {
  * @param {String} version The version to be retrieved
  * @param {Boolean} returnNullIfVersionNotFound Return null if the version is not found
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getRoleInformationById = (
-  id,
-  version,
-  returnNullIfVersionNotFound,
-  token
-) => {
-  return new Promise(function (resolve, reject) {
+const getRoleInformationById = (
+  id: number,
+  version: string,
+  returnNullIfVersionNotFound: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/roles/role/${id}/${version}/${returnNullIfVersionNotFound}`,
       {
@@ -166,19 +185,26 @@ export const getRoleInformationById = (
  * @param {Boolean} returnDefaultIfVersionNotAvailable Return the default version if published not available
  * @param {Boolean} namesOnly Return only the names of the roles
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getRolesList = (
-  filter,
-  version,
-  includeDeleted,
-  includeDetailedInformation,
-  returnDefaultIfVersionNotAvailable,
-  namesOnly,
-  token
-) => {
-  return new Promise(function (resolve, reject) {
-    const requestData = {
+const getRolesList = (
+  filter: object,
+  version: string,
+  includeDeleted: boolean,
+  includeDetailedInformation: boolean,
+  returnDefaultIfVersionNotAvailable: boolean,
+  namesOnly: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const requestData: { 
+      includeDeleted: boolean; 
+      includeDetailedInformation: boolean; 
+      namesOnly: boolean; 
+      returnDefaultIfVersionNotAvailable: boolean; 
+      version: string; 
+      filter?: object;
+    } = {
       includeDeleted: includeDeleted,
       includeDetailedInformation: includeDetailedInformation,
       namesOnly: namesOnly,
@@ -203,10 +229,10 @@ export const getRolesList = (
  * Get role template updates
  * @param {String} id The role id
  * @param {String} token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const getRoleTemplateUpdates = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const getRoleTemplateUpdates = (id: string, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/roles/getroletemplateupdates/${id}`,
       {
@@ -225,14 +251,18 @@ export const getRoleTemplateUpdates = (id, token) => {
 
 /**
  * Import role templates
- * @param {Array<String>} data The list of role templates to be imported
+ * @param {Array<Object>} data The list of role templates to be imported
  * @param {String} token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const importRoleTemplates = (data, token) => {
-  return new Promise(function (resolve, reject) {
-    const requestData = {
-      data: data,
+const importRoleTemplates = (
+  data: object[],
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const requestData: { roles: object[]; jobDescription: string; userid?: string } = {
+      roles: data,
+      jobDescription: "default job description", // Add a default job description or pass it as a parameter
     };
     let confirmationRequest = client.post(
       `api/v1/roles/importRoleTemplates`,
@@ -242,7 +272,6 @@ export const importRoleTemplates = (data, token) => {
       }
     );
     confirmationRequest
-
       .then((response) => {
         resolve(response.data);
       })
@@ -257,11 +286,15 @@ export const importRoleTemplates = (data, token) => {
  * @param {number} id The id of the role 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 publishRole = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    let data = {};
+const publishRole = (
+  id: number,
+  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/roles/publish/${id}`, data, {
       headers: { authorization: token },
@@ -281,10 +314,14 @@ export const publishRole = (id, comments, token) => {
  * @param {String} id The id of the role to be updated
  * @param {Object} data Data used to update the role
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const setRoleInformation = (id, data, token) => {
-  return new Promise(function (resolve, reject) {
+const setRoleInformation = (
+  id: string,
+  data: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
       id: id,
@@ -307,10 +344,14 @@ export const setRoleInformation = (id, data, token) => {
  * @param {String} id The id of the role to be updated
  * @param {Object} data Data used to update the role
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const setRoleInformationFromTemplate = (id, data, token) => {
-  return new Promise(function (resolve, reject) {
+const setRoleInformationFromTemplate = (
+  id: string,
+  data: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
       id: id,
@@ -338,11 +379,16 @@ export const setRoleInformationFromTemplate = (id, data, token) => {
  * @param {Array<Object>} roles The list of roles to be assigned to the user
  * @param {String} jobDescription The job description to be assigned to the user
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const setUserRoles = (id, roles, jobDescription, token) => {
-  return new Promise(function (resolve, reject) {
-    const requestData = {
+const setUserRoles = (
+  id: string,
+  roles: object[],
+  jobDescription: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const requestData: { roles: object[]; jobDescription: string; userid?: string } = {
       roles: roles,
       jobDescription: jobDescription,
     };
@@ -365,10 +411,14 @@ export const setUserRoles = (id, roles, jobDescription, token) => {
  * @param {String} id The id of the role to be updated
  * @param {Boolean} watch Set to true or false
  * @param {String} token Authorization token
- * @returns {Promise}
+ * @returns {Promise<Object>}
  */
-export const watchRole = (id, watch, token) => {
-  return new Promise(function (resolve, reject) {
+const watchRole = (
+  id: string,
+  watch: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       id: id,
       watch: watch,
@@ -386,7 +436,7 @@ export const watchRole = (id, watch, token) => {
   });
 };
 
-const role = {
+export default {
   createRole,
   createRoleFromTemplate,
   deleteRole,
@@ -402,5 +452,3 @@ const role = {
   setUserRoles,
   watchRole,
 };
-
-export default role;

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

@@ -4,9 +4,10 @@ import { client } from "./axiosClient.js";
  * Create role template and set information
  * @param {Object} data
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const createRoleTemplate = (data, token) => {
-  return new Promise(function (resolve, reject) {
+const createRoleTemplate = (data: object, token: string): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
     };
@@ -28,10 +29,15 @@ export const createRoleTemplate = (data, token) => {
  * @param {String} id The id of the template to be deleted
  * @param {String} comments The comments included with the deletion
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const deleteRoleTemplate = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    const data = {
+const deleteRoleTemplate = (
+  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;
@@ -53,9 +59,13 @@ export const deleteRoleTemplate = (id, comments, token) => {
  * Discard the role template draft changes
  * @param {String} id The id of the role template to be deleted
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const discardRoleTemplateChanges = (id, token) => {
-  return new Promise(function (resolve, reject) {
+const discardRoleTemplateChanges = (
+  id: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const data = {};
     const request = client.get(`api/v1/roletemplates/discard/${id}`, {
       headers: { authorization: token },
@@ -74,10 +84,16 @@ export const discardRoleTemplateChanges = (id, token) => {
 /**
  * Get role template information
  * @param {String} id The id of the template
+ * @param {String} version The version of the template
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const getRoleTemplateInformationById = (id, version, token) => {
-  return new Promise(function (resolve, reject) {
+const getRoleTemplateInformationById = (
+  id: string,
+  version: string,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     let confirmationRequest = client.get(
       `api/v1/roletemplates/${id}/${version}`,
       {
@@ -101,16 +117,17 @@ export const getRoleTemplateInformationById = (id, version, token) => {
  * @param {Boolean} includeDeleted When true it will return the deleted records as well
  * @param {Boolean} namesOnly When true it will return only the names of the templates
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const getRoleTemplateList = (
-  filter,
-  version,
-  includeDeleted,
-  namesOnly,
-  token
-) => {
-  return new Promise(function (resolve, reject) {
-    const requestData = {
+const getRoleTemplateList = (
+  filter: string[],
+  version: string,
+  includeDeleted: boolean,
+  namesOnly: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
+    const requestData: { includeDeleted: boolean; namesOnly: boolean; version: string; filter?: string[] } = {
       includeDeleted: includeDeleted,
       namesOnly: namesOnly,
       version: version,
@@ -134,10 +151,15 @@ export const getRoleTemplateList = (
  * @param {number} id The id of the template to be published
  * @param {String} comments The comments to be include with the request
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const publishTemplate = (id, comments, token) => {
-  return new Promise(function (resolve, reject) {
-    let data = {};
+const publishTemplate = (
+  id: number,
+  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/roletemplates/publish/${id}`,
@@ -161,9 +183,14 @@ export const publishTemplate = (id, comments, token) => {
  * @param {String} id The id of the template to be updated
  * @param {Object} data Data used to update the template
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const setTemplateInformation = (id, data, token) => {
-  return new Promise(function (resolve, reject) {
+const setTemplateInformation = (
+  id: string,
+  data: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       data: data,
       id: id,
@@ -190,9 +217,14 @@ export const setTemplateInformation = (id, data, token) => {
  * @param {String} id The id of the template to be updated
  * @param {Object} tags Updated template tags
  * @param {String} token Authorization token
+ * @returns {Promise<Object>}
  */
-export const setTemplateTags = (id, tags, token) => {
-  return new Promise(function (resolve, reject) {
+const setTemplateTags = (
+  id: string,
+  tags: object,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       tags: tags,
       id: id,
@@ -219,9 +251,14 @@ export const setTemplateTags = (id, tags, 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<Object>}
  */
-export const watchRoleTemplate = (id, watch, token) => {
-  return new Promise(function (resolve, reject) {
+const watchRoleTemplate = (
+  id: string,
+  watch: boolean,
+  token: string
+): Promise<object> => {
+  return new Promise((resolve, reject) => {
     const requestData = {
       id: id,
       watch: watch,
@@ -243,7 +280,7 @@ export const watchRoleTemplate = (id, watch, token) => {
   });
 };
 
-const roleTemplate = {
+export default {
   createRoleTemplate,
   deleteRoleTemplate,
   discardRoleTemplateChanges,
@@ -254,5 +291,3 @@ const roleTemplate = {
   setTemplateTags,
   watchRoleTemplate,
 };
-
-export default roleTemplate;