effect 4.0.0-beta.67 → 4.0.0-beta.69

package/dist/Channel.js

@@ -232,7 +232,7 @@ export const toTransform = channel => channel.transform;
  * ```
  *
  * @category constants
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const DefaultChunkSize = 4096;
 const asyncQueue = (scope, f, options) => Queue.make({
@@ -257,7 +257,7 @@ const asyncQueue = (scope, f, options) => Queue.make({
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const callback = (f, options) => fromTransform((_, scope) => Effect.map(asyncQueue(scope, f, options), Queue.take));
 /**
@@ -345,7 +345,7 @@ export const acquireUseRelease = (acquire, use, release) => fromTransformBracket
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const acquireRelease = /*#__PURE__*/dual(2, (self, release) => unwrap(Effect.map(Effect.acquireRelease(self, release), succeed)));
 /**
@@ -362,7 +362,7 @@ export const acquireRelease = /*#__PURE__*/dual(2, (self, release) => unwrap(Eff
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIterator = iterator => fromPull(Effect.sync(() => {
   const iter = iterator();
@@ -384,7 +384,7 @@ export const fromIterator = iterator => fromPull(Effect.sync(() => {
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromArray = array => fromPull(Effect.sync(() => {
   let index = 0;
@@ -404,7 +404,7 @@ export const fromArray = array => fromPull(Effect.sync(() => {
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromChunk = chunk => fromArray(Chunk.toReadonlyArray(chunk));
 /**
@@ -451,7 +451,7 @@ export const fromChunk = chunk => fromArray(Chunk.toReadonlyArray(chunk));
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIteratorArray = (iterator, chunkSize = DefaultChunkSize) => fromPull(Effect.sync(() => {
   const iter = iterator();
@@ -487,7 +487,7 @@ export const fromIteratorArray = (iterator, chunkSize = DefaultChunkSize) => fro
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIterable = iterable => fromIterator(() => iterable[Symbol.iterator]());
 /**
@@ -504,7 +504,7 @@ export const fromIterable = iterable => fromIterator(() => iterable[Symbol.itera
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIterableArray = (iterable, chunkSize = DefaultChunkSize) => fromIteratorArray(() => iterable[Symbol.iterator](), chunkSize);
 /**
@@ -588,7 +588,7 @@ export const sync = evaluate => fromEffect(Effect.sync(evaluate));
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const empty = /*#__PURE__*/fromPull(/*#__PURE__*/Effect.succeed(/*#__PURE__*/Cause.done()));
 /**
@@ -755,7 +755,7 @@ export const failCauseSync = evaluate => fromPull(Effect.failCauseSync(evaluate)
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const die = defect => failCause(Cause.die(defect));
 /**
@@ -868,7 +868,7 @@ export const fromEffectTake = effect => fromPull(Effect.succeed(Effect.flatMap(e
  * ```
  *
  * @category constructors
