automacao-core-playwright 5.6.3 → 5.7.1

package/.npm/_logs/{2025-10-15T15_19_35_664Z-debug-0.log → 2025-10-24T18_13_46_028Z-debug-0.log}

@@ -1,18 +1,18 @@
-0 verbose cli /root/.nvm/versions/node/v22.20.0/bin/node /root/.nvm/versions/node/v22.20.0/bin/npm
-1 info using npm@10.9.3
-2 info using node@v22.20.0
-3 silly config load:file:/root/.nvm/versions/node/v22.20.0/lib/node_modules/npm/npmrc
+0 verbose cli /root/.nvm/versions/node/v22.21.0/bin/node /root/.nvm/versions/node/v22.21.0/bin/npm
+1 info using npm@10.9.4
+2 info using node@v22.21.0
+3 silly config load:file:/root/.nvm/versions/node/v22.21.0/lib/node_modules/npm/npmrc
 4 silly config load:file:/builds/automacao-testes/automacao-core-playwright/node_modules/node-jq/.npmrc
 5 silly config load:file:/root/.npmrc
-6 silly config load:file:/root/.nvm/versions/node/v22.20.0/etc/npmrc
+6 silly config load:file:/root/.nvm/versions/node/v22.21.0/etc/npmrc
 7 verbose title npm run install-binary
 8 verbose argv "run" "install-binary"
-9 verbose logfile logs-max:10 dir:/builds/automacao-testes/automacao-core-playwright/.npm/_logs/2025-10-15T15_19_35_664Z-
-10 verbose logfile /builds/automacao-testes/automacao-core-playwright/.npm/_logs/2025-10-15T15_19_35_664Z-debug-0.log
+9 verbose logfile logs-max:10 dir:/builds/automacao-testes/automacao-core-playwright/.npm/_logs/2025-10-24T18_13_46_028Z-
+10 verbose logfile /builds/automacao-testes/automacao-core-playwright/.npm/_logs/2025-10-24T18_13_46_028Z-debug-0.log
 11 silly logfile done cleaning log files
 12 verbose cwd /builds/automacao-testes/automacao-core-playwright/node_modules/node-jq
 13 verbose os Linux 5.10.230-223.885.amzn2.x86_64
-14 verbose node v22.20.0
-15 verbose npm  v10.9.3
+14 verbose node v22.21.0
+15 verbose npm  v10.9.4
 16 verbose exit 0
 17 info ok

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 5.7.1
+[24/10/2025]
+
+# 5.7.0
+[24/10/2025]
+
 # 5.6.3
 [15/10/2025]
 

package/dist/bundled.js

@@ -16,20 +16,26 @@
   const dotenv$1 = require('dotenv');
   dotenv$1.config();
   let contadorMenu = 0;
-  const FRAME = 'iframe[name="ci"]';
+  const FRAME$1 = 'iframe[name="ci"]';
+
+  /**
+   * Utilitários para automação de testes e manipulação de dados
+   * Funções para login, navegação, validação de formulários, manipulação de datas e verificações de tela
+   */
   class DataUtils {
     constructor(page) {
       this.page = page;
     }
+
     /**
-    * Realiza o processo de login na página.
-    * @param {Object} usuario - As informações de usuário para autenticação.
+     * Realiza o processo de login na página.
+     * @param {Object} usuario - As informações de usuário para autenticação.
      * @example
      * const usuario = {
      *   email: 'seu_usuario@senior.com', {string}
      *   senha: 'sua_senha', {string}
      * };
-    */
+     */
     async login(usuario) {
       await this.page.goto('/');
       const password = this.page.getByPlaceholder('Senha');
@@ -42,16 +48,17 @@
       await this.page.locator('[id="loginbtn"]').click();
       console.log(`Usuário ${usuario.email} logado com sucesso`);
     }
+
     /**
-    * Navega para a página da plataforma.
-    * @param {string} produto - Produto a ser acessado.
-    * @param {string|null} modulo - Módulo a ser acessado.
-    * @param {string|null} area - Área a ser acessada.
-    * @param {string|null} processo - Processo a ser acessado.
-    * @param {string|null} subProcesso - Subprocesso a ser acessado.
-    * @param {string|null} subProcesso2 - Segundo subprocesso a ser acessado.
-    * @param {string|null} subProcesso3 - Terceiro subprocesso a ser acessado.
-    */
+     * Navega para a página da plataforma.
+     * @param {string} produto - Produto a ser acessado.
+     * @param {string|null} modulo - Módulo a ser acessado.
+     * @param {string|null} area - Área a ser acessada.
+     * @param {string|null} processo - Processo a ser acessado.
+     * @param {string|null} subProcesso - Subprocesso a ser acessado.
+     * @param {string|null} subProcesso2 - Segundo subprocesso a ser acessado.
+     * @param {string|null} subProcesso3 - Terceiro subprocesso a ser acessado.
+     */
     async navegarParaPagina(produto) {
       let modulo = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
       let area = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
@@ -88,6 +95,7 @@
       await this.navegarSeExistir(subProcesso2);
       await this.navegarSeExistir(subProcesso3);
     }
+
     /**
      * Navega para um item do menu se ele existir.
      *
@@ -107,6 +115,7 @@
         contadorMenu++;
       }
     }
+
     /**
      * Navega para um item do menu se ele existir.
      * @param {Array} menuItems - Array de itens do menu para navegar.
@@ -126,6 +135,7 @@
         }
       }
     }
+
     /**
      * Função que navega no menu da plataforma podendo ter mais de uma opção ou nomenclatura.
      * @param {string} produto - Produto da homologX.
@@ -162,6 +172,7 @@
         await this.navegaMenu(menu);
       }
     }
+
     /**
      * Encontra um colaborador em uma tabela dentro de um iframe que
      * tem o seguinte locator: table.table tbody.
@@ -172,7 +183,7 @@
      * @throws {Error} Lança um erro se não conseguir localizar o colaborador na tabela.
      */
     async encontrarValorNaTabela(seletorTabela, valorBusca) {
-      const frameElement = await this.page.$(FRAME);
+      const frameElement = await this.page.$(FRAME$1);
       const frame = await frameElement.contentFrame();
       await frame.waitForSelector(seletorTabela, {
         timeout: 60000
@@ -191,10 +202,11 @@
       }
       return null;
     }
+
     /**
-     *  Função que verifica se um elemento está desabilitado na tela.
-     * @param {string} componente informar qual é o elemento que deve ser validado na tela, locator
-     * @param {string} desabilitado qual o valor esperado para ser comparado (true, false)
+     * Função que verifica se um elemento está desabilitado na tela.
+     * @param {string} componente - informar qual é o elemento que deve ser validado na tela, locator
+     * @param {string} desabilitado - qual o valor esperado para ser comparado (true, false)
      */
     async verificaElementoDesabilitado(componente, desabilitado) {
       const frame = await this.page.frame({
@@ -218,19 +230,21 @@
       await frame.locator(locator).press('Control+A');
       await frame.locator(locator).press('Backspace');
     }
+
     /**
-    * Converte uma data no formato brasileiro para o formato americano (YYYY-MM-DD).
-    * @param {string} data - Data no formato brasileiro (DD/MM/AAAA).
-    * @returns {string} - Data no formato americano (YYYY-MM-DD).
-    */
+     * Converte uma data no formato brasileiro para o formato americano (YYYY-MM-DD).
+     * @param {string} data - Data no formato brasileiro (DD/MM/AAAA).
+     * @returns {string} - Data no formato americano (YYYY-MM-DD).
+     */
     formataDataAmericano(data) {
       return moment$1(data, 'DD/MM/YYYY').format('YYYY-MM-DD');
     }
+
     /**
-    * Função que valida se a data informada é um feriado nacional, caso seja, retorna o dia seguinte ao feriado.
-    * @param {string} dataInicioFerias - Data para validação (formato brasileiro de data - 22/04/2021)
-    * @returns {string} - Data no formato "dia/mês/ano"
-    */
+     * Função que valida se a data informada é um feriado nacional, caso seja, retorna o dia seguinte ao feriado.
+     * @param {string} dataInicioFerias - Data para validação (formato brasileiro de data - 22/04/2021)
+     * @returns {string} - Data no formato "dia/mês/ano"
+     */
     async validarFeriados(dataInicioFerias) {
       const dataValidarFeriadosEng = await this.formataDataAmericano(dataInicioFerias);
       const data = new Date(`"${dataValidarFeriadosEng}"`);
@@ -257,19 +271,21 @@
       inicioFerias = this.configurarDiaMes(data.getDate(), data.getMonth() + 1);
       return `${inicioFerias}/${data.getFullYear()}`;
     }
-    /** Função que valida se a data informada: é uma Sexta, Sábado ou Domingo, caso o retorno seja positivo,
-    *  a data é forçada para a próxima Segunda.
-    * @param {data} dataInicioFerias data para validação (em formato brasileiro de data - 22/04/2021)
-    * REGRA DE NEGÓCIO G5: Não é permitido iniciar as férias no período de dois dias que antecedem um DSR.
-        [0] - Domingo
-        [1] - Segunda
-        [2] - Terça
-        [3] - Quarta
-        [4] - Quinta
-        [5] - Sexta
-        [6] - Sábado
-    * @returns {string} - Data ajustada, se necessário, para a próxima Segunda.
-    **/
+
+    /**
+     * Função que valida se a data informada: é uma Sexta, Sábado ou Domingo, caso o retorno seja positivo,
+     * a data é forçada para a próxima Segunda.
+     * @param {data} dataInicioFerias - data para validação (em formato brasileiro de data - 22/04/2021)
+     * REGRA DE NEGÓCIO G5: Não é permitido iniciar as férias no período de dois dias que antecedem um DSR.
+     * [0] - Domingo
+     * [1] - Segunda
+     * [2] - Terça
+     * [3] - Quarta
+     * [4] - Quinta
+     * [5] - Sexta
+     * [6] - Sábado
+     * @returns {string} - Data ajustada, se necessário, para a próxima Segunda.
+     */
     async validarDiaUtilFerias(dataInicioFerias) {
       // Valida se a data informada é um feriado
       let dataValidarFeriados = await this.validarFeriados(dataInicioFerias);
@@ -286,13 +302,14 @@
       }
       return format$1(data, 'dd/MM/yyyy');
     }
+
     /**
-    * Configura o dia e o mês com zero à esquerda se o valor for menor que 10.
-    * @param {number} dia - O dia a ser configurado.
-    * @param {number} mes - O mês a ser configurado.
-    * @param {boolean} [formatAmericano=false] - Se true, retorna no formato americano (mes/dia); caso contrário, retorna no formato brasileiro (dia/mes).
-    * @returns {string} - Dia e mês formatados.
-    */
+     * Configura o dia e o mês com zero à esquerda se o valor for menor que 10.
+     * @param {number} dia - O dia a ser configurado.
+     * @param {number} mes - O mês a ser configurado.
+     * @param {boolean} [formatAmericano=false] - Se true, retorna no formato americano (mes/dia); caso contrário, retorna no formato brasileiro (dia/mes).
+     * @returns {string} - Dia e mês formatados.
+     */
     configurarDiaMes(dia, mes) {
       let formatAmericano = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       const data = new Date(0, mes - 1, dia); // Ano 0 é usado aqui porque só estamos interessados no mês e no dia
@@ -302,6 +319,7 @@
         return format$1(data, 'dd/MM');
       }
     }
+
     /**
      * Valida se não há mensagens de erro na tela.
      *
@@ -315,7 +333,7 @@
      */
     async validaSemMsgErroEmTela() {
       let validarErroSimples = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-      const frame = await this.page.frameLocator(FRAME);
+      const frame = await this.page.frameLocator(FRAME$1);
       const errorMessages = ['Ocorreu um erro inesperado no servidor:', 'Oops', 'Erro na busca das informações.', 'expection'];
       if (validarErroSimples) {
         errorMessages.push('Erro');
@@ -326,6 +344,7 @@
         })).toBeHidden();
       }));
     }
