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

パッケージ詳細v0.2.0

fresh_http

自動更新機能付きのHTTPクライアント。package:http をベースに構築され、認証トークンを透明に管理します。

AndroidiOSLinuxmacOSWebWindows
30日間ダウンロード
6.1万
いいね数
5
Pub ポイント
160

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

flutter pub add fresh_http

パッケージ概要

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

Fresh Http は、`http` パッケージの上に構築された自動更新機能を備えた Flutter/Dart パッケージです。認証トークンの自動更新を処理し、手動でのトークン管理なしでスムーズな API 呼び出しを実現します。セキュアで継続的な認証済み API アクセスが必要なアプリに最適であり、期限切れのトークンを透明に更新することで、ボイラープレートコードを削減し信頼性を向上させます。既存の HTTP ワークフローとスムーズに統合でき、Web、モバイル、デスクトップを含むすべての主要プラットフォームをサポートしています。

用途

  • トークンの更新を必要とするAPI
  • セキュアなモバイルおよびWebアプリケーション
  • 認証のボイラープレートを減らす
  • 自動トークン管理
  • ステートフルな API クライアント

主な機能

  • 自動トークンの再取得
  • `package:http` をベースに構築されています
  • 透過的な認証処理
  • クロスプラットフォーム対応
  • 最小限のセットアップが必要

適している対象

  • JWT または OAuth2 を使用するアプリ
  • 認証の複雑さを低減したい開発者
  • 信頼性のあるAPI接続を必要とするプロジェクト
  • 開発者体験を重視するチーム
  • 頻繁なAPI操作を行うアプリケーション

注意事項

  • カスタムトークン更新ロジックが必要です
  • 外部認証状態管理に依存しています
  • HTTPベースのAPIに限定
  • 一度限りのリクエストには適していません
  • トークンの再取得フローに適切なエラー処理が必要です

元の 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.

カテゴリー

依存関係

依存関係一覧 2 件

ソースリポジトリ

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

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

ランキング