Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.7.0

fresh

Uma biblioteca de atualização de token para o dart. Este pacote expõe os componentes principais que são comuns em várias implementações de token de atualização (REST, GraphQL, etc.).

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
87 mil
Curtidas
157
Pontos Pub
160

Instalar pacote

flutter pub add fresh

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Fresh é uma biblioteca Dart projetada para gerenciar fluxos de atualização de token em APIs REST e GraphQL. Oferece componentes reutilizáveis para lidar com tokens de autenticação, garantindo atualizações seguras e consistentes dos tokens sem duplicar lógica. O pacote abstrai padrões comuns como detecção de expiração de token, solicitações automáticas de atualização e tratamento de erros, facilitando a implementação de fluxos de autenticação robustos em aplicativos Flutter e outros aplicativos Dart. Desenvolvido com modularidade em mente, o Fresh suporta múltiplas plataformas, incluindo móvel, web e desktop.

Casos de uso

  • Gerenciando tokens JWT expirados
  • Automatizando a atualização de token em APIs REST
  • Gerenciando o estado de autenticação em clientes GraphQL
  • Protegendo chamadas de API com tokens válidos
  • Implementando fluxos de autenticação resilientes

Principais recursos

  • Arquitetura modular de atualização de token
  • Suporte para REST e GraphQL
  • Compatibilidade multiplataforma
  • Repetição automática em solicitações com falha
  • Estratégias configuráveis de atualização

Indicado para

  • Aplicativos Flutter com autenticação de API
  • Aplicações usando JWT ou tokens semelhantes
  • Desenvolvedores construindo sistemas de autenticação reutilizáveis
  • Projetos que exigem gerenciamento seguro de tokens
  • Aplicações multiplataforma

Considerações

  • Requer implementação personalizada para pontos finais de autenticação específicos
  • Pode ser necessário integração com clientes HTTP como dio ou http
  • Não é uma solução de autenticação completa, mas uma utilidade de atualização
  • Depende da configuração correta de atualização de token do backend
  • Limitado à atualização de token – não login ou logout

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Fresh 🍋

build License: MIT GitHub stars


A collection of packages for automatic token refresh in Dart and Flutter. Fresh handles refreshing, caching, and attaching authentication tokens transparently so your API calls just work.

Why Fresh?

Token-based authentication seems simple until you handle the edge cases: tokens expire mid-session, multiple requests fail at the same time triggering duplicate refreshes, refresh tokens get revoked, and you need to route users to login when auth is lost. Fresh handles all of this so you don't have to.

  • No more manual 401 handling scattered across your codebase
  • No more race conditions when concurrent requests trigger simultaneous refreshes
  • No more stale tokens causing request failures - expired tokens are refreshed proactively before the request is even sent

Packages

Package Pub
fresh pub package
fresh_dio pub package
fresh_graphql pub package
fresh_http pub package

Features

  • Automatic token refresh on 401 / auth errors, with automatic request retry
  • Proactive refresh before requests when the token is expired
  • Single-flight refresh - concurrent requests share one refresh call instead of triggering multiple
  • authenticationStatus stream for reacting to login/logout events
  • Pluggable TokenStorage - bring your own persistence layer
  • Built-in OAuth2Token with expiresAt support

Usage

fresh_dio
final dio = Dio();

dio.interceptors.add(
  Fresh.oAuth2(
    tokenStorage: InMemoryTokenStorage<OAuth2Token>(),
    refreshToken: (token, client) async {
      final response = await client.post(
        'https://api.example.com/auth/refresh',
        data: {'refresh_token': token?.refreshToken},
      );
      return OAuth2Token(
        accessToken: response.data['access_token'],
        refreshToken: response.data['refresh_token'],
      );
    },
  ),
);

See the fresh_dio README for full documentation.

fresh_graphql
import 'dart:convert';

final freshLink = FreshLink.oAuth2(
  tokenStorage: InMemoryTokenStorage<OAuth2Token>(),
  refreshToken: (token, client) async {
    final response = await client.post(
      Uri.parse('https://api.example.com/auth/refresh'),
      body: jsonEncode({'refresh_token': token?.refreshToken}),
    );
    final body = jsonDecode(response.body) as Map<String, dynamic>;
    return OAuth2Token(
      accessToken: body['access_token'],
      refreshToken: body['refresh_token'],
    );
  },
  shouldRefresh: (response) =>
      response.errors?.any((e) => e.message.contains('UNAUTHENTICATED')) ?? false,
);

// HttpLink comes from package:gql_http_link
final link = Link.from([freshLink, HttpLink('https://api.example.com/graphql')]);

See the fresh_graphql README for full documentation.

fresh_http
import 'dart:convert';

final client = Fresh.oAuth2(
  tokenStorage: InMemoryTokenStorage<OAuth2Token>(),
  refreshToken: (token, client) async {
    final response = await client.post(
      Uri.parse('https://api.example.com/auth/refresh'),
      body: jsonEncode({'refresh_token': token?.refreshToken}),
    );
    final body = jsonDecode(response.body) as Map<String, dynamic>;
    return OAuth2Token(
      accessToken: body['access_token'],
      refreshToken: body['refresh_token'],
    );
  },
);

See the fresh_http README for full documentation.

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.

Rankings