effect 4.0.1 → 4.0.3

package/src/TxPriorityQueue.ts

@@ -9,6 +9,7 @@
  * is empty, so they can be combined with other transactional reads and writes in
  * one atomic workflow.
  *
+ * @stability stable
  * @since 4.0.0
  */
 
@@ -53,6 +54,7 @@ const TypeId = "~effect/TxPriorityQueue"
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -136,6 +138,7 @@ const mergeSorted = <A>(chunk: Chunk<A>, values: ReadonlyArray<A>, ord: Order<A>
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -158,6 +161,7 @@ export const empty = <A>(order: Order<A>): Effect.Effect<TxPriorityQueue<A>> =>
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -198,6 +202,7 @@ export function fromIterable<A>(
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -220,6 +225,7 @@ export const make = <A>(order: Order<A>) => (...elements: Array<A>): Effect.Effe
  * await Effect.runPromise(program) // => 3
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -241,6 +247,7 @@ export const size = <A>(self: TxPriorityQueue<A>): Effect.Effect<number> => Effe
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -262,6 +269,7 @@ export const isEmpty = <A>(self: TxPriorityQueue<A>): Effect.Effect<boolean> =>
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -288,6 +296,7 @@ export const isNonEmpty = <A>(self: TxPriorityQueue<A>): Effect.Effect<boolean>
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -322,6 +331,7 @@ export const peek = <A>(self: TxPriorityQueue<A>): Effect.Effect<A> =>
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -346,6 +356,7 @@ export const peekOption = <A>(self: TxPriorityQueue<A>): Effect.Effect<Option<A>
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -368,6 +379,7 @@ export const offer: {
    * await Effect.runPromise(program) // => 1
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -390,6 +402,7 @@ export const offer: {
    * await Effect.runPromise(program) // => 1
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -417,6 +430,7 @@ export const offer: {
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -438,6 +452,7 @@ export const offerAll: {
    * await Effect.runPromise(program) // => 1
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -459,14 +474,17 @@ export const offerAll: {
    * await Effect.runPromise(program) // => 1
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
   <A>(self: TxPriorityQueue<A>, values: Iterable<A>): Effect.Effect<void>
 } = dual(
   2,
-  <A>(self: TxPriorityQueue<A>, values: Iterable<A>): Effect.Effect<void> =>
-    TxRef.update(self.ref, (chunk) => mergeSorted(chunk, Array.from(values).sort(self.ord), self.ord))
+  <A>(self: TxPriorityQueue<A>, values: Iterable<A>): Effect.Effect<void> => {
+    const sorted = Array.from(values).sort(self.ord)
+    return TxRef.update(self.ref, (chunk) => mergeSorted(chunk, sorted, self.ord))
+  }
 )
 
 /**
@@ -485,6 +503,7 @@ export const offerAll: {
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -515,6 +534,7 @@ export const take = <A>(self: TxPriorityQueue<A>): Effect.Effect<A> =>
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -540,6 +560,7 @@ export const takeAll = <A>(self: TxPriorityQueue<A>): Effect.Effect<Array<A>> =>
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -568,6 +589,7 @@ export const takeOption = <A>(self: TxPriorityQueue<A>): Effect.Effect<Option<A>
  * await Effect.runPromise(program) // => [1, 2]
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -588,6 +610,7 @@ export const takeUpTo: {
    * await Effect.runPromise(program) // => [1, 2]
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -608,6 +631,7 @@ export const takeUpTo: {
    * await Effect.runPromise(program) // => [1, 2]
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -642,6 +666,7 @@ export const takeUpTo: {
  * await Effect.runPromise(program) // => [1, 3, 5]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -663,6 +688,7 @@ export const removeIf: {
    * await Effect.runPromise(program) // => [1, 3, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -684,6 +710,7 @@ export const removeIf: {
    * await Effect.runPromise(program) // => [1, 3, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -711,6 +738,7 @@ export const removeIf: {
  * await Effect.runPromise(program) // => [2, 4]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -732,6 +760,7 @@ export const retainIf: {
    * await Effect.runPromise(program) // => [2, 4]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -753,6 +782,7 @@ export const retainIf: {
    * await Effect.runPromise(program) // => [2, 4]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -779,6 +809,7 @@ export const retainIf: {
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -801,6 +832,7 @@ export const toArray = <A>(self: TxPriorityQueue<A>): Effect.Effect<Array<A>> =>
  * await Effect.runPromise(program) // => [true, false]
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */

package/src/TxPubSub.ts

@@ -7,6 +7,7 @@
  * bounded, dropping, sliding, and unbounded hubs, publishing helpers, scoped
  * subscriptions, shutdown operations, and a guard.
  *
+ * @stability stable
  * @since 4.0.0
  */
 import * as Arr from "./Array.ts"
@@ -47,6 +48,7 @@ const TypeId = "~effect/TxPubSub"
  * await Effect.runPromise(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -122,6 +124,7 @@ const makeTxPubSub = <A>(
  * await Effect.runPromise(program) // => 42
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -160,6 +163,7 @@ export const bounded = <A = never>(capacity: number): Effect.Effect<TxPubSub<A>>
  * await Effect.runPromise(program) // => [1, 2]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -196,6 +200,7 @@ export const dropping = <A = never>(capacity: number): Effect.Effect<TxPubSub<A>
  * await Effect.runPromise(program) // => 2
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -229,6 +234,7 @@ export const sliding = <A = never>(capacity: number): Effect.Effect<TxPubSub<A>>
  * await Effect.runPromise(program) // => "msg"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -259,6 +265,7 @@ export const unbounded = <A = never>(): Effect.Effect<TxPubSub<A>> =>
  * await Effect.runPromise(program) // => 16
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -288,6 +295,7 @@ export const capacity = <A>(self: TxPubSub<A>): number => self.capacity
  * await Effect.runPromise(program) // => 2
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -318,6 +326,7 @@ export const size = <A>(self: TxPubSub<A>): Effect.Effect<number> =>
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -347,6 +356,7 @@ export const isEmpty = <A>(self: TxPubSub<A>): Effect.Effect<boolean> => Effect.
  * await Effect.runPromise(program) // => [false, true]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -368,6 +378,7 @@ export const isNonEmpty = <A>(self: TxPubSub<A>): Effect.Effect<boolean> => Effe
  * await Effect.runPromise(program) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -399,6 +410,7 @@ export const isFull = <A>(self: TxPubSub<A>): Effect.Effect<boolean> =>
  * await Effect.runPromise(program) // => [false, true]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -439,6 +451,7 @@ export const isShutdown = <A>(self: TxPubSub<A>): Effect.Effect<boolean> => TxRe
  * await Effect.runPromise(program) // => [true, "hello"]
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -478,6 +491,7 @@ export const publish: {
    * await Effect.runPromise(program) // => [true, "hello"]
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -517,6 +531,7 @@ export const publish: {
    * await Effect.runPromise(program) // => [true, "hello"]
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -569,6 +584,7 @@ export const publish: {
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -603,6 +619,7 @@ export const publishAll: {
    * await Effect.runPromise(program) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -637,6 +654,7 @@ export const publishAll: {
    * await Effect.runPromise(program) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -690,6 +708,7 @@ export const publishAll: {
  * await Effect.runPromise(program) // => ["broadcast", "broadcast"]
  * ```
  *
+ * @stability unstable
  * @category mutations
  * @since 2.0.0
  */
@@ -714,6 +733,7 @@ export const subscribe = <A>(self: TxPubSub<A>): Effect.Effect<TxQueue.TxQueue<A
  * @see {@link subscribe} for the scoped acquire and release wrapper when no custom transaction composition is needed
  * @see {@link releaseSubscriber} to remove and shut down a queue returned by `acquireSubscriber`
  *
+ * @stability unstable
  * @category mutations
  * @since 4.0.0
  */
@@ -747,6 +767,7 @@ export const acquireSubscriber = <A>(
  * @see {@link acquireSubscriber} for the matching transactional acquire step
  * @see {@link subscribe} for the scoped acquire and release wrapper
  *
+ * @stability unstable
  * @category mutations
  * @since 4.0.0
  */
@@ -772,6 +793,7 @@ export const releaseSubscriber: {
    * @see {@link acquireSubscriber} for the matching transactional acquire step
    * @see {@link subscribe} for the scoped acquire and release wrapper
    *
+   * @stability unstable
    * @category mutations
    * @since 4.0.0
    */
@@ -797,6 +819,7 @@ export const releaseSubscriber: {
    * @see {@link acquireSubscriber} for the matching transactional acquire step
    * @see {@link subscribe} for the scoped acquire and release wrapper
    *
+   * @stability unstable
    * @category mutations
    * @since 4.0.0
    */
@@ -857,6 +880,7 @@ const makeSubscriberQueue = <A>(
  * await Effect.runPromise(program) // => [true, false]
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -892,6 +916,7 @@ export const shutdown = <A>(self: TxPubSub<A>): Effect.Effect<void> =>
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -918,6 +943,7 @@ export const awaitShutdown = <A>(self: TxPubSub<A>): Effect.Effect<void> =>
  * TxPubSub.isTxPubSub(someValue) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */