effect 4.0.1 → 4.0.2

package/src/TxHashMap.ts

@@ -7,6 +7,7 @@
  * shared registries, counters, indexes, and other maps that need safe
  * read-modify-write sequences alongside related transactional state.
  *
+ * @stability stable
  * @since 2.0.0
  */
 
@@ -79,6 +80,7 @@ const TxHashMapProto = {
  * await Effect.runPromise(program) // => 2
  * ```
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -123,6 +125,7 @@ export interface TxHashMap<in out K, in out V> extends Inspectable, Pipeable {
  * await Effect.runPromise(program) // => Option.some({ stock: 3, price: 999 })
  * ```
  *
+ * @stability stable
  * @since 4.0.0
  */
 export declare namespace TxHashMap {
@@ -252,6 +255,7 @@ export declare namespace TxHashMap {
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -288,6 +292,7 @@ export const empty = <K, V>(): Effect.Effect<TxHashMap<K, V>> =>
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -331,17 +336,19 @@ export const make = <K, V>(
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
 export const fromIterable = <K, V>(
   entries: Iterable<readonly [K, V]>
-): Effect.Effect<TxHashMap<K, V>> =>
-  Effect.gen(function*() {
-    const hashMap = HashMap.fromIterable(entries)
+): Effect.Effect<TxHashMap<K, V>> => {
+  const hashMap = HashMap.fromIterable(entries)
+  return Effect.gen(function*() {
     const ref = yield* TxRef.make(hashMap)
     return Object.assign(Object.create(TxHashMapProto), { ref })
   })
+}
 
 /**
  * Looks up the value for the specified key in the TxHashMap.
@@ -368,6 +375,7 @@ export const fromIterable = <K, V>(
  * await Effect.runPromise(program) // => Option.some({ name: "Bob", role: "user" })
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -397,6 +405,7 @@ export const get: {
    * await Effect.runPromise(program) // => Option.some({ name: "Bob", role: "user" })
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -426,6 +435,7 @@ export const get: {
    * await Effect.runPromise(program) // => Option.some({ name: "Bob", role: "user" })
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -474,6 +484,7 @@ export const get: {
  * await Effect.runPromise(program) // => Option.some(8)
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -513,6 +524,7 @@ export const set: {
    * await Effect.runPromise(program) // => Option.some(8)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -552,6 +564,7 @@ export const set: {
    * await Effect.runPromise(program) // => Option.some(8)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -588,6 +601,7 @@ export const set: {
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -618,6 +632,7 @@ export const has: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -648,6 +663,7 @@ export const has: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -695,6 +711,7 @@ export const has: {
  * await Effect.runPromise(program) // => 2
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -733,6 +750,7 @@ export const remove: {
    * await Effect.runPromise(program) // => 2
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -771,6 +789,7 @@ export const remove: {
    * await Effect.runPromise(program) // => 2
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -822,6 +841,7 @@ export const remove: {
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -856,6 +876,7 @@ export const clear = <K, V>(self: TxHashMap<K, V>): Effect.Effect<void> => TxRef
  * await Effect.runPromise(program) // => 3
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -890,6 +911,7 @@ export const size = <K, V>(self: TxHashMap<K, V>): Effect.Effect<number> =>
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -920,6 +942,7 @@ export const isEmpty = <K, V>(self: TxHashMap<K, V>): Effect.Effect<boolean> =>
  * await Effect.runPromise(program) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -971,6 +994,7 @@ export const isNonEmpty = <K, V>(self: TxHashMap<K, V>): Effect.Effect<boolean>
  * await Effect.runPromise(program) // => Option.some(500)
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1020,6 +1044,7 @@ export const modify: {
    * await Effect.runPromise(program) // => Option.some(500)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1069,6 +1094,7 @@ export const modify: {
    * await Effect.runPromise(program) // => Option.some(500)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1133,6 +1159,7 @@ export const modify: {
  * await Effect.runPromise(program) // => Option.some("content1.bak")
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1178,6 +1205,7 @@ export const modifyAt: {
    * await Effect.runPromise(program) // => Option.some("content1.bak")
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1223,6 +1251,7 @@ export const modifyAt: {
    * await Effect.runPromise(program) // => Option.some("content1.bak")
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1283,6 +1312,7 @@ export const modifyAt: {
  * await Effect.runPromise(program) // => ["alice: admin", "bob: user", "charlie: moderator"]
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -1322,6 +1352,7 @@ export const keys = <K, V>(self: TxHashMap<K, V>): Effect.Effect<Array<K>> =>
  * await Effect.runPromise(program) // => 95
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -1352,6 +1383,7 @@ export const values = <K, V>(self: TxHashMap<K, V>): Effect.Effect<Array<V>> =>
  * await Effect.runPromise(program) // => [["host", "localhost"], ["port", "3000"], ["ssl", "false"]]
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1396,6 +1428,7 @@ export const entries = <K, V>(
  * await Effect.runPromise(program) // => Option.some(45.2)
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1445,6 +1478,7 @@ export const snapshot = <K, V>(
  * await Effect.runPromise(program) // => 5
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1491,6 +1525,7 @@ export const union: {
    * await Effect.runPromise(program) // => 5
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1537,6 +1572,7 @@ export const union: {
    * await Effect.runPromise(program) // => 5
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1592,6 +1628,7 @@ export const union: {
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1639,6 +1676,7 @@ export const removeMany: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1686,14 +1724,17 @@ export const removeMany: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
   <K1 extends K, K, V>(self: TxHashMap<K, V>, keys: Iterable<K1>): Effect.Effect<void>
 } = dual(
   2,
-  <K1 extends K, K, V>(self: TxHashMap<K, V>, keys: Iterable<K1>): Effect.Effect<void> =>
-    TxRef.update(self.ref, (map) => HashMap.removeMany(map, keys))
+  <K1 extends K, K, V>(self: TxHashMap<K, V>, keys: Iterable<K1>): Effect.Effect<void> => {
+    const snapshot = Array.from(keys)
+    return TxRef.update(self.ref, (map) => HashMap.removeMany(map, snapshot))
+  }
 )
 
 /**
@@ -1755,6 +1796,7 @@ export const removeMany: {
  * await Effect.runPromise(program) // => Option.some({ price: 399, stock: 3 })
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -1818,6 +1860,7 @@ export const setMany: {
    * await Effect.runPromise(program) // => Option.some({ price: 399, stock: 3 })
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1881,6 +1924,7 @@ export const setMany: {
    * await Effect.runPromise(program) // => Option.some({ price: 399, stock: 3 })
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -1890,7 +1934,10 @@ export const setMany: {
   <K1 extends K, K, V1 extends V, V>(
     self: TxHashMap<K, V>,
     entries: Iterable<readonly [K1, V1]>
-  ): Effect.Effect<void> => TxRef.update(self.ref, (map) => HashMap.setMany(map, entries))
+  ): Effect.Effect<void> => {
+    const snapshot = Array.from(entries)
+    return TxRef.update(self.ref, (map) => HashMap.setMany(map, snapshot))
+  }
 )
 
 /**
@@ -1925,6 +1972,7 @@ export const setMany: {
  * await Effect.runPromise(program) // => Exit.succeed("Valid TxHashMap")
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -1972,6 +2020,7 @@ export const isTxHashMap = <K, V>(value: unknown): value is TxHashMap<K, V> => {
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -2016,6 +2065,7 @@ export const getHash: {
    * await Effect.runPromise(program) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2060,6 +2110,7 @@ export const getHash: {
    * await Effect.runPromise(program) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2122,6 +2173,7 @@ export const getHash: {
  * await Effect.runPromise(program) // => ["Role admin: true", "Role user: true", "Role moderator: false"]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -2175,6 +2227,7 @@ export const hasHash: {
    * await Effect.runPromise(program) // => ["Role admin: true", "Role user: true", "Role moderator: false"]
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2228,6 +2281,7 @@ export const hasHash: {
    * await Effect.runPromise(program) // => ["Role admin: true", "Role user: true", "Role moderator: false"]
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2285,6 +2339,7 @@ export const hasHash: {
  * await Effect.runPromise(program) // => Option.some({ name: "Alice", age: 30, active: true })
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -2333,6 +2388,7 @@ export const map: {
    * await Effect.runPromise(program) // => Option.some({ name: "Alice", age: 30, active: true })
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2381,6 +2437,7 @@ export const map: {
    * await Effect.runPromise(program) // => Option.some({ name: "Alice", age: 30, active: true })
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2446,6 +2503,7 @@ export const map: {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -2498,6 +2556,7 @@ export const filter: {
    * await Effect.runPromise(program)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2550,6 +2609,7 @@ export const filter: {
    * await Effect.runPromise(program)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2602,6 +2662,7 @@ export const filter: {
    * await Effect.runPromise(program)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2654,6 +2715,7 @@ export const filter: {
    * await Effect.runPromise(program)
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2714,6 +2776,7 @@ export const filter: {
  * await Effect.runPromise(program) // => { quarters: 4, total: 80000, max: 25000 }
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -2761,6 +2824,7 @@ export const reduce: {
    * await Effect.runPromise(program) // => { quarters: 4, total: 80000, max: 25000 }
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -2808,6 +2872,7 @@ export const reduce: {
    * await Effect.runPromise(program) // => { quarters: 4, total: 80000, max: 25000 }
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -2877,6 +2942,7 @@ export const reduce: {
  * await Effect.runPromise(program) // => 3
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -2937,6 +3003,7 @@ export const filterMap: {
    * await Effect.runPromise(program) // => 3
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -2997,6 +3064,7 @@ export const filterMap: {
    * await Effect.runPromise(program) // => 3
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -3052,6 +3120,7 @@ export const filterMap: {
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -3094,6 +3163,7 @@ export const hasBy: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -3136,6 +3206,7 @@ export const hasBy: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -3182,6 +3253,7 @@ export const hasBy: {
  * await Effect.runPromise(program) // => Option.some(["task1", { priority: 1, assignee: "alice", completed: false }])
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -3220,6 +3292,7 @@ export const findFirst: {
    * await Effect.runPromise(program) // => Option.some(["task1", { priority: 1, assignee: "alice", completed: false }])
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -3258,6 +3331,7 @@ export const findFirst: {
    * await Effect.runPromise(program) // => Option.some(["task1", { priority: 1, assignee: "alice", completed: false }])
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -3308,6 +3382,7 @@ export const findFirst: {
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -3349,6 +3424,7 @@ export const some: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -3390,6 +3466,7 @@ export const some: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -3439,6 +3516,7 @@ export const some: {
  * await Effect.runPromise(program) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -3480,6 +3558,7 @@ export const every: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -3521,6 +3600,7 @@ export const every: {
    * await Effect.runPromise(program) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -3563,6 +3643,7 @@ export const every: {
  * result // => ["access.log: 2048 bytes (info)", "debug.log: 512 bytes (debug)", "error.log: 1024 bytes (error)"]
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -3597,6 +3678,7 @@ export const forEach: {
    * result // => ["access.log: 2048 bytes (info)", "debug.log: 512 bytes (debug)", "error.log: 1024 bytes (error)"]
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -3631,6 +3713,7 @@ export const forEach: {
    * result // => ["access.log: 2048 bytes (info)", "debug.log: 512 bytes (debug)", "error.log: 1024 bytes (error)"]
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -3695,6 +3778,7 @@ export const forEach: {
  * await Effect.runPromise(program) // => 4
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -3746,6 +3830,7 @@ export const flatMap: {
    * await Effect.runPromise(program) // => 4
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -3797,6 +3882,7 @@ export const flatMap: {
    * await Effect.runPromise(program) // => 4
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 4.0.0
    */
@@ -3859,6 +3945,7 @@ export const flatMap: {
        * await Effect.runPromise(program) // => 4
        * ```
        *
+       * @stability stable
        * @category combinators
        * @since 4.0.0
        */
@@ -3909,6 +3996,7 @@ export const flatMap: {
        * await Effect.runPromise(program) // => 4
        * ```
        *
+       * @stability stable
        * @category combinators
        * @since 4.0.0
        */
@@ -3967,6 +4055,7 @@ export const flatMap: {
  * await Effect.runPromise(program) // => [["alice", 30], ["charlie", 25], ["eve", 28]]
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 4.0.0
  */
@@ -4007,6 +4096,7 @@ export const compact = <K, A>(
  * await Effect.runPromise(program) // => { language: "en-US", theme: "dark", timezone: "UTC" }
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 4.0.0
  */
@@ -4048,6 +4138,7 @@ export const toEntries = <K, V>(
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 4.0.0
  */