搜索插件、代码仓与 APP 分类

插件详情v0.7.0

fresh

一个用于 Dart 的令牌刷新库。此包公开了各种刷新令牌实现(REST、GraphQL 等)共用的核心组件。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
8.7万
喜欢数
157
Pub 分数
160

安装插件

flutter pub add fresh

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Fresh 是一个 Dart 库,旨在管理 REST 和 GraphQL API 中的令牌刷新工作流。它提供了可重用的组件来处理身份验证令牌,确保安全且一致的令牌续订,而无需重复逻辑。该包抽象了常见的模式,如令牌过期检测、自动刷新请求和错误处理,使在 Flutter 及其他 Dart 应用中实现健壮的身份验证流程变得更加容易。该库注重模块化设计,支持移动、Web 和桌面等多种平台。

适合场景

  • 处理过期的 JWT 令牌
  • 在 REST API 中自动刷新令牌
  • 管理 GraphQL 客户端中的身份验证状态
  • 使用有效令牌保护 API 调用
  • 实现弹性身份验证流程

主要特点

  • 模块化令牌刷新架构
  • 对 REST 和 GraphQL 的支持
  • 跨平台兼容性
  • 失败请求的自动重试
  • 可配置的刷新策略

适合对象

  • Flutter 应用程序与 API 身份验证
  • 使用 JWT 或类似令牌的应用程序
  • 开发可重用的身份验证系统
  • 需要安全令牌管理的项目
  • 跨平台应用程序

使用建议

  • 需要为特定的认证端点自定义实现
  • 可能需要与 HTTP 客户端(如 dio 或 http)集成
  • 不是完整的认证解决方案,而是一个刷新工具
  • 依赖于正确的后端令牌刷新设置
  • 仅限令牌刷新,不包括登录或登出

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

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.

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

暂无相关数据。

所在榜单