Mutaciones

Define mutaciones as provider methods, monitor state con MutationToken, y execute through ref.invoke(call).

Open API Referencia Read providers

Bloques de construcción de la mutación

A mutation is a Call<R, State> returned de mutate(token, body, concurrency: ...).

Token

late final renameMut = mutation<void>(#rename)

Execution

await ref.invoke(provider.rename(...))

State

Idle / Pending / Success / Error via ref.watch(token)

Nota

A diferencia de las APIs estilo notifier.method(), miniriverpod convierte la ejecución de la mutación en un objeto call de primera clase.

Ejecuta una mutación

Use ref.invoke so cancellation y drop behaviors are surfaced a the caller.

Ejecutar

Opciones de concurrencia

concurrent : run all calls in parallel (default).
queue      : FIFO; keep running queued calls even after an error.
restart    : cancel previous run, keep only latest call.
dropLatest : drop incoming calls while one is running.

ejemplo: optimistic update + restart

A common write pattern updates AsyncData optimistically, then syncs con server response.

class UserProvider extends AsyncProvider<User?> {
  UserProvider() : super.args(null);

  late final renameMut = mutation<void>(#rename);

  Call<void, AsyncValue<User?>> rename(String newName) => mutate(
    renameMut,
    (ref) async {
      final cur = ref.watch(this).valueOrNull;
      ref.state = AsyncData((cur ?? const User()).copyWith(name: newName), isRefreshing: true);

      final api = ref.watch(apiProvider);
      await api.rename(newName);
      ref.state = AsyncData(await api.me());
    },
    concurrency: Concurrency.restart,
  );
}

restart may throw CancelledMutation a older callers.

dropLatest puede lanzar DroppedMutation mientras está ocupado.

Catch these en UI when you want a suppress transient cancellation errors.

Siguientes pasos

Flutter API

Bind mutation state a UI using ConsumerWidget o ConsumerStatefulWidget.

Abrir Flutter API

API Reference

Review invoke, mutation, mutate, y MutationState tipos quickly.

Open API Referencia