@docbrasil/api-systemmanager 1.1.75 → 1.1.77

package/api/admin/list.js

@@ -128,6 +128,220 @@ class AdminLists {
       throw ex;
     }
   }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Filter organization lists by name
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {array} [params.names=[]] Array of list names to filter (empty = all)
+   * @param {string} session JWT session token
+   * @return {Promise<array>} Array of matching org lists sorted by name
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', names: ['Tags', 'Categorias'] };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const lists = await api.admin.list.filterByName(params, session);
+   */
+  async filterByName(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required());
+      Joi.assert(params.orgId, Joi.string().required());
+      Joi.assert(session, Joi.string().required());
+
+      const { orgId, names = [] } = params;
+      const payload = { names };
+
+      const apiCall = self._client.post(
+        `/admin/organizations/${orgId}/orgtags/filter`,
+        payload,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Create a new organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.name List name (required)
+   * @param {array} [params.list=[]] Initial list items
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Created list document
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', name: 'My List', list: [] };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const list = await api.admin.list.create(params, session);
+   */
+  async create(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required());
+      Joi.assert(params.orgId, Joi.string().required());
+      Joi.assert(params.name, Joi.string().required());
+      Joi.assert(session, Joi.string().required());
+
+      const { orgId, name, list = [] } = params;
+      const payload = { orgId, name, list };
+
+      const apiCall = self._client.put(
+        `/admin/organizations/${orgId}/orgtags`,
+        payload,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Update an organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.id List ID (required)
+   * @param {object} params.data Fields to update (name, list, etc.)
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Updated list document
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', id: '55e4a3bd6be6b45210833fae', data: { name: 'Renamed' } };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const list = await api.admin.list.update(params, session);
+   */
+  async update(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required());
+      Joi.assert(params.orgId, Joi.string().required());
+      Joi.assert(params.id, Joi.string().required());
+      Joi.assert(params.data, Joi.object().required());
+      Joi.assert(session, Joi.string().required());
+
+      const { orgId, id, data } = params;
+
+      const apiCall = self._client.put(
+        `/admin/organizations/${orgId}/orgtags/${id}`,
+        data,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Remove an organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.id List ID to remove (required)
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Removal confirmation
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', id: '55e4a3bd6be6b45210833fae' };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * await api.admin.list.remove(params, session);
+   */
+  async remove(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required());
+      Joi.assert(params.orgId, Joi.string().required());
+      Joi.assert(params.id, Joi.string().required());
+      Joi.assert(session, Joi.string().required());
+
+      const { orgId, id } = params;
+
+      const apiCall = self._client.delete(
+        `/admin/organizations/${orgId}/orgtags/${id}`,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Update list items of an organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.id List ID (required)
+   * @param {array} params.list Updated list items array (required)
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Updated list document
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = {
+   *   orgId: '5edd11c46b6ce9729c2c297c',
+   *   id: '55e4a3bd6be6b45210833fae',
+   *   list: [{ _id: '1', value: 'Item 1', filter: '', order: 0 }]
+   * };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const list = await api.admin.list.updateListItems(params, session);
+   */
+  async updateListItems(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required());
+      Joi.assert(params.orgId, Joi.string().required());
+      Joi.assert(params.id, Joi.string().required());
+      Joi.assert(params.list, Joi.array().required());
+      Joi.assert(session, Joi.string().required());
+
+      const { orgId, id, list } = params;
+
+      const apiCall = self._client.put(
+        `/admin/organizations/${orgId}/orgtags/${id}`,
+        { list },
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
 }
 
 export default AdminLists;

package/api/user/help.js

@@ -150,6 +150,47 @@ class Help {
     }
   }
 
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Update a schedule associated with a help page.
+   * Allows partial updates (e.g., just the cron expression).
+   * @param {object} params Params for update
+   * @param {string} params.id Schedule id (_id database)
+   * @param {object} params.data Partial update data (e.g., { schedule: { cron: '0 9 * * *' } })
+   * @param {string} session Session, token JWT
+   * @returns {promise<object>} Updated schedule document
+   * @public
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = {
+   *   id: '5dadd01dc4af3941d42f8c5c',
+   *   data: {
+   *     schedule: { cron: '0 9 * * *' }
+   *   }
+   * };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * await api.user.help.updateSchedule(params, session);
+   */
+  async updateSchedule(params, session) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required(), 'Params to update schedule');
+      Joi.assert(params.id, Joi.string().required(), 'Schedule id (_id database)');
+      Joi.assert(params.data, Joi.object().required(), 'Data to update');
+      Joi.assert(session, Joi.string().required(), 'Session token JWT');
+
+      const { id, data } = params;
+      const apiCall = self._client.put(`/help/schedule/${id}`, data, self._setHeader(session));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
 }
 
 export default Help;

package/dist/bundle.cjs

@@ -11481,6 +11481,47 @@ class Help {
     }
   }
 
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Update a schedule associated with a help page.
+   * Allows partial updates (e.g., just the cron expression).
+   * @param {object} params Params for update
+   * @param {string} params.id Schedule id (_id database)
+   * @param {object} params.data Partial update data (e.g., { schedule: { cron: '0 9 * * *' } })
+   * @param {string} session Session, token JWT
+   * @returns {promise<object>} Updated schedule document
+   * @public
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = {
+   *   id: '5dadd01dc4af3941d42f8c5c',
+   *   data: {
+   *     schedule: { cron: '0 9 * * *' }
+   *   }
+   * };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * await api.user.help.updateSchedule(params, session);
+   */
+  async updateSchedule(params, session) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required(), 'Params to update schedule');
+      Joi__default["default"].assert(params.id, Joi__default["default"].string().required(), 'Schedule id (_id database)');
+      Joi__default["default"].assert(params.data, Joi__default["default"].object().required(), 'Data to update');
+      Joi__default["default"].assert(session, Joi__default["default"].string().required(), 'Session token JWT');
+
+      const { id, data } = params;
+      const apiCall = self._client.put(`/help/schedule/${id}`, data, self._setHeader(session));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
 }
 
 /**
@@ -13842,6 +13883,220 @@ class AdminLists {
       throw ex;
     }
   }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Filter organization lists by name
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {array} [params.names=[]] Array of list names to filter (empty = all)
+   * @param {string} session JWT session token
+   * @return {Promise<array>} Array of matching org lists sorted by name
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', names: ['Tags', 'Categorias'] };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const lists = await api.admin.list.filterByName(params, session);
+   */
+  async filterByName(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required());
+      Joi__default["default"].assert(params.orgId, Joi__default["default"].string().required());
+      Joi__default["default"].assert(session, Joi__default["default"].string().required());
+
+      const { orgId, names = [] } = params;
+      const payload = { names };
+
+      const apiCall = self._client.post(
+        `/admin/organizations/${orgId}/orgtags/filter`,
+        payload,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Create a new organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.name List name (required)
+   * @param {array} [params.list=[]] Initial list items
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Created list document
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', name: 'My List', list: [] };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const list = await api.admin.list.create(params, session);
+   */
+  async create(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required());
+      Joi__default["default"].assert(params.orgId, Joi__default["default"].string().required());
+      Joi__default["default"].assert(params.name, Joi__default["default"].string().required());
+      Joi__default["default"].assert(session, Joi__default["default"].string().required());
+
+      const { orgId, name, list = [] } = params;
+      const payload = { orgId, name, list };
+
+      const apiCall = self._client.put(
+        `/admin/organizations/${orgId}/orgtags`,
+        payload,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Update an organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.id List ID (required)
+   * @param {object} params.data Fields to update (name, list, etc.)
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Updated list document
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', id: '55e4a3bd6be6b45210833fae', data: { name: 'Renamed' } };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const list = await api.admin.list.update(params, session);
+   */
+  async update(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required());
+      Joi__default["default"].assert(params.orgId, Joi__default["default"].string().required());
+      Joi__default["default"].assert(params.id, Joi__default["default"].string().required());
+      Joi__default["default"].assert(params.data, Joi__default["default"].object().required());
+      Joi__default["default"].assert(session, Joi__default["default"].string().required());
+
+      const { orgId, id, data } = params;
+
+      const apiCall = self._client.put(
+        `/admin/organizations/${orgId}/orgtags/${id}`,
+        data,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Remove an organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.id List ID to remove (required)
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Removal confirmation
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = { orgId: '5edd11c46b6ce9729c2c297c', id: '55e4a3bd6be6b45210833fae' };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * await api.admin.list.remove(params, session);
+   */
+  async remove(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required());
+      Joi__default["default"].assert(params.orgId, Joi__default["default"].string().required());
+      Joi__default["default"].assert(params.id, Joi__default["default"].string().required());
+      Joi__default["default"].assert(session, Joi__default["default"].string().required());
+
+      const { orgId, id } = params;
+
+      const apiCall = self._client.delete(
+        `/admin/organizations/${orgId}/orgtags/${id}`,
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Update list items of an organization list
+   * @param {object} params Parameters
+   * @param {string} params.orgId Organization ID (required)
+   * @param {string} params.id List ID (required)
+   * @param {array} params.list Updated list items array (required)
+   * @param {string} session JWT session token
+   * @return {Promise<object>} Updated list document
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const params = {
+   *   orgId: '5edd11c46b6ce9729c2c297c',
+   *   id: '55e4a3bd6be6b45210833fae',
+   *   list: [{ _id: '1', value: 'Item 1', filter: '', order: 0 }]
+   * };
+   * const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+   * const list = await api.admin.list.updateListItems(params, session);
+   */
+  async updateListItems(params = {}, session) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required());
+      Joi__default["default"].assert(params.orgId, Joi__default["default"].string().required());
+      Joi__default["default"].assert(params.id, Joi__default["default"].string().required());
+      Joi__default["default"].assert(params.list, Joi__default["default"].array().required());
+      Joi__default["default"].assert(session, Joi__default["default"].string().required());
+
+      const { orgId, id, list } = params;
+
+      const apiCall = self._client.put(
+        `/admin/organizations/${orgId}/orgtags/${id}`,
+        { list },
+        self._setHeader(session)
+      );
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
 }
 
 /**