@docbrasil/api-systemmanager 1.1.86 → 1.1.89

package/api/ai/index.js

@@ -29,9 +29,13 @@ class MyndAI {
   _returnData(retData, def = {}) {
     if (retData.status !== 200) {
       throw Boom.badRequest(_.get(retData, 'message', 'No error message reported!'))
-    } else {
-      return _.get(retData, 'data', def);
     }
+    const body = _.get(retData, 'data', def);
+    // Unwrap Akamai response envelope { statusCode, message, data }
+    if (body && typeof body === 'object' && body.statusCode !== undefined && body.data !== undefined) {
+      return body.data;
+    }
+    return body;
   }
 
   /**

package/api/ai/sessions.js

@@ -26,9 +26,13 @@ class AISession {
   _returnData(retData, def = {}) {
     if (retData.status !== 200) {
       throw Boom.badRequest(_.get(retData, 'message', 'No error message reported!'))
-    } else {
-      return _.get(retData, 'data', def);
     }
+    const body = _.get(retData, 'data', def);
+    // Unwrap Akamai response envelope { statusCode, message, data }
+    if (body && typeof body === 'object' && body.statusCode !== undefined && body.data !== undefined) {
+      return body.data;
+    }
+    return body;
   }
 
   /**
@@ -241,6 +245,89 @@ class AISession {
       throw ex;
     }
   }
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Add documents to an existing agent session.
+   * The agent will handle the documentIds accordingly.
+   * @param {object} params Parameters
+   * @param {string} params.sessionId The session ID
+   * @param {array<string>} params.documentIds Array of document IDs to add
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The result from the agent
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   sessionId: 'session-abc-123',
+   *   documentIds: ['doc-123', 'doc-456']
+   * };
+   * const retData = await api.ai.sessions.addDocuments(params, authorization);
+   */
+  async addDocuments(params, authorization) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required().error(new Error('params is required')));
+      Joi.assert(params.sessionId, Joi.string().required().error(new Error('sessionId is required')));
+      Joi.assert(params.documentIds, Joi.array().items(Joi.string()).min(1).required().error(new Error('documentIds is required and must be a non-empty array')));
+
+      const { sessionId, documentIds } = params;
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post(`/agents/${sessionId}/documents/add`, { documentIds }, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Remove documents from an existing agent session.
+   * The agent will handle the documentIds accordingly.
+   * @param {object} params Parameters
+   * @param {string} params.sessionId The session ID
+   * @param {array<string>} params.documentIds Array of document IDs to remove
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The result from the agent
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   sessionId: 'session-abc-123',
+   *   documentIds: ['doc-123', 'doc-456']
+   * };
+   * const retData = await api.ai.sessions.removeDocuments(params, authorization);
+   */
+  async removeDocuments(params, authorization) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required().error(new Error('params is required')));
+      Joi.assert(params.sessionId, Joi.string().required().error(new Error('sessionId is required')));
+      Joi.assert(params.documentIds, Joi.array().items(Joi.string()).min(1).required().error(new Error('documentIds is required and must be a non-empty array')));
+
+      const { sessionId, documentIds } = params;
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post(`/agents/${sessionId}/documents/remove`, { documentIds }, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
 }
 
 export default AISession;

package/dist/bundle.cjs

@@ -16190,9 +16190,13 @@ class AISession {
   _returnData(retData, def = {}) {
     if (retData.status !== 200) {
       throw Boom__default["default"].badRequest(___default["default"].get(retData, 'message', 'No error message reported!'))
-    } else {
-      return ___default["default"].get(retData, 'data', def);
     }
+    const body = ___default["default"].get(retData, 'data', def);
+    // Unwrap Akamai response envelope { statusCode, message, data }
+    if (body && typeof body === 'object' && body.statusCode !== undefined && body.data !== undefined) {
+      return body.data;
+    }
+    return body;
   }
 
   /**
@@ -16405,6 +16409,89 @@ class AISession {
       throw ex;
     }
   }
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Add documents to an existing agent session.
+   * The agent will handle the documentIds accordingly.
+   * @param {object} params Parameters
+   * @param {string} params.sessionId The session ID
+   * @param {array<string>} params.documentIds Array of document IDs to add
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The result from the agent
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   sessionId: 'session-abc-123',
+   *   documentIds: ['doc-123', 'doc-456']
+   * };
+   * const retData = await api.ai.sessions.addDocuments(params, authorization);
+   */
+  async addDocuments(params, authorization) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required().error(new Error('params is required')));
+      Joi__default["default"].assert(params.sessionId, Joi__default["default"].string().required().error(new Error('sessionId is required')));
+      Joi__default["default"].assert(params.documentIds, Joi__default["default"].array().items(Joi__default["default"].string()).min(1).required().error(new Error('documentIds is required and must be a non-empty array')));
+
+      const { sessionId, documentIds } = params;
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post(`/agents/${sessionId}/documents/add`, { documentIds }, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Remove documents from an existing agent session.
+   * The agent will handle the documentIds accordingly.
+   * @param {object} params Parameters
+   * @param {string} params.sessionId The session ID
+   * @param {array<string>} params.documentIds Array of document IDs to remove
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The result from the agent
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   sessionId: 'session-abc-123',
+   *   documentIds: ['doc-123', 'doc-456']
+   * };
+   * const retData = await api.ai.sessions.removeDocuments(params, authorization);
+   */
+  async removeDocuments(params, authorization) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required().error(new Error('params is required')));
+      Joi__default["default"].assert(params.sessionId, Joi__default["default"].string().required().error(new Error('sessionId is required')));
+      Joi__default["default"].assert(params.documentIds, Joi__default["default"].array().items(Joi__default["default"].string()).min(1).required().error(new Error('documentIds is required and must be a non-empty array')));
+
+      const { sessionId, documentIds } = params;
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post(`/agents/${sessionId}/documents/remove`, { documentIds }, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
 }
 
 /**
@@ -16433,9 +16520,13 @@ class MyndAI {
   _returnData(retData, def = {}) {
     if (retData.status !== 200) {
       throw Boom__default["default"].badRequest(___default["default"].get(retData, 'message', 'No error message reported!'))
-    } else {
-      return ___default["default"].get(retData, 'data', def);
     }
+    const body = ___default["default"].get(retData, 'data', def);
+    // Unwrap Akamai response envelope { statusCode, message, data }
+    if (body && typeof body === 'object' && body.statusCode !== undefined && body.data !== undefined) {
+      return body.data;
+    }
+    return body;
   }
 
   /**