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

패키지 상세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 워크플로우와 원활하게 통합되며 웹, 모바일, 데스크톱을 포함한 모든 주요 플랫폼을 지원합니다.

사용 사례

  • 토큰 갱신이 필요한 API
  • 보안 모바일 및 웹 애플리케이션
  • 인증 부품 코드 줄이기
  • 자동 토큰 관리
  • 상태 있는 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 개

소스 저장소

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

아직 데이터가 없습니다.

순위