effect 4.0.1 → 4.0.3

package/dist/Channel.js

@@ -7,6 +7,7 @@
  * higher-level modules instead. This module is useful when implementing stream
  * operators or specialized streaming workflows.
  *
+ * @stability stable
  * @since 2.0.0
  */
 // @effect-diagnostics returnEffectInGen:off
@@ -43,6 +44,7 @@ import { ParentSpan } from "./Tracer.js";
  * Runtime identifier stored on `Channel` values and used by `isChannel` to
  * recognize them.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -60,6 +62,7 @@ export const TypeId = "~effect/Channel";
  * Channel.isChannel("not a channel") // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 3.5.4
  */
@@ -93,6 +96,7 @@ const ChannelProto = {
  * await Effect.runPromise(Channel.runCollect(channel)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -122,6 +126,7 @@ export const fromTransform = transform => {
  * await Effect.runPromise(Channel.runCollect(transformedChannel)) // => [2, 4, 6]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -145,6 +150,7 @@ export const transformPull = (self, f) => fromTransform((upstream, scope) => Eff
  * await Effect.runPromise(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -161,6 +167,7 @@ export const fromPull = effect => fromTransform((_, __) => effect);
  * when the channel completes.
  *
  * @see {@link fromTransform} for a simpler transformation without a forked scope
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -184,6 +191,7 @@ export const fromTransformBracket = f => fromTransform(Effect.fnUntraced(functio
  * Effect.runSync(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -199,6 +207,7 @@ export const toTransform = channel => channel.transform;
  * Channel.DefaultChunkSize // => 4096
  * ```
  *
+ * @stability stable
  * @category constants
  * @since 4.0.0
  */
@@ -206,7 +215,7 @@ export const DefaultChunkSize = 4096;
 const asyncQueue = (scope, f, options) => Queue.make({
   capacity: options?.bufferSize,
   strategy: options?.strategy
-}).pipe(Effect.tap(queue => Scope.addFinalizer(scope, Queue.shutdown(queue))), Effect.tap(queue => Effect.forkIn(Scope.provide(f(queue), scope), scope)));
+}).pipe(Effect.tap(queue => Scope.addFinalizer(scope, Queue.shutdown(queue))), Effect.tap(queue => Scope.provide(f(queue), scope).pipe(Effect.catchCause(cause => Queue.failCause(queue, cause)), Effect.forkIn(scope))));
 /**
  * Creates a `Channel` that interacts with a callback function using a queue.
  *
@@ -226,6 +235,7 @@ const asyncQueue = (scope, f, options) => Queue.make({
  * await Effect.runPromise(Channel.runCollect(channel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -246,6 +256,7 @@ export const callback = (f, options) => fromTransform((_, scope) => Effect.map(a
  * await Effect.runPromise(Channel.runCollect(channel)) // => [[1, 2]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -262,6 +273,7 @@ export const callbackArray = (f, options) => fromTransform((_, scope) => Effect.
  * Effect.runSync(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -290,14 +302,17 @@ export const suspend = evaluate => fromTransform((upstream, scope) => Effect.sus
  * const observed = [await Effect.runPromise(Channel.runCollect(channel)), released] // => [["RESOURCE"], ["resource"]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
 export const acquireUseRelease = (acquire, use, release) => fromTransformBracket(Effect.fnUntraced(function* (upstream, scope, forkedScope) {
   let option = Option.none();
   yield* Scope.addFinalizerExit(forkedScope, exit => Option.isSome(option) ? release(option.value, exit) : Effect.void);
-  const value = yield* Effect.uninterruptible(acquire);
-  option = Option.some(value);
+  const value = yield* Effect.uninterruptible(Effect.map(acquire, value => {
+    option = Option.some(value);
+    return value;
+  }));
   return yield* toTransform(use(value))(upstream, scope);
 }));
 /**
@@ -323,6 +338,7 @@ export const acquireUseRelease = (acquire, use, release) => fromTransformBracket
  * const observed = [await Effect.runPromise(Channel.runCollect(channel)), released] // => [["resource"], ["resource"]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -340,6 +356,7 @@ export const acquireRelease = /*#__PURE__*/dual(2, (self, release) => unwrap(Eff
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -362,6 +379,7 @@ export const fromIterator = iterator => fromPull(Effect.sync(() => {
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -382,6 +400,7 @@ export const fromArray = array => fromPull(Effect.sync(() => {
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -434,6 +453,7 @@ export const fromChunk = chunk => fromArray(Chunk.toReadonlyArray(chunk));
  * Effect.runSync(Channel.runCollect(fibChannel)) // => [[0, 1, 1], [2, 3]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -473,6 +493,7 @@ export const fromIteratorArray = (iterator, chunkSize = DefaultChunkSize) => {
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -495,6 +516,7 @@ export const fromIterable = iterable => fromIterator(() => iterable[Symbol.itera
  * Effect.runSync(Channel.runCollect(channel)) // => [[1, 2, 3, 4], [5]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -511,6 +533,7 @@ export const fromIterableArray = (iterable, chunkSize = DefaultChunkSize) => fro
  * Effect.runSync(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -527,6 +550,7 @@ export const succeed = value => fromEffect(Effect.succeed(value));
  * Effect.runSync(Channel.runCollect(channel)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -534,6 +558,7 @@ export const end = value => fromPull(Effect.succeed(Cause.done(value)));
 /**
  * Creates a `Channel` that immediately ends with the lazily evaluated value.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -555,6 +580,7 @@ export const endSync = evaluate => fromPull(Effect.sync(() => Cause.done(evaluat
  * Effect.runSync(Channel.runCollect(channel)) // => ["request-1"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -581,6 +607,7 @@ export const sync = evaluate => fromEffect(Effect.sync(evaluate));
  * Effect.runSync(Channel.runCollect(conditionalChannel(true))) // => ["data"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -609,6 +636,7 @@ export const empty = /*#__PURE__*/fromPull(/*#__PURE__*/Effect.succeed(/*#__PURE
  * Channel.isChannel(conditionalChannel(false)) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -625,6 +653,7 @@ export const never = /*#__PURE__*/fromPull(/*#__PURE__*/Effect.succeed(Effect.ne
  * Effect.runSync(Effect.exit(Channel.runCollect(failedChannel))) // => Exit.fail("Something went wrong")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -654,6 +683,7 @@ export const fail = error => fromPull(Effect.succeed(Effect.fail(error)));
  * ] // => [Exit.fail("Error after attempt 1"), 1]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -676,6 +706,7 @@ export const failSync = evaluate => fromPull(Effect.failSync(evaluate));
  * Effect.runSync(Effect.exit(Channel.runCollect(failedChannel))) // => Exit.failCause(simpleCause)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -702,6 +733,7 @@ export const failCause = cause => fromPull(Effect.failCause(cause));
  * ] // => [Exit.fail("Runtime error after attempt 1"), 1]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -719,6 +751,7 @@ export const failCauseSync = evaluate => fromPull(Effect.failCauseSync(evaluate)
  * Effect.runSync(Effect.exit(Channel.runCollect(diedChannel))) // => Exit.failCause(Cause.die(defect))
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -737,6 +770,7 @@ export const die = defect => failCause(Cause.die(defect));
  * Effect.runSync(Channel.runCollect(successChannel)) // => ["Hello from effect!"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -756,6 +790,7 @@ export const fromEffect = effect => fromPull(Effect.sync(() => {
  *
  * If the effect fails, the channel fails with the effect's error.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -763,6 +798,7 @@ export const fromEffectDone = effect => fromPull(Effect.succeed(Effect.flatMap(e
 /**
  * Uses an effect and discards its result.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -776,6 +812,7 @@ export const fromEffectDrain = effect => fromPull(Effect.flatMap(effect, () => C
  * `Take` fails the channel. A done `Take` completes the channel with its done
  * value.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -798,6 +835,7 @@ export const fromEffectTake = effect => fromPull(Effect.succeed(Effect.flatMap(e
  * await Effect.runPromise(program) // => ["item1", "item2", "item3"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -820,6 +858,7 @@ export const fromQueue = queue => fromPull(Effect.succeed(Queue.take(queue)));
  * await Effect.runPromise(program) // => [[1, 2, 3, 4]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -828,6 +867,7 @@ export const fromQueueArray = queue => fromPull(Effect.succeed(Queue.takeAll(que
  * Creates a channel that forwards upstream input elements, input errors, and
  * the upstream done value unchanged.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -875,6 +915,7 @@ export const identity = () => fromTransform((upstream, _scope) => Effect.succeed
  * })
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -986,6 +1027,7 @@ export const fromSubscription = subscription => fromPull(Effect.succeed(Effect.o
  * Option.map(result, ({ count, sum, average, min, max }) => ({ count, sum, average, min, max })) // => Option.some({ count: 1, sum: 10, average: 10, min: 10, max: 10 })
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1088,6 +1130,7 @@ export const fromSubscriptionArray = subscription => fromPull(Effect.succeed(Eff
  * const result = await Effect.runPromise(event) // => Option.some({ type: "user.created", payload: {}, timestamp: 1, processed: true, processedAt: 2 })
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1227,6 +1270,7 @@ export const fromPubSub = pubsub => unwrap(Effect.map(PubSub.subscribe(pubsub),
  * Option.map(result, (batch) => [batch.batchId, batch.totalEntries, batch.infoCount]) // => Option.some(["1-1", 1, 1])
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1239,6 +1283,7 @@ export const fromPubSubArray = pubsub => unwrap(Effect.map(PubSub.subscribe(pubs
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the channel. Done `Take` values complete the channel.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1246,6 +1291,7 @@ export const fromPubSubTake = pubsub => unwrap(Effect.map(PubSub.subscribe(pubsu
 /**
  * Creates a Channel from a Schedule.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1271,6 +1317,7 @@ export const fromSchedule = schedule => fromPull(Effect.map(Schedule.toStepWithS
  * await Effect.runPromise(Channel.runCollect(channel)) // => [[1]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1324,6 +1371,7 @@ export const pullIntoWritableStream = options => Effect.acquireUseRelease(Effect
  * written // => [1, 2]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1361,6 +1409,7 @@ export const fromWritableStream = options => fromTransform(pull => {
  * await Effect.runPromise(program) // => [[2], [4]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1416,6 +1465,7 @@ const readableStreamToPullUnsafe = options => {
  * are converted with `onError`. If the channel scope closes early and the
  * iterator has a `return` method, that method is called.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1439,6 +1489,7 @@ export const fromAsyncIterable = (iterable, onError) => fromTransform(Effect.fnU
  * rejected iterator errors are converted with `onError`. If the channel scope
  * closes early and the iterator has a `return` method, that method is called.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1480,6 +1531,7 @@ export const fromAsyncIterableArray = (iterable, onError) => map(fromAsyncIterab
  * Effect.runSync(Channel.runCollect(displayChannel)) // => [{ displayName: "User: Alice", isActive: true }, { displayName: "User: Bob", isActive: true }]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1490,6 +1542,7 @@ export const map = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pull =>
 /**
  * Maps the done value of this channel using the specified function.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1502,6 +1555,7 @@ export const mapDone = /*#__PURE__*/dual(2, (self, f) => mapDoneEffect(self, o =
  * Use when the terminal done value transformation needs services or can fail,
  * while emitted elements should pass through unchanged.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1536,6 +1590,7 @@ const concurrencyIsSequential = concurrency => concurrency === undefined || conc
  * await Effect.runPromise(Channel.runCollect(processedChannel)) // => [1, 4, 9, 16, 25]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1598,6 +1653,7 @@ const mapEffectConcurrent = (self, f, options) => fromTransformBracket(Effect.fn
  * Returns a new channel which is the same as this one but applies the given
  * function to the input channel’s input elements.
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1606,6 +1662,7 @@ export const mapInput = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstrea
  * Returns a new channel which is the same as this one but applies the given
  * function to the input errors.
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1645,6 +1702,7 @@ export const mapInputError = /*#__PURE__*/dual(2, (self, f) => fromTransform((up
  * const observed = [await Effect.runPromise(Channel.runCollect(tappedChannel)), processed] // => [[1, 2, 3], [1, 2, 3]]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1682,6 +1740,7 @@ export const tap = /*#__PURE__*/dual(args => isChannel(args[0]), (self, f, optio
  * Effect.runSync(Channel.runCollect(flatMappedChannel)) // => ["item-1-0", "item-2-0", "item-2-1", "item-3-0", "item-3-1", "item-3-2"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1730,6 +1789,7 @@ const flatMapConcurrent = (self, f, options) => self.pipe(map(f), mergeAll(optio
  * Effect.runSync(Channel.runCollect(numberChannel)) // => [1, 2, 3, "Completed processing"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1770,6 +1830,7 @@ export const concatWith = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstr
  * Effect.runSync(Channel.runCollect(concatenatedChannel)) // => [1, 2, 3, "a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1788,6 +1849,7 @@ export const concat = /*#__PURE__*/dual(2, (self, that) => concatWith(self, _ =>
  * left and right channels. It returns the next output element together with the
  * next state.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1813,6 +1875,7 @@ export const combine = /*#__PURE__*/dual(4, (self, that, s, f) => fromTransform(
  * the source completes before emitting an element, the fallback function
  * receives the source done value and returns the replacement channel.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1857,6 +1920,7 @@ export const orElseIfEmpty = /*#__PURE__*/dual(2, (self, f) => fromTransform((up
  * Effect.runSync(Channel.runCollect(flattenedChannel)) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1886,6 +1950,7 @@ export const flatten = channels => flatMap(channels, identity_);
  * Effect.runSync(Channel.runCollect(flattenedChannel)) // => [1, 2, 3, 4, 5, 6, 7, 8, 9]
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -1926,6 +1991,7 @@ export const flattenArray = self => transformPull(self, pull => {
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the returned channel. Done `Take` values complete the returned channel.
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -1948,6 +2014,7 @@ export const flattenTake = self => mapEffectSequential(self, Take.toPull);
  * Effect.runSync(Channel.runCollect(drainedChannel)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1957,6 +2024,7 @@ export const drain = self => transformPull(self, pull => Effect.succeed(Effect.f
 /**
  * Repeats this channel according to the provided schedule.
  *
+ * @stability stable
  * @category repetition
  * @since 4.0.0
  */
@@ -1980,6 +2048,7 @@ const repeatLoop = (self, onDone) => fromTransform((upstream, scope) => Effect.s
 /**
  * Repeats this channel forever.
  *
+ * @stability stable
  * @category repetition
  * @since 4.0.0
  */
@@ -1995,6 +2064,7 @@ export const forever = self => repeatLoop(self, () => Effect.void);
  * fails. If the schedule finishes, the returned channel completes with the
  * schedule output.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2027,6 +2097,7 @@ export const schedule = /*#__PURE__*/dual(2, (self, schedule) => transformPull(s
  * Effect.runSync(Channel.runCollect(numbersOnlyChannel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2051,6 +2122,7 @@ export const filter = /*#__PURE__*/dual(2, (self, predicate) => fromTransform((u
  * @see {@link filterMapEffect} for using an effectful `Filter`
  * @see {@link filterMapArray} for filtering arrays of output elements
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2072,6 +2144,7 @@ export const filterMap = /*#__PURE__*/dual(2, (self, filter) => fromTransform((u
  * for which the predicate succeeds with `false` are discarded. Predicate
  * failures fail the returned channel.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2097,6 +2170,7 @@ export const filterEffect = /*#__PURE__*/dual(2, (self, predicate) => fromTransf
  * @see {@link mapEffect} for effectfully transforming every output element
  * @see {@link filterMapArrayEffect} for effectful filtering of array outputs
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2136,6 +2210,7 @@ export const filterMapEffect = /*#__PURE__*/dual(2, (self, filter) => fromTransf
  * Effect.runSync(Channel.runCollect(filteredOddChannel)) // => [[2, 4]]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2157,6 +2232,7 @@ export const filterArray = /*#__PURE__*/dual(2, (self, predicate) => transformPu
  * Successful filter results are kept as mapped values. Failed filter results
  * are removed from the array. Arrays that become empty are discarded.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2185,6 +2261,7 @@ export const filterMapArray = /*#__PURE__*/dual(2, (self, filter) => transformPu
  * for which the predicate succeeds with `true` are kept. Arrays that become
  * empty are discarded. Predicate failures fail the returned channel.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2209,6 +2286,7 @@ export const filterArrayEffect = /*#__PURE__*/dual(2, (self, predicate) => trans
  * are removed from the array. Arrays that become empty are discarded. Failures
  * from the effectful filter fail the returned channel.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -2250,6 +2328,7 @@ export const filterMapArrayEffect = /*#__PURE__*/dual(2, (self, filter) => trans
  * Effect.runSync(Channel.runCollect(asyncMapAccum)) // => ["1-processed", "1", "2-processed", "12", "3-processed", "123", "4-processed", "1234"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2319,6 +2398,7 @@ export const mapAccum = /*#__PURE__*/dual(args => isChannel(args[0]), (self, ini
  * Effect.runSync(Channel.runCollect(sentenceChannel)) // => ["", "hello", "hello world", "hello world from", "hello world from effect"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2369,6 +2449,7 @@ export const scan = /*#__PURE__*/dual(3, (self, initial, f) => scanEffect(self,
  * await Effect.runPromise(Channel.runCollect(errorHandlingScan)) // => [0, 1, 3, 6, 10]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2419,6 +2500,7 @@ export const scanEffect = /*#__PURE__*/dual(3, (self, initial, f) => fromTransfo
  * Effect.runSync(Channel.runCollect(recoveredChannel)) // => ["Recovered from failure"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2458,6 +2540,7 @@ export const catchCause = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstr
  * Effect.runSync(Channel.runCollect(channel)) // => ["recovered: boom"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2476,6 +2559,7 @@ export const catchDefect = /*#__PURE__*/dual(2, (self, f) => catchCauseFilter(se
  * Use this for observing failures, such as logging or metrics. If the observer
  * effect fails, that failure can fail the returned channel.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2499,6 +2583,7 @@ export const tapCause = /*#__PURE__*/dual(2, (self, f) => catchCause(self, cause
  * @see {@link catchCause} for recovering from every cause
  * @see {@link catchIf} for recovering from typed channel errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2524,6 +2609,7 @@ export const catchCauseIf = /*#__PURE__*/dual(3, (self, predicate, f) => catchCa
  * @see {@link catchFilter} for selecting typed errors with a `Filter`
  * @see {@link catchCause} for recovering from every cause
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2536,6 +2622,7 @@ export {
 /**
  * Recovers from typed channel errors by running a fallback channel.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2549,6 +2636,7 @@ catch_ as catch };
  * The effect is not run for normal channel completion. If the observer effect
  * fails, that failure can fail the returned channel.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2572,6 +2660,7 @@ export const tapError = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pu
  * @see {@link catchTag} for selecting tagged typed errors
  * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2596,6 +2685,7 @@ export const catchIf = /*#__PURE__*/dual(args => isChannel(args[0]), (self, pred
  * @see {@link catchTag} for selecting tagged typed errors
  * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2612,6 +2702,7 @@ export const catchFilter = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
  * errors are handled by `orElse` when provided. Without `orElse`,
  * non-matching errors are re-failed.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2650,6 +2741,7 @@ export const catchTag = /*#__PURE__*/dual(args => isChannel(args[0]), (self, k,
  * Effect.runSync(Channel.runCollect(recovered)) // => ["retry: 60"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2666,6 +2758,7 @@ export const catchReason = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
 /**
  * Catches multiple reasons within a tagged error using an object of handlers.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2710,6 +2803,7 @@ export const catchReasons = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
  * Effect.runSync(Effect.exit(Channel.runCollect(unwrapped))) // => Exit.fail(reason)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2719,6 +2813,7 @@ export const unwrapReason = /*#__PURE__*/dual(2, (self, errorTag) => catchFilter
  * value of the returned channel is created by applying the specified function
  * to the failure value of this channel.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2746,6 +2841,7 @@ export const mapError = /*#__PURE__*/dual(2, (self, f) => catch_(self, err => fa
  * Effect.runSync(Effect.exit(Channel.runCollect(fatalChannel))) // => Exit.failCause(Cause.die(error))
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2757,6 +2853,7 @@ export const orDie = self => catch_(self, die);
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2780,6 +2877,7 @@ const ignoreCause_ = self => catchCause(self, () => empty);
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2792,6 +2890,7 @@ export const ignoreCause = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
  * Returns a new channel that retries this channel according to the specified
  * schedule whenever it fails.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2844,6 +2943,7 @@ export const retry = /*#__PURE__*/dual(2, (self, schedule) => suspend(() => {
  * await Effect.runPromise(Channel.runCollect(switchedChannel)) // => ["value-3"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2885,6 +2985,7 @@ export const switchMap = /*#__PURE__*/dual(args => isChannel(args[0]), (self, f,
  * await Effect.runPromise(Channel.runCollect(mergedChannel)) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -2923,14 +3024,17 @@ export const mergeAll = /*#__PURE__*/dual(2, (channels, {
       const fiber = yield* childPull.pipe(Effect.tap(() => Effect.yieldNow), Effect.flatMap(value => Queue.offer(queue, value)), Effect.forever({
         disableYield: true
       }), Effect.onError(Effect.fnUntraced(function* (cause) {
-        const halt = Pull.filterDone(cause);
-        yield* Effect.exit(Scope.close(childScope, !Result.isFailure(halt) ? Exit.succeed(halt.success.value) : Exit.failCause(halt.failure)));
+        const exit = Pull.doneExitFromCause(cause);
+        const closeExit = yield* Effect.exit(Scope.close(childScope, exit));
         if (!fibers.has(fiber)) return;
+        // Publish usage and finalizer failures before releasing the
+        // permit or opening the latch, so the outer channel cannot
+        // complete ahead of them.
+        const failure = Exit.asVoidAll([exit, closeExit]);
+        if (Exit.isFailure(failure)) yield* Queue.failCause(queue, failure.cause);
         fibers.delete(fiber);
         if (semaphore) yield* semaphore.release(1);
         if (fibers.size === 0) yield* doneLatch.open;
-        if (Result.isSuccess(halt)) return;
-        return yield* Queue.failCause(queue, cause);
       })), Effect.forkChild);
       doneLatch.closeUnsafe();
       fibers.add(fiber);
@@ -2964,6 +3068,7 @@ export const mergeAll = /*#__PURE__*/dual(2, (channels, {
  * values.map(String).sort() // => ["1", "2", "3", "a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 4.0.0
  */
@@ -2993,7 +3098,10 @@ export const merge = /*#__PURE__*/dual(args => isChannel(args[0]) && isChannel(a
         }
     }
   }
-  const runSide = (side, channel, scope) => toTransform(channel)(upstream, scope).pipe(Effect.flatMap(pull => pull.pipe(Effect.flatMap(value => Queue.offer(queue, value)), Effect.forever)), Effect.onError(cause => Effect.andThen(Scope.close(scope, Pull.doneExitFromCause(cause)), onExit(side, cause))), Effect.forkIn(forkedScope));
+  const runSide = (side, channel, scope) => toTransform(channel)(upstream, scope).pipe(Effect.flatMap(pull => pull.pipe(Effect.flatMap(value => Queue.offer(queue, value)), Effect.forever)), Effect.onError(cause => Effect.onExitPrimitive(Pull.doneExitFromCause(cause), exit => Scope.close(scope, exit)).pipe(Effect.matchCauseEffect({
+    onFailure: cause => onExit(side, cause),
+    onSuccess: () => onExit(side, cause)
+  }))), Effect.forkIn(forkedScope));
   yield* runSide("left", left, Scope.forkUnsafe(forkedScope));
   yield* runSide("right", right, Scope.forkUnsafe(forkedScope));
   return Queue.take(queue);
@@ -3012,6 +3120,7 @@ export const merge = /*#__PURE__*/dual(args => isChannel(args[0]) && isChannel(a
  * The effect's successful value is ignored. If the effect fails while the
  * channel is running, the returned channel fails with that error.
  *
+ * @stability stable
  * @category combining
  * @since 4.0.0
  */
@@ -3041,6 +3150,7 @@ export const mergeEffect = /*#__PURE__*/dual(2, (self, effect) => merge(self, fr
  * result // => ["hello", "world"]
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -3135,6 +3245,7 @@ export const splitLines = () => fromTransform((upstream, _scope) => Effect.sync(
  * span `Uint8Array` boundaries. The optional `encoding` and `options` are
  * passed to `TextDecoder`.
  *
+ * @stability stable
  * @category decoding
  * @since 4.0.0
  */
@@ -3152,6 +3263,7 @@ export const decodeText = (encoding, options) => fromTransform((upstream, _scope
  *
  * Each string inside an emitted array is encoded independently.
  *
+ * @stability stable
  * @category encoding
  * @since 4.0.0
  */
@@ -3184,6 +3296,7 @@ export const encodeText = () => fromTransform((upstream, _scope) => Effect.sync(
  * Effect.runSync(Channel.runCollect(pipedChannel)) // => [2, 4, 6]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3213,6 +3326,7 @@ export const pipeTo = /*#__PURE__*/dual(2, (self, that) => fromTransform((upstre
  * Effect.runSync(Effect.exit(Channel.runCollect(safePipedChannel))) // => Exit.fail(error)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3244,6 +3358,7 @@ export const pipeToOrFail = /*#__PURE__*/dual(2, (self, that) => fromTransform((
  * Effect.runSync(Channel.runCollect(unwrappedChannel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -3258,6 +3373,7 @@ export const unwrap = channel => fromTransform((upstream, scope) => {
  * Runs a channel with a scope provided for the duration of the channel
  * execution, removing the channel's `Scope` requirement.
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -3291,6 +3407,7 @@ export const scoped = self => fromTransformBracket((upstream, scope, forkedScope
  * await Effect.runPromise(Channel.runCollect(embeddedChannel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3317,6 +3434,7 @@ export const embedInput = /*#__PURE__*/dual(2, (self, input) => fromTransformBra
  *
  * @see {@link bufferArray} for buffering elements from array outputs
  *
+ * @stability stable
  * @category buffering
  * @since 2.0.0
  */
@@ -3356,6 +3474,7 @@ export const buffer = /*#__PURE__*/dual(2, (self, options) => fromTransform(Effe
  *
  * @see {@link buffer} for buffering output elements without flattening arrays
  *
+ * @stability stable
  * @category buffering
  * @since 4.0.0
  */
@@ -3385,6 +3504,7 @@ export const bufferArray = /*#__PURE__*/dual(2, (self, options) => fromTransform
  * channel's done value. If the channel completes first, the original channel's
  * done value is preserved.
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -3401,6 +3521,7 @@ export const interruptWhen = /*#__PURE__*/dual(2, (self, effect) => merge(self,
  * fails with that error. If the channel completes first, the channel's done
  * value is preserved.
  *
+ * @stability stable
  * @category interruption
  * @since 4.0.0
  */
@@ -3425,6 +3546,7 @@ export const haltWhen = /*#__PURE__*/dual(2, (self, effect) => fromTransformBrac
  * The finalizer receives the failure `Cause`. The original channel failure is
  * preserved. The finalizer itself must not fail.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3454,6 +3576,7 @@ export const onError = /*#__PURE__*/dual(2, (self, finalizer) => onExit(self, ex
  * const observed = [await Effect.runPromise(Channel.runCollect(channelWithExit)), exits] // => [[1, 2, 3], [Exit.void]]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -3466,6 +3589,7 @@ export const onExit = /*#__PURE__*/dual(2, (self, finalizer) => fromTransformBra
  * The effect's successful value is ignored. If the effect fails, the returned
  * channel fails before running the source channel.
  *
+ * @stability stable
  * @category hooks
  * @since 4.0.0
  */
@@ -3484,6 +3608,7 @@ export const onStart = /*#__PURE__*/dual(2, (self, onStart) => unwrap(Effect.as(
  * emitted unchanged. The effect is not run if the channel completes without
  * emitting an element.
  *
+ * @stability stable
  * @category hooks
  * @since 4.0.0
  */
@@ -3504,6 +3629,7 @@ export const onFirst = /*#__PURE__*/dual(2, (self, onFirst) => transformPull(sel
  * not run when the channel fails. If the effect fails, the returned channel
  * fails with that error.
  *
+ * @stability stable
  * @category hooks
  * @since 4.0.0
  */
@@ -3533,6 +3659,7 @@ export const onEnd = /*#__PURE__*/dual(2, (self, onEnd) => transformPull(self, p
  * const observed = [await Effect.runPromise(Channel.runCollect(channelWithCleanup)), events] // => [[1, 2, 3], ["cleanup"]]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -3545,6 +3672,7 @@ const runWith = (self, f, onHalt) => Effect.suspend(() => {
 /**
  * Creates a channel from the specified services.
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -3553,6 +3681,7 @@ export const contextWith = f => fromTransform((upstream, scope) => Effect.contex
  * Provides a `Context` to the channel, removing the corresponding service
  * requirements from the returned channel.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -3561,6 +3690,7 @@ export const provideContext = /*#__PURE__*/dual(2, (self, context) => fromTransf
  * Provides a concrete service for a context key, removing that service
  * requirement from the returned channel.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -3578,6 +3708,7 @@ export const provideService = /*#__PURE__*/dual(3, (self, key, service) => fromT
  * If the service effect fails, the returned channel fails. The provided service
  * removes the corresponding service requirement from the returned channel.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -3592,6 +3723,7 @@ export const provideServiceEffect = /*#__PURE__*/dual(3, (self, key, service) =>
  * builds the layer in the channel scope. Use `options.local` to build a fresh
  * layer instance for this provision.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -3605,6 +3737,7 @@ export const provide = /*#__PURE__*/dual(args => isChannel(args[0]), (self, laye
  * provide to the channel. The returned channel requires the services needed to
  * build that context.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -3620,6 +3753,7 @@ export const updateContext = /*#__PURE__*/dual(2, (self, f) => fromTransform((up
  * The existing service is read from the context. The updated service is
  * provided to the channel under the same key.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -3632,6 +3766,7 @@ export const updateService = /*#__PURE__*/dual(3, (self, service, f) => updateCo
  * The created span is provided as the current parent span while the channel
  * runs. The span is ended with the channel's exit value.
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -3653,6 +3788,7 @@ const withSpanImpl = (self, name, options) => acquireUseRelease(Effect.makeSpan(
 /**
  * The starting channel for Do notation, emitting an empty object.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -3665,6 +3801,7 @@ export {
 /**
  * Adds a computed field to each object emitted by a channel.
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -3679,6 +3816,7 @@ let_ as let };
  * channel's output becomes the value of the new field. `options.concurrency`
  * and `options.bufferSize` control how derived channels are flattened.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -3698,6 +3836,7 @@ export const bind = /*#__PURE__*/dual(args => isChannel(args[0]), (self, name, f
  * @see {@link bind} for adding a field produced by another channel
  * @see {@link let_ let} for adding a computed field
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -3725,6 +3864,7 @@ export const bindTo = /*#__PURE__*/dual(2, (self, name) => map(self, elem => ({
  * Effect.runSync(countEffect) // => 5
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3751,6 +3891,7 @@ export const runCount = self => runFold(self, () => 0, acc => acc + 1);
  * Effect.runSync(drainEffect) // => "completed"
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -3783,6 +3924,7 @@ export const runDrain = self => runWith(self, pull => Effect.forever(pull, {
  * processed // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3798,6 +3940,7 @@ export const runForEach = /*#__PURE__*/dual(2, (self, f) => runWith(self, pull =
  * Returning `true` continues consuming the channel. Returning `false` stops
  * consumption early. The returned effect completes with `void`.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3826,6 +3969,7 @@ export const runForEachWhile = /*#__PURE__*/dual(2, (self, f) => runWith(self, p
  * Array.from(bytes) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3872,6 +4016,7 @@ export const mkUint8Array = self => Effect.map(runFold(self, () => ({
  * Effect.runSync(collectEffect) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -3888,6 +4033,7 @@ export const runCollect = self => runFold(self, () => [], (acc, o) => {
  * Returns `Option.some` with the first output element, or `Option.none` if the
  * channel completes without emitting output.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3907,6 +4053,7 @@ export const runHead = self => Effect.suspend(() => {
  * Returns `Option.some` with the last emitted element, or `Option.none` if the
  * channel completes without emitting output.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3941,6 +4088,7 @@ export const runLast = self => Effect.suspend(() => {
  * Effect.runSync(sumEffect) // => 15
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -3968,6 +4116,7 @@ export const runFold = /*#__PURE__*/dual(3, (self, initial, f) => Effect.suspend
  * the effectful accumulator function. The returned effect succeeds with the
  * final accumulator value.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -4009,6 +4158,7 @@ export const runFoldEffect = /*#__PURE__*/dual(3, (self, initial, f) => Effect.s
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -4046,6 +4196,7 @@ Effect.catchCause(cause => Effect.succeed(Effect.failCause(cause))));
  * await Effect.runPromise(Effect.scoped(scopedPullEffect)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4059,6 +4210,7 @@ export const toPullScoped = (self, scope) => toTransform(self)(Cause.done(), sco
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4080,6 +4232,7 @@ export const runIntoQueue = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4121,6 +4274,7 @@ export const runIntoQueueArray = /*#__PURE__*/dual(args => isChannel(args[0]), (
  * await Effect.runPromise(program) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -4143,6 +4297,7 @@ export const toQueue = /*#__PURE__*/dual(args => isChannel(args[0]), /*#__PURE__
  * completion and failure are signaled through the queue. The queue is shut down
  * when the surrounding scope closes.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4164,6 +4319,7 @@ export const toQueueArray = /*#__PURE__*/dual(args => isChannel(args[0]), /*#__P
  * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
  * channel ends. By default this is `true`.
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -4182,6 +4338,7 @@ export const toPubSub = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced(func
  * The channel's output values are published as individual PubSub messages. Use
  * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4197,6 +4354,7 @@ const makePubSub = options => Effect.acquireRelease(options.capacity === "unboun
  * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
  * down when the channel ends. By default this is `true`.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4217,6 +4375,7 @@ export const toPubSubArray = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced
  * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
  * channel execution ends.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -4231,6 +4390,7 @@ export const runIntoPubSubArray = /*#__PURE__*/dual(args => isChannel(args[0]),
  * subscriber, including one that subscribes later, observes completion or
  * failure once it has consumed its buffered values.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */