effect 4.0.0-beta.6 → 4.0.0-beta.62

package/dist/TxDeferred.js

@@ -0,0 +1,197 @@
+/**
+ * A transactional deferred value — a write-once cell that can be read within transactions.
+ * Readers retry until a value is set; once set, the value is immutable.
+ *
+ * @since 4.0.0
+ */
+import * as Effect from "./Effect.js";
+import { dual } from "./Function.js";
+import { NodeInspectSymbol, toJson } from "./Inspectable.js";
+import * as O from "./Option.js";
+import { pipeArguments } from "./Pipeable.js";
+import { hasProperty } from "./Predicate.js";
+import * as Res from "./Result.js";
+import * as TxRef from "./TxRef.js";
+const TypeId = "~effect/transactions/TxDeferred";
+const TxDeferredProto = {
+  [NodeInspectSymbol]() {
+    return toJson(this);
+  },
+  toJSON() {
+    return {
+      _id: "TxDeferred"
+    };
+  },
+  pipe() {
+    return pipeArguments(this, arguments);
+  }
+};
+const makeTxDeferred = ref => {
+  const self = Object.create(TxDeferredProto);
+  self[TypeId] = TypeId;
+  self.ref = ref;
+  return self;
+};
+/**
+ * Creates a new empty `TxDeferred`.
+ *
+ * @example
+ * ```ts
+ * import { Effect, Option, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<string, Error>()
+ *   const state = yield* TxDeferred.poll(deferred)
+ *   console.log(Option.isNone(state)) // true
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category constructors
+ */
+export const make = () => Effect.map(TxRef.make(O.none()), makeTxDeferred);
+/**
+ * Reads the deferred value. Retries the transaction if the deferred has not
+ * been completed yet.
+ *
+ * @example
+ * ```ts
+ * import { Effect, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<number>()
+ *   yield* TxDeferred.succeed(deferred, 42)
+ *   const value = yield* TxDeferred.await(deferred)
+ *   console.log(value) // 42
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category getters
+ */
+const await_ = self => Effect.gen(function* () {
+  const option = yield* TxRef.get(self.ref);
+  if (O.isNone(option)) {
+    return yield* Effect.txRetry;
+  }
+  return Res.isSuccess(option.value) ? option.value.success : yield* Effect.fail(option.value.failure);
+}).pipe(Effect.tx);
+export {
+/**
+ * Reads the deferred value. Retries the transaction if the deferred has not
+ * been completed yet.
+ *
+ * @since 4.0.0
+ * @category getters
+ */
+await_ as await };
+/**
+ * Reads the current state of the deferred without retrying. Returns `None` if
+ * not yet completed.
+ *
+ * @example
+ * ```ts
+ * import { Effect, Option, Result, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<number>()
+ *   const before = yield* TxDeferred.poll(deferred)
+ *   console.log(Option.isNone(before)) // true
+ *
+ *   yield* TxDeferred.succeed(deferred, 42)
+ *   const after = yield* TxDeferred.poll(deferred)
+ *   console.log(after) // Some(Success(42))
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category getters
+ */
+export const poll = self => TxRef.get(self.ref);
+/**
+ * Completes the deferred with a `Result`. Returns `true` if this was the first
+ * completion, `false` if already completed.
+ *
+ * @example
+ * ```ts
+ * import { Effect, Result, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<number, string>()
+ *   const first = yield* TxDeferred.done(deferred, Result.succeed(42))
+ *   console.log(first) // true
+ *   const second = yield* TxDeferred.done(deferred, Result.succeed(99))
+ *   console.log(second) // false
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category mutations
+ */
+export const done = /*#__PURE__*/dual(2, (self, result) => TxRef.modify(self.ref, current => {
+  if (O.isSome(current)) {
+    return [false, current];
+  }
+  return [true, O.some(result)];
+}));
+/**
+ * Completes the deferred with a success value. Returns `true` if this was the
+ * first completion, `false` if already completed.
+ *
+ * @example
+ * ```ts
+ * import { Effect, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<number>()
+ *   const first = yield* TxDeferred.succeed(deferred, 42)
+ *   console.log(first) // true
+ *   const second = yield* TxDeferred.succeed(deferred, 99)
+ *   console.log(second) // false
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category mutations
+ */
+export const succeed = /*#__PURE__*/dual(2, (self, value) => done(self, Res.succeed(value)));
+/**
+ * Completes the deferred with a failure. Returns `true` if this was the first
+ * completion, `false` if already completed.
+ *
+ * @example
+ * ```ts
+ * import { Effect, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<number, string>()
+ *   const first = yield* TxDeferred.fail(deferred, "boom")
+ *   console.log(first) // true
+ *   const second = yield* TxDeferred.fail(deferred, "boom2")
+ *   console.log(second) // false
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category mutations
+ */
+export const fail = /*#__PURE__*/dual(2, (self, error) => done(self, Res.fail(error)));
+/**
+ * Determines if the provided value is a `TxDeferred`.
+ *
+ * @example
+ * ```ts
+ * import { Effect, TxDeferred } from "effect"
+ *
+ * const program = Effect.gen(function*() {
+ *   const deferred = yield* TxDeferred.make<number>()
+ *   console.log(TxDeferred.isTxDeferred(deferred)) // true
+ *   console.log(TxDeferred.isTxDeferred("not a deferred")) // false
+ * })
+ * ```
+ *
+ * @since 4.0.0
+ * @category guards
+ */
+export const isTxDeferred = u => hasProperty(u, TypeId);
+//# sourceMappingURL=TxDeferred.js.map

