http_auto

A lightweight Dart library that simplifies HTTP requests by automatically attaching authentication tokens and handling token refresh when they expire.

🚀 Features

  • Simple and clean API for HTTP requests
  • Automatic attachment of access tokens
  • Built-in refresh token handling on 401 Unauthorized
  • Supports common HTTP methods: GET, POST, PUT, DELETE
  • Designed to work smoothly with Flutter and Dart projects

📦 Installation

Add the package to your pubspec.yaml:

dependencies:
  http_auto: ^1.0.0

Then run:

flutter pub get

⚙️ Initialization

Before making any requests, initialize the library:

Http.init(
  baseUrl: "https://api.example.com",
  refreshTokenURL: "/auth/refresh-token",
  accessToken: "YOUR_ACCESS_TOKEN",
  refreshToken: "YOUR_REFRESH_TOKEN",
);

📡 Usage Examples

GET Request

final response = await Http.get(url: "/users");

POST Request

final response = await Http.post(
  url: "/login",
  body: {
    "email": "test@example.com",
    "password": "123456",
  },
);

PUT Request

final response = await Http.put(
  url: "/profile",
  body: {
    "name": "Ahmed",
  },
);

DELETE Request

final response = await Http.delete(url: "/account");

🔐 Token Handling

  • The access token is automatically sent with every request

  • If a request returns 401 Unauthorized, the library:

    1. Calls the refresh token endpoint
    2. Saves the new tokens
    3. Retries the original request automatically

🧪 Testing

Use the test/ folder to write unit tests for your package logic using the test package.

📄 License

This project is licensed under the MIT License.

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

🇸🇦 الوصف باللغة العربية

http_auto

مكتبة Dart خفيفة تسهل التعامل مع طلبات HTTP عن طريق إرسال رمز الوصول (Token) تلقائيًا ومعالجة انتهاء صلاحيته بشكل آلي.

✨ المميزات

  • واجهة برمجية بسيطة ونظيفة للتعامل مع HTTP
  • إرسال رمز الوصول (Access Token) تلقائيًا مع كل طلب
  • معالجة تلقائية لرمز التجديد (Refresh Token) عند انتهاء الجلسة
  • دعم لعمليات GET و POST و PUT و DELETE
  • مناسبة لمشاريع Flutter و Dart

⚙️ التهيئة

يجب تهيئة المكتبة قبل الاستخدام:

Http.init(
  baseUrl: "https://api.example.com",
  refreshTokenURL: "/auth/refresh-token",
  accessToken: "ACCESS_TOKEN",
  refreshToken: "REFRESH_TOKEN",
);

📡 أمثلة الاستخدام

GET

await Http.get(url: "/users");

POST

await Http.post(
  url: "/login",
  body: {
    "email": "test@example.com",
    "password": "123456",
  },
);

🔐 إدارة الرموز (Tokens)

  • يتم إرسال الرمز تلقائيًا مع كل طلب

  • إذا أعاد الخادم الرمز 401:

    • يتم طلب رمز التجديد (Refresh Token)
    • حفظ الرمز الجديد
    • إعادة إرسال الطلب الأصلي تلقائيًا

🧪 الاختبارات

استخدم المجلد test/ لكتابة اختبارات للوحدات البرمجية الخاصة بالمكتبة.

📄 الرخصة

المشروع مرخص بموجب رخصة MIT.

Libraries

http_auto