パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v0.7.0

fresh

Dart用のトークンリフレッシュライブラリです。このパッケージは、RESTやGraphQLなど、さまざまなリフレッシュトークン実装に共通するコアコンポーネントを公開しています。

AndroidiOSWebmacOSWindowsLinux
30日間ダウンロード
8.7万
いいね数
157
Pub ポイント
160

パッケージをインストール

flutter pub add fresh

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

Fresh は、REST および GraphQL API のトークンの再取得ワークフローを管理するための Dart ライブラリです。認証トークンの処理に役立つ再利用可能なコンポーネントを提供し、ロジックの重複なく安全かつ一貫したトークンの更新を実現します。このパッケージは、トークンの有効期限切れの検出、自動的な再取得リクエスト、エラー処理といった一般的なパターンを抽象化しており、Flutter および他の Dart アプリケーションで堅牢な認証フローを実装しやすくしています。モジュール性を意識して設計されており、モバイル、Web、デスクトップなど複数のプラットフォームをサポートしています。

用途

  • 有効期限が切れたJWTトークンの処理
  • REST API でのトークンの自動更新
  • GraphQL クライアントにおける認証状態の管理
  • 有効なトークンを使用してAPI呼び出しを保護する
  • レジリエントな認証フローの実装

主な機能

  • モジュール型トークン再生成アーキテクチャ
  • REST および GraphQL のサポート
  • クロスプラットフォーム互換性
  • 失敗したリクエストの自動再試行
  • 設定可能な更新戦略

適している対象

  • API認証付きのFlutterアプリ
  • JWT や同様のトークンを使用するアプリケーション
  • 再利用可能な認証システムを構築する開発者
  • セキュアなトークン管理を必要とするプロジェクト
  • マルチプラットフォームアプリケーション

注意事項

  • 特定の認証エンドポイント用にカスタム実装が必要です
  • dio や http などの 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 件

ソースリポジトリ

このパッケージを使用しているプロジェクト

データはまだありません。

ランキング