api_helper_rana 1.0.2

A robust Flutter package for API integration with Hive caching, background isolates, and auto-token refresh.

api_helper_rana

A robust Flutter package for API integration with Hive caching, background isolates, and auto-token refresh.

Features

• Standard HTTP Methods: Support for GET, POST, PUT, DELETE, and MULTIPART.
• Local Caching (Hive): Optional caching for any request. For GET requests, it supports a "Cache-then-Network" strategy.
• Isolate Support: Perform heavy parsing or requests in a background isolate to keep the UI smooth.
• Token Management: Automatic Bearer token insertion and refresh token handling via interceptors.
• Comprehensive Logging: Detailed request/response logs with support for manual user logs.
• State Management Agnostic: Works seamlessly with Provider, BLoC, GetX, Riverpod, etc.

Getting Started

1. Initialization

Initialize the ApiClient with your base URL and optional token handlers.

final apiClient = ApiClient(
  baseUrl: "https://api.example.com",
  getToken: () async => "your_token",
  onRefreshToken: () async => { /* refresh logic */ },
);
await apiClient.init(); // Initialize Hive

Request Examples

GET Request (with Cache then Network)

Returns cached data immediately, then fetches and updates in the background.

final response = await apiClient.get<List<dynamic>>(
  "/posts",
  options: ApiRequestOptions(saveInLocal: true, isIsolate: true),
  onUpdate: (updatedResponse) {
    // Handle background update
  },
);

POST Request

final response = await apiClient.post<Map<String, dynamic>>(
  "/posts",
  data: {'title': 'foo', 'body': 'bar', 'userId': 1},
);

PUT Request

final response = await apiClient.put<Map<String, dynamic>>(
  "/posts/1",
  data: {'id': 1, 'title': 'foo', 'body': 'bar', 'userId': 1},
);

DELETE Request

final response = await apiClient.delete("/posts/1");

MULTIPART Request (File Upload)

final response = await apiClient.multipart(
  "/upload",
  {
    'file': await MultipartFile.fromFile('path/to/file.jpg'),
    'name': 'api_helper_rana',
  },
);

Manual Logging

apiClient.manualLog("User clicked refresh button");

Credits

Built with Dio, Hive, and Logger.