패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.6.0

fresh_dio

토큰 갱신을 위한 HTTP 인터셉터입니다. Fresh는 package:dio 위에 구축되어 인증 토큰을 자동으로 관리합니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
2.2만
좋아요
169
Pub 점수
160

패키지 설치

flutter pub add fresh_dio

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

Fresh Dio는 Dio 위에 구축된 가벼운 HTTP 인터셉터로, API 요청 중 토큰 갱신을 자동화합니다. 인증 토큰을 투명하게 처리하여 보호된 엔드포인트에 안전하고 끊김 없는 접근을 보장합니다. 요청을 가로채고 만료된 토큰을 원활하게 갱신함으로써 반복 코드를 줄이고 사용자 경험을 향상시킵니다. 최소한의 설정으로 강력한 인증 워크플로우가 필요한 앱에 이상적입니다.

사용 사례

  • API 호출 중 자동 토큰 갱신
  • 만료된 JWT 토큰 처리
  • 인증된 API 엔드포인트 보호
  • 수동 토큰 관리 감소
  • 로그인 세션 지속성 향상
  • 인증 상태 처리 간소화

주요 기능

  • Dio 위에 구축됨
  • 투명한 토큰 갱신
  • JWT 및 유사 토큰을 지원합니다
  • 필요한 최소 구성
  • 요청을 자동으로 가로챕니다
  • 401 오류에 대한 재시도 로직 처리

적합한 대상

  • JWT 인증을 사용하는 앱
  • 자주 API 상호작용이 있는 프로젝트
  • 인증 보일러플레이트를 줄이려는 개발자
  • 세션 관리가 있는 모바일 및 웹 애플리케이션
  • 깨끗하고 유지보수 가능한 인증 코드를 우선시하는 팀

고려 사항

  • 기존 Dio 설정과의 통합이 필요합니다
  • 토큰 기반 인증 흐름에 한정
  • 비표준 토큰 형식에 맞는 사용자 정의 로직이 필요할 수 있습니다
  • 새로 고침을 위해 외부 네트워크의 가용성에 의존합니다
  • 상태 없는 또는 토큰 없는 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 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.