effect 4.0.0 → 4.0.2

package/dist/Sink.d.ts

@@ -7,6 +7,7 @@
  * search, count, or otherwise reduce streamed input, and they can be composed
  * when a stream needs more than one consuming step.
  *
+ * @stability stable
  * @since 2.0.0
  */
 import type { NonEmptyReadonlyArray } from "./Array.ts";
@@ -50,6 +51,7 @@ declare const TypeId = "~effect/Sink";
  * await Effect.runPromise(Stream.run(stream, sink)) // => 42
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -67,6 +69,7 @@ export interface Sink<out A, in In = unknown, out L = never, out E = never, out
  * The first element is the sink result. The optional second element contains a
  * non-empty array of leftover input that was pulled but not consumed.
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -81,6 +84,7 @@ export type End<A, L = never> = readonly [value: A, leftover?: NonEmptyReadonlyA
  * include sinks. Users normally do not need to reference this interface
  * directly.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -98,6 +102,7 @@ export interface SinkUnify<A extends {
  * sink-specific unification should preserve the `Sink` type parameters. Users
  * normally do not need to reference this interface directly.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -107,6 +112,7 @@ export interface SinkUnifyIgnore {
 /**
  * Namespace containing types and interfaces for Sink variance and type relationships.
  *
+ * @stability stable
  * @since 2.0.0
  */
 export declare namespace Sink {
@@ -160,6 +166,7 @@ export declare namespace Sink {
  * Sink.isSink(notStream) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -187,6 +194,7 @@ export declare const isSink: (u: unknown) => u is Sink<unknown, never, unknown,
  * ```
  *
  * @see {@link toChannel} for converting a `Sink` back to a `Channel`
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -213,6 +221,7 @@ export declare const fromChannel: <L, In, E, A, R>(channel: Channel.Channel<neve
  * written // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -230,6 +239,7 @@ export declare const fromWritableStream: <A, E>(options: {
  * active scope, and returns an effect that completes with the sink's `End`
  * value.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -249,6 +259,7 @@ export declare const fromTransform: <In, A, E, R, L = never>(transform: (upstrea
  * await Effect.runPromise(Channel.runDrain(channel)) // => [6]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -262,6 +273,7 @@ export declare const toChannel: <A, In, L, E, R>(self: Sink<A, In, L, E, R>) =>
  * provided pipeline, and uses the final effect's success value as the sink
  * result.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -270,6 +282,7 @@ export declare const make: <In>() => make.Constructor<In>;
  * Companion namespace containing overload types for the pipe-style sink
  * constructor returned by `Sink.make`.
  *
+ * @stability stable
  * @since 4.0.0
  */
 export declare namespace make {
@@ -307,6 +320,7 @@ export declare namespace make {
  * Use when you need to create a sink from an effect that returns both the sink
  * result value and optional leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -319,6 +333,7 @@ export declare const fromEffectEnd: <A, E, R, L = never>(effect: Effect.Effect<E
  *
  * If the effect fails, the sink fails with the same error.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -331,6 +346,7 @@ export declare const fromEffect: <A, E, R>(effect: Effect.Effect<A, E, R>) => Si
  * When the upstream stream ends, the sink ends the queue and completes with
  * `void`.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -342,6 +358,7 @@ export declare const fromQueue: <A>(queue: Queue.Queue<A, Cause.Done>) => Sink<v
  *
  * The sink completes with `void` when the upstream stream ends.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -362,6 +379,7 @@ export declare const fromPubSub: <A>(pubsub: PubSub.PubSub<A>) => Sink<void, A>;
  * await Effect.runPromise(Stream.run(stream, sink)) // => 42
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -369,6 +387,7 @@ export declare const succeed: <A, L = never>(a: A, leftovers?: NonEmptyReadonlyA
 /**
  * A sink that immediately ends with the specified lazily evaluated value.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -376,6 +395,7 @@ export declare const sync: <A>(a: LazyArg<A>) => Sink<A>;
 /**
  * A sink that is created from a lazily evaluated sink.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -396,6 +416,7 @@ export declare const suspend: <A, In, L, E, R>(evaluate: LazyArg<Sink<A, In, L,
  * await Effect.runPromiseExit(Stream.run(stream, sink)) // => Exit.fail("Sink failed")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -416,6 +437,7 @@ export declare const fail: <E>(e: E) => Sink<never, unknown, never, E>;
  * await Effect.runPromiseExit(Stream.run(stream, sink)) // => Exit.fail("Lazy error")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -436,6 +458,7 @@ export declare const failSync: <E>(evaluate: LazyArg<E>) => Sink<never, unknown,
  * await Effect.runPromiseExit(Stream.run(stream, sink)) // => Exit.fail("Custom cause")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -456,6 +479,7 @@ export declare const failCause: <E>(cause: Cause.Cause<E>) => Sink<never, unknow
  * await Effect.runPromiseExit(Stream.run(stream, sink)) // => Exit.fail("Lazy cause")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -476,6 +500,7 @@ export declare const failCauseSync: <E>(evaluate: LazyArg<Cause.Cause<E>>) => Si
  * await Effect.runPromiseExit(Stream.run(stream, sink)) // => Exit.die("Defect error")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -483,6 +508,7 @@ export declare const die: (defect: unknown) => Sink<never>;
 /**
  * A sink that never completes.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -496,6 +522,7 @@ export declare const never: Sink<unknown>;
  * instead of being returned to downstream sink composition. This does not
  * continue pulling additional elements from the upstream stream.
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -511,6 +538,7 @@ export declare const ignoreLeftover: <A, In, L, E, R>(self: Sink<A, In, L, E, R>
  * @see {@link count} for consuming all input while returning the number of elements
  * @see {@link forEach} for consuming all input while running an effect for each element
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -534,6 +562,7 @@ export declare const drain: Sink<void, unknown>;
  * @see {@link foldArray} for folding each pulled non-empty input array at once
  * @see {@link foldUntil} for folding until a fixed maximum number of elements is consumed
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -555,6 +584,7 @@ export declare const fold: <S, In, E = never, R = never>(s: LazyArg<S>, contFn:
  * @see {@link fold} for folding element by element and returning leftovers when stopping mid-array
  * @see {@link reduceWhileArrayEffect} for array-level effectful reducing that checks the predicate before consuming input
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -572,6 +602,7 @@ export declare const foldArray: <S, In, E = never, R = never>(s: LazyArg<S>, con
  * If the sink stops in the middle of a pulled array, the remaining elements
  * from that array are returned as leftovers.
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -586,6 +617,7 @@ export declare const foldUntil: <S, In, E = never, R = never>(s: LazyArg<S>, max
  *
  * @see {@link some} for the dual any-match check
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -600,6 +632,7 @@ export declare const every: <In>(predicate: Predicate<In>) => Sink<boolean, In,
  *
  * @see {@link every} for the all-match check
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -621,6 +654,7 @@ export declare const some: <In>(predicate: Predicate<In>) => Sink<boolean, In, I
  * @see {@link as} for replacing the result with a constant value
  * @see {@link mapEnd} for transforming both the result and leftovers
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -642,6 +676,7 @@ export declare const map: {
      * @see {@link as} for replacing the result with a constant value
      * @see {@link mapEnd} for transforming both the result and leftovers
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -663,6 +698,7 @@ export declare const map: {
      * @see {@link as} for replacing the result with a constant value
      * @see {@link mapEnd} for transforming both the result and leftovers
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -678,6 +714,7 @@ export declare const map: {
  *
  * @see {@link map} for computing the replacement from the original result
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -692,6 +729,7 @@ export declare const as: {
      *
      * @see {@link map} for computing the replacement from the original result
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -706,6 +744,7 @@ export declare const as: {
      *
      * @see {@link map} for computing the replacement from the original result
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -714,6 +753,7 @@ export declare const as: {
 /**
  * Transforms this sink's input elements.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -721,6 +761,7 @@ export declare const mapInput: {
     /**
      * Transforms this sink's input elements.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -728,6 +769,7 @@ export declare const mapInput: {
     /**
      * Transforms this sink's input elements.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -736,6 +778,7 @@ export declare const mapInput: {
 /**
  * Transforms this sink's input elements effectfully.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -743,6 +786,7 @@ export declare const mapInputEffect: {
     /**
      * Transforms this sink's input elements effectfully.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -750,6 +794,7 @@ export declare const mapInputEffect: {
     /**
      * Transforms this sink's input elements effectfully.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -759,6 +804,7 @@ export declare const mapInputEffect: {
  * Transforms each non-empty array of upstream input before it is fed to this
  * sink.
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -767,6 +813,7 @@ export declare const mapInputArray: {
      * Transforms each non-empty array of upstream input before it is fed to this
      * sink.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -775,6 +822,7 @@ export declare const mapInputArray: {
      * Transforms each non-empty array of upstream input before it is fed to this
      * sink.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -784,6 +832,7 @@ export declare const mapInputArray: {
  * Transforms each non-empty array of upstream input effectfully before it is
  * fed to this sink.
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -792,6 +841,7 @@ export declare const mapInputArrayEffect: {
      * Transforms each non-empty array of upstream input effectfully before it is
      * fed to this sink.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -800,6 +850,7 @@ export declare const mapInputArrayEffect: {
      * Transforms each non-empty array of upstream input effectfully before it is
      * fed to this sink.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -812,6 +863,7 @@ export declare const mapInputArrayEffect: {
  *
  * This can change both the result value and the optional leftovers.
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -823,6 +875,7 @@ export declare const mapEnd: {
      *
      * This can change both the result value and the optional leftovers.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -834,6 +887,7 @@ export declare const mapEnd: {
      *
      * This can change both the result value and the optional leftovers.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -847,6 +901,7 @@ export declare const mapEnd: {
  * This can change both the result value and the optional leftovers, and the
  * transformation can fail or require services.
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -859,6 +914,7 @@ export declare const mapEffectEnd: {
      * This can change both the result value and the optional leftovers, and the
      * transformation can fail or require services.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -871,6 +927,7 @@ export declare const mapEffectEnd: {
      * This can change both the result value and the optional leftovers, and the
      * transformation can fail or require services.
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -893,6 +950,7 @@ export declare const mapEffectEnd: {
  * @see {@link mapEffectEnd} for effectfully transforming both the result and leftovers
  * @see {@link flatMap} for continuing with another sink based on the result
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -914,6 +972,7 @@ export declare const mapEffect: {
      * @see {@link mapEffectEnd} for effectfully transforming both the result and leftovers
      * @see {@link flatMap} for continuing with another sink based on the result
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -935,6 +994,7 @@ export declare const mapEffect: {
      * @see {@link mapEffectEnd} for effectfully transforming both the result and leftovers
      * @see {@link flatMap} for continuing with another sink based on the result
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -943,6 +1003,7 @@ export declare const mapEffect: {
 /**
  * Transforms the errors emitted by this sink using `f`.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -950,6 +1011,7 @@ export declare const mapError: {
     /**
      * Transforms the errors emitted by this sink using `f`.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -957,6 +1019,7 @@ export declare const mapError: {
     /**
      * Transforms the errors emitted by this sink using `f`.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -965,6 +1028,7 @@ export declare const mapError: {
 /**
  * Transforms the leftovers emitted by this sink using `f`.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -972,6 +1036,7 @@ export declare const mapLeftover: {
     /**
      * Transforms the leftovers emitted by this sink using `f`.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -979,6 +1044,7 @@ export declare const mapLeftover: {
     /**
      * Transforms the leftovers emitted by this sink using `f`.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -994,6 +1060,7 @@ export declare const mapLeftover: {
  * pulled than needed, the remaining elements from the same array are returned
  * as leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1016,6 +1083,7 @@ export declare const take: <In>(n: number) => Sink<Array<In>, In, In>;
  * @see {@link map} for transforming the result without switching sinks
  * @see {@link mapEffect} for effectfully transforming the result without switching sinks
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1038,6 +1106,7 @@ export declare const flatMap: {
      * @see {@link map} for transforming the result without switching sinks
      * @see {@link mapEffect} for effectfully transforming the result without switching sinks
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -1060,6 +1129,7 @@ export declare const flatMap: {
      * @see {@link map} for transforming the result without switching sinks
      * @see {@link mapEffect} for effectfully transforming the result without switching sinks
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -1069,6 +1139,7 @@ export declare const flatMap: {
  * A sink that reduces input elements from the provided `initial` state with
  * `f` while the specified `predicate` returns `true`.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1077,6 +1148,7 @@ export declare const reduceWhile: <S, In>(initial: LazyArg<S>, predicate: Predic
  * A sink that effectfully reduces input elements from the provided `initial`
  * state with `f` while the specified `predicate` returns `true`.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1085,6 +1157,7 @@ export declare const reduceWhileEffect: <S, In, E, R>(initial: LazyArg<S>, predi
  * A sink that reduces non-empty input arrays from the provided `initial` state
  * with `f` while the specified `predicate` returns `true`.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1093,6 +1166,7 @@ export declare const reduceWhileArray: <S, In>(initial: LazyArg<S>, contFn: Pred
  * A sink that effectfully reduces non-empty input arrays from the provided
  * `initial` state with `f` while the specified `predicate` returns `true`.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1101,6 +1175,7 @@ export declare const reduceWhileArrayEffect: <S, In, E, R>(initial: LazyArg<S>,
  * A sink that reduces its inputs using the provided function `f` starting from
  * the provided `initial` state.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1109,6 +1184,7 @@ export declare const reduce: <S, In>(initial: LazyArg<S>, f: (s: S, input: In) =
  * A sink that reduces its inputs using the provided function `f` starting from
  * the specified `initial` state.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1117,6 +1193,7 @@ export declare const reduceArray: <S, In>(initial: LazyArg<S>, f: (s: S, input:
  * A sink that reduces its inputs using the provided effectful function `f`
  * starting from the specified `initial` state.
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
@@ -1130,6 +1207,7 @@ export declare const reduceEffect: <S, In, E, R>(initial: LazyArg<S>, f: (s: S,
  * upstream ends without input. The first element is consumed; later elements
  * from the same pulled array are emitted as leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1154,6 +1232,7 @@ export declare const head: <In>() => Sink<Option.Option<In>, In, In>;
  *
  * @see {@link head} for taking the first input value instead
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1175,6 +1254,7 @@ export declare const last: <In>() => Sink<Option.Option<In>, In>;
  *
  * @see {@link findEffect} for an effectful predicate that can fail or require services
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1196,6 +1276,7 @@ export declare const find: {
      *
      * @see {@link findEffect} for an effectful predicate that can fail or require services
      *
+     * @stability stable
      * @category constructors
      * @since 4.0.0
      */
@@ -1217,6 +1298,7 @@ export declare const find: {
      *
      * @see {@link findEffect} for an effectful predicate that can fail or require services
      *
+     * @stability stable
      * @category constructors
      * @since 4.0.0
      */
@@ -1238,6 +1320,7 @@ export declare const find: {
  *
  * @see {@link find} for the synchronous predicate variant
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1245,6 +1328,7 @@ export declare const findEffect: <In, E, R>(predicate: (input: In) => Effect.Eff
 /**
  * Creates a sink which sums up its inputs.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1256,6 +1340,7 @@ export declare const sum: Sink<number, number>;
  *
  * Use to consume input and return only the number of elements received.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1269,6 +1354,7 @@ export declare const count: Sink<number, unknown>;
  *
  * @see {@link take} for collecting only a fixed number of input elements
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1282,6 +1368,7 @@ export declare const collect: <In>() => Sink<Array<In>, In>;
  * The first failing input is consumed and excluded from the result. Any later
  * elements from the same pulled array are returned as leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1295,6 +1382,7 @@ export declare const takeWhile: {
      * The first failing input is consumed and excluded from the result. Any later
      * elements from the same pulled array are returned as leftovers.
      *
+     * @stability stable
      * @category constructors
      * @since 4.0.0
      */
@@ -1308,6 +1396,7 @@ export declare const takeWhile: {
      * The first failing input is consumed and excluded from the result. Any later
      * elements from the same pulled array are returned as leftovers.
      *
+     * @stability stable
      * @category constructors
      * @since 4.0.0
      */
@@ -1323,6 +1412,7 @@ export declare const takeWhile: {
  * result. Any later elements from the same pulled array are returned as
  * leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1336,6 +1426,7 @@ export declare const takeWhileFilter: <In, Out, X>(filter: Filter.Filter<In, Out
  * excluded from the result. Any later elements from the same pulled array are
  * returned as leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1349,6 +1440,7 @@ export declare const takeWhileEffect: {
      * excluded from the result. Any later elements from the same pulled array are
      * returned as leftovers.
      *
+     * @stability stable
      * @category constructors
      * @since 4.0.0
      */
@@ -1364,6 +1456,7 @@ export declare const takeWhileEffect: {
  * result. Any later elements from the same pulled array are returned as
  * leftovers.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1372,6 +1465,7 @@ export declare const takeWhileFilterEffect: <In, Out, X, E, R>(filter: Filter.Fi
  * Collects input elements until the predicate returns `true`, including the
  * matching element in the result.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1384,6 +1478,7 @@ export declare const takeUntil: <In>(predicate: Predicate<In>) => Sink<Array<In>
  *
  * If the predicate effect fails, the sink fails with the same error.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1406,6 +1501,7 @@ export declare const takeUntilEffect: <In, E, R>(predicate: (input: In) => Effec
  * processed // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1428,6 +1524,7 @@ export declare const forEach: <In, X, E, R>(f: (input: In) => Effect.Effect<X, E
  * processed // => [[1, 2, 3, 4, 5]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1440,6 +1537,7 @@ export declare const forEachArray: <In, X, E, R>(f: (input: NonEmptyReadonlyArra
  * The sink stops consuming input when the function returns `false` or when the
  * upstream stream ends, and completes with `void`.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1453,6 +1551,7 @@ export declare const forEachWhile: <In, E, R>(f: (input: In) => Effect.Effect<bo
  * The sink stops consuming input when the function returns `false` or when the
  * upstream stream ends, and completes with `void`.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1478,6 +1577,7 @@ export declare const forEachWhileArray: <In, E, R>(f: (input: NonEmptyReadonlyAr
  * processed // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1485,6 +1585,7 @@ export declare const unwrap: <A, In, L, E, R, R2>(effect: Effect.Effect<Sink<A,
 /**
  * Runs a summary effect when the sink starts and again when it completes.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1492,6 +1593,7 @@ export declare const summarized: {
     /**
      * Runs a summary effect when the sink starts and again when it completes.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -1499,6 +1601,7 @@ export declare const summarized: {
     /**
      * Runs a summary effect when the sink starts and again when it completes.
      *
+     * @stability stable
      * @category mapping
      * @since 2.0.0
      */
@@ -1507,6 +1610,7 @@ export declare const summarized: {
 /**
  * Returns the sink that executes this one and times its execution.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1514,6 +1618,7 @@ export declare const withDuration: <A, In, L, E, R>(self: Sink<A, In, L, E, R>)
 /**
  * A sink that drains all input and returns the elapsed duration.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1526,6 +1631,7 @@ export declare const timed: Sink<Duration.Duration, unknown>;
  * Services contained in the provided context are removed from the sink's
  * service requirements.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -1538,6 +1644,7 @@ export declare const provideContext: {
      * Services contained in the provided context are removed from the sink's
      * service requirements.
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -1550,6 +1657,7 @@ export declare const provideContext: {
      * Services contained in the provided context are removed from the sink's
      * service requirements.
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -1563,6 +1671,7 @@ export declare const provideContext: {
  * The service identified by `key` is removed from the sink's service
  * requirements.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -1575,6 +1684,7 @@ export declare const provideService: {
      * The service identified by `key` is removed from the sink's service
      * requirements.
      *
+     * @stability stable
      * @category providing services
      * @since 4.0.0
      */
@@ -1587,6 +1697,7 @@ export declare const provideService: {
      * The service identified by `key` is removed from the sink's service
      * requirements.
      *
+     * @stability stable
      * @category providing services
      * @since 4.0.0
      */
@@ -1601,6 +1712,7 @@ export declare const provideService: {
  * upstream stream. If the upstream stream had already ended, the fallback sees
  * the upstream end instead.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -1614,6 +1726,7 @@ export declare const orElse: {
      * upstream stream. If the upstream stream had already ended, the fallback sees
      * the upstream end instead.
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -1627,6 +1740,7 @@ export declare const orElse: {
      * upstream stream. If the upstream stream had already ended, the fallback sees
      * the upstream end instead.
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -1649,6 +1763,7 @@ export declare const orElse: {
  * @see {@link catch_ catch} for recovering from typed errors only
  * @see {@link orElse} for recovering by switching to another sink
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -1670,10 +1785,11 @@ export declare const catchCause: {
      * @see {@link catch_ catch} for recovering from typed errors only
      * @see {@link orElse} for recovering by switching to another sink
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
-    <E, A2, E2, R2>(f: (error: Cause.Cause<Types.NoInfer<E>>) => Effect.Effect<A2, E2, R2>): <A, In, L, R>(self: Sink<A, In, L, E, R>) => Sink<A2 | A, In, L, E, R2 | R>;
+    <E, A2, E2, R2>(f: (error: Cause.Cause<Types.NoInfer<E>>) => Effect.Effect<A2, E2, R2>): <A, In, L, R>(self: Sink<A, In, L, E, R>) => Sink<A2 | A, In, L, E2, R2 | R>;
     /**
      * Handles failures from this sink by inspecting the full `Cause`.
      *
@@ -1691,6 +1807,7 @@ export declare const catchCause: {
      * @see {@link catch_ catch} for recovering from typed errors only
      * @see {@link orElse} for recovering by switching to another sink
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -1712,6 +1829,7 @@ export {
  * @see {@link catchCause} for recovering from the full failure cause
  * @see {@link orElse} for recovering by switching to another sink
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -1724,6 +1842,7 @@ catch_ as catch };
  * The effect receives the sink's `Exit` for the result value. The original
  * sink result and leftovers are preserved unless the finalizer itself fails.
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -1736,6 +1855,7 @@ export declare const onExit: {
      * The effect receives the sink's `Exit` for the result value. The original
      * sink result and leftovers are preserved unless the finalizer itself fails.
      *
+     * @stability stable
      * @category resource management
      * @since 4.0.0
      */
@@ -1748,6 +1868,7 @@ export declare const onExit: {
      * The effect receives the sink's `Exit` for the result value. The original
      * sink result and leftovers are preserved unless the finalizer itself fails.
      *
+     * @stability stable
      * @category resource management
      * @since 4.0.0
      */
@@ -1761,6 +1882,7 @@ export declare const onExit: {
  * The original sink result and leftovers are preserved unless the finalizer
  * itself fails.
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -1773,6 +1895,7 @@ export declare const ensuring: {
      * The original sink result and leftovers are preserved unless the finalizer
      * itself fails.
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -1785,6 +1908,7 @@ export declare const ensuring: {
      * The original sink result and leftovers are preserved unless the finalizer
      * itself fails.
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */