zeba_academy_connectivity_manager

A lightweight Flutter connectivity management toolkit designed for apps that must work reliably even with unstable or intermittent internet connections.

zeba_academy_connectivity_manager helps developers detect network status changes, queue offline API requests, retry failed calls with automatic backoff, and manage WebSocket connections — all in one simple package.

---

✨ Features

• 📡 Network Status Detection – Listen to real‑time connectivity changes.
• 📴 Offline Request Queue – Automatically queue API calls when the device is offline.
• 🔁 Automatic Retry System – Retry failed requests with configurable backoff.
• 🌐 REST API Support – Works seamlessly with HTTP requests.
• 🔌 WebSocket Support – Manage WebSocket connections and messages.
• 🎧 Connection Event Listeners – React to online/offline changes in real time.
• ⚡ Lightweight & Fast – No unnecessary complexity or heavy dependencies.

---

📦 Installation

Add the package to your pubspec.yaml:

dependencies:
  zeba_academy_connectivity_manager: ^1.0.0

Then run:

flutter pub get

---

🚀 Getting Started

Import the package:

import 'package:zeba_academy_connectivity_manager/zeba_academy_connectivity_manager.dart';

---

📡 Detect Connectivity Changes

final connectivity = ConnectivityService();

connectivity.onStatusChange.listen((event) {
  if (event.status == ConnectivityStatus.online) {
    print("Device is online");
  } else {
    print("Device is offline");
  }
});

---

📴 Queue Requests When Offline

final queue = RequestQueue();

await queue.add(() async {
  print("Executing queued request");
});

Requests added to the queue will execute sequentially.

---

🔁 Retry Failed Requests

final retryManager = RetryManager();

final result = await retryManager.retry(() async {
  // Your API call
  return "Success";
});

print(result);

The retry manager automatically retries failed requests using a backoff delay.

---

🌐 REST API Example

import 'package:http/http.dart' as http;

final connectivity = ConnectivityService();
final queue = RequestQueue();
final retry = RetryManager();

Future fetchData() async {
  final online = await connectivity.isOnline();

  if (!online) {
    queue.add(() => fetchData());
    return;
  }

  return retry.retry(() async {
    final response = await http.get(
      Uri.parse("https://jsonplaceholder.typicode.com/posts"),
    );

    return response.body;
  });
}

---

🔌 WebSocket Support

final socket = WebSocketManager();

socket.connect("wss://echo.websocket.events");

socket.messages.listen((message) {
  print("Received: $message");
});

socket.send("Hello Server");

---

📊 Use Cases

This package is ideal for apps that require reliable connectivity handling:

• Offline‑first applications
• Messaging apps
• Delivery or ride‑sharing apps
• Field service apps
• Data sync systems
• IoT dashboards

---

🧪 Testing

Run tests using:

flutter test

Analyze the package:

flutter analyze

---

📁 Package Structure

lib/
 ├── zeba_academy_connectivity_manager.dart
 └── src/
      ├── connectivity_service.dart
      ├── request_queue.dart
      ├── retry_manager.dart
      ├── websocket_manager.dart
      └── connectivity_event.dart

---

🔮 Planned Improvements

Future versions may include:

• Persistent offline queue (Hive/SQLite)
• Background synchronization
• Network quality detection
• Smart caching
• Automatic token refresh handling

---

🤝 Contributing

Contributions, bug reports, and feature requests are welcome!

If you would like to contribute, please open an issue or submit a pull request.

---

📄 License

This project is licensed under the GPL-3.0 License.

---

About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin

Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development. ➡ Visit our main site: zeba.academy
➡ Explore hands-on courses and resources at: code.zeba.academy
➡ Check out our YouTube for more tutorials: zeba.academy
➡ Follow us on Instagram: zeba.academy

Thank you for visiting!