polgo-upload-kit 1.2.3 → 2.0.0

package/dist/polgoUploadClient.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Configuracoes do cliente de upload
+ */
+export interface PolgoUploadClientConfig {
+    /** Define se esta em ambiente de producao */
+    isProd?: boolean;
+    /** Token de autorizacao Bearer */
+    token: string;
+    /** Nome da stack/aplicacao */
+    stack: string;
+    /** URL base personalizada para a API */
+    baseUrl?: string;
+    /** Timeout das requisicoes em ms (padrao: 30s) */
+    timeout?: number;
+    /** Endpoints personalizados */
+    endpoints?: EndpointsConfig;
+}
+/**
+ * Configuracao de endpoints personalizados
+ */
+export interface EndpointsConfig {
+    /** Endpoint de upload personalizado */
+    upload?: string;
+    /** Endpoint de recuperacao personalizado */
+    recuperar?: string;
+    /** Endpoint de listagem personalizado */
+    listar?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Opcoes para upload de arquivo
+ */
+export interface UploadOptions {
+    /** Diretorio de destino no bucket */
+    diretorio?: string;
+    /** Nome personalizado para o arquivo */
+    nomeArquivo?: string;
+    /**
+     * Otimizacao conforme a lambda espera:
+     * - false: desabilita otimizacao
+     * - "jpeg" | "webp" | "avif": formato desejado (padrao: "webp")
+     * - { formato }: compatibilidade com versoes antigas (aceita "none" para desabilitar)
+     */
+    otimizacao?: false | "jpeg" | "webp" | "avif" | {
+        formato?: string;
+    };
+    /** Forca conversao mesmo se o arquivo resultante for maior que o original */
+    forcarConversao?: boolean;
+}
+/**
+ * Resultado do upload de arquivo
+ */
+export interface UploadResult {
+    /** ID unico do arquivo */
+    id: string;
+    /** URL do arquivo no bucket */
+    endereco: string;
+    /** Tamanho original do arquivo em bytes */
+    tamanhoOriginal: number;
+    /** Tamanho do arquivo apos otimizacao em bytes */
+    tamanhoOtimizado: number;
+    /** Indica se o arquivo foi otimizado */
+    otimizado: boolean;
+    /** Formato MIME original do arquivo */
+    formatoOriginal: string;
+    /** Formato MIME apos otimizacao */
+    formatoOtimizado: string;
+    /** Percentual de economia de espaco (pode ser negativo se forcar conversao) */
+    economiaPercentual: number;
+}
+/**
+ * Resultado da recuperacao de arquivo
+ */
+export interface RecuperarArquivoResult {
+    /** URL pre-assinada do arquivo */
+    url?: string;
+    /** Dados do arquivo */
+    [key: string]: unknown;
+}
+/**
+ * Item da listagem de arquivos
+ */
+export interface ArquivoListItem {
+    /** Chave do arquivo no bucket */
+    key: string;
+    /** Tamanho do arquivo em bytes */
+    size?: number;
+    /** Data da ultima modificacao */
+    lastModified?: string;
+    [key: string]: unknown;
+}
+/**
+ * Callback de progresso do upload
+ */
+export type ProgressCallback = (percentCompleted: number) => void;
+/**
+ * Cliente para upload de arquivos para o servico Polgo
+ */
+declare class PolgoUploadClient {
+    private isProd;
+    private ambiente;
+    private token;
+    private stack;
+    private timeout;
+    private baseUrl;
+    private endpoints;
+    private urls;
+    /**
+     * Inicializa o cliente de upload
+     * @param config - Configuracoes do cliente
+     */
+    constructor(config: PolgoUploadClientConfig);
+    /**
+     * Valida se o bucket foi informado
+     * @param bucket - Nome do bucket
+     */
+    private _validarBucket;
+    /**
+     * Trata erros das requisicoes HTTP
+     * @param error - Erro capturado
+     * @param operacao - Nome da operacao que falhou
+     */
+    private _handleError;
+    /**
+     * Recupera um arquivo do bucket especificado
+     * @param bucket - Nome do bucket
+     * @param key - Chave (caminho) do arquivo no bucket
+     * @returns Dados do arquivo recuperado
+     * @throws Se houver erro na requisicao ou arquivo nao encontrado
+     *
+     * @example
+     * const arquivo = await client.recuperarArquivos('meu-bucket', 'imagens/avatar.jpg');
+     */
+    recuperarArquivos(bucket: string, key: string): Promise<RecuperarArquivoResult>;
+    /**
+     * Lista arquivos de um diretorio no bucket
+     * @param bucket - Nome do bucket
+     * @param key - Chave (caminho) do diretorio no bucket
+     * @returns Lista de arquivos encontrados
+     * @throws Se houver erro na requisicao ou diretorio nao encontrado
+     *
+     * @example
+     * const arquivos = await client.listarArquivos('meu-bucket', 'imagens/perfil');
+     */
+    listarArquivos(bucket: string, key: string): Promise<ArquivoListItem[]>;
+    /**
+     * Faz upload de um arquivo para o bucket especificado
+     * @param bufferArquivo - O arquivo a ser enviado
+     * @param bucket - Nome do bucket de destino
+     * @param options - Opcoes do upload
+     * @param onProgress - Callback para acompanhar progresso do upload (recebe percentual 0-100)
+     * @returns Dados de resposta do upload
+     *
+     * @example
+     * // Upload simples
+     * await client.uploadFile(file, 'meu-bucket');
+     *
+     * @example
+     * // Upload com otimizacao de imagem
+     * await client.uploadFile(file, 'meu-bucket', {
+     *   diretorio: 'imagens/perfil',
+     *   nomeArquivo: 'avatar.jpg',
+     *   otimizacao: 'webp'
+     * }, (progress) => console.log(`Progress: ${progress}%`));
+     *
+     * @example
+     * // Upload com conversao forcada (mantem formato mesmo se maior)
+     * await client.uploadFile(file, 'meu-bucket', {
+     *   otimizacao: 'avif',
+     *   forcarConversao: true
+     * });
+     *
+     * @example
+     * // Upload sem otimizacao
+     * await client.uploadFile(file, 'meu-bucket', {
+     *   otimizacao: false
+     * });
+     */
+    uploadFile(bufferArquivo: File | Blob, bucket: string, options?: UploadOptions, onProgress?: ProgressCallback): Promise<UploadResult>;
+}
+export { PolgoUploadClient };
+export default PolgoUploadClient;
+//# sourceMappingURL=polgoUploadClient.d.ts.map

package/dist/polgoUploadClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polgoUploadClient.d.ts","sourceRoot":"","sources":["../src/polgoUploadClient.ts"],"names":[],"mappings":"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"}

package/dist/polgoUploadClient.js

@@ -0,0 +1,254 @@
+import axios from "axios";
+/**
+ * Cliente para upload de arquivos para o servico Polgo
+ */
+class PolgoUploadClient {
+    /**
+     * Inicializa o cliente de upload
+     * @param config - Configuracoes do cliente
+     */
+    constructor(config) {
+        // Validacao de parametros obrigatorios
+        if (!config.token) {
+            throw new Error("Token de autorizacao e obrigatorio");
+        }
+        if (!config.stack) {
+            throw new Error("Stack e obrigatoria");
+        }
+        // Configuracoes principais
+        this.isProd = config.isProd || false;
+        this.ambiente = this.isProd ? "producao" : "dev";
+        this.token = config.token;
+        this.stack = config.stack;
+        this.timeout = config.timeout || 30000;
+        // URL base configuravel
+        this.baseUrl = config.baseUrl || "https://uploadws.polgo.com.br";
+        // Endpoints configuraveis
+        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}`
+        };
+    }
+    /**
+     * Valida se o bucket foi informado
+     * @param bucket - Nome do bucket
+     */
+    _validarBucket(bucket) {
+        if (!bucket || typeof bucket !== "string" || bucket.trim() === "") {
+            throw new Error("Bucket e obrigatorio");
+        }
+    }
+    /**
+     * Trata erros das requisicoes HTTP
+     * @param error - Erro capturado
+     * @param operacao - Nome da operacao que falhou
+     */
+    _handleError(error, operacao) {
+        if (error.response) {
+            const status = error.response.status;
+            const data = error.response.data;
+            if (status === 401) {
+                throw new Error("Nao autorizado. Verifique seu token de acesso.");
+            }
+            else if (status === 400) {
+                throw new Error(data?.message || "Requisicao invalida. Verifique os parametros enviados.");
+            }
+            else if (status === 404) {
+                throw new Error(data?.message || "Recurso nao encontrado.");
+            }
+            else if (status === 413) {
+                throw new Error("Arquivo muito grande. Tamanho maximo excedido.");
+            }
+            else if (status >= 500) {
+                throw new Error("Erro interno do servidor. Tente novamente mais tarde.");
+            }
+            else {
+                throw new Error(data?.message || `Falha ao ${operacao}: ${error.message}`);
+            }
+        }
+        else if (error.code === "ECONNABORTED") {
+            throw new Error(`Timeout: a requisicao excedeu o tempo limite de ${this.timeout}ms.`);
+        }
+        else if (error.request) {
+            throw new Error("Nao foi possivel conectar ao servidor. Verifique sua conexao.");
+        }
+        else {
+            throw new Error(`Falha ao ${operacao}: ${error.message}`);
+        }
+    }
+    /**
+     * Recupera um arquivo do bucket especificado
+     * @param bucket - Nome do bucket
+     * @param key - Chave (caminho) do arquivo no bucket
+     * @returns Dados do arquivo recuperado
+     * @throws Se houver erro na requisicao ou arquivo nao encontrado
+     *
+     * @example
+     * const arquivo = await client.recuperarArquivos('meu-bucket', 'imagens/avatar.jpg');
+     */
+    async recuperarArquivos(bucket, key) {
+        this._validarBucket(bucket);
+        if (!key || typeof key !== "string" || key.trim() === "") {
+            throw new Error("Key e obrigatoria");
+        }
+        const queryParams = new URLSearchParams({
+            bucket,
+            key,
+        });
+        const finalUrl = `${this.urls.recuperar}?${queryParams.toString()}`;
+        try {
+            const response = await axios.get(finalUrl, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                },
+                timeout: this.timeout,
+            });
+            return response.data;
+        }
+        catch (error) {
+            this._handleError(error, "recuperar arquivo");
+        }
+    }
+    /**
+     * Lista arquivos de um diretorio no bucket
+     * @param bucket - Nome do bucket
+     * @param key - Chave (caminho) do diretorio no bucket
+     * @returns Lista de arquivos encontrados
+     * @throws Se houver erro na requisicao ou diretorio nao encontrado
+     *
+     * @example
+     * const arquivos = await client.listarArquivos('meu-bucket', 'imagens/perfil');
+     */
+    async listarArquivos(bucket, key) {
+        this._validarBucket(bucket);
+        if (!key || typeof key !== "string" || key.trim() === "") {
+            throw new Error("Key e obrigatoria");
+        }
+        const queryParams = new URLSearchParams({
+            bucket,
+            key,
+        });
+        const finalUrl = `${this.urls.listar}?${queryParams.toString()}`;
+        try {
+            const response = await axios.get(finalUrl, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                },
+                timeout: this.timeout,
+            });
+            return response.data.arquivos || [];
+        }
+        catch (error) {
+            this._handleError(error, "listar arquivos");
+        }
+    }
+    /**
+     * Faz upload de um arquivo para o bucket especificado
+     * @param bufferArquivo - O arquivo a ser enviado
+     * @param bucket - Nome do bucket de destino
+     * @param options - Opcoes do upload
+     * @param onProgress - Callback para acompanhar progresso do upload (recebe percentual 0-100)
+     * @returns Dados de resposta do upload
+     *
+     * @example
+     * // Upload simples
+     * await client.uploadFile(file, 'meu-bucket');
+     *
+     * @example
+     * // Upload com otimizacao de imagem
+     * await client.uploadFile(file, 'meu-bucket', {
+     *   diretorio: 'imagens/perfil',
+     *   nomeArquivo: 'avatar.jpg',
+     *   otimizacao: 'webp'
+     * }, (progress) => console.log(`Progress: ${progress}%`));
+     *
+     * @example
+     * // Upload com conversao forcada (mantem formato mesmo se maior)
+     * await client.uploadFile(file, 'meu-bucket', {
+     *   otimizacao: 'avif',
+     *   forcarConversao: true
+     * });
+     *
+     * @example
+     * // Upload sem otimizacao
+     * await client.uploadFile(file, 'meu-bucket', {
+     *   otimizacao: false
+     * });
+     */
+    async uploadFile(bufferArquivo, bucket, options = {}, onProgress) {
+        this._validarBucket(bucket);
+        if (!bufferArquivo) {
+            throw new Error("Arquivo e obrigatorio");
+        }
+        const mimeType = bufferArquivo.type;
+        const fileBlob = new Blob([bufferArquivo], { type: mimeType });
+        const queryParams = new URLSearchParams({
+            ambiente: this.ambiente,
+            stack: this.stack,
+        });
+        if (options.diretorio)
+            queryParams.append("diretorio", options.diretorio);
+        if (options.nomeArquivo)
+            queryParams.append("nomeArquivo", options.nomeArquivo);
+        if (options.forcarConversao === true) {
+            queryParams.append("forcarConversao", "true");
+        }
+        // Parametro de otimizacao conforme a lambda espera (false|0|jpeg|webp|avif; padrao: webp)
+        const normalizarOtimizacao = (otimizacao) => {
+            if (otimizacao === undefined || otimizacao === null)
+                return "webp";
+            if (otimizacao === false)
+                return "false";
+            // Compatibilidade com a forma antiga: { formato: 'webp' }
+            if (typeof otimizacao === "object") {
+                const formato = otimizacao?.formato;
+                if (formato === undefined || formato === null)
+                    return "webp";
+                if (formato === "false" || formato === "0" || formato === "none")
+                    return "false";
+                if (formato === "jpg")
+                    return "jpeg";
+                if (formato === "jpeg" || formato === "webp" || formato === "avif")
+                    return formato;
+                return "webp";
+            }
+            if (otimizacao === "jpeg" || otimizacao === "webp" || otimizacao === "avif")
+                return otimizacao;
+            return "webp";
+        };
+        queryParams.append("otimizacao", normalizarOtimizacao(options.otimizacao));
+        const finalUrl = `${this.urls.upload}?${queryParams.toString()}`;
+        const form = new FormData();
+        form.append("file", fileBlob, options.nomeArquivo || "uploaded_file");
+        form.append("bucket", bucket);
+        try {
+            const response = await axios.post(finalUrl, form, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                },
+                timeout: this.timeout,
+                onUploadProgress: (progressEvent) => {
+                    if (typeof onProgress === "function" && progressEvent.total) {
+                        const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total);
+                        onProgress(percentCompleted);
+                    }
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            this._handleError(error, "fazer upload");
+        }
+    }
+}
+export { PolgoUploadClient };
+export default PolgoUploadClient;
+//# sourceMappingURL=polgoUploadClient.js.map

package/dist/polgoUploadClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polgoUploadClient.js","sourceRoot":"","sources":["../src/polgoUploadClient.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,22 +1,37 @@
 {
   "name": "polgo-upload-kit",
-  "version": "1.2.3",
+  "version": "2.0.0",
   "type": "module",
-  "main": "src/polgoUploadClient.js",
+  "main": "./dist/polgoUploadClient.js",
+  "types": "./dist/polgoUploadClient.d.ts",
   "exports": {
-    ".": "./src/polgoUploadClient.js"
+    ".": {
+      "types": "./dist/polgoUploadClient.d.ts",
+      "import": "./dist/polgoUploadClient.js"
+    },
+    "./src/polgoUploadClient": {
+      "types": "./dist/polgoUploadClient.d.ts",
+      "import": "./dist/polgoUploadClient.js"
+    },
+    "./src/polgoUploadClient.js": {
+      "types": "./dist/polgoUploadClient.d.ts",
+      "import": "./dist/polgoUploadClient.js"
+    }
   },
   "files": [
+    "dist",
     "src"
   ],
   "scripts": {
-    "build": "webpack"
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "upload",
     "s3",
     "polgo",
-    "file-upload"
+    "file-upload",
+    "typescript"
   ],
   "author": "Grupo NSC",
   "license": "ISC",
@@ -30,8 +45,10 @@
   },
   "homepage": "https://github.com/Grupo-NSC/polgo-upload-kit#readme",
   "dependencies": {
-    "axios": "^1.7.7",
-    "form-data": "^4.0.1",
-    "mime-types": "^2.1.35"
+    "axios": "^1.7.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
   }
 }

package/src/{polgoUploadClient.js → polgoUploadClient.ts}

@@ -1,42 +1,132 @@
-import axios from "axios";
+import axios, { AxiosError, AxiosProgressEvent } from "axios";
+
+/**
+ * Configuracoes do cliente de upload
+ */
+export interface PolgoUploadClientConfig {
+  /** Define se esta em ambiente de producao */
+  isProd?: boolean;
+  /** Token de autorizacao Bearer */
+  token: string;
+  /** Nome da stack/aplicacao */
+  stack: string;
+  /** URL base personalizada para a API */
+  baseUrl?: string;
+  /** Timeout das requisicoes em ms (padrao: 30s) */
+  timeout?: number;
+  /** Endpoints personalizados */
+  endpoints?: EndpointsConfig;
+}
+
+/**
+ * Configuracao de endpoints personalizados
+ */
+export interface EndpointsConfig {
+  /** Endpoint de upload personalizado */
+  upload?: string;
+  /** Endpoint de recuperacao personalizado */
+  recuperar?: string;
+  /** Endpoint de listagem personalizado */
+  listar?: string;
+  [key: string]: string | undefined;
+}
+
+/**
+ * Opcoes para upload de arquivo
+ */
+export interface UploadOptions {
+  /** Diretorio de destino no bucket */
+  diretorio?: string;
+  /** Nome personalizado para o arquivo */
+  nomeArquivo?: string;
+  /**
+   * Otimizacao conforme a lambda espera:
+   * - false: desabilita otimizacao
+   * - "jpeg" | "webp" | "avif": formato desejado (padrao: "webp")
+   * - { formato }: compatibilidade com versoes antigas (aceita "none" para desabilitar)
+   */
+  otimizacao?: false | "jpeg" | "webp" | "avif" | { formato?: string };
+  /** Forca conversao mesmo se o arquivo resultante for maior que o original */
+  forcarConversao?: boolean;
+}
+
+/**
+ * Resultado do upload de arquivo
+ */
+export interface UploadResult {
+  /** ID unico do arquivo */
+  id: string;
+  /** URL do arquivo no bucket */
+  endereco: string;
+  /** Tamanho original do arquivo em bytes */
+  tamanhoOriginal: number;
+  /** Tamanho do arquivo apos otimizacao em bytes */
+  tamanhoOtimizado: number;
+  /** Indica se o arquivo foi otimizado */
+  otimizado: boolean;
+  /** Formato MIME original do arquivo */
+  formatoOriginal: string;
+  /** Formato MIME apos otimizacao */
+  formatoOtimizado: string;
+  /** Percentual de economia de espaco (pode ser negativo se forcar conversao) */
+  economiaPercentual: number;
+}
+
+/**
+ * Resultado da recuperacao de arquivo
+ */
+export interface RecuperarArquivoResult {
+  /** URL pre-assinada do arquivo */
+  url?: string;
+  /** Dados do arquivo */
+  [key: string]: unknown;
+}
+
+/**
+ * Item da listagem de arquivos
+ */
+export interface ArquivoListItem {
+  /** Chave do arquivo no bucket */
+  key: string;
+  /** Tamanho do arquivo em bytes */
+  size?: number;
+  /** Data da ultima modificacao */
+  lastModified?: string;
+  [key: string]: unknown;
+}
+
+/**
+ * Callback de progresso do upload
+ */
+export type ProgressCallback = (percentCompleted: number) => void;
+
+/**
+ * URLs internas do cliente
+ */
+interface ClientUrls {
+  upload: string;
+  recuperar: string;
+  listar: string;
+}
 
 /**
  * Cliente para upload de arquivos para o servico Polgo
- * @class PolgoUploadClient
  */
 class PolgoUploadClient {
+  private isProd: boolean;
+  private ambiente: "producao" | "dev";
+  private token: string;
+  private stack: string;
+  private timeout: number;
+  private baseUrl: string;
+  private endpoints: Required<Pick<EndpointsConfig, "upload" | "recuperar" | "listar">> & EndpointsConfig;
+  private urls: ClientUrls;
+
   /**
    * Inicializa o cliente de upload
-   * @param {Object|boolean} configOrIsProd - Configuracoes do cliente OU isProd (retrocompatibilidade)
-   * @param {boolean} [configOrIsProd.isProd=false] - Define se esta em ambiente de producao
-   * @param {string} configOrIsProd.token - Token de autorizacao Bearer
-   * @param {string} configOrIsProd.stack - Nome da stack/aplicacao
-   * @param {string} [configOrIsProd.baseUrl] - URL base personalizada para a API
-   * @param {number} [configOrIsProd.timeout=30000] - Timeout das requisicoes em ms (padrao: 30s)
-   * @param {Object} [configOrIsProd.endpoints] - Endpoints personalizados
-   * @param {string} [configOrIsProd.endpoints.upload] - Endpoint de upload personalizado
-   * @param {string} [configOrIsProd.endpoints.recuperar] - Endpoint de recuperacao personalizado
-   * @param {string} [configOrIsProd.endpoints.listar] - Endpoint de listagem personalizado
-   * @param {string} [token] - Token de autorizacao (usado na assinatura antiga)
-   * @param {string} [stack] - Nome da stack (usado na assinatura antiga)
+   * @param config - Configuracoes do cliente
    */
-  constructor(configOrIsProd = {}, token, stack) {
-    let config;
-
-    // Verifica se esta 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("Aviso: a assinatura PolgoUploadClient(isProd, token, stack) esta deprecated. Use: new PolgoUploadClient({ isProd, token, stack })");
-      config = {
-        isProd: configOrIsProd,
-        token: token,
-        stack: stack
-      };
-    } else {
-      // Nova assinatura: constructor(config)
-      config = configOrIsProd;
-    }
-
+  constructor(config: PolgoUploadClientConfig) {
     // Validacao de parametros obrigatorios
     if (!config.token) {
       throw new Error("Token de autorizacao e obrigatorio");
@@ -53,7 +143,7 @@ class PolgoUploadClient {
     this.timeout = config.timeout || 30000;
 
     // URL base configuravel
-    this.baseUrl = config.baseUrl || "https://mkgplyz3tc.execute-api.us-east-1.amazonaws.com/lambdaUploadProducao";
+    this.baseUrl = config.baseUrl || "https://uploadws.polgo.com.br";
 
     // Endpoints configuraveis
     this.endpoints = {
@@ -73,10 +163,9 @@ class PolgoUploadClient {
 
   /**
    * Valida se o bucket foi informado
-   * @param {string} bucket - Nome do bucket
-   * @private
+   * @param bucket - Nome do bucket
    */
-  _validarBucket(bucket) {
+  private _validarBucket(bucket: string): void {
     if (!bucket || typeof bucket !== "string" || bucket.trim() === "") {
       throw new Error("Bucket e obrigatorio");
     }
@@ -84,11 +173,10 @@ class PolgoUploadClient {
 
   /**
    * Trata erros das requisicoes HTTP
-   * @param {Error} error - Erro capturado
-   * @param {string} operacao - Nome da operacao que falhou
-   * @private
+   * @param error - Erro capturado
+   * @param operacao - Nome da operacao que falhou
    */
-  _handleError(error, operacao) {
+  private _handleError(error: AxiosError<{ message?: string }>, operacao: string): never {
     if (error.response) {
       const status = error.response.status;
       const data = error.response.data;
@@ -117,15 +205,15 @@ class PolgoUploadClient {
 
   /**
    * Recupera um arquivo do bucket especificado
-   * @param {string} bucket - Nome do bucket
-   * @param {string} key - Chave (caminho) do arquivo no bucket
-   * @returns {Promise<Object>} Dados do arquivo recuperado
-   * @throws {Error} Se houver erro na requisicao ou arquivo nao encontrado
+   * @param bucket - Nome do bucket
+   * @param key - Chave (caminho) do arquivo no bucket
+   * @returns Dados do arquivo recuperado
+   * @throws Se houver erro na requisicao ou arquivo nao encontrado
    *
    * @example
    * const arquivo = await client.recuperarArquivos('meu-bucket', 'imagens/avatar.jpg');
    */
-  async recuperarArquivos(bucket, key) {
+  async recuperarArquivos(bucket: string, key: string): Promise<RecuperarArquivoResult> {
     this._validarBucket(bucket);
 
     if (!key || typeof key !== "string" || key.trim() === "") {
@@ -140,7 +228,7 @@ class PolgoUploadClient {
     const finalUrl = `${this.urls.recuperar}?${queryParams.toString()}`;
 
     try {
-      const response = await axios.get(finalUrl, {
+      const response = await axios.get<RecuperarArquivoResult>(finalUrl, {
         headers: {
           Authorization: `Bearer ${this.token}`,
         },
@@ -149,21 +237,21 @@ class PolgoUploadClient {
 
       return response.data;
     } catch (error) {
-      this._handleError(error, "recuperar arquivo");
+      this._handleError(error as AxiosError<{ message?: string }>, "recuperar arquivo");
     }
   }
 
   /**
    * Lista arquivos de um diretorio no bucket
-   * @param {string} bucket - Nome do bucket
-   * @param {string} key - Chave (caminho) do diretorio no bucket
-   * @returns {Promise<Array>} Lista de arquivos encontrados
-   * @throws {Error} Se houver erro na requisicao ou diretorio nao encontrado
+   * @param bucket - Nome do bucket
+   * @param key - Chave (caminho) do diretorio no bucket
+   * @returns Lista de arquivos encontrados
+   * @throws Se houver erro na requisicao ou diretorio nao encontrado
    *
    * @example
    * const arquivos = await client.listarArquivos('meu-bucket', 'imagens/perfil');
    */
-  async listarArquivos(bucket, key) {
+  async listarArquivos(bucket: string, key: string): Promise<ArquivoListItem[]> {
     this._validarBucket(bucket);
 
     if (!key || typeof key !== "string" || key.trim() === "") {
@@ -178,7 +266,7 @@ class PolgoUploadClient {
     const finalUrl = `${this.urls.listar}?${queryParams.toString()}`;
 
     try {
-      const response = await axios.get(finalUrl, {
+      const response = await axios.get<{ arquivos?: ArquivoListItem[] }>(finalUrl, {
         headers: {
           Authorization: `Bearer ${this.token}`,
         },
@@ -187,32 +275,17 @@ class PolgoUploadClient {
 
       return response.data.arquivos || [];
     } catch (error) {
-      this._handleError(error, "listar arquivos");
+      this._handleError(error as AxiosError<{ message?: string }>, "listar arquivos");
     }
   }
 
   /**
    * 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 - Opcoes do upload
-   * @param {string} [options.diretorio] - Diretorio de destino no bucket
-   * @param {string} [options.nomeArquivo] - Nome personalizado para o arquivo
-   * @param {false|"jpeg"|"webp"|"avif"|Object} [options.otimizacao] - Otimizacao conforme a lambda espera:
-   *  - false: desabilita otimizacao
-   *  - "jpeg" | "webp" | "avif": formato desejado (padrao: "webp")
-   *  - { formato }: compatibilidade com versoes antigas (aceita "none" para desabilitar)
-   * @param {boolean} [options.forcarConversao=false] - Forca conversao mesmo se o arquivo resultante for maior que o original
-   * @param {Function} [onProgress] - Callback para acompanhar progresso do upload (recebe percentual 0-100)
-   * @returns {Promise<Object>} Dados de resposta do upload contendo:
-   *  - {string} id - ID unico do arquivo
-   *  - {string} endereco - URL do arquivo no bucket
-   *  - {number} tamanhoOriginal - Tamanho original do arquivo em bytes
-   *  - {number} tamanhoOtimizado - Tamanho do arquivo apos otimizacao em bytes
-   *  - {boolean} otimizado - Indica se o arquivo foi otimizado
-   *  - {string} formatoOriginal - Formato MIME original do arquivo
-   *  - {string} formatoOtimizado - Formato MIME apos otimizacao
-   *  - {number} economiaPercentual - Percentual de economia de espaco (pode ser negativo se forcar conversao)
+   * @param bufferArquivo - O arquivo a ser enviado
+   * @param bucket - Nome do bucket de destino
+   * @param options - Opcoes do upload
+   * @param onProgress - Callback para acompanhar progresso do upload (recebe percentual 0-100)
+   * @returns Dados de resposta do upload
    *
    * @example
    * // Upload simples
@@ -238,14 +311,13 @@ class PolgoUploadClient {
    * await client.uploadFile(file, 'meu-bucket', {
    *   otimizacao: false
    * });
-   *
-   * @example
-   * // Upload com compatibilidade de formato antigo
-   * await client.uploadFile(file, 'meu-bucket', {
-   *   otimizacao: { formato: 'webp' }
-   * });
    */
-  async uploadFile(bufferArquivo, bucket, options = {}, onProgress) {
+  async uploadFile(
+    bufferArquivo: File | Blob,
+    bucket: string,
+    options: UploadOptions = {},
+    onProgress?: ProgressCallback
+  ): Promise<UploadResult> {
     this._validarBucket(bucket);
 
     if (!bufferArquivo) {
@@ -262,28 +334,25 @@ class PolgoUploadClient {
 
     if (options.diretorio) queryParams.append("diretorio", options.diretorio);
     if (options.nomeArquivo) queryParams.append("nomeArquivo", options.nomeArquivo);
-    if (options.forcarConversao === true || options.forcarConversao === "true" || options.forcarConversao === 1 || options.forcarConversao === "1") {
+    if (options.forcarConversao === true) {
       queryParams.append("forcarConversao", "true");
     }
 
     // Parametro de otimizacao conforme a lambda espera (false|0|jpeg|webp|avif; padrao: webp)
-    const normalizarOtimizacao = (otimizacao) => {
+    const normalizarOtimizacao = (otimizacao: UploadOptions["otimizacao"]): string => {
       if (otimizacao === undefined || otimizacao === null) return "webp";
-      if (otimizacao === false || otimizacao === 0 || otimizacao === "0") return "false";
+      if (otimizacao === false) return "false";
 
       // Compatibilidade com a forma antiga: { formato: 'webp' }
       if (typeof otimizacao === "object") {
         const formato = otimizacao?.formato;
         if (formato === undefined || formato === null) return "webp";
-        if (formato === false || formato === "false" || formato === "0" || formato === "none") return "false";
+        if (formato === "false" || formato === "0" || formato === "none") return "false";
         if (formato === "jpg") return "jpeg";
         if (formato === "jpeg" || formato === "webp" || formato === "avif") return formato;
         return "webp";
       }
 
-      if (otimizacao === "false") return "false";
-      if (otimizacao === "none") return "false";
-      if (otimizacao === "jpg") return "jpeg";
       if (otimizacao === "jpeg" || otimizacao === "webp" || otimizacao === "avif") return otimizacao;
       return "webp";
     };
@@ -296,12 +365,12 @@ class PolgoUploadClient {
     form.append("bucket", bucket);
 
     try {
-      const response = await axios.post(finalUrl, form, {
+      const response = await axios.post<UploadResult>(finalUrl, form, {
         headers: {
           Authorization: `Bearer ${this.token}`,
         },
         timeout: this.timeout,
-        onUploadProgress: (progressEvent) => {
+        onUploadProgress: (progressEvent: AxiosProgressEvent) => {
           if (typeof onProgress === "function" && progressEvent.total) {
             const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total);
             onProgress(percentCompleted);
@@ -311,9 +380,11 @@ class PolgoUploadClient {
 
       return response.data;
     } catch (error) {
-      this._handleError(error, "fazer upload");
+      this._handleError(error as AxiosError<{ message?: string }>, "fazer upload");
     }
   }
 }
 
 export { PolgoUploadClient };
+export default PolgoUploadClient;
+