Fresh는 REST 및 GraphQL API에서 토큰 갱신 워크플로를 관리하기 위해 설계된 Dart 라이브러리입니다. 인증 토큰을 처리하기 위한 재사용 가능한 구성 요소를 제공하여 로직 중복 없이 안전하고 일관된 토큰 갱신을 보장합니다. 이 패키지는 토큰 만료 감지, 자동 갱신 요청, 오류 처리와 같은 일반적인 패턴을 추상화하여 Flutter 및 기타 Dart 애플리케이션에서 견고한 인증 흐름을 구현하는 것을 쉽게 만듭니다. 모듈성에 중점을 두어 모바일, 웹, 데스크톱 등 다양한 플랫폼을 지원합니다.
사용 사례
만료된 JWT 토큰 처리
REST API에서 토큰 갱신 자동화
GraphQL 클라이언트에서 인증 상태 관리
유효한 토큰으로 API 호출 보호
유연한 인증 흐름 구현
주요 기능
모듈러 토큰 갱신 아키텍처
REST 및 GraphQL 지원
크로스 플랫폼 호환성
실패한 요청에 대한 자동 재시도
사용자 정의 가능한 갱신 전략
적합한 대상
API 인증이 있는 Flutter 앱
JWT 또는 유사 토큰을 사용하는 애플리케이션
재사용 가능한 인증 시스템을 구축하는 개발자
보안 토큰 관리가 필요한 프로젝트
다중 플랫폼 애플리케이션
고려 사항
특정 인증 엔드포인트를 위한 사용자 정의 구현이 필요합니다
dio 또는 http와 같은 HTTP 클라이언트와의 통합이 필요할 수 있습니다
완전한 인증 솔루션이 아니지만 갱신 유틸리티입니다
올바른 백엔드 토큰 갱신 설정에 따라 다름
토큰 갱신에 국한됨—로그인 또는 로그아웃은 아님
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
Fresh 🍋
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