<Values extends ReadonlyArray<any>>(...values: Values): Effect.Effect<
TxHashSet<Values[number]>
>Creates a TxHashSet from a variable number of values.
Example (Creating transactional hash sets from values)
import { Effect, TxHashSet } from "effect"
const program = Effect.gen(function*() {
const fruits = yield* TxHashSet.make("apple", "banana", "cherry")
console.log(yield* TxHashSet.size(fruits)) // 3
const numbers = yield* TxHashSet.make(1, 2, 3, 2, 1) // Duplicates ignored
console.log(yield* TxHashSet.size(numbers)) // 3
const mixed = yield* TxHashSet.make("hello", 42, true)
console.log(yield* TxHashSet.size(mixed)) // 3
})constructors
Source effect/TxHashSet.ts:2058 lines
export const const make: <
Values extends ReadonlyArray<any>
>(
...values: Values
) => Effect.Effect<TxHashSet<Values[number]>>
Creates a TxHashSet from a variable number of values.
Example (Creating transactional hash sets from values)
import { Effect, TxHashSet } from "effect"
const program = Effect.gen(function*() {
const fruits = yield* TxHashSet.make("apple", "banana", "cherry")
console.log(yield* TxHashSet.size(fruits)) // 3
const numbers = yield* TxHashSet.make(1, 2, 3, 2, 1) // Duplicates ignored
console.log(yield* TxHashSet.size(numbers)) // 3
const mixed = yield* TxHashSet.make("hello", 42, true)
console.log(yield* TxHashSet.size(mixed)) // 3
})
make = <function (type parameter) Values in <Values extends ReadonlyArray<any>>(...values: Values): Effect.Effect<TxHashSet<Values[number]>>Values extends interface ReadonlyArray<T>ReadonlyArray<any>>(
...values: Values extends ReadonlyArray<any>values: function (type parameter) Values in <Values extends ReadonlyArray<any>>(...values: Values): Effect.Effect<TxHashSet<Values[number]>>Values
): import EffectEffect.type Effect.Effect = /*unresolved*/ anyEffect<interface TxHashSet<in out V>A TxHashSet is a transactional hash set data structure that provides atomic operations on unique values within Effect transactions. It uses an immutable HashSet internally with TxRef for transactional semantics, ensuring all operations are performed atomically.
Details
Mutation operations such as add, remove, and clear update the original TxHashSet and return Effect<void> or Effect<boolean>. Transform operations such as union, intersection, difference, map, and filter create new TxHashSet instances and leave the original TxHashSet unchanged.
Example (Using transactional hash sets)
import { Effect, TxHashSet } from "effect"
const program = Effect.gen(function*() {
// Create a transactional hash set
const txSet = yield* TxHashSet.make("apple", "banana", "cherry")
// Single operations are automatically transactional
yield* TxHashSet.add(txSet, "grape")
const hasApple = yield* TxHashSet.has(txSet, "apple")
console.log(hasApple) // true
// Multi-step atomic operations
yield* Effect.tx(
Effect.gen(function*() {
const hasCherry = yield* TxHashSet.has(txSet, "cherry")
if (hasCherry) {
yield* TxHashSet.remove(txSet, "cherry")
yield* TxHashSet.add(txSet, "orange")
}
})
)
const size = yield* TxHashSet.size(txSet)
console.log(size) // 4
})
The TxHashSet namespace contains type-level utilities and helper types
for working with TxHashSet instances.
Example (Extracting value types inside transactions)
import { Effect, TxHashSet } from "effect"
const program = Effect.gen(function*() {
// Create a transactional color set
const colors = yield* TxHashSet.make("red", "green", "blue")
// Extract the value type for reuse
type Color = TxHashSet.TxHashSet.Value<typeof colors> // string
// Use extracted type in functions
const addColor = (color: Color) => TxHashSet.add(colors, color)
yield* addColor("yellow")
})
TxHashSet<function (type parameter) Values in <Values extends ReadonlyArray<any>>(...values: Values): Effect.Effect<TxHashSet<Values[number]>>Values[number]>> =>
import EffectEffect.gen(function*() {
const const hashSet: HashSet.HashSet<
[...Values][number]
>
const hashSet: {
pipe: { <A>(this: A): A; <A, B = never>(this: A, ab: (_: A) => B): B; <A, B = never, C = never>(this: A, ab: (_: A) => B, bc: (_: B) => C): C; <A, B = never, C = never, D = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D): D; <…;
toString: () => string;
toJSON: () => unknown;
}
import HashSetHashSet.make(...values: Values extends ReadonlyArray<any>values)
const const ref: TxRef.TxRef<
HashSet.HashSet<[...Values][number]>
>
const ref: {
version: number;
pending: Map<unknown, () => void>;
value: A;
pipe: { <A>(this: A): A; <A, B = never>(this: A, ab: (_: A) => B): B; <A, B = never, C = never>(this: A, ab: (_: A) => B, bc: (_: B) => C): C; <A, B = never, C = never, D = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D): D; <…;
}
import TxRefTxRef.const make: <any>(initial: any) => anyCreates a new TxRef with the specified initial value.
When to use
Use to create a TxRef inside an Effect workflow.
Example (Creating transactional references)
import { Effect, TxRef } from "effect"
const program = Effect.gen(function*() {
// Create a transactional reference with initial value
const counter = yield* TxRef.make(0)
const name = yield* TxRef.make("Alice")
// Use in transactions
yield* Effect.tx(Effect.gen(function*() {
yield* TxRef.set(counter, 42)
yield* TxRef.set(name, "Bob")
}))
console.log(yield* TxRef.get(counter)) // 42
console.log(yield* TxRef.get(name)) // "Bob"
})
make(const hashSet: HashSet.HashSet<
[...Values][number]
>
const hashSet: {
pipe: { <A>(this: A): A; <A, B = never>(this: A, ab: (_: A) => B): B; <A, B = never, C = never>(this: A, ab: (_: A) => B, bc: (_: B) => C): C; <A, B = never, C = never, D = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D): D; <…;
toString: () => string;
toJSON: () => unknown;
}
const makeTxHashSet: <V>(
ref: TxRef.TxRef<HashSet.HashSet<V>>
) => TxHashSet<V>
const ref: TxRef.TxRef<
HashSet.HashSet<[...Values][number]>
>
const ref: {
version: number;
pending: Map<unknown, () => void>;
value: A;
pipe: { <A>(this: A): A; <A, B = never>(this: A, ab: (_: A) => B): B; <A, B = never, C = never>(this: A, ab: (_: A) => B, bc: (_: B) => C): C; <A, B = never, C = never, D = never>(this: A, ab: (_: A) => B, bc: (_: B) => C, cd: (_: C) => D): D; <…;
}