Pakete, Repositories und App-Kategorien suchen

Paketdetailsv0.7.0

fresh

Eine Token-Refresh-Bibliothek für Dart. Dieses Paket stellt die grundlegenden Komponenten bereit, die bei verschiedenen Implementierungen von Refresh-Token (REST, GraphQL usw.) gemeinsam sind.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
87.000
Likes
157
Pub-Punkte
160

Paket installieren

flutter pub add fresh

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Fresh ist eine Dart-Bibliothek, die entwickelt wurde, um Token-Refresh-Workflows über REST- und GraphQL-APIs zu verwalten. Sie bietet wiederverwendbare Komponenten zur Handhabung von Authentifizierungstoken und sorgt für sichere und konsistente Token-Aktualisierungen ohne Logik-Duplikation. Das Paket abstrahiert gängige Muster wie Token-Ablauferkennung, automatische Aktualisierungsanfragen und Fehlerbehandlung, was die Implementierung robuster Authentifizierungsabläufe in Flutter und anderen Dart-Anwendungen erleichtert. Mit Modularität im Fokus entwickelt, unterstützt Fresh mehrere Plattformen wie Mobile, Web und Desktop.

Anwendungsfälle

  • Ungültige JWT-Token verarbeiten
  • Automatisierung der Tokenaktualisierung in REST-APIs
  • Verwaltung des Authentifizierungsstatus in GraphQL-Clients
  • Sicherung von API-Aufrufen mit gültigen Tokens
  • Resiliente Auth-Flows implementieren

Hauptmerkmale

  • Modulares Token-Aktualisierungsarchitektur
  • Unterstützung für REST und GraphQL
  • Plattformübergreifende Kompatibilität
  • Automatische Wiederholung bei fehlgeschlagenen Anfragen
  • Konfigurierbare Aktualisierungsstrategien

Geeignet für

  • Flutter-Apps mit API-Authentifizierung
  • Anwendungen, die JWT oder ähnliche Token verwenden
  • Entwickler, die wiederverwendbare Authentifizierungssysteme erstellen
  • Projekte, die sichere Token-Verwaltung erfordern
  • Multiplattform-Anwendungen

Hinweise

  • Benötigt benutzerdefinierte Implementierung für bestimmte Auth-Endpunkte
  • Möglicherweise ist eine Integration mit HTTP-Clients wie dio oder http erforderlich
  • Keine vollständige Authentifizierungslösung, sondern ein Aktualisierungswerkzeug
  • Abhängig von der korrekten Backend-Token-Aktualisierungseinstellung
  • Beschränkt auf Token-Refresh – nicht Anmeldung oder Abmeldung

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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.

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.

Ranglisten