@jtandrelevicius/utils-js-library 1.0.5 → 1.0.7

package/index.js

@@ -1,365 +1,9 @@
 'use strict';
 
-class ServicoDados {
-    
-    /**
-     * Define o executor de query padrão para a classe (Legado).
-     * @param {Function} funcaoExecutor Função que aceita (query, params, onSuccess, onError).
-     */
-    static definirExecutor(funcaoExecutor) {
-        this.executor = funcaoExecutor;
-    }
-
-    /**
-     * Realiza requisições do tipo POST (Base para salvar/excluir).
-     * @param {string} url URL da requisição.
-     * @param {Object} corpo Corpo da requisição.
-     * @param {Object} opcoes Opções adicionais (headers, raw).
-     * @returns {Promise<Object>} Resposta da requisição.
-     */
-    static async post(url, corpo, { headers, raw } = { headers: {}, raw: false }) {
-        let isJSON = true;
-
-        if (headers) {
-            const cabecalhoTipoOriginal = headers['Content-Type'] ? String(headers['Content-Type']) : 'application/json; charset=UTF-8';
-            isJSON = headers['Content-Type'] ? RegExp(/json/i).exec(headers['Content-Type']) : isJSON;
-
-            if (headers['Content-Type']) delete headers['Content-Type'];
-            headers['Content-Type'] = cabecalhoTipoOriginal;
-        }
-
-        try {
-            let corpoRequisicaoFormatado = corpo;
-
-            if (corpo && typeof corpo === 'object') {
-                corpoRequisicaoFormatado = JSON.stringify(corpo);
-            }
-
-            if (typeof window === 'undefined' || !window.fetch) {
-                throw new Error("O método 'post' requer um ambiente de navegador com 'fetch' disponível.");
-            }
-
-            const resposta = await window.fetch.bind(window)(url, {
-                headers,
-                method: 'POST',
-                redirect: 'follow',
-                credentials: 'include',
-                body: corpoRequisicaoFormatado
-            });
-
-            if (raw) {
-                return resposta;
-            }
-
-            return isJSON ? resposta.json() : resposta.text();
-
-        } catch (erro) {
-            console.error("[ServicoDados] Erro no POST:", erro);
-            throw erro;
-        }
-    }
-
-    /**
-     * Normaliza a resposta da API (Método auxiliar).
-     * @private
-     */
-    static normalizarResposta(valorBruto) {
-        try {
-            const valorParseado = typeof valorBruto === 'string' ? JSON.parse(valorBruto) : valorBruto;
-
-            if (!valorParseado) return [];
-            if (Array.isArray(valorParseado)) return valorParseado;
-
-            let dadosFinais = null;
-
-            if (typeof valorParseado === 'object') {
-                if (typeof valorParseado.b === 'string') {
-                    dadosFinais = JSON.parse(valorParseado.b);
-                } else if (valorParseado.c?.b && typeof valorParseado.c.b === 'string') {
-                    dadosFinais = JSON.parse(valorParseado.c.b);
-                } else if (valorParseado.data?.responseBody || valorParseado.responseBody) {
-                    const corpo = valorParseado.data?.responseBody || valorParseado.responseBody;
-                    dadosFinais = typeof corpo === 'string' ? JSON.parse(corpo) : corpo;
-                }
-            }
-
-            if (Array.isArray(dadosFinais)) return dadosFinais;
-            throw new Error("Formato de resposta desconhecido ou inválido.");
-        } catch (erro) {
-            throw new Error(`Falha ao normalizar resposta da query: ${erro.message}`);
-        }
-    }
-
-    /**
-     * Executa uma consulta de dados (Via executor configurado ou executeQuery global).
-     * @param {string} query A string da consulta.
-     * @param {Object} [params=null] Parâmetros opcionais.
-     * @returns {Promise<Array<Object>>} Promise resolvendo com os dados.
-     */
-    static async consultar(query, params = null) {
-        const executor = this.executor || (typeof window !== 'undefined' ? window.executeQuery : null);
-
-        if (typeof executor !== 'function') {
-            return Promise.reject(new Error("Executor de query não configurado e 'executeQuery' global não encontrado."));
-        }
-
-        return new Promise((resolve, reject) => {
-            executor(query, params, 
-                (valorBruto) => {
-                    try {
-                        const dados = ServicoDados.normalizarResposta(valorBruto);
-                        resolve(dados || []);
-                    } catch (err) {
-                        reject(err);
-                    }
-                }, 
-                (err) => reject(new Error(`Erro na execução da query: ${err}`))
-            );
-        });
-    }
-
-    /**
-     * Executa uma consulta paginada.
-     */
-    static async consultarPaginado(query, params = null, limite, offset) {
-        const limiteSeguro = Number(limite);
-        const offsetSeguro = Number(offset);
-
-        if (isNaN(limiteSeguro) || isNaN(offsetSeguro) || limiteSeguro < 0 || offsetSeguro < 0) {
-            throw new Error("Parâmetros 'limite' e 'offset' devem ser números positivos válidos.");
-        }
-
-        const queryPaginada = `${query} LIMIT ${limiteSeguro} OFFSET ${offsetSeguro}`;
-        const dados = await ServicoDados.consultar(queryPaginada, params);
-        const paginaAtual = Math.floor(offsetSeguro / limiteSeguro) + 1;
-
-        return {
-            dados,
-            meta: { paginaAtual, itensPorPagina: limiteSeguro, totalItens: null, totalPaginas: null }
-        };
-    }
-
-    /**
-     * Salva (Insert) ou Atualiza (Update) um registro usando DatasetSP.
-     * * Lógica Automática:
-     * 1. Se 'chavesPrimarias' for informado -> Realiza UPDATE no registro específico.
-     * 2. Se 'chavesPrimarias' for NULO/UNDEFINED -> Realiza INSERT de um novo registro.
-     * * @param {Object} dados Objeto com os dados a serem gravados { CAMPO: valor }.
-     * @param {string} entidade Nome da entidade/tabela (ex: 'Parceiro', 'TGFCAB').
-     * @param {Object} [chavesPrimarias=null] Chaves primárias { PK: valor } para edição.
-     * @returns {Promise<Object>} Resposta da requisição.
-     */
-    static async salvar(dados, entidade, chavesPrimarias = null) {
-        const url = `${window.location.origin}/mge/service.sbr?serviceName=DatasetSP.save&outputType=json`;
-
-        const chavesDados = Object.keys(dados);
-        const fields = chavesDados.map(campo => campo.toUpperCase());
-        
-        const values = {};
-        chavesDados.forEach((chave, indice) => {
-            values[indice.toString()] = String(dados[chave]);
-        });
-
-        const record = { values: values };
-
-        if (chavesPrimarias) {
-            const pk = {};
-            Object.keys(chavesPrimarias).forEach(chave => {
-                pk[chave.toUpperCase()] = String(chavesPrimarias[chave]);
-            });
-            record.pk = pk;
-        }
-
-        const dadosEnvio = {
-            serviceName: 'DatasetSP.save',
-            requestBody: {
-                entityName: entidade,
-                fields: fields,
-                records: [record]
-            }
-        };
-
-        return await ServicoDados.post(url, dadosEnvio);
-    }
-
-    /**
-     * Exclui registros da base de dados.
-     * @param {string} entidade Nome da Entidade.
-     * @param {Object|Array} chavesPrimarias Objeto PK { COD: 1 } ou Array de PKs.
-     * @returns {Promise<Object>} Resposta da exclusão.
-     */
-    static async excluir(entidade, chavesPrimarias) {
-        const url = `${window.location.origin}/mge/service.sbr?serviceName=DatasetSP.removeRecord&outputType=json`;
-        
-        const dadosEnvio = {
-            serviceName: 'DatasetSP.removeRecord',
-            requestBody: {
-                entityName: entidade,
-                pks: Array.isArray(chavesPrimarias) ? chavesPrimarias : [chavesPrimarias]
-            }
-        };
-
-        return ServicoDados.post(url, dadosEnvio);
-    }
-}
-
-/**
- * UtilitariosFormatacao
- */
-class UtilitariosFormatacao {
-    static moeda(valor) {
-        const valorNumerico = parseFloat(valor);
-        if (isNaN(valorNumerico)) return "R$ 0,00";
-        return new Intl.NumberFormat('pt-BR', { style: 'currency', currency: 'BRL' }).format(valorNumerico);
-    }
-
-    static numerico(valor) {
-        const valorNumerico = parseFloat(valor);
-        if (isNaN(valorNumerico)) return "0";
-        return new Intl.NumberFormat('pt-BR', { maximumFractionDigits: 0 }).format(valorNumerico);
-    }
-    
-    static decimal(valor) {
-        const valorNumerico = parseFloat(valor);
-        if (isNaN(valorNumerico)) return "0,00";
-        return new Intl.NumberFormat('pt-BR', { minimumFractionDigits: 2, maximumFractionDigits: 2 }).format(valorNumerico);
-    }
-
-    static data() {
-        return new Intl.DateTimeFormat('pt-BR').format(new Date());
-    }
-
-    static formatarDataParaDMY(stringDataIso) {
-        if (!stringDataIso) return '';
-        const partes = stringDataIso.split('-');
-        if (partes.length !== 3) return stringDataIso;
-        return `${partes[2]}/${partes[1]}/${partes[0]}`;
-    }
-
-    static normalizarStringData(entradaData) {
-        if (!entradaData) return '01/01/2025';
-        let str = String(entradaData).trim();
-    
-        if (str.includes('/')) {
-            const partes = str.split('/');
-            if (partes.length >= 3) {
-                const dia = String(parseInt(partes[0], 10)).padStart(2, '0');
-                const mes = String(parseInt(partes[1], 10)).padStart(2, '0');
-                const ano = partes[2].substring(0, 4); 
-                return `${dia}/${mes}/${ano}`;
-            }
-        }
-    
-        if (str.includes('-')) {
-            const partes = str.split('-');
-            if (partes.length === 3) {
-                return `${partes[2].substring(0, 2)}/${partes[1]}/${partes[0]}`;
-            }
-        }
-    
-        return str; 
-    }
-
-    static obterDataAtualISO() {
-        return new Date().toISOString().split('T')[0];
-    }
-
-    static dataHora() {
-        const agora = new Date();
-        const parteData = new Intl.DateTimeFormat('pt-BR').format(agora);
-        const parteHora = agora.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' });
-        return `${parteData} ${parteHora}`;
-    }
-}
-
-/**
- * UtilitariosOrdenacao
- */
-class UtilitariosOrdenacao {
-    static ordenar(dados, chave, direcao = 'asc') {
-        if (!Array.isArray(dados) || !chave) return dados;
-        const multiplicador = direcao === 'asc' ? 1 : -1;
-
-        return [...dados].sort((a, b) => {
-            const valA = a[chave];
-            const valB = b[chave];
-            if (valA == null) return 1; 
-            if (valB == null) return -1;
-            if (typeof valA === 'string' && typeof valB === 'string') {
-                return valA.localeCompare(valB) * multiplicador;
-            }
-            if (valA < valB) return -1 * multiplicador;
-            if (valA > valB) return 1 * multiplicador;
-            return 0;
-        });
-    }
-}
-
-/**
- * ServicoExportacao
- */
-class ServicoExportacao {
-    static CDN_URL = "https://cdnjs.cloudflare.com/ajax/libs/xlsx/0.18.5/xlsx.full.min.js";
-
-    static async carregarDependencia() {
-        if (typeof window !== 'undefined' && window.XLSX) return;
-        return new Promise((resolve, reject) => {
-            const script = document.createElement('script');
-            script.src = this.CDN_URL;
-            script.async = true;
-            script.onload = () => resolve();
-            script.onerror = () => reject(new Error('Falha ao baixar dependência XLSX.'));
-            document.head.appendChild(script);
-        });
-    }
-
-    static async paraExcel(dados, colunas, nomeArquivo, nomePlanilha = 'Dados') {
-        await this.carregarDependencia();
-        const dadosFormatados = dados.map(item => {
-            const linha = {};
-            colunas.forEach(col => { linha[col.display] = item[col.key]; });
-            return linha;
-        });
-
-        const planilha = XLSX.utils.json_to_sheet(dadosFormatados);
-        const pastaTrabalho = XLSX.utils.book_new();
-        XLSX.utils.book_append_sheet(pastaTrabalho, planilha, nomePlanilha);
-        XLSX.writeFile(pastaTrabalho, `${nomeArquivo}.xlsx`);
-    }
-
-    static paraCSV(dados, colunas, nomeArquivo) {
-        const linhaCabecalho = colunas.map(c => `"${c.display}"`).join(';');
-        const linhasCorpo = dados.map(item => {
-            return colunas.map(col => {
-                const val = item[col.key] ?? '';
-                const valString = String(val).replace(/"/g, '""').replace(/\r?\n|\r/g, ' ');
-                return `"${valString}"`;
-            }).join(';');
-        });
-        const conteudoCsv = [linhaCabecalho, ...linhasCorpo].join('\r\n');
-        const blob = new Blob([conteudoCsv], { type: 'text/csv;charset=utf-8;' });
-        const link = document.createElement('a');
-        if (link.download !== undefined) { 
-            const url = URL.createObjectURL(blob);
-            link.setAttribute('href', url);
-            link.setAttribute('download', `${nomeArquivo}.csv`);
-            link.style.visibility = 'hidden';
-            document.body.appendChild(link);
-            link.click();
-            document.body.removeChild(link);
-        }
-    }
-
-    static async exportar(dados, colunas, nomeArquivo = 'exportacao', formato = 'xlsx') {
-        if (!dados?.length) throw new Error("Sem dados para exportar.");
-        if (!colunas?.length) throw new Error("Colunas não definidas.");
-
-        const fmt = formato.toLowerCase();
-        if (fmt === 'xlsx') await this.paraExcel(dados, colunas, nomeArquivo);
-        else if (fmt === 'csv') this.paraCSV(dados, colunas, nomeArquivo);
-        else throw new Error(`Formato '${formato}' não suportado.`);
-    }
-}
+import { ServicoDados } from './lib/jsk-core.js';
+import { UtilitariosFormatacao } from './lib/format-core.js';
+import { UtilitariosOrdenacao } from './lib/order-core.js';
+import { ServicoExportacao } from './lib/export-core.js';
 
 const lib = {
     ServicoDados,
@@ -367,17 +11,24 @@ const lib = {
     UtilitariosOrdenacao,
     ServicoExportacao,
 
-    // Aliases
-    JSK: ServicoDados,
+    // Aliases 
+    JSK: ServicoDados,   
     JFSK: UtilitariosFormatacao,
     JOSK: UtilitariosOrdenacao,
     JEXSK: ServicoExportacao
 };
 
-if (typeof module !== 'undefined' && module.exports) {
-    module.exports = lib;
-} else if (typeof window !== 'undefined') {
+export {
+    ServicoDados,
+    UtilitariosFormatacao,
+    UtilitariosOrdenacao,
+    ServicoExportacao,
+    lib as default
+};
+
+if (typeof window !== 'undefined') {
     Object.assign(window, lib);
+    
     if (typeof window.executeQuery === 'function') {
         ServicoDados.definirExecutor(window.executeQuery);
         console.log("[JSK] Executor 'executeQuery' detectado e configurado automaticamente.");

package/lib/export-core.js

@@ -0,0 +1,64 @@
+'use strict';
+
+export class ServicoExportacao {
+    static CDN_URL = "https://cdnjs.cloudflare.com/ajax/libs/xlsx/0.18.5/xlsx.full.min.js";
+
+    static async carregarDependencia() {
+        if (typeof window !== 'undefined' && window.XLSX) return;
+        return new Promise((resolve, reject) => {
+            const script = document.createElement('script');
+            script.src = this.CDN_URL;
+            script.async = true;
+            script.onload = () => resolve();
+            script.onerror = () => reject(new Error('Falha ao baixar dependência XLSX.'));
+            document.head.appendChild(script);
+        });
+    }
+
+    static async paraExcel(dados, colunas, nomeArquivo, nomePlanilha = 'Dados') {
+        await this.carregarDependencia();
+        const dadosFormatados = dados.map(item => {
+            const linha = {};
+            colunas.forEach(col => { linha[col.display] = item[col.key]; });
+            return linha;
+        });
+
+        const planilha = XLSX.utils.json_to_sheet(dadosFormatados);
+        const pastaTrabalho = XLSX.utils.book_new();
+        XLSX.utils.book_append_sheet(pastaTrabalho, planilha, nomePlanilha);
+        XLSX.writeFile(pastaTrabalho, `${nomeArquivo}.xlsx`);
+    }
+
+    static paraCSV(dados, colunas, nomeArquivo) {
+        const linhaCabecalho = colunas.map(c => `"${c.display}"`).join(';');
+        const linhasCorpo = dados.map(item => {
+            return colunas.map(col => {
+                const val = item[col.key] ?? '';
+                const valString = String(val).replace(/"/g, '""').replace(/\r?\n|\r/g, ' ');
+                return `"${valString}"`;
+            }).join(';');
+        });
+        const conteudoCsv = [linhaCabecalho, ...linhasCorpo].join('\r\n');
+        const blob = new Blob([conteudoCsv], { type: 'text/csv;charset=utf-8;' });
+        const link = document.createElement('a');
+        if (link.download !== undefined) { 
+            const url = URL.createObjectURL(blob);
+            link.setAttribute('href', url);
+            link.setAttribute('download', `${nomeArquivo}.csv`);
+            link.style.visibility = 'hidden';
+            document.body.appendChild(link);
+            link.click();
+            document.body.removeChild(link);
+        }
+    }
+
+    static async exportar(dados, colunas, nomeArquivo = 'exportacao', formato = 'xlsx') {
+        if (!dados?.length) throw new Error("Sem dados para exportar.");
+        if (!colunas?.length) throw new Error("Colunas não definidas.");
+
+        const fmt = formato.toLowerCase();
+        if (fmt === 'xlsx') await this.paraExcel(dados, colunas, nomeArquivo);
+        else if (fmt === 'csv') this.paraCSV(dados, colunas, nomeArquivo);
+        else throw new Error(`Formato '${formato}' não suportado.`);
+    }
+}

package/lib/format-core.js

@@ -0,0 +1,73 @@
+'use strict';
+
+export class UtilitariosFormatacao {
+    static moeda(valor) {
+        const valorNumerico = parseFloat(valor);
+        if (isNaN(valorNumerico)) return "R$ 0,00";
+        return new Intl.NumberFormat('pt-BR', { style: 'currency', currency: 'BRL' }).format(valorNumerico);
+    }
+
+    static numerico(valor) {
+        const valorNumerico = parseFloat(valor);
+        if (isNaN(valorNumerico)) return "0";
+        return new Intl.NumberFormat('pt-BR', { maximumFractionDigits: 0 }).format(valorNumerico);
+    }
+    
+    static decimal(valor) {
+        const valorNumerico = parseFloat(valor);
+        if (isNaN(valorNumerico)) return "0,00";
+        return new Intl.NumberFormat('pt-BR', { minimumFractionDigits: 2, maximumFractionDigits: 2 }).format(valorNumerico);
+    }
+
+    static porcentagem(valor) {
+        const valorNumerico = parseFloat(valor);
+        if (isNaN(valorNumerico)) return "0,00 %";
+        return new Intl.NumberFormat('pt-BR', { minimumFractionDigits: 2, maximumFractionDigits: 2 }).format(valorNumerico) + ' %';
+    }
+
+    static data() {
+        return new Intl.DateTimeFormat('pt-BR').format(new Date());
+    }
+
+    static formatarDataParaDMY(stringDataIso) {
+        if (!stringDataIso) return '';
+        const partes = stringDataIso.split('-');
+        if (partes.length !== 3) return stringDataIso;
+        return `${partes[2]}/${partes[1]}/${partes[0]}`;
+    }
+
+    static normalizarStringData(entradaData) {
+        if (!entradaData) return '01/01/2025';
+        let str = String(entradaData).trim();
+    
+        if (str.includes('/')) {
+            const partes = str.split('/');
+            if (partes.length >= 3) {
+                const dia = String(parseInt(partes[0], 10)).padStart(2, '0');
+                const mes = String(parseInt(partes[1], 10)).padStart(2, '0');
+                const ano = partes[2].substring(0, 4); 
+                return `${dia}/${mes}/${ano}`;
+            }
+        }
+    
+        if (str.includes('-')) {
+            const partes = str.split('-');
+            if (partes.length === 3) {
+                return `${partes[2].substring(0, 2)}/${partes[1]}/${partes[0]}`;
+            }
+        }
+    
+        return str; 
+    }
+
+    static obterDataAtualISO() {
+        return new Date().toISOString().split('T')[0];
+    }
+
+    static dataHora() {
+        const agora = new Date();
+        const parteData = new Intl.DateTimeFormat('pt-BR').format(agora);
+        const parteHora = agora.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' });
+        return `${parteData} ${parteHora}`;
+    }
+}

package/lib/jsk-core.js

@@ -0,0 +1,251 @@
+'use strict';
+
+export class ServicoDados {
+    
+    // =========================================================================
+    // PARTE 1: MANIPULAÇÃO DE DADOS (Banco de Dados)
+    // =========================================================================
+
+    /**
+     * Define o executor de query padrão (Legado).
+     */
+    static definirExecutor(funcaoExecutor) {
+        this.executor = funcaoExecutor;
+    }
+
+    /**
+     * Realiza requisições POST.
+     */
+    static async post(url, corpo, { headers, raw } = { headers: {}, raw: false }) {
+        let isJSON = true;
+
+        if (headers) {
+            const cabecalhoTipoOriginal = headers['Content-Type'] ? String(headers['Content-Type']) : 'application/json; charset=UTF-8';
+            isJSON = headers['Content-Type'] ? RegExp(/json/i).exec(headers['Content-Type']) : isJSON;
+            if (headers['Content-Type']) delete headers['Content-Type'];
+            headers['Content-Type'] = cabecalhoTipoOriginal;
+        }
+
+        try {
+            let corpoRequisicaoFormatado = corpo;
+            if (corpo && typeof corpo === 'object') {
+                corpoRequisicaoFormatado = JSON.stringify(corpo);
+            }
+
+            if (typeof window === 'undefined' || !window.fetch) {
+                throw new Error("Requer ambiente de navegador com 'fetch'.");
+            }
+
+            const resposta = await window.fetch.bind(window)(url, {
+                headers,
+                method: 'POST',
+                redirect: 'follow',
+                credentials: 'include',
+                body: corpoRequisicaoFormatado
+            });
+
+            if (raw) return resposta;
+            return isJSON ? resposta.json() : resposta.text();
+
+        } catch (erro) {
+            console.error("[JSK] Erro no POST:", erro);
+            throw erro;
+        }
+    }
+
+    /**
+     * Normaliza a resposta da API.
+     */
+    static normalizarResposta(valorBruto) {
+        try {
+            const valorParseado = typeof valorBruto === 'string' ? JSON.parse(valorBruto) : valorBruto;
+            if (!valorParseado) return [];
+            if (Array.isArray(valorParseado)) return valorParseado;
+
+            let dadosFinais = null;
+            if (typeof valorParseado === 'object') {
+                if (typeof valorParseado.b === 'string') {
+                    dadosFinais = JSON.parse(valorParseado.b);
+                } else if (valorParseado.c?.b && typeof valorParseado.c.b === 'string') {
+                    dadosFinais = JSON.parse(valorParseado.c.b);
+                } else if (valorParseado.data?.responseBody || valorParseado.responseBody) {
+                    const corpo = valorParseado.data?.responseBody || valorParseado.responseBody;
+                    dadosFinais = typeof corpo === 'string' ? JSON.parse(corpo) : corpo;
+                }
+            }
+            if (Array.isArray(dadosFinais)) return dadosFinais;
+            throw new Error("Formato de resposta inválido.");
+        } catch (erro) {
+            throw new Error(`Erro ao normalizar resposta: ${erro.message}`);
+        }
+    }
+
+    /**
+     * Executa consulta SQL.
+     */
+    static async consultar(query, params = null) {
+        const executor = this.executor || (typeof window !== 'undefined' ? window.executeQuery : null);
+
+        if (typeof executor !== 'function') {
+            return Promise.reject(new Error("Executor 'executeQuery' não encontrado."));
+        }
+
+        return new Promise((resolve, reject) => {
+            executor(query, params, 
+                (valorBruto) => {
+                    try {
+                        const dados = ServicoDados.normalizarResposta(valorBruto);
+                        resolve(dados || []);
+                    } catch (err) { reject(err); }
+                }, 
+                (err) => reject(new Error(`Erro na query: ${err}`))
+            );
+        });
+    }
+
+    /**
+     * Executa consulta paginada.
+     */
+    static async consultarPaginado(query, params = null, limite, offset) {
+        const limiteSeguro = Number(limite);
+        const offsetSeguro = Number(offset);
+        if (isNaN(limiteSeguro) || isNaN(offsetSeguro) || limiteSeguro < 0) throw new Error("Parâmetros de paginação inválidos.");
+
+        const queryPaginada = `${query} LIMIT ${limiteSeguro} OFFSET ${offsetSeguro}`;
+        const dados = await ServicoDados.consultar(queryPaginada, params);
+        const paginaAtual = Math.floor(offsetSeguro / limiteSeguro) + 1;
+
+        return {
+            dados,
+            meta: { paginaAtual, itensPorPagina: limiteSeguro, totalItens: null, totalPaginas: null }
+        };
+    }
+
+    /**
+     * Salva (Insert/Update) via DatasetSP.
+     */
+    static async salvar(dados, entidade, chavesPrimarias = null) {
+        const url = `${window.location.origin}/mge/service.sbr?serviceName=DatasetSP.save&outputType=json`;
+        const chavesDados = Object.keys(dados);
+        const fields = chavesDados.map(campo => campo.toUpperCase());
+        const values = {};
+        
+        chavesDados.forEach((chave, indice) => {
+            values[indice.toString()] = String(dados[chave]);
+        });
+
+        const record = { values: values };
+        if (chavesPrimarias) {
+            const pk = {};
+            Object.keys(chavesPrimarias).forEach(chave => pk[chave.toUpperCase()] = String(chavesPrimarias[chave]));
+            record.pk = pk;
+        }
+
+        return await ServicoDados.post(url, {
+            serviceName: 'DatasetSP.save',
+            requestBody: { entityName: entidade, fields: fields, records: [record] }
+        });
+    }
+
+    /**
+     * Exclui registro via DatasetSP.
+     */
+    static async excluir(entidade, chavesPrimarias) {
+        const url = `${window.location.origin}/mge/service.sbr?serviceName=DatasetSP.removeRecord&outputType=json`;
+        return ServicoDados.post(url, {
+            serviceName: 'DatasetSP.removeRecord',
+            requestBody: {
+                entityName: entidade,
+                pks: Array.isArray(chavesPrimarias) ? chavesPrimarias : [chavesPrimarias]
+            }
+        });
+    }
+
+    // =========================================================================
+    // PARTE 2: SERVIÇO DE PÁGINA (Interface / Navegação)
+    // =========================================================================
+
+    static getUrl(path) {
+        return `${window.location.origin}${path ? '/' + path.replace('/', '') : ''}`;
+    }
+
+    /**
+     * Remove o frame (Modo Fullscreen).
+     * Requer ID (nuGdt) resolvido previamente.
+     */
+    static removerFrame({ nuGdt, paginaInicial, ...opcoes } = { nuGdt: 0, paginaInicial: 'app.jsp' }) {
+        return new Promise(resolve => {
+            // Limpa alertas e scroll do parent
+            [window.parent.document, window.parent.parent.document].forEach(doc => {
+                if (doc && doc.getElementsByTagName('body').length) {
+                    const alertBox = doc.querySelector('div.gwt-PopupPanel.alert-box.box-shadow');
+                    if (alertBox) alertBox.style.display = 'none';
+                    doc.getElementsByTagName('body')[0].style.overflow = 'hidden';
+                }
+            });
+
+            resolve({ gadGetID: 'html5_z6dld', nuGdt: nuGdt || 0, ...opcoes });
+        }).then(o =>
+            setTimeout(() => {
+                if (typeof window.parent.document.getElementsByClassName('DashWindow')[0] != 'undefined') {
+                    const opcoesUrl = Object.keys(o)
+                        .filter(item => !['params', 'UID', 'instance', 'nuGdg', 'gadGetID'].includes(item))
+                        .map(item => `&${item}=${o[item]}`)
+                        .join('');
+
+                    const url = `/mge/html5component.mge?entryPoint=${paginaInicial}&nuGdg=${o.nuGdt}${opcoesUrl}`;
+                    
+                    const gadgetDiv = window.parent.document.getElementsByClassName('dyna-gadget')[0];
+                    if (gadgetDiv) {
+                        gadgetDiv.innerHTML = `<iframe src="${url}" class="gwt-Frame" style="width: 100%; height: 100%;"></iframe>`;
+                    }
+
+                    // Limpa popups residuais
+                    const popup = document.getElementsByClassName('popupContent')[0];
+                    if (popup && popup.parentElement) popup.parentElement.remove();
+
+                    // Trava scroll local
+                    const styleEl = document.getElementById('stndz-style');
+                    if (styleEl && styleEl.parentElement && styleEl.parentElement.parentElement) {
+                        styleEl.parentElement.parentElement.getElementsByTagName('body')[0].style.overflow = 'hidden';
+                    }
+                }
+            }, 500)
+        );
+    }
+
+    /**
+     * Abre Nova Guia.
+     */
+    static novaGuia(forcado = false) {
+        const isSankhya = !!window.parent.parent.document.querySelector('.Taskbar-container');
+        if ((isSankhya && !forcado) || forcado) {
+            Object.assign(document.createElement('a'), { target: '_blank', href: window.location.href }).click();
+        }
+    }
+
+    /**
+     * Abre Pagina no Sankhya-W.
+     */
+    static abrirPagina(resourceID, chavesPrimarias) {
+        let url = ServicoDados.getUrl(`/mge/system.jsp#app/%resID`);
+        url = url.replace('%resID', btoa(resourceID));
+
+        if (chavesPrimarias) {
+            let body = {};
+            Object.keys(chavesPrimarias).forEach(k => body[k] = isNaN(chavesPrimarias[k]) ? String(chavesPrimarias[k]) : Number(chavesPrimarias[k]));
+            url = url.concat(`/${btoa(JSON.stringify(body))}`);
+        }
+
+        Object.assign(document.createElement('a'), { target: '_top', href: url }).click();
+    }
+
+    /**
+     * Fecha a Pagina atual.
+     */
+    static fecharPagina() {
+        const closeBtn = window.parent.parent.document.querySelector('li.ListItem.AppItem.AppItem-selected div.Taskbar-icon.icon-close');
+        if (closeBtn) closeBtn.click();
+        else window.close();
+    }
+}

package/lib/order-core.js

@@ -0,0 +1,21 @@
+'use strict';
+
+export class UtilitariosOrdenacao {
+    static ordenar(dados, chave, direcao = 'asc') {
+        if (!Array.isArray(dados) || !chave) return dados;
+        const multiplicador = direcao === 'asc' ? 1 : -1;
+
+        return [...dados].sort((a, b) => {
+            const valA = a[chave];
+            const valB = b[chave];
+            if (valA == null) return 1; 
+            if (valB == null) return -1;
+            if (typeof valA === 'string' && typeof valB === 'string') {
+                return valA.localeCompare(valB) * multiplicador;
+            }
+            if (valA < valB) return -1 * multiplicador;
+            if (valA > valB) return 1 * multiplicador;
+            return 0;
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jtandrelevicius/utils-js-library",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "",
   "main": "index.js",
   "scripts": {