app_log_tracker 0.1.0

Event + API log tracker with dedup and offline outbox for Flutter.

app_log_tracker

Event + API log tracker dengan dedup dan offline outbox untuk Flutter.

Bukan cuma HTTP logger. Consumer bisa track event custom apapun (errorApiRegistrasi, notif_read, ...), disimpan dulu di local, di-dedup (keyEvent + id + data), lalu dikirim ke server sebagai satu batch JSON dengan batch_id unik.

Cocok untuk: tracking error log, tracking user baca notifikasi multi-case, positive/negative case, dan API log otomatis (Dio + http).

Fitur

• track(keyEvent, id, status, data) — custom event apapun
• Dedup otomatis: sama persis → skip, beda → tambah
• Auto API log: TrackerDioInterceptor + TrackedHttpClient
• Outbox: simpan di local dulu, flush() kirim batch ke server
• batch_id (uuid) sebagai idempotency key per payload
• Storage: SqfliteTrackStorage (persist) + InMemoryTrackStorage (test)
• Overlay debug: list, search, filter success/failed, detail JSON, clear
• Cap 500 event per device (FIFO), batch 50, timeout 15s, bedain 4xx vs 5xx

Install

dependencies:
  app_log_tracker: ^0.1.0

Usage

1. Custom event + dedup

import 'package:app_log_tracker/app_log_tracker.dart';

final tracker = LogTracker(storage: SqfliteTrackStorage());

final added = await tracker.track(
  keyEvent: 'errorApiRegistrasi',
  id: 'user_123',
  status: TrackStatus.failed,
  data: {'code': 'EMAIL_TAKEN'},
);
// added == false kalau keyEvent+id+data sudah ada -> di-skip

2. Auto API log (Dio + http)

final dio = Dio()..interceptors.add(TrackerDioInterceptor(tracker));

final client = TrackedHttpClient(tracker, http.Client());
await client.get(Uri.parse('https://api.lu/users'));

3. Kirim ke server (outbox)

Payload yang dikirim:

{
  "batch_id": "uuid-v4",
  "sent_at": "2026-10-03T10:00:00+07:00",
  "events": [
    {
      "event_id": "uuid",
      "key_event": "errorApiRegistrasi",
      "entity_id": "user_123",
      "status": "failed",
      "data": {"code": "EMAIL_TAKEN"},
      "created_at": "..."
    }
  ]
}

final result = await tracker.flush((payload) async {
  await dio.post('https://api.lu/logs', data: payload);
});
if (!result.success && result.retryable) {
  // 5xx / timeout -> coba lagi nanti dengan backoff
}

4. Overlay debug

// Bubble kecil di pojok (debug only):
TrackerBubble(tracker: tracker)

// Atau full page:
Navigator.push(context,
  MaterialPageRoute(builder: (_) => TrackerLogPage(tracker: tracker)));

5. Logout

await tracker.clear(); // wajib, biar data user tidak bocor

Konfigurasi

LogTracker(
  storage: SqfliteTrackStorage(),
  config: const LogTrackerConfig(maxQueue: 500, batchSize: 50),
)

• maxQueue: maksimal event per device, lebih → FIFO buang paling lama
• batchSize: event per sekali flush()

Example

Lihat example/ untuk demo lengkap: custom track, Dio GET, http GET, preview payload, flush, overlay.

cd example
flutter run

Additional information

• Butuh persist antar restart → SqfliteTrackStorage()
• Butuh unit test cepat → InMemoryTrackStorage()
• Mau engine sendiri (Drift/Hive) → implement TrackStorage
• Issue & kontribusi via GitHub repo di pubspec.