+
     /**
      * Valida a tradução de mensagens comuns na tela.
      *
@@ -336,7 +355,7 @@
      * @returns {Promise<void>} Uma promessa que é resolvida quando todas as verificações são concluídas.
      */
     async validaTraducaoComunsEmTela() {
-      const frame = this.page.frameLocator(FRAME);
+      const frame = this.page.frameLocator(FRAME$1);
       const translateMessages = ['erpx_', 'erp_', 'crmx_', 'hcm.', 'hcm_'];
       const buttonsElements = ['add', 'edit', 'cancel', 'delete', 'save'];
       await Promise.all([...translateMessages.map(async translateMessage => {
@@ -349,17 +368,16 @@
     }
 
     /**
-       * Valida a tradução de mensagens comuns na tela.
-       *
-       * Esta função verifica se as mensagens de tradução e os botões comuns estão ocultos no frame especificado.
-       * Caso encontre algum texto de tradução visível, lança uma mensagem amigável de erro.
-       * @async
-       * @function validaTraducaoComunsEmTela
-       * @returns {Promise<void>} Uma promessa que é resolvida quando todas as verificações são concluídas.
-       */
-
+     * Valida a tradução de mensagens comuns na tela.
+     *
+     * Esta função verifica se as mensagens de tradução e os botões comuns estão ocultos no frame especificado.
+     * Caso encontre algum texto de tradução visível, lança uma mensagem amigável de erro.
+     * @async
+     * @function validaTraducaoComunsEmTela
+     * @returns {Promise<void>} Uma promessa que é resolvida quando todas as verificações são concluídas.
+     */
     async validaTraducaoEmTela() {
-      const frame = this.page.frameLocator(FRAME);
+      const frame = this.page.frameLocator(FRAME$1);
       const traducoesRegex = [/hcm[._]/i, /hcmx[._]/i, /sam[._]/i, /moods[._]/i];
       await Promise.all(traducoesRegex.map(async regex => {
         const elementos = frame.locator('body').getByText(regex);
@@ -377,13 +395,13 @@
     }
 
     /**
-    * Retorna a data no formato dd/mm/aaaa, com offset de dias, meses e anos.
-    * @param {number} dias - Quantidade de dias a adicionar ou subtrair.
-    * @param {number} meses - Quantidade de meses a adicionar ou subtrair.Meses vão de 0 a 11, ou seja, janeiro é 0 e dezembro é 11
-    * @param {number} anos - Quantidade de anos a adicionar ou subtrair.
-    * @param {Date} [dataBase] - Data base para cálculo, padrão é a data atual.
-    * @returns {string} Data formatada no padrão pt-BR.
-    */
+     * Retorna a data no formato dd/mm/aaaa, com offset de dias, meses e anos.
+     * @param {number} dias - Quantidade de dias a adicionar ou subtrair.
+     * @param {number} meses - Quantidade de meses a adicionar ou subtrair.Meses vão de 0 a 11, ou seja, janeiro é 0 e dezembro é 11
+     * @param {number} anos - Quantidade de anos a adicionar ou subtrair.
+     * @param {Date} [dataBase] - Data base para cálculo, padrão é a data atual.
+     * @returns {string} Data formatada no padrão pt-BR.
+     */
     obterDataPtBR() {
       let dias = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
       let meses = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
@@ -428,10 +446,16 @@
   } = require('date-fns');
   const dotenv = require('dotenv');
   dotenv.config();
+
+  /**
+   * Utilitários para formatação e manipulação de datas
+   * Funções para conversão entre formatos, cálculos de datas e geração de timestamps
+   */
   class FormatDate {
     constructor(page) {
       this.page = page;
     }
+
     /**
      * Retorna a data atual no formato 'MM/DD/AAAA'.
      * @returns {string} - A data atual no formato 'MM/DD/AAAA'.
@@ -439,14 +463,15 @@
     pegaDataAtualComBarrasMesDiaAno() {
       return moment().format('MM/DD/YYYY');
     }
+
     /**
-    * Função para obter uma data com um deslocamento de dias, meses e anos específicos.
-    * @param {number} dias - A quantidade de dias para adicionar (pode ser negativo para datas anteriores).
-    * @param {number} meses - A quantidade de meses para adicionar (pode ser negativo para meses anteriores).
-    * @param {number} anos - A quantidade de anos para adicionar (pode ser negativo para anos anteriores).
-    * @param {boolean} formato - O formato da data (false para 'dd/mm/yyyy' e true para 'yyyy-mm-dd').
-    * @return {string} - A data formatada.
-    */
+     * Função para obter uma data com um deslocamento de dias, meses e anos específicos.
+     * @param {number} dias - A quantidade de dias para adicionar (pode ser negativo para datas anteriores).
+     * @param {number} meses - A quantidade de meses para adicionar (pode ser negativo para meses anteriores).
+     * @param {number} anos - A quantidade de anos para adicionar (pode ser negativo para anos anteriores).
+     * @param {boolean} formato - O formato da data (false para 'dd/mm/yyyy' e true para 'yyyy-mm-dd').
+     * @return {string} - A data formatada.
+     */
     pegaDataComBarras() {
       let dias = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
       let meses = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
@@ -461,19 +486,21 @@
       }
       return format(dataAtual, 'dd/MM/yyyy');
     }
+
     /**
-      * Função que converte data formato americano para data formato brasileiro
-      * @param {string} data data que deve ser convertida
-      * @return data no formato brasileiro
-      */
+     * Função que converte data formato americano para data formato brasileiro
+     * @param {string} data data que deve ser convertida
+     * @return data no formato brasileiro
+     */
     formataDataBrasil(data) {
       return moment(data, 'YYYY-MM-DD').format('DD/MM/YYYY');
     }
+
     /**
-    * Função que retorna por extenso a data atual.
-    * @param {string} formato qual o formato de data deve retornar.
-    * @returns {string} - A data atual no formato extenso ou mês e ano.
-    */
+     * Função que retorna por extenso a data atual.
+     * @param {string} formato qual o formato de data deve retornar.
+     * @returns {string} - A data atual no formato extenso ou mês e ano.
+     */
     transformarDataAtualExtenso(formato) {
       const dataAtual = new Date();
       if (formato === 'extenso') {
@@ -485,12 +512,13 @@
         locale: ptBR
       }); // Novembro 2020
     }
+
     /**
-      * Função que retorna por extenso uma data específicas.
-      * @param {string} dataEspecificas qual a data que deve ser transformada em extenso
-      * @param {string} formato qual o formato de data deve retornar
-      * @return {string} - A data no formato extenso ou mês e ano.
-      */
+     * Função que retorna por extenso uma data específicas.
+     * @param {string} dataEspecificas qual a data que deve ser transformada em extenso
+     * @param {string} formato qual o formato de data deve retornar
+     * @return {string} - A data no formato extenso ou mês e ano.
+     */
     transformarDataExtenso(dataEspecificas, formato) {
       const data = parse(dataEspecificas, 'dd/MM/yyyy', new Date());
       if (formato === 'extenso') {
@@ -507,7 +535,7 @@
     /**
      * busca a data atual da máquina e retorna no formato AAAA-MM-DDTHH:MM:SSZ
      * @return {string} - Data atual no formato AAAA-MM-DDTHH:MM:SSZ
-    */
+     */
     getCurrentDateTime() {
       return new Date().toISOString().split('.')[0] + 'Z';
     }
@@ -521,10 +549,9 @@
      * @param {number} [options.anos=0] - Número de anos a ajustar.
      * @param {number} [options.horas=0] - Número de horas a ajustar.
      * @param {number} [options.minutos=0] - Número de minutos a ajustar.
-     * @param {number} [options.segundos=0] - Número de segundos a ajustar.
-     * @param {boolean} [options.formato=false] - Se true, retorna a data no formato 'yyyy-MM-dd HH:mm:ss', caso contrário 'dd/MM/yyyy HH:mm:ss'.
+     * @param {number} [options.segundos=0] - Número de segundos a ajustar.   * @param {boolean} [options.formato=false] - Se true, retorna a data no formato 'yyyy-MM-dd HH:mm:ss', caso contrário 'dd/MM/yyyy HH:mm:ss'.
      * @returns {string} A data ajustada e formatada.
-    */
+     */
     pegaDataHoraAtualComBarras() {
       let {
         dias = 0,
@@ -545,37 +572,38 @@
       const formatoDesejado = formato ? 'yyyy-MM-dd HH:mm:ss' : 'dd/MM/yyyy HH:mm:ss';
       return format(dataAtual, formatoDesejado);
     }
+
     /**
-    * Formata uma data para diferentes formatos especificados.
-    * @param {number} formato - Código do formato de retorno:
-    *   1 - 'dd/MM/yyyy' (padrão brasileiro)
-    *   2 - 'yyyy/MM/dd'
-    *   3 - 'dd-MM-yyyy'
-    *   4 - 'MM/dd/yyyy' (americano)
-    *   5 - 'yyyy-MM-dd' (ISO)
-    *   6 - 'MM/yyyy'            // 08/2025
-    *   7 - 'yyMMddHHmmss'       // 25082015134500
-    *   8 - 'dd/yy'              // 15/25
-    *   9 - 'dd/yyyy'            // 15/2025
-    *   10 - 'yyyy-MM-dd HH:mm:ss' // 2025-08-15 13:45:00
-    *   11 - 'dd/MM/yyyy HH:mm:ss' // 15/08/2025 13:45:00
-    *   12 - 'yyyy/MM/dd HH:mm:ss' // 2025/08/15 13:45:00
-    *   13 - 'MM/dd/yyyy HH:mm:ss' // 08/15/2025 13:45:00
-    *   14 - 'dd-MM-yyyy HH:mm:ss' // 15-08-2025 13:45:00
-    *   15 - 'yyyyMMdd'           // 20250815
-    *   16 - 'ddMMyyyy'           // 15082025
-    *   17 - 'MM/yy'              // 08/25
-    *   18 - 'yyyyMMddHHmmss'     // 20250815134500
-    *   19 - 'ddMMyyyyHHmmss',     // 15082025134500
-    *   20 - 'yyyy-MM-dd\'T\'HH:mm:ssXXX' (ISO com offset local)
-    * @param {string|Date} data - Objeto Date ou string:
-    *   "YYYY-MM-DD" ISO
-    *   "MM/DD/YYYY" Americano
-    *   "YYYY-MM-DDTHH:mm:ssZ" ISO com hora
-    *   new Date() Date object
-    * @returns {string} Data formatada conforme o formato especificado.
-    * @throws {Error} Se a data ou formato for inválido.
-    */
+     * Formata uma data para diferentes formatos especificados.
+     * @param {number} formato - Código do formato de retorno:
+     *   1 - 'dd/MM/yyyy' (padrão brasileiro)
+     *   2 - 'yyyy/MM/dd'
+     *   3 - 'dd-MM-yyyy'
+     *   4 - 'MM/dd/yyyy' (americano)
+     *   5 - 'yyyy-MM-dd' (ISO)
+     *   6 - 'MM/yyyy'            // 08/2025
+     *   7 - 'yyMMddHHmmss'       // 25082015134500
+     *   8 - 'dd/yy'              // 15/25
+     *   9 - 'dd/yyyy'            // 15/2025
+     *   10 - 'yyyy-MM-dd HH:mm:ss' // 2025-08-15 13:45:00
+     *   11 - 'dd/MM/yyyy HH:mm:ss' // 15/08/2025 13:45:00
+     *   12 - 'yyyy/MM/dd HH:mm:ss' // 2025/08/15 13:45:00
+     *   13 - 'MM/dd/yyyy HH:mm:ss' // 08/15/2025 13:45:00
+     *   14 - 'dd-MM-yyyy HH:mm:ss' // 15-08-2025 13:45:00
+     *   15 - 'yyyyMMdd'           // 20250815
+     *   16 - 'ddMMyyyy'           // 15082025
+     *   17 - 'MM/yy'              // 08/25
+     *   18 - 'yyyyMMddHHmmss'     // 20250815134500
+     *   19 - 'ddMMyyyyHHmmss',     // 15082025134500
+     *   20 - 'yyyy-MM-dd\'T\'HH:mm:ssXXX' (ISO com offset local)
+     * @param {string|Date} data - Objeto Date ou string:
+     *   "YYYY-MM-DD" ISO
+     *   "MM/DD/YYYY" Americano
+     *   "YYYY-MM-DDTHH:mm:ssZ" ISO com hora
+     *   new Date() Date object
+     * @returns {string} Data formatada conforme o formato especificado.
+     * @throws {Error} Se a data ou formato for inválido.
+     */
     formataData() {
       let formato = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1;
       let data = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : new Date();
@@ -633,19 +661,20 @@
         throw new Error(`Erro ao formatar data: ${error.message}`);
       }
     }
+
     /**
-    * Gera uma data personalizada com validação de datas válidas.
-    * Suporta tanto valores fixos quanto operações de soma/subtração.
-    * @param {number|string} [dias=0] - Dia: número fixo (ex: 15) ou operação (ex: "+7", "-3").
-    * @param {number|string} [meses=0] - Mês: número fixo (ex: 3) ou operação (ex: "+2", "-1").
-    * @param {number|string} [anos=0] - Ano: número fixo (ex: 2025) ou operação (ex: "+1", "-2").
-    * @param {number} [formato=1] - Formato de retorno da data (formataData). Se 0, retorna ISO.
-    * @returns {string} Data personalizada válida no formato definido.
-    * @throws {Error} Se a data for inválida.
-    *
-    * @example
-    * geraDataPersonalizada(1, "-1", "+1", 1) // → "01/08/2026" (se hoje é 26/07/2025)
-    */
+     * Gera uma data personalizada com validação de datas válidas.
+     * Suporta tanto valores fixos quanto operações de soma/subtração.
+     * @param {number|string} [dias=0] - Dia: número fixo (ex: 15) ou operação (ex: "+7", "-3").
+     * @param {number|string} [meses=0] - Mês: número fixo (ex: 3) ou operação (ex: "+2", "-1").
+     * @param {number|string} [anos=0] - Ano: número fixo (ex: 2025) ou operação (ex: "+1", "-2").
+     * @param {number} [formato=1] - Formato de retorno da data (formataData). Se 0, retorna ISO.
+     * @returns {string} Data personalizada válida no formato definido.
+     * @throws {Error} Se a data for inválida.
+     *
+     * @example
+     * geraDataPersonalizada(1, "-1", "+1", 1) // → "01/08/2026" (se hoje é 26/07/2025)
+     */
     geraDataPersonalizada() {
       let dias = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
       let meses = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
@@ -672,6 +701,7 @@
         throw new Error(`Erro ao gerar data personalizada: ${error.message}`);
       }
     }
+
     /**
      * Função auxiliar para obter data e hora atual no formato ISO 8601 UTC (Z), ajustando dias, meses, anos e horas.
      * @param {Object} options - Parâmetros de ajuste: { days, months, years, hours }
@@ -706,16 +736,40 @@
       }
       return date.toISOString();
     }
+
     /**
-    * Função auxiliar para obter data e hora atual no formato ISO 8601 com offset de horas
-    * @param {number} hoursOffset - Número de horas a adicionar (positivo) ou subtrair (negativo)
-    * @returns {string} - Data no formato ISO 8601 (2025-04-03T18:11:07Z)
-    */
+     * Função auxiliar para obter data e hora atual no formato ISO 8601 com offset de horas
+     * @param {number} hoursOffset - Número de horas a adicionar (positivo) ou subtrair (negativo)
+     * @returns {string} - Data no formato ISO 8601 (2025-04-03T18:11:07Z)
+     */
     async getISODateWithOffsetHours(hoursOffset) {
       const date = new Date();
       date.setHours(date.getHours() + hoursOffset);
       return date.toISOString();
     }
+
+    /**
+     * Retorna a hora atual com um offset específico no formato HH:MM
+     *
+     * @param {number} horasOffset - Quantidade de horas a adicionar/subtrair (padrão: 0)
+     * @param {number} minutosOffset - Quantidade de minutos a adicionar/subtrair (padrão: 0)
+     * @returns {string} Hora formatada no padrão HH:MM
+     *
+     * @example
+     * obterHoraComOffset() // "14:30" (hora atual)
+     * obterHoraComOffset(2, 15) // "16:45" (2h15min a mais)
+     * obterHoraComOffset(-1, -30) // "13:00" (1h30min a menos)
+     */
+    obterHoraComOffset() {
+      let horasOffset = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
+      let minutosOffset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+      const date = new Date();
+      date.setHours(date.getHours() + horasOffset);
+      date.setMinutes(date.getMinutes() + minutosOffset);
+      const hora = date.getHours().toString().padStart(2, '0');
+      const minutos = date.getMinutes().toString().padStart(2, '0');
+      return `${hora}:${minutos}`;
+    }
   }
 
   const {
@@ -725,6 +779,7 @@
   const TECLA_BACKSPACE = 'Backspace';
   const TECLA_ENTER = 'Enter';
   const TECLA_TAB = 'Tab';
+  const FRAME = 'iframe[name="ci"]';
 
   /**
    * Utilitários para preenchimento e manipulação de formulários
@@ -919,6 +974,49 @@
       await locator.fill(dataInput);
       await locator.press(TECLA_ENTER);
     }
+
+    /**
+     * Valida e testa componente dropdown ou autocomplete
+     * @param {string} labelCampo - Label do campo a ser validado
+     * @param {string} tipo - Tipo do componente ('dropdown' ou 'autocomplete')
+     * @param {boolean} validaItemLista - Se deve validar se há itens na lista
+     */
+    async validaComponenteDropDown(labelCampo, tipo) {
+      let validaItemLista = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+      const frame = this.page.frameLocator(FRAME);
+      const locatorLabel = frame.locator(`label:has-text("${labelCampo}")`);
+      let locatorTrigger;
+      if (tipo === 'dropdown') {
+        locatorTrigger = locatorLabel.locator('..').locator('.ui-dropdown-trigger');
+      }
+      if (tipo === 'autocomplete') {
+        locatorTrigger = locatorLabel.first().locator('..').locator('button.ui-autocomplete-dropdown');
+      }
+      await locatorTrigger.click();
+      if (validaItemLista) {
+        await expect$3(frame.locator('ul.ui-dropdown-items li, ul.ui-autocomplete-items li').first()).toBeVisible();
+      }
+      await locatorTrigger.press('Escape');
+    }
+
+    /**
+     * Preenche campo autocomplete com texto e opcionalmente seleciona item
+     * @param {string} labelCampo - Label do campo autocomplete
+     * @param {string} texto - Texto a ser digitado
+     * @param {boolean} selecionarTexto - Se deve selecionar o texto da lista
+     */
+    async escreverComponenteAutoComplete(labelCampo, texto) {
+      let selecionarTexto = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+      const frame = this.page.frameLocator(FRAME);
+      const locatorLabel = frame.locator(`label:has-text("${labelCampo}")`);
+      const locatorInput = locatorLabel.first().locator('..').locator('input.ui-inputtext');
+      await locatorInput.fill(texto);
+      if (selecionarTexto) {
+        const locatorOption = frame.getByText(`${texto}`);
+        await expect$3(locatorOption).toBeVisible();
+        await locatorOption.click();
+      }
+    }
   }
 
   const fs = require('fs');
@@ -1254,6 +1352,7 @@
     async aguardarEstabilizacao(delayMs) {
       return new Promise(resolve => setTimeout(resolve, delayMs));
     }
+
     /**
      * Helper method para retry de elementos
      * @param {Function} countFunction - Função que retorna a contagem de elementos
@@ -1585,6 +1684,11 @@
   const {
     expect
   } = require('@playwright/test');
+
+  /**
+   * Utilitários para operações específicas da plataforma
+   * Funções para gerenciamento de notificações, exportação de dados e navegação em recursos da plataforma
+   */
   class PlatformUtils {
     constructor(page) {
       this.page = page;