Skip to main content

mutation_queue 0.1.0 copy "mutation_queue: ^0.1.0" to clipboard
mutation_queue: ^0.1.0 copied to clipboard

Offline-first mutation queue for Dart and Flutter: enqueue writes that persist before returning, drain FIFO with retry limits and dead-lettering.

example/mutation_queue.dart

// Runnable tour of the offline-first mutation queue:
//   dart example/mutation_queue.dart
//
// Shows: enqueue that persists before returning, FIFO drain with retries,
// dead-lettering after max attempts, and startup restore.
import 'package:mutation_queue/mutation_queue.dart';

Future<void> main() async {
  final disk = <List<Map<String, Object?>>>[]; // pretend disk writes

  var networkUp = false;
  var sendCalls = 0;

  final queue = MutationQueue(
    store: (json) => disk.add(json), // persist immediately
    load: () => disk.isEmpty ? const [] : disk.last,
    send: (m) async {
      sendCalls++;
      if (!networkUp) {
        throw StateError('offline: ${m.type}');
      }
      print('sent ${m.type}');
    },
    maxAttempts: 3,
  );

  // 1) User acts while offline — the write is already safe on "disk".
  queue.enqueue('create-post', {'title': 'Hello'});
  queue.enqueue('like-post', {'id': 42});

  // 2) Drain fails while offline; nothing is lost, items wait for retry.
  await queue.flush();

  // 3) Connectivity returns; a later drain delivers FIFO.
  networkUp = true;
  await queue.flush();
  print('send calls: $sendCalls');
}
0
likes
160
points
64
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Offline-first mutation queue for Dart and Flutter: enqueue writes that persist before returning, drain FIFO with retry limits and dead-lettering.

Repository (GitHub)
View/report issues

Topics

#offline-first #queue #sync #flutter #dart

License

MIT (license)

More

Packages that depend on mutation_queue