ilkersevim_async_utils 0.1.2

Prevent duplicate async work and stale result updates with dependency-free Dart coalescers and request guards.

ilkersevim_async_utils

Dependency-free Dart guards for coalescing concurrent async work and rejecting stale async completions.

Why use this package?

• Stop duplicate refresh, save, or fetch work when callers trigger the same operation concurrently.
• Ignore an older async result after a newer request has started.
• Add both protections without runtime dependencies or framework coupling.

License: Apache-2.0. Package: pub.dev/packages/ilkersevim_async_utils. Issues: github.com/redjadet/ilkersevim_async_utils/issues.

Installation

dependencies:
  ilkersevim_async_utils: ^0.1.2

InFlightCoalescer

One instance shares a single in-flight Future<void>. Concurrent callers await the same future. Success or failure clears the gate so the next call starts fresh.

final InFlightCoalescer coalescer = InFlightCoalescer();
Future<void> refresh() => coalescer.run(() => _doRefresh());

KeyedInFlightCoalescer

Same idea, one in-flight future per key. Different keys run concurrently.

final KeyedInFlightCoalescer<String> coalescer =
    KeyedInFlightCoalescer<String>();
Future<void> refreshQuery(String query) =>
    coalescer.run(query, () => _doRefreshAndCache(query));

RequestIdGuard

Ignore stale async completions (request-id pattern).

final RequestIdGuard guard = RequestIdGuard();
Future<void> load() async {
  final int id = guard.next();
  final result = await repository.fetch();
  if (!guard.isCurrent(id)) return;
  // apply result
}

API stability

Public type names and method signatures are a semantic-versioned contract. Breaking changes require a major version bump.

Publishing

Releases are tagged vX.Y.Z matching pubspec.yaml. Automated publishing uses GitHub Actions OIDC with the protected pub.dev Environment (reviewer: redjadet). Configure Pub.dev Admin → Automated publishing for repository redjadet/ilkersevim_async_utils, tag pattern v{{version}}, environment pub.dev.