vyfetch

VyFetch - HTTP Client para TypeScript/JavaScript 🚀 (WIP)

VyFetch é uma biblioteca poderosa e extensível para realizar requisições HTTP de forma simplificada, com suporte a interceptadores, sistema de plugins e transformação avançada de respostas usando SuperJSON.

📦 Instalação

pnpm add vyfetch

🚀 Uso Básico

import { vyfetch } from "vyfetch";

const response = await vyfetch("/api/users");
console.log(response);

📌 Recursos Atuais

Recurso	Descrição	Status
✅ Base URL Global	Define um base URL para requisições
✅ Interceptadores	Permite manipular requisições e respostas
✅ Sistema de Plugins (Beta)	Suporte a extensões personalizadas
✅ Suporte a SuperJSON (Beta)	Transformação avançada de dados
✅ Cache Integrado	Configuração de cache para requisições
✅ Configuração Global	Personalização de opções padrão

🔮 Recursos Planejados

Recurso	Descrição	Status
⏳ Suporte a WebSockets	Comunicação em tempo real
⏳ CLI para Gerenciamento	Ferramenta CLI para configuração
⏳ Suporte a GraphQL	Suporte nativo para GraphQL
⏳ Melhor Gerenciamento de Erros	Novas opções para tratamento de falhas
⏳ Extensibilidade Avançada	Melhorias no sistema de plugins

📖 Documentação Completa

Para mais detalhes, acesse a documentação oficial: Em breve

Overview

Vyfetch é um wrapper poderoso para o fetch nativo, que agrega diversas funcionalidades:

• Configuração Global: Permite definir uma base URL, timeout, headers, interceptadores e callbacks que serão aplicados a todas as requisições.
• Sistema de Plugins: Possibilita a injeção de lógica customizada em pontos-chave do fluxo de requisição (pré e pós-processamento, tratamento de erros).
• Integração Opcional com SuperJSON (Beta): Suporta a desserialização de tipos complexos (como Date, Map, Set, BigInt) via flag useSuperJSON ou função transformResponse.
• Cache, Timeout e Batching: Mecanismos integrados para otimizar performance e evitar requisições duplicadas.

Configurações Globais

import { configure } from 'vyfetch';

configure({
  baseUrl: "https://jsonplaceholder.typicode.com", // URL base para requisições relativas
  timeout: 5000, // Timeout padrão de 5000ms
  cacheOptions: { ttl: 60000 }, // Cache com TTL de 60 segundos
  useSuperJSON: true, // Ativa o uso do SuperJSON para transformações de resposta
  interceptors: {
    request: [
      async (url, options) => {
        options.headers = { ...options.headers, "Authorization": "Bearer TOKEN_GLOBAL" };
        return { url, options };
      },
    ],
  },
  onError: (error) => {
    console.error("Erro global:", error);
  },
});

Suporte SuperJSON

Ative o uso do SuperJSON para transformar a resposta:

vyfetch('/api/data', {
  method: 'GET',
  useSuperJSON: true, // ou use transformResponse: (rawData, response) => SuperJSON.parse(rawData)
});

Referências da API

• vyfetch<T = any>(url: string, options?: SuperFetchOptions): Promise<SuperFetchResponse> Realiza a requisição HTTP e retorna um objeto contendo:

  • data: Dados transformados da resposta.
  • status: Código de status HTTP.
  • headers: Cabeçalhos da resposta.
  • fromCache: Flag indicando se os dados vieram do cache.
  • duration: Tempo total da requisição (em milissegundos).
  • configure(options: Partial): void
  • Define configurações globais para todas as requisições, incluindo baseUrl, timeout, interceptadores e outras opções.

Criado com 💙 por [@binhodev]