polgo-upload-kit 1.1.12 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polgo-upload-kit",
-  "version": "1.1.12",
+  "version": "1.2.1",
   "type": "module",
   "main": "src/polgoUploadClient.js",
   "scripts": {

package/src/polgoUploadClient.js

@@ -1,12 +1,73 @@
 import axios from "axios";
 
+/**
+ * Cliente para upload de arquivos para o serviço Polgo
+ * @class PolgoUploadClient
+ */
 class PolgoUploadClient {
-  constructor(isProd, token, stack) {
-    this.ambiente = isProd ? "producao" : "dev";
-    this.url =
-      "https://mkgplyz3tc.execute-api.us-east-1.amazonaws.com/lambdaUploadProducao/arquivo/upload";
-    this.stack = stack;
-    this.token = token;
+  /**
+   * Inicializa o cliente de upload
+   * @param {Object|boolean} configOrIsProd - Configurações do cliente OU isProd (retrocompatibilidade)
+   * @param {boolean} [configOrIsProd.isProd=false] - Define se está em ambiente de produção
+   * @param {string} configOrIsProd.token - Token de autorização Bearer
+   * @param {string} configOrIsProd.stack - Nome da stack/aplicação
+   * @param {string} [configOrIsProd.baseUrl] - URL base personalizada para a API
+   * @param {Object} [configOrIsProd.endpoints] - Endpoints personalizados
+   * @param {string} [configOrIsProd.endpoints.upload] - Endpoint de upload personalizado
+   * @param {string} [configOrIsProd.endpoints.recuperar] - Endpoint de recuperação personalizado
+   * @param {string} [configOrIsProd.endpoints.listar] - Endpoint de listagem personalizado
+   * @param {string} [token] - Token de autorização (usado na assinatura antiga)
+   * @param {string} [stack] - Nome da stack (usado na assinatura antiga)
+   * 
+   */
+  constructor(configOrIsProd = {}, token, stack) {
+    let config;
+    
+    // Verifica se está usando a assinatura antiga (isProd, token, stack)
+    if (typeof configOrIsProd === 'boolean' || (typeof configOrIsProd !== 'object' || Array.isArray(configOrIsProd))) {
+      // Assinatura antiga: constructor(isProd, token, stack)
+      console.warn('⚠️  A assinatura PolgoUploadClient(isProd, token, stack) está deprecated. Use: new PolgoUploadClient({ isProd, token, stack })');
+      config = {
+        isProd: configOrIsProd,
+        token: token,
+        stack: stack
+      };
+    } else {
+      // Nova assinatura: constructor(config)
+      config = configOrIsProd;
+    }
+
+    // Validação de parâmetros obrigatórios
+    if (!config.token) {
+      throw new Error('Token de autorização é obrigatório');
+    }
+    if (!config.stack) {
+      throw new Error('Stack é obrigatória');
+    }
+
+    // Configurações principais
+    this.isProd = config.isProd || false;
+    this.ambiente = this.isProd ? "producao" : "dev";
+    this.token = config.token;
+    this.stack = config.stack;
+
+    // URL base configurável
+    this.baseUrl = config.baseUrl || "https://mkgplyz3tc.execute-api.us-east-1.amazonaws.com/lambdaUploadProducao";
+
+    // Endpoints configuráveis
+    this.endpoints = {
+      upload: config.endpoints?.upload || "/arquivo/upload",
+      recuperar: config.endpoints?.recuperar || "/arquivo/recuperar",
+      listar: config.endpoints?.listar || "/arquivo/listar",
+      ...config.endpoints
+    };
+
+    // URLs completas
+    this.urls = {
+      upload: `${this.baseUrl}${this.endpoints.upload}`,
+      recuperar: `${this.baseUrl}${this.endpoints.recuperar}`,
+      listar: `${this.baseUrl}${this.endpoints.listar}`
+    };
   }
 
   async recuperarArquivos(bucket, key) {
@@ -15,7 +76,7 @@ class PolgoUploadClient {
       key,
     });
 
-    const finalUrl = `https://mkgplyz3tc.execute-api.us-east-1.amazonaws.com/lambdaUploadProducao/arquivo/recuperar?${queryParams.toString()}`;
+    const finalUrl = `${this.urls.recuperar}?${queryParams.toString()}`;
 
     try {
       const response = await axios.get(finalUrl, {
@@ -38,7 +99,7 @@ class PolgoUploadClient {
       key,
     });
 
-    const finalUrl = `https://mkgplyz3tc.execute-api.us-east-1.amazonaws.com/lambdaUploadProducao/arquivo/listar?${queryParams.toString()}`;
+    const finalUrl = `${this.urls.listar}?${queryParams.toString()}`;
 
     try {
       const response = await axios.get(finalUrl, {
@@ -54,6 +115,41 @@ class PolgoUploadClient {
     }
   }
 
+  /**
+   * Faz upload de um arquivo para o bucket especificado
+   * @param {File|Buffer} bufferArquivo - O arquivo a ser enviado
+   * @param {string} bucket - Nome do bucket de destino
+   * @param {Object} options - Opções do upload
+   * @param {string} [options.diretorio] - Diretório de destino no bucket
+   * @param {string} [options.nomeArquivo] - Nome personalizado para o arquivo
+   * @param {Object} [options.otimizacao] - Parâmetros de otimização de imagem
+   * @param {number} [options.otimizacao.qualidade] - Qualidade da imagem (0-100, padrão: 85)
+   * @param {number} [options.otimizacao.largura] - Largura desejada em pixels
+   * @param {number} [options.otimizacao.altura] - Altura desejada em pixels
+   * @param {string} [options.otimizacao.formato] - Formato de saída (jpeg, png, webp)
+   * @param {number} [options.otimizacao.compressao] - Nível de compressão (0-9)
+   * @param {boolean} [options.otimizacao.manterProporcao] - Manter proporção ao redimensionar (padrão: true)
+   * @param {Function} [onProgress] - Callback para acompanhar progresso do upload
+   * @returns {Promise<Object>} Dados de resposta do upload
+   * 
+   * @example
+   * // Upload simples
+   * await client.uploadFile(file, 'meu-bucket');
+   * 
+   * @example
+   * // Upload com otimização de imagem
+   * await client.uploadFile(file, 'meu-bucket', {
+   *   diretorio: 'imagens/perfil',
+   *   nomeArquivo: 'avatar.jpg',
+   *   otimizacao: {
+   *     qualidade: 80,
+   *     largura: 800,
+   *     altura: 600,
+   *     formato: 'webp',
+   *     manterProporcao: true
+   *   }
+   * }, (progress) => console.log(`Progress: ${progress}%`));
+   */
   async uploadFile(bufferArquivo, bucket, options = {}, onProgress) {
     const mimeType = bufferArquivo.type;
 
@@ -65,10 +161,25 @@ class PolgoUploadClient {
     });
 
     if (options.diretorio) queryParams.append("diretorio", options.diretorio);
-    if (options.nomeArquivo)
-      queryParams.append("nomeArquivo", options.nomeArquivo);
+    if (options.nomeArquivo) queryParams.append("nomeArquivo", options.nomeArquivo);
+
+    // Parâmetro de otimização simplificado conforme esperado pela lambda
+    if (options.otimizacao) {
+      const { formato } = options.otimizacao;
+      if (formato === 'avif') {
+        queryParams.append("otimizacao", "avif");
+      } else if (formato === 'webp') {
+        queryParams.append("otimizacao", "webp");
+      } else if (formato === 'none' || formato === false) {
+        queryParams.append("otimizacao", "false");
+      } else {
+        queryParams.append("otimizacao", "webp"); // padrão
+      }
+    } else {
+      queryParams.append("otimizacao", "webp"); // padrão quando não especificado
+    }
 
-    const finalUrl = `${this.url}?${queryParams.toString()}`;
+    const finalUrl = `${this.urls.upload}?${queryParams.toString()}`;
     const form = new FormData();
     form.append("file", fileBlob, options.nomeArquivo || "uploaded_file");
     form.append("bucket", bucket);
@@ -98,4 +209,4 @@ class PolgoUploadClient {
   }
 }
 
-export { PolgoUploadClient };
+export { PolgoUploadClient };