- * @since 4.0.0
+ * @since 2.0.0
  */
 export const fromQueue = queue => fromPull(Effect.succeed(Queue.take(queue)));
 /**
@@ -919,7 +919,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.
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export const identity = () => fromTransform((upstream, _scope) => Effect.succeed(upstream));
@@ -975,9 +975,6 @@ export const fromSubscription = subscription => fromPull(Effect.succeed(Effect.o
  * arrays of values in chunks. It's useful when you want to process multiple values at once
  * for better performance.
  *
- * @param subscription - The PubSub subscription to read from
- * @param chunkSize - The maximum number of elements to read in each chunk (default: 4096)
- *
  * **Example** (Batching subscription values)
  *
  * ```ts
@@ -1079,8 +1076,6 @@ export const fromSubscriptionArray = subscription => fromPull(Effect.succeed(Eff
  * subscribing to it. The channel outputs individual values as they are published
  * to the PubSub, making it ideal for real-time streaming scenarios.
  *
- * @param pubsub - The PubSub to read from
- *
  * **Example** (Creating channels from PubSubs)
  *
  * ```ts
@@ -1163,7 +1158,7 @@ export const fromSubscriptionArray = subscription => fromPull(Effect.succeed(Eff
  * ```
  *
  * @category constructors
- * @since 4.0.0
+ * @since 2.0.0
  */
 export const fromPubSub = pubsub => unwrap(Effect.map(PubSub.subscribe(pubsub), fromSubscription));
 /**
@@ -1173,9 +1168,6 @@ export const fromPubSub = pubsub => unwrap(Effect.map(PubSub.subscribe(pubsub),
  * subscribing to it and collecting values into arrays. The channel outputs
  * arrays of values in chunks, making it ideal for batch processing scenarios.
  *
- * @param pubsub - The PubSub to read from
- * @param chunkSize - The maximum number of elements to collect in each array (default: 4096)
- *
  * **Example** (Batching PubSub values)
  *
  * ```ts
@@ -1375,7 +1367,7 @@ export const fromAsyncIterableArray = (iterable, onError) => map(fromAsyncIterab
  * }))
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const map = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pull => Effect.sync(() => {
@@ -1385,15 +1377,15 @@ export const map = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pull =>
 /**
  * Maps the done value of this channel using the specified function.
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const mapDone = /*#__PURE__*/dual(2, (self, f) => mapDoneEffect(self, o => Effect.succeed(f(o))));
 /**
  * Maps the done value of this channel using the specified effectful function.
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const mapDoneEffect = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pull => Effect.succeed(Pull.catchDone(pull, done => Effect.flatMap(f(done), Cause.done)))));
 const concurrencyIsSequential = concurrency => concurrency === undefined || concurrency !== "unbounded" && concurrency <= 1;
@@ -1635,7 +1627,7 @@ const flatMapConcurrent = (self, f, options) => self.pipe(map(f), mergeAll(optio
  * ```
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const concatWith = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstream, scope) => Effect.sync(() => {
   let currentPull;
@@ -1675,7 +1667,7 @@ export const concatWith = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstr
  * ```
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const concat = /*#__PURE__*/dual(2, (self, that) => concatWith(self, _ => that));
 /**
@@ -1709,7 +1701,7 @@ export const combine = /*#__PURE__*/dual(4, (self, that, s, f) => fromTransform(
  * receives the source done value and returns the replacement channel.
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const orElseIfEmpty = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstream, scope) => Effect.sync(() => {
   let currentPull;
@@ -1910,8 +1902,8 @@ export const schedule = /*#__PURE__*/dual(2, (self, schedule) => transformPull(s
  * // Outputs: 1, 2, 3 (all typed as numbers)
  * ```
  *
- * @category Filtering
- * @since 2.0.0
+ * @category filtering
+ * @since 4.0.0
  */
 export const filter = /*#__PURE__*/dual(2, (self, predicate) => fromTransform((upstream, scope) => Effect.map(toTransform(self)(upstream, scope), pull => Effect.flatMap(pull, function loop(elem) {
   return predicate(elem) ? Effect.succeed(elem) : Effect.flatMap(pull, loop);
@@ -1923,7 +1915,7 @@ export const filter = /*#__PURE__*/dual(2, (self, predicate) => fromTransform((u
  * results are discarded. The source channel's errors and done value are
  * preserved.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMap = /*#__PURE__*/dual(2, (self, filter) => fromTransform((upstream, scope) => Effect.map(toTransform(self)(upstream, scope), pull => Effect.flatMap(pull, function loop(elem) {
@@ -1937,7 +1929,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.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterEffect = /*#__PURE__*/dual(2, (self, predicate) => fromTransform((upstream, scope) => Effect.map(toTransform(self)(upstream, scope), pull => Effect.flatMap(pull, function loop(elem) {
@@ -1950,7 +1942,7 @@ export const filterEffect = /*#__PURE__*/dual(2, (self, predicate) => fromTransf
  * results are discarded. Failures from the effectful filter fail the returned
  * channel.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMapEffect = /*#__PURE__*/dual(2, (self, filter) => fromTransform((upstream, scope) => Effect.map(toTransform(self)(upstream, scope), pull => Effect.flatMap(pull, function loop(elem) {
@@ -1989,7 +1981,7 @@ export const filterMapEffect = /*#__PURE__*/dual(2, (self, filter) => fromTransf
  * // Outputs: [2, 4] (the arrays [1,3,5] and [7,9] are discarded)
  * ```
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterArray = /*#__PURE__*/dual(2, (self, predicate) => transformPull(self, pull => Effect.succeed(Effect.flatMap(pull, function loop(arr) {
@@ -2008,7 +2000,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.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMapArray = /*#__PURE__*/dual(2, (self, filter) => transformPull(self, pull => Effect.succeed(Effect.flatMap(pull, function loop(arr) {
@@ -2029,7 +2021,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.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterArrayEffect = /*#__PURE__*/dual(2, (self, predicate) => transformPull(self, pull => {
@@ -2046,7 +2038,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.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMapArrayEffect = /*#__PURE__*/dual(2, (self, filter) => transformPull(self, pull => Effect.succeed(Effect.flatMap(pull, function loop(arr) {
@@ -2087,8 +2079,8 @@ export const filterMapArrayEffect = /*#__PURE__*/dual(2, (self, filter) => trans
  * )
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const mapAccum = /*#__PURE__*/dual(args => isChannel(args[0]), (self, initial, f, options) => fromTransform((upstream, scope) => Effect.map(toTransform(self)(upstream, scope), pull => {
   let state = initial();
@@ -2156,8 +2148,8 @@ export const mapAccum = /*#__PURE__*/dual(args => isChannel(args[0]), (self, ini
  * // Outputs: "", "hello", "hello world", "hello world from", "hello world from effect"
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const scan = /*#__PURE__*/dual(3, (self, initial, f) => scanEffect(self, initial, (s, a) => Effect.succeed(f(s, a))));
 /**
@@ -2202,8 +2194,8 @@ export const scan = /*#__PURE__*/dual(3, (self, initial, f) => scanEffect(self,
  * )
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const scanEffect = /*#__PURE__*/dual(3, (self, initial, f) => fromTransform((upstream, scope) => Effect.map(toTransform(self)(upstream, scope), pull => {
   let state = initial;
@@ -2252,8 +2244,8 @@ export const scanEffect = /*#__PURE__*/dual(3, (self, initial, f) => fromTransfo
  * // The channel recovers gracefully from errors
  * ```
  *
- * @category Error handling
- * @since 4.0.0
+ * @category error handling
+ * @since 2.0.0
  */
 export const catchCause = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstream, scope) => {
   let forkedScope = Scope.forkUnsafe(scope);
@@ -2279,7 +2271,7 @@ export const catchCause = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstr
  * Use this for observing failures, such as logging or metrics. If the observer
  * effect fails, that failure can fail the returned channel.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const tapCause = /*#__PURE__*/dual(2, (self, f) => catchCause(self, cause => fromEffectDrain(Effect.flatMap(f(cause), _ => Effect.failCause(cause)))));
@@ -2287,7 +2279,7 @@ export const tapCause = /*#__PURE__*/dual(2, (self, f) => catchCause(self, cause
  * Catches causes of failure that match a specific filter, allowing
  * conditional error recovery based on the type of failure.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchCauseIf = /*#__PURE__*/dual(3, (self, predicate, f) => catchCause(self, cause => {
@@ -2300,7 +2292,7 @@ export const catchCauseIf = /*#__PURE__*/dual(3, (self, predicate, f) => catchCa
  * and the original cause. When the filter fails, the returned channel fails
  * with the residual cause produced by the filter.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchCauseFilter = /*#__PURE__*/dual(3, (self, filter, f) => catchCause(self, cause => {
@@ -2310,7 +2302,7 @@ export const catchCauseFilter = /*#__PURE__*/dual(3, (self, filter, f) => catchC
 const catch_ = /*#__PURE__*/dual(2, (self, f) => catchCauseFilter(self, Cause.findError, e => f(e)));
 export {
 /**
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 catch_ as catch };
@@ -2321,7 +2313,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.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const tapError = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pull => Effect.succeed(Effect.tapError(pull, err => Cause.isDone(err) ? Effect.void : Effect.asVoid(f(err))))));
@@ -2332,7 +2324,7 @@ export const tapError = /*#__PURE__*/dual(2, (self, f) => transformPull(self, pu
  * are handled by `orElse` when provided. Without `orElse`, non-matching errors
  * are re-failed.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchIf = /*#__PURE__*/dual(args => isChannel(args[0]), (self, predicate, f, orElse) => catch_(self, err => {
@@ -2345,7 +2337,7 @@ export const catchIf = /*#__PURE__*/dual(args => isChannel(args[0]), (self, pred
  * filter results are handled by `orElse` when provided. Without `orElse`,
  * failed filter results are re-failed.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchFilter = /*#__PURE__*/dual(args => isChannel(args[0]), (self, filter, f, orElse) => catch_(self, err => {
@@ -2359,7 +2351,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.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchTag = /*#__PURE__*/dual(args => isChannel(args[0]), (self, k, f, orElse) => {
@@ -2397,7 +2389,7 @@ export const catchTag = /*#__PURE__*/dual(args => isChannel(args[0]), (self, k,
  * )
  * ```
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchReason = /*#__PURE__*/dual(args => isChannel(args[0]), (self, errorTag, reasonTag, f, orElse) => catch_(self, error => {
@@ -2413,7 +2405,7 @@ export const catchReason = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
 /**
  * Catches multiple reasons within a tagged error using an object of handlers.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchReasons = /*#__PURE__*/dual(args => isChannel(args[0]), (self, errorTag, cases, orElse) => {
@@ -2457,7 +2449,7 @@ export const catchReasons = /*#__PURE__*/dual(args => isChannel(args[0]), (self,
  * const unwrapped = channel.pipe(Channel.unwrapReason("AiError"))
  * ```
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const unwrapReason = /*#__PURE__*/dual(2, (self, errorTag) => catchFilter(self, error => isTagged(error, errorTag) && hasProperty(error, "reason") ? Result.succeed(error.reason) : Result.fail(error), fail));
@@ -2466,7 +2458,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.
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export const mapError = /*#__PURE__*/dual(2, (self, f) => catch_(self, err => fail(f(err))));
@@ -2492,8 +2484,8 @@ export const mapError = /*#__PURE__*/dual(2, (self, f) => catch_(self, err => fa
  * // Any failure will now become a defect (uncaught exception)
  * ```
  *
- * @category Error handling
- * @since 4.0.0
+ * @category error handling
+ * @since 2.0.0
  */
 export const orDie = self => catch_(self, die);
 /**
@@ -2501,7 +2493,7 @@ export const orDie = self => catch_(self, die);
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const ignore = /*#__PURE__*/dual(args => isChannel(args[0]), (self, options) => {
@@ -2517,7 +2509,7 @@ const ignoreCause_ = self => catchCause(self, () => empty);
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const ignoreCause = /*#__PURE__*/dual(args => isChannel(args[0]), (self, options) => {
@@ -2580,7 +2572,7 @@ export const retry = /*#__PURE__*/dual(2, (self, schedule) => suspend(() => {
  * ```
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const switchMap = /*#__PURE__*/dual(args => isChannel(args[0]), (self, f, options) => self.pipe(map(f), mergeAll({
   ...options,
@@ -2687,7 +2679,7 @@ export const mergeAll = /*#__PURE__*/dual(2, (channels, {
  * ```
  *
  * @category utils
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const merge = /*#__PURE__*/dual(args => isChannel(args[0]) && isChannel(args[1]), (left, right, options) => fromTransformBracket(Effect.fnUntraced(function* (upstream, _scope, forkedScope) {
   const strategy = options?.haltStrategy ?? "both";
@@ -2848,15 +2840,19 @@ export const splitLines = () => fromTransform((upstream, _scope) => Effect.sync(
 /**
  * Decodes incoming `Uint8Array` chunks into strings using `TextDecoder`.
  *
- * Each `Uint8Array` inside an emitted array is decoded independently. The
- * optional `encoding` and `options` are passed to `TextDecoder`.
+ * Input chunks are decoded with streaming enabled so multi-byte characters may
+ * span `Uint8Array` boundaries. The optional `encoding` and `options` are
+ * passed to `TextDecoder`.
  *
  * @category String manipulation
  * @since 4.0.0
  */
 export const decodeText = (encoding, options) => fromTransform((upstream, _scope) => Effect.sync(() => {
   const decoder = new TextDecoder(encoding, options);
-  return Effect.map(upstream, Arr.map(line => decoder.decode(line)));
+  const streamOptions = {
+    stream: true
+  };
+  return Effect.map(upstream, Arr.map(line => decoder.decode(line, streamOptions)));
 }));
 /**
  * Encodes incoming string chunks into `Uint8Array` values using `TextEncoder`.
@@ -2971,7 +2967,7 @@ export const unwrap = channel => fromTransform((upstream, scope) => {
  * @category utils
  * @since 2.0.0
  */
-export const scoped = self => fromTransformBracket((upstream, scope, forkedScope) => Scope.provide(toTransform(self)(upstream, scope), forkedScope));
+export const scoped = self => fromTransformBracket((upstream, scope, forkedScope) => Effect.map(Scope.provide(toTransform(self)(upstream, scope), forkedScope), Scope.provide(forkedScope)));
 /**
  * Runs an input handler against the upstream pull while the wrapped channel
  * runs without receiving upstream input directly.
@@ -3029,7 +3025,7 @@ export const buffer = /*#__PURE__*/dual(2, (self, options) => fromTransform(Effe
  * buffering up to `capacity` elements in a queue.
  *
  * @category Buffering
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const bufferArray = /*#__PURE__*/dual(2, (self, options) => fromTransform(Effect.fnUntraced(function* (upstream, scope) {
   const pull = yield* toTransform(self)(upstream, scope);
@@ -3194,7 +3190,7 @@ const runWith = (self, f, onHalt) => Effect.suspend(() => {
 /**
  * Create a channel from the specified services.
  *
- * @category Services
+ * @category services
  * @since 2.0.0
  */
 export const contextWith = f => fromTransform((upstream, scope) => Effect.contextWith(context => toTransform(f(context))(upstream, scope)));
@@ -3202,16 +3198,16 @@ export const contextWith = f => fromTransform((upstream, scope) => Effect.contex
  * Provides a `Context` to the channel, removing the corresponding service
  * requirements from the returned channel.
  *
- * @category Services
- * @since 4.0.0
+ * @category services
+ * @since 2.0.0
  */
 export const provideContext = /*#__PURE__*/dual(2, (self, context) => fromTransform((upstream, scope) => Effect.map(Effect.provideContext(toTransform(self)(upstream, scope), context), Effect.provideContext(context))));
 /**
  * Provides a concrete service for a context key, removing that service
  * requirement from the returned channel.
  *
- * @category Services
- * @since 4.0.0
+ * @category services
+ * @since 2.0.0
  */
 export const provideService = /*#__PURE__*/dual(3, (self, key, service) => fromTransform((upstream, scope) => Effect.map(Effect.provideService(toTransform(self)(upstream, scope), key, service), Effect.provideService(key, service))));
 /**
@@ -3221,7 +3217,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.
  *
- * @category Services
+ * @category services
  * @since 4.0.0
  */
 export const provideServiceEffect = /*#__PURE__*/dual(3, (self, key, service) => fromTransform((upstream, scope) => Effect.flatMap(service, s => toTransform(provideService(self, key, s))(upstream, scope))));
@@ -3233,7 +3229,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.
  *
- * @category Services
+ * @category services
  * @since 4.0.0
  */
 export const provide = /*#__PURE__*/dual(args => isChannel(args[0]), (self, layer, options) => Context.isContext(layer) ? provideContext(self, layer) : fromTransform((upstream, scope) => Effect.flatMap(options?.local ? Layer.buildWithMemoMap(layer, Layer.makeMemoMapUnsafe(), scope) : Layer.buildWithScope(layer, scope), context => Effect.map(Effect.provideContext(toTransform(self)(upstream, scope), context), Effect.provideContext(context)))));
@@ -3244,8 +3240,8 @@ 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.
  *
- * @category Services
- * @since 2.0.0
+ * @category services
+ * @since 4.0.0
  */
 export const updateContext = /*#__PURE__*/dual(2, (self, f) => fromTransform((upstream, scope) => Effect.contextWith(context => {
   const toProvide = f(context);
@@ -3257,7 +3253,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.
  *
- * @category Services
+ * @category services
  * @since 2.0.0
  */
 export const updateService = /*#__PURE__*/dual(3, (self, service, f) => updateContext(self, context => Context.add(context, service, f(Context.get(context, service)))));
@@ -3267,8 +3263,8 @@ 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.
  *
- * @category Tracing
- * @since 4.0.0
+ * @category tracing
+ * @since 2.0.0
  */
 export const withSpan = function () {
   const dataFirst = isChannel(arguments[0]);
@@ -3348,7 +3344,7 @@ export const bindTo = /*#__PURE__*/dual(2, (self, name) => map(self, elem => ({
  * ```
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runCount = self => runFold(self, () => 0, acc => acc + 1);
 /**
@@ -3407,7 +3403,7 @@ export const runDrain = self => runWith(self, pull => Effect.forever(pull, {
  * ```
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runForEach = /*#__PURE__*/dual(2, (self, f) => runWith(self, pull => Effect.forever(Effect.flatMap(pull, f), {
   disableYield: true
@@ -3420,7 +3416,7 @@ export const runForEach = /*#__PURE__*/dual(2, (self, f) => runWith(self, pull =
  * consumption early. The returned effect completes with `void`.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runForEachWhile = /*#__PURE__*/dual(2, (self, f) => runWith(self, pull => pull.pipe(Effect.flatMap(f), Effect.flatMap(cont => cont ? Effect.void : Cause.done()), Effect.forever({
   disableYield: true
@@ -3468,7 +3464,7 @@ export const runDone = self => runWith(self, identity_, Effect.succeed);
  * channel completes without emitting output.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runHead = self => Effect.suspend(() => {
   let head = Option.none();
@@ -3485,7 +3481,7 @@ export const runHead = self => Effect.suspend(() => {
  * channel completes without emitting output.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runLast = self => Effect.suspend(() => {
   const absent = Symbol(); // Prevent boxing
@@ -3519,7 +3515,7 @@ export const runLast = self => Effect.suspend(() => {
  * ```
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runFold = /*#__PURE__*/dual(3, (self, initial, f) => Effect.suspend(() => {
   let state = initial();
@@ -3539,7 +3535,7 @@ export const runFold = /*#__PURE__*/dual(3, (self, initial, f) => Effect.suspend
  * final accumulator value.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runFoldEffect = /*#__PURE__*/dual(3, (self, initial, f) => Effect.suspend(() => {
   let state = initial();
@@ -3578,7 +3574,7 @@ export const runFoldEffect = /*#__PURE__*/dual(3, (self, initial, f) => Effect.s
  * // Use the Pull to manually consume elements
  * ```
  *
- * @category Destructors
+ * @category destructors
  * @since 2.0.0
  */
 export const toPull = /*#__PURE__*/Effect.fnUntraced(function* (self) {
@@ -3614,7 +3610,7 @@ Effect.catchCause(cause => Effect.succeed(Effect.failCause(cause))));
  * })
  * ```
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toPullScoped = (self, scope) => toTransform(self)(Cause.done(), scope);
@@ -3625,7 +3621,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`.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoQueue = /*#__PURE__*/dual(args => isChannel(args[0]), (self, queue) => Effect.uninterruptibleMask(restore => runForEach(self, value => Queue.offer(queue, value)).pipe(restore, Effect.exit, Effect.flatMap(exit => {
@@ -3644,7 +3640,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`.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoQueueArray = /*#__PURE__*/dual(args => isChannel(args[0]), (self, queue) => Effect.uninterruptibleMask(restore => runForEach(self, value => Queue.offerAll(queue, value)).pipe(restore, Effect.exit, Effect.flatMap(exit => {
@@ -3682,8 +3678,8 @@ export const runIntoQueueArray = /*#__PURE__*/dual(args => isChannel(args[0]), (
  * // Multiple consumers can read from the queue
  * ```
  *
- * @category Destructors
- * @since 4.0.0
+ * @category destructors
+ * @since 2.0.0
  */
 export const toQueue = /*#__PURE__*/dual(args => isChannel(args[0]), /*#__PURE__*/Effect.fnUntraced(function* (self, options) {
   const scope = yield* Effect.scope;
@@ -3702,7 +3698,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.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toQueueArray = /*#__PURE__*/dual(args => isChannel(args[0]), /*#__PURE__*/Effect.fnUntraced(function* (self, options) {
@@ -3721,8 +3717,8 @@ 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`.
  *
- * @category Destructors
- * @since 4.0.0
+ * @category destructors
+ * @since 2.0.0
  */
 export const toPubSub = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced(function* (self, options) {
   const pubsub = yield* makePubSub(options);
@@ -3737,7 +3733,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.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoPubSub = /*#__PURE__*/dual(args => isChannel(args[0]), (self, pubsub, options) => runForEach(self, value => PubSub.publish(pubsub, value)).pipe(options?.shutdownOnEnd === true ? Effect.ensuring(PubSub.shutdown(pubsub)) : identity_));
@@ -3750,7 +3746,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`.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toPubSubArray = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced(function* (self, options) {
@@ -3768,7 +3764,7 @@ export const toPubSubArray = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced
  * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
  * channel execution ends.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoPubSubArray = /*#__PURE__*/dual(args => isChannel(args[0]), (self, pubsub, options) => runForEach(self, value => PubSub.publishAll(pubsub, value)).pipe(options?.shutdownOnEnd === true ? Effect.ensuring(PubSub.shutdown(pubsub)) : identity_));
@@ -3779,7 +3775,7 @@ export const runIntoPubSubArray = /*#__PURE__*/dual(args => isChannel(args[0]),
  * channel ends, its final `Exit` is published so subscribers can observe
  * completion or failure.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toPubSubTake = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced(function* (self, options) {