mapEither & mapEitherAsync

Ejecuta cada evento en su propio ámbito Raise: r.raise (y r.ensure / r.bind) se convierte en un Left, un retorno normal en un Right.

FxEvents<Either<E, R>> FxEvents<T>.mapEither<E, R>(R Function(Raise<E> r, T value) f) FxEvents<Either<E, R>> FxEvents<T>.mapEitherAsync<E, R>(FutureOr<R> Function(Raise<E> r, T value) f)

Lección

attempt es la conversión de frontera — convierte lo que ya está en el canal de error en un Left. mapEither es el operador al que llegas después de eso, o sobre una fuente limpia: cada evento corre dentro de un constructor fxEither, así que escribes Dart en línea recta con r.ensure / r.raise y el resultado del map entero es Either<E, R>. Un evento que falla no cancela la fuente; los eventos posteriores siguen llegando.

Una excepción lanzada se queda en el canal de error — ese es el contrato del constructor fxEither, y mantiene a attempt como el sitio donde un throw en el stream se convierte en un valor. Cuando un callback tanto eleva como lanza, prefiere fxEitherCatching dentro de mapEither para que salga un único Either.

mapEitherAsync es el gemelo async: un evento a la vez, como asyncMap. La regla de fxEitherAsync se conserva: un raise debe ocurrir dentro de la cadena awaited. Un raise desde un future no awaited sobrevive al ámbito y aparece como un error de zona no manejado en vez de un Left.

Un error de la fuente atraviesa ambos operadores intacto. Conviértelos con attempt aguas arriba cuando también los quieras como Lefts.

Una vez que la cadena lleva valores Either, mapRight transforma cada éxito y deja pasar un Left sin cambios (mapLeft es el gemelo del lado del fallo). No se llama map porque FxEvents.map ya mapea el Either entero. Encadenar attempt después de mapEither sí atrapa una excepción lanzada, pero envuelve el resultado en Either<E, Either<E, R>>; flattenEither colapsa ese anidamiento — un Left externo sigue siendo un Left, y el Either interno sale tal cual.

Demo 1 · Un raise se convierte en Left, un return en Right

Demo 2 · mapEitherAsync, un evento a la vez

Pruébalo tú

Ejercicio: una excepción lanzada se queda en el canal de error, y la cadena continúa más allá de ella.

Relacionado: attempt — la frontera que convierte un throw en un Left · fxEither constructor — el mismo ámbito Raise, sobre un solo valor · rights / separated — parte los Eithers resultantes