@jtandrelevicius/utils-js-library 1.0.0 → 1.0.1

package/index.js

@@ -1,5 +1,5 @@
 /**
- * DataQueryService
+ * DataQueryService (Antigo JSK)
  * Responsável pela execução e processamento de consultas assíncronas.
  */
 class DataQueryService {
@@ -53,12 +53,15 @@ class DataQueryService {
      * @returns {Promise<Array<Object>>} Promise resolvendo com os dados.
      */
     static async fetch(query, params = null) {
-        if (typeof this.executor !== 'function') {
-            return Promise.reject(new Error("Executor de query não configurado. Use DataQueryService.setExecutor()."));
+        // Tenta usar o executor configurado ou busca o global executeQuery como fallback
+        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) => {
-            this.executor(query, params, 
+            executor(query, params, 
                 (rawValue) => {
                     try {
                         const data = DataQueryService.normalizeResponse(rawValue);
@@ -107,14 +110,12 @@ class DataQueryService {
 }
 
 /**
- * FormatUtils
+ * FormatUtils (Antigo JFSK)
  * Utilitários para formatação de moeda, números e datas (Locale pt-BR).
  */
 class FormatUtils {
     /**
      * Formata valor para moeda BRL (R$).
-     * @param {number|string} value 
-     * @returns {string} Ex: "R$ 1.250,00"
      */
     static currency(value) {
         const numberVal = parseFloat(value);
@@ -128,8 +129,6 @@ class FormatUtils {
 
     /**
      * Formata número inteiro com separadores de milhar.
-     * @param {number|string} value 
-     * @returns {string} Ex: "1.000"
      */
     static number(value) {
         const numberVal = parseFloat(value);
@@ -142,8 +141,6 @@ class FormatUtils {
     
     /**
      * Formata número decimal com 2 casas fixas.
-     * @param {number|string} value 
-     * @returns {string} Ex: "1.200,50"
      */
     static decimal(value) {
         const numberVal = parseFloat(value);
@@ -157,7 +154,6 @@ class FormatUtils {
 
     /**
      * Retorna data atual no formato DD/MM/YYYY.
-     * @returns {string}
      */
     static currentDate() {
         return new Intl.DateTimeFormat('pt-BR').format(new Date());
@@ -165,22 +161,16 @@ class FormatUtils {
 
     /**
      * Converte string ISO (YYYY-MM-DD) para PT-BR (DD/MM/YYYY).
-     * @param {string} isoDateString 
-     * @returns {string}
      */
     static formatDateToBR(isoDateString) {
         if (!isoDateString) return '';
         const parts = isoDateString.split('-');
         if (parts.length !== 3) return isoDateString;
-        
-        // [Ano, Mes, Dia] -> "Dia/Mes/Ano"
         return `${parts[2]}/${parts[1]}/${parts[0]}`;
     }
 
     /**
      * Retorna data atual em ISO (YYYY-MM-DD).
-     * Útil para inputs HTML tipo date.
-     * @returns {string}
      */
     static currentIsoDate() {
         return new Date().toISOString().split('T')[0];
@@ -188,7 +178,6 @@ class FormatUtils {
 
     /**
      * Data e Hora atuais (DD/MM/YYYY HH:mm).
-     * @returns {string}
      */
     static currentDateTime() {
         const now = new Date();
@@ -199,17 +188,10 @@ class FormatUtils {
 }
 
 /**
- * SortUtils
+ * SortUtils (Antigo JOSK)
  * Utilitários para ordenação de listas.
  */
 class SortUtils {
-    /**
-     * Ordena array de objetos.
-     * @param {Array<Object>} data Lista original.
-     * @param {string} key Chave do objeto para ordenar.
-     * @param {'asc'|'desc'} direction Direção da ordenação.
-     * @returns {Array<Object>} Nova lista ordenada.
-     */
     static sortBy(data, key, direction = 'asc') {
         if (!Array.isArray(data) || !key) return data;
 
@@ -234,16 +216,12 @@ class SortUtils {
 }
 
 /**
- * ExportService
+ * ExportService (Antigo JEXSK)
  * Exportação para Excel (.xlsx) e CSV.
  */
 class ExportService {
     static CDN_URL = "https://cdnjs.cloudflare.com/ajax/libs/xlsx/0.18.5/xlsx.full.min.js";
 
-    /**
-     * Carrega biblioteca externa (SheetJS) sob demanda.
-     * @private
-     */
     static async loadDependency() {
         if (typeof window !== 'undefined' && window.XLSX) return;
 
@@ -257,17 +235,8 @@ class ExportService {
         });
     }
 
-    /**
-     * Gera arquivo Excel.
-     * @param {Array<Object>} data Dados brutos.
-     * @param {Array<{key: string, display: string}>} columns Definição de colunas.
-     * @param {string} filename Nome do arquivo (sem extensão).
-     * @param {string} sheetName Nome da aba.
-     */
     static async toExcel(data, columns, filename, sheetName = 'Dados') {
         await this.loadDependency();
-
-        // Mapeia os dados para as chaves de exibição
         const formattedData = data.map(item => {
             const row = {};
             columns.forEach(col => {
@@ -282,28 +251,18 @@ class ExportService {
         XLSX.writeFile(workbook, `${filename}.xlsx`);
     }
 
-    /**
-     * Gera arquivo CSV.
-     * @param {Array<Object>} data Dados brutos.
-     * @param {Array<{key: string, display: string}>} columns Definição de colunas.
-     * @param {string} filename Nome do arquivo (sem extensão).
-     */
     static toCSV(data, columns, filename) {
         const headerRow = columns.map(c => `"${c.display}"`).join(';');
-        
         const bodyRows = data.map(item => {
             return columns.map(col => {
-                const val = item[col.key] ?? ''; 
+                const val = item[col.key] ?? '';
                 const stringVal = String(val).replace(/"/g, '""').replace(/\r?\n|\r/g, ' ');
                 return `"${stringVal}"`;
             }).join(';');
         });
-
         const csvContent = [headerRow, ...bodyRows].join('\r\n');
-        
         const blob = new Blob([csvContent], { type: 'text/csv;charset=utf-8;' });
         const link = document.createElement('a');
-        
         if (link.download !== undefined) { 
             const url = URL.createObjectURL(blob);
             link.setAttribute('href', url);
@@ -315,31 +274,35 @@ class ExportService {
         }
     }
 
-    /**
-     * Método principal de exportação.
-     */
     static async export(data, columns, filename = 'export', format = 'xlsx') {
         if (!data?.length) throw new Error("Sem dados para exportar.");
         if (!columns?.length) throw new Error("Colunas não definidas.");
 
         const fmt = format.toLowerCase();
-        
-        if (fmt === 'xlsx') {
-            await this.toExcel(data, columns, filename);
-        } else if (fmt === 'csv') {
-            this.toCSV(data, columns, filename);
-        } else {
-            throw new Error(`Formato '${format}' não suportado. Use 'xlsx' ou 'csv'.`);
-        }
+        if (fmt === 'xlsx') await this.toExcel(data, columns, filename);
+        else if (fmt === 'csv') this.toCSV(data, columns, filename);
+        else throw new Error(`Formato '${format}' não suportado.`);
     }
 }
 
+if (typeof window !== 'undefined') {
+    window.JSK = DataQueryService;
+    window.JFSK = FormatUtils;
+    window.JOSK = SortUtils;
+    window.JEXSK = ExportService;
+
+    if (typeof window.executeQuery === 'function') {
+        DataQueryService.setExecutor(window.executeQuery);
+        console.log("[DataQueryService] Executor 'executeQuery' detectado e configurado automaticamente.");
+    }
+}
 
 export { 
     DataQueryService, 
     FormatUtils, 
     SortUtils, 
     ExportService,
+    // Aliases
     DataQueryService as JSK,
     FormatUtils as JFSK,
     SortUtils as JOSK,

package/package.json

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