package/dist/TxDeferred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TxDeferred.js","names":["Effect","dual","NodeInspectSymbol","toJson","O","pipeArguments","hasProperty","Res","TxRef","TypeId","TxDeferredProto","toJSON","_id","pipe","arguments","makeTxDeferred","ref","self","Object","create","make","map","none","await_","gen","option","get","isNone","txRetry","isSuccess","value","success","fail","failure","tx","await","poll","done","result","modify","current","isSome","some","succeed","error","isTxDeferred","u"],"sources":["../src/TxDeferred.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/TxHashMap.d.ts

@@ -6,6 +6,7 @@ import * as HashMap from "./HashMap.ts";
 import type { Inspectable } from "./Inspectable.ts";
 import * as Option from "./Option.ts";
 import type { Pipeable } from "./Pipeable.ts";
+import type { Result } from "./Result.ts";
 import * as TxRef from "./TxRef.ts";
 declare const TypeId = "~effect/transactions/TxHashMap";
 /**
@@ -15,7 +16,7 @@ declare const TypeId = "~effect/transactions/TxHashMap";
  *
  * @example
  * ```ts
- * import { Effect, Option, TxHashMap } from "effect"
+ * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a transactional hash map
@@ -27,10 +28,10 @@ declare const TypeId = "~effect/transactions/TxHashMap";
  *   console.log(user) // Option.some("Alice")
  *
  *   // Multi-step atomic operations
- *   yield* Effect.atomic(
+ *   yield* Effect.tx(
  *     Effect.gen(function*() {
  *       const currentUser = yield* TxHashMap.get(txMap, "user1")
- *       if (Option.isSome(currentUser)) {
+ *       if (currentUser._tag === "Some") {
  *         yield* TxHashMap.set(txMap, "user1", currentUser.value + "_updated")
  *         yield* TxHashMap.remove(txMap, "user2")
  *       }
@@ -296,7 +297,7 @@ export declare const fromIterable: <K, V>(entries: Iterable<readonly [K, V]>) =>
  *
  *   // Use with pipe syntax for type-safe access
  *   const bobRole = yield* TxHashMap.get(userMap, "bob")
- *   if (Option.isSome(bobRole)) {
+ *   if (bobRole._tag === "Some") {
  *     console.log(bobRole.value.role) // "user"
  *   }
  * })
@@ -328,7 +329,7 @@ export declare const get: {
      *
      *   // Use with pipe syntax for type-safe access
      *   const bobRole = yield* TxHashMap.get(userMap, "bob")
-     *   if (Option.isSome(bobRole)) {
+     *   if (bobRole._tag === "Some") {
      *     console.log(bobRole.value.role) // "user"
      *   }
      * })
@@ -360,7 +361,7 @@ export declare const get: {
      *
      *   // Use with pipe syntax for type-safe access
      *   const bobRole = yield* TxHashMap.get(userMap, "bob")
-     *   if (Option.isSome(bobRole)) {
+     *   if (bobRole._tag === "Some") {
      *     console.log(bobRole.value.role) // "user"
      *   }
      * })
@@ -951,7 +952,7 @@ export declare const modify: {
  *
  * @example
  * ```ts
- * import { Effect, Option, TxHashMap } from "effect"
+ * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const storage = yield* TxHashMap.make<string, string | number>([
@@ -959,26 +960,32 @@ export declare const modify: {
  *     "content1"
  *   ], ["access_count", 0])
  *
- *   // Increment counter or initialize to 1
- *   const updateFn = (opt: Option.Option<string | number>) =>
- *     Option.isSome(opt) && typeof opt.value === "number"
- *       ? Option.some(opt.value + 1)
- *       : Option.some(1)
- *
  *   // Increment existing counter
- *   yield* TxHashMap.modifyAt(storage, "access_count", updateFn)
+ *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
+ *     current._tag === "Some" && typeof current.value === "number"
+ *       ? { ...current, value: current.value + 1 }
+ *       : current
+ *   )
  *   const count1 = yield* TxHashMap.get(storage, "access_count")
  *   console.log(count1) // Option.some(1)
  *
  *   // Increment existing counter again
- *   yield* TxHashMap.modifyAt(storage, "access_count", updateFn)
+ *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
+ *     current._tag === "Some" && typeof current.value === "number"
+ *       ? { ...current, value: current.value + 1 }
+ *       : current
+ *   )
  *   const count2 = yield* TxHashMap.get(storage, "access_count")
  *   console.log(count2) // Option.some(2)
  *
- *   // Remove by returning None
- *   yield* TxHashMap.modifyAt(storage, "file1.txt", () => Option.none())
- *   const hasFile = yield* TxHashMap.has(storage, "file1.txt")
- *   console.log(hasFile) // false
+ *   // Update an existing string entry
+ *   yield* TxHashMap.modifyAt(storage, "file1.txt", (current) =>
+ *     current._tag === "Some" && typeof current.value === "string"
+ *       ? { ...current, value: `${current.value}.bak` }
+ *       : current
+ *   )
+ *   const backup = yield* TxHashMap.get(storage, "file1.txt")
+ *   console.log(backup) // Option.some("content1.bak")
  * })
  * ```
  *
@@ -995,7 +1002,7 @@ export declare const modifyAt: {
      *
      * @example
      * ```ts
-     * import { Effect, Option, TxHashMap } from "effect"
+     * import { Effect, TxHashMap } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   const storage = yield* TxHashMap.make<string, string | number>([
@@ -1003,26 +1010,32 @@ export declare const modifyAt: {
      *     "content1"
      *   ], ["access_count", 0])
      *
-     *   // Increment counter or initialize to 1
-     *   const updateFn = (opt: Option.Option<string | number>) =>
-     *     Option.isSome(opt) && typeof opt.value === "number"
-     *       ? Option.some(opt.value + 1)
-     *       : Option.some(1)
-     *
      *   // Increment existing counter
-     *   yield* TxHashMap.modifyAt(storage, "access_count", updateFn)
+     *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
+     *     current._tag === "Some" && typeof current.value === "number"
+     *       ? { ...current, value: current.value + 1 }
+     *       : current
+     *   )
      *   const count1 = yield* TxHashMap.get(storage, "access_count")
      *   console.log(count1) // Option.some(1)
      *
      *   // Increment existing counter again
-     *   yield* TxHashMap.modifyAt(storage, "access_count", updateFn)
+     *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
+     *     current._tag === "Some" && typeof current.value === "number"
+     *       ? { ...current, value: current.value + 1 }
+     *       : current
+     *   )
      *   const count2 = yield* TxHashMap.get(storage, "access_count")
      *   console.log(count2) // Option.some(2)
      *
-     *   // Remove by returning None
-     *   yield* TxHashMap.modifyAt(storage, "file1.txt", () => Option.none())
-     *   const hasFile = yield* TxHashMap.has(storage, "file1.txt")
-     *   console.log(hasFile) // false
+     *   // Update an existing string entry
+     *   yield* TxHashMap.modifyAt(storage, "file1.txt", (current) =>
+     *     current._tag === "Some" && typeof current.value === "string"
+     *       ? { ...current, value: `${current.value}.bak` }
+     *       : current
+     *   )
+     *   const backup = yield* TxHashMap.get(storage, "file1.txt")
+     *   console.log(backup) // Option.some("content1.bak")
      * })
      * ```
      *
@@ -1039,7 +1052,7 @@ export declare const modifyAt: {
      *
      * @example
      * ```ts
-     * import { Effect, Option, TxHashMap } from "effect"
+     * import { Effect, TxHashMap } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   const storage = yield* TxHashMap.make<string, string | number>([
@@ -1047,26 +1060,32 @@ export declare const modifyAt: {
      *     "content1"
      *   ], ["access_count", 0])
      *
-     *   // Increment counter or initialize to 1
-     *   const updateFn = (opt: Option.Option<string | number>) =>
-     *     Option.isSome(opt) && typeof opt.value === "number"
-     *       ? Option.some(opt.value + 1)
-     *       : Option.some(1)
-     *
      *   // Increment existing counter
-     *   yield* TxHashMap.modifyAt(storage, "access_count", updateFn)
+     *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
+     *     current._tag === "Some" && typeof current.value === "number"
+     *       ? { ...current, value: current.value + 1 }
+     *       : current
+     *   )
      *   const count1 = yield* TxHashMap.get(storage, "access_count")
      *   console.log(count1) // Option.some(1)
      *
      *   // Increment existing counter again
-     *   yield* TxHashMap.modifyAt(storage, "access_count", updateFn)
+     *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
+     *     current._tag === "Some" && typeof current.value === "number"
+     *       ? { ...current, value: current.value + 1 }
+     *       : current
+     *   )
      *   const count2 = yield* TxHashMap.get(storage, "access_count")
      *   console.log(count2) // Option.some(2)
      *
-     *   // Remove by returning None
-     *   yield* TxHashMap.modifyAt(storage, "file1.txt", () => Option.none())
-     *   const hasFile = yield* TxHashMap.has(storage, "file1.txt")
-     *   console.log(hasFile) // false
+     *   // Update an existing string entry
+     *   yield* TxHashMap.modifyAt(storage, "file1.txt", (current) =>
+     *     current._tag === "Some" && typeof current.value === "string"
+     *       ? { ...current, value: `${current.value}.bak` }
+     *       : current
+     *   )
+     *   const backup = yield* TxHashMap.get(storage, "file1.txt")
+     *   console.log(backup) // Option.some("content1.bak")
      * })
      * ```
      *
@@ -1095,7 +1114,7 @@ export declare const modifyAt: {
  *   // Useful for iteration
  *   for (const username of usernames) {
  *     const role = yield* TxHashMap.get(userRoles, username)
- *     if (Option.isSome(role)) {
+ *     if (role._tag === "Some") {
  *       console.log(`${username}: ${role.value}`)
  *     }
  *   }
@@ -2488,15 +2507,15 @@ export declare const reduce: {
     <K, V, A>(self: TxHashMap<K, V>, zero: A, f: (accumulator: A, value: V, key: K) => A): Effect.Effect<A>;
 };
 /**
- * Combines filtering and mapping in a single operation. Applies a function that returns
- * an Option to each entry, keeping only the Some values and transforming them.
+ * Combines filtering and mapping in a single operation. Applies a filter to each
+ * entry, keeping only successful results and transforming them.
  *
  * **Return behavior**: This function returns a new TxHashMap reference containing
- * only the transformed entries that returned Some values. The original TxHashMap is not modified.
+ * only the transformed entries that succeeded. The original TxHashMap is not modified.
  *
  * @example
  * ```ts
- * import { Effect, Option, TxHashMap } from "effect"
+ * import { Effect, Option, Result, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a mixed data map
@@ -2511,10 +2530,10 @@ export declare const reduce: {
  *   const activeAdminAges = yield* TxHashMap.filterMap(
  *     userData,
  *     (user, username) => {
- *       if (!user.active || user.role !== "admin") return Option.none()
+ *       if (!user.active || user.role !== "admin") return Result.failVoid
  *       const age = parseInt(user.age)
- *       if (isNaN(age)) return Option.none()
- *       return Option.some({
+ *       if (isNaN(age)) return Result.failVoid
+ *       return Result.succeed({
  *         username,
  *         age,
  *         seniority: age > 27 ? "senior" : "junior"
@@ -2532,7 +2551,7 @@ export declare const reduce: {
  *   const validAges = yield* userData.pipe(
  *     TxHashMap.filterMap((user) => {
  *       const age = parseInt(user.age)
- *       return isNaN(age) ? Option.none() : Option.some(age)
+ *       return isNaN(age) ? Result.failVoid : Result.succeed(age)
  *     })
  *   )
  *
@@ -2546,15 +2565,15 @@ export declare const reduce: {
  */
 export declare const filterMap: {
     /**
-     * Combines filtering and mapping in a single operation. Applies a function that returns
-     * an Option to each entry, keeping only the Some values and transforming them.
+     * Combines filtering and mapping in a single operation. Applies a filter to each
+     * entry, keeping only successful results and transforming them.
      *
      * **Return behavior**: This function returns a new TxHashMap reference containing
-     * only the transformed entries that returned Some values. The original TxHashMap is not modified.
+     * only the transformed entries that succeeded. The original TxHashMap is not modified.
      *
      * @example
      * ```ts
-     * import { Effect, Option, TxHashMap } from "effect"
+     * import { Effect, Option, Result, TxHashMap } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   // Create a mixed data map
@@ -2569,10 +2588,10 @@ export declare const filterMap: {
      *   const activeAdminAges = yield* TxHashMap.filterMap(
      *     userData,
      *     (user, username) => {
-     *       if (!user.active || user.role !== "admin") return Option.none()
+     *       if (!user.active || user.role !== "admin") return Result.failVoid
      *       const age = parseInt(user.age)
-     *       if (isNaN(age)) return Option.none()
-     *       return Option.some({
+     *       if (isNaN(age)) return Result.failVoid
+     *       return Result.succeed({
      *         username,
      *         age,
      *         seniority: age > 27 ? "senior" : "junior"
@@ -2590,7 +2609,7 @@ export declare const filterMap: {
      *   const validAges = yield* userData.pipe(
      *     TxHashMap.filterMap((user) => {
      *       const age = parseInt(user.age)
-     *       return isNaN(age) ? Option.none() : Option.some(age)
+     *       return isNaN(age) ? Result.failVoid : Result.succeed(age)
      *     })
      *   )
      *
@@ -2602,17 +2621,17 @@ export declare const filterMap: {
      * @since 2.0.0
      * @category combinators
      */
-    <A, V, K>(f: (value: V, key: K) => Option.Option<A>): (self: TxHashMap<K, V>) => Effect.Effect<TxHashMap<K, A>>;
+    <V, K, A, X>(f: (input: V, key: K) => Result<A, X>): (self: TxHashMap<K, V>) => Effect.Effect<TxHashMap<K, A>>;
     /**
-     * Combines filtering and mapping in a single operation. Applies a function that returns
-     * an Option to each entry, keeping only the Some values and transforming them.
+     * Combines filtering and mapping in a single operation. Applies a filter to each
+     * entry, keeping only successful results and transforming them.
      *
      * **Return behavior**: This function returns a new TxHashMap reference containing
-     * only the transformed entries that returned Some values. The original TxHashMap is not modified.
+     * only the transformed entries that succeeded. The original TxHashMap is not modified.
      *
      * @example
      * ```ts
-     * import { Effect, Option, TxHashMap } from "effect"
+     * import { Effect, Option, Result, TxHashMap } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   // Create a mixed data map
@@ -2627,10 +2646,10 @@ export declare const filterMap: {
      *   const activeAdminAges = yield* TxHashMap.filterMap(
      *     userData,
      *     (user, username) => {
-     *       if (!user.active || user.role !== "admin") return Option.none()
+     *       if (!user.active || user.role !== "admin") return Result.failVoid
      *       const age = parseInt(user.age)
-     *       if (isNaN(age)) return Option.none()
-     *       return Option.some({
+     *       if (isNaN(age)) return Result.failVoid
+     *       return Result.succeed({
      *         username,
      *         age,
      *         seniority: age > 27 ? "senior" : "junior"
@@ -2648,7 +2667,7 @@ export declare const filterMap: {
      *   const validAges = yield* userData.pipe(
      *     TxHashMap.filterMap((user) => {
      *       const age = parseInt(user.age)
-     *       return isNaN(age) ? Option.none() : Option.some(age)
+     *       return isNaN(age) ? Result.failVoid : Result.succeed(age)
      *     })
      *   )
      *
@@ -2660,7 +2679,7 @@ export declare const filterMap: {
      * @since 2.0.0
      * @category combinators
      */
-    <K, V, A>(self: TxHashMap<K, V>, f: (value: V, key: K) => Option.Option<A>): Effect.Effect<TxHashMap<K, A>>;
+    <K, V, A, X>(self: TxHashMap<K, V>, f: (input: V, key: K) => Result<A, X>): Effect.Effect<TxHashMap<K, A>>;
 };
 /**
  * Checks if any entry in the TxHashMap matches the given predicate.
@@ -2808,8 +2827,8 @@ export declare const hasBy: {
  *     (task) => task.priority >= 2 && !task.completed
  *   )
  *
- *   if (highPriorityTask) {
- *     const [taskId, task] = highPriorityTask
+ *   if (highPriorityTask._tag === "Some") {
+ *     const [taskId, task] = highPriorityTask.value
  *     console.log(`Found task: ${taskId}, priority: ${task.priority}`)
  *     // "Found task: task3, priority: 2"
  *   }
@@ -2819,8 +2838,8 @@ export declare const hasBy: {
  *     TxHashMap.findFirst((task) => task.assignee === "alice")
  *   )
  *
- *   if (aliceTask) {
- *     console.log(`Alice's task: ${aliceTask[0]}`)
+ *   if (aliceTask._tag === "Some") {
+ *     console.log(`Alice's task: ${aliceTask.value[0]}`)
  *   }
  * })
  * ```
@@ -2851,8 +2870,8 @@ export declare const findFirst: {
      *     (task) => task.priority >= 2 && !task.completed
      *   )
      *
-     *   if (highPriorityTask) {
-     *     const [taskId, task] = highPriorityTask
+     *   if (highPriorityTask._tag === "Some") {
+     *     const [taskId, task] = highPriorityTask.value
      *     console.log(`Found task: ${taskId}, priority: ${task.priority}`)
      *     // "Found task: task3, priority: 2"
      *   }
@@ -2862,8 +2881,8 @@ export declare const findFirst: {
      *     TxHashMap.findFirst((task) => task.assignee === "alice")
      *   )
      *
-     *   if (aliceTask) {
-     *     console.log(`Alice's task: ${aliceTask[0]}`)
+     *   if (aliceTask._tag === "Some") {
+     *     console.log(`Alice's task: ${aliceTask.value[0]}`)
      *   }
      * })
      * ```
@@ -2871,7 +2890,7 @@ export declare const findFirst: {
      * @since 2.0.0
      * @category combinators
      */
-    <K, V>(predicate: (value: V, key: K) => boolean): (self: TxHashMap<K, V>) => Effect.Effect<[K, V] | undefined>;
+    <K, V>(predicate: (value: V, key: K) => boolean): (self: TxHashMap<K, V>) => Effect.Effect<Option.Option<[K, V]>>;
     /**
      * Finds the first entry in the TxHashMap that matches the given predicate.
      * Returns the key-value pair as a tuple wrapped in an Option.
@@ -2894,8 +2913,8 @@ export declare const findFirst: {
      *     (task) => task.priority >= 2 && !task.completed
      *   )
      *
-     *   if (highPriorityTask) {
-     *     const [taskId, task] = highPriorityTask
+     *   if (highPriorityTask._tag === "Some") {
+     *     const [taskId, task] = highPriorityTask.value
      *     console.log(`Found task: ${taskId}, priority: ${task.priority}`)
      *     // "Found task: task3, priority: 2"
      *   }
@@ -2905,8 +2924,8 @@ export declare const findFirst: {
      *     TxHashMap.findFirst((task) => task.assignee === "alice")
      *   )
      *
-     *   if (aliceTask) {
-     *     console.log(`Alice's task: ${aliceTask[0]}`)
+     *   if (aliceTask._tag === "Some") {
+     *     console.log(`Alice's task: ${aliceTask.value[0]}`)
      *   }
      * })
      * ```
@@ -2914,7 +2933,7 @@ export declare const findFirst: {
      * @since 2.0.0
      * @category combinators
      */
-    <K, V>(self: TxHashMap<K, V>, predicate: (value: V, key: K) => boolean): Effect.Effect<[K, V] | undefined>;
+    <K, V>(self: TxHashMap<K, V>, predicate: (value: V, key: K) => boolean): Effect.Effect<Option.Option<[K, V]>>;
 };
 /**
  * Checks if at least one entry in the TxHashMap satisfies the given predicate.