// ets_tracing: off import * as Cause from "../Cause/core.js" import * as E from "../Either/index.js" import * as Exit from "../Exit/api.js" import * as Fiber from "../Fiber/core.js" import { pipe } from "../Function/index.js" import { as_ } from "./as.js" import * as core from "./core.js" import { raceWith_ } from "./core-scope.js" import { done } from "./done.js" import type { Effect } from "./effect.js" import { uninterruptibleMask } from "./interruption.js" import { map_ } from "./map.js" import { mapErrorCause_ } from "./mapErrorCause.js" /** * Returns an effect that races this effect with the specified effect, * returning the first successful `A` from the faster side. If one effect * succeeds, the other will be interrupted. If neither succeeds, then the * effect will fail with some error. * * WARNING: The raced effect will safely interrupt the "loser", but will not * resume until the loser has been cleanly terminated. If early return is * desired */ export function race_( self: Effect, that: Effect, __trace?: string ): Effect { return core.descriptorWith((descriptor) => { const parentFiberId = descriptor.id const maybeDisconnect = (io: Effect) => uninterruptibleMask((interruptible) => interruptible.force(io)) return raceWith_( maybeDisconnect(self), maybeDisconnect(that), (exit, right) => Exit.foldM_( exit, (cause) => mapErrorCause_(Fiber.join(right), (_) => Cause.combinePar(cause, _)), (a) => as_(right.interruptAs(parentFiberId), a) ), (exit, left) => Exit.foldM_( exit, (cause) => mapErrorCause_(Fiber.join(left), (_) => Cause.combinePar(_, cause)), (a) => as_(left.interruptAs(parentFiberId), a) ), __trace ) }) } /** * Returns an effect that races this effect with the specified effect, * returning the first successful `A` from the faster side. If one effect * succeeds, the other will be interrupted. If neither succeeds, then the * effect will fail with some error. * * WARNING: The raced effect will safely interrupt the "loser", but will not * resume until the loser has been cleanly terminated. * * @ets_data_first race_ */ export function race(that: Effect, __trace?: string) { return (self: Effect): Effect => race_(self, that, __trace) } /** * Returns an effect that races this effect with the specified effect, * yielding the first result to succeed. If neither effect succeeds, then the * composed effect will fail with some error. * * WARNING: The raced effect will safely interrupt the "loser", but will not * resume until the loser has been cleanly terminated. */ export function raceEither_( self: Effect, that: Effect, __trace?: string ): Effect> { return race_(map_(self, E.left), map_(that, E.right), __trace) } /** * Returns an effect that races this effect with the specified effect, * yielding the first result to succeed. If neither effect succeeds, then the * composed effect will fail with some error. * * WARNING: The raced effect will safely interrupt the "loser", but will not * resume until the loser has been cleanly terminated. * * @ets_data_first raceEither_ */ export function raceEither(that: Effect, __trace?: string) { return (self: Effect): Effect> => raceEither_(self, that, __trace) } /** * Returns an effect that races this effect with the specified effect, * yielding the first result to complete, whether by success or failure. If * neither effect completes, then the composed effect will not complete. * * WARNING: The raced effect will safely interrupt the "loser", but will not * resume until the loser has been cleanly terminated. If early return is * desired, then instead of performing `l raceFirst r`, perform * `l.disconnect raceFirst r.disconnect`, which disconnects left and right * interrupt signal, allowing a fast return, with interruption performed * in the background. */ export function raceFirst_( self: Effect, that: Effect, __trace?: string ): Effect { return pipe( race_(core.result(self), core.result(that), __trace), core.chain((a) => done(a as Exit.Exit)) ) } /** * Returns an effect that races this effect with the specified effect, * yielding the first result to complete, whether by success or failure. If * neither effect completes, then the composed effect will not complete. * * WARNING: The raced effect will safely interrupt the "loser", but will not * resume until the loser has been cleanly terminated. If early return is * desired, then instead of performing `l raceFirst r`, perform * `l.disconnect raceFirst r.disconnect`, which disconnects left and right * interrupt signal, allowing a fast return, with interruption performed * in the background. * * @ets_data_first raceFirst_ */ export function raceFirst(that: Effect, __trace?: string) { return (self: Effect) => raceFirst_(self, that, __trace) }