Add tap for Option and Result

src/Option.php

@@ -202,4 +202,17 @@ readonly class Option
     {
         return self::isSome($it) ? $it->get() : null;
     }
+
+    /**
+     * Tap into the `Result` for a secondary action, returning the result
+     *
+     * @param callable(Option<T>): mixed $f The function to run (return value is ignored)
+     * @param Option<T> $it The option against which the function should be run
+     * @return Option<T> The same option provided
+     */
+    public static function tap(callable $f, Option $it): Option
+    {
+        $f($it);
+        return $it;
+    }
 }

src/Result.php

@@ -165,4 +165,17 @@ readonly class Result
     {
         return Result::isOK($it) ? Option::Some($it->getOK()) : Option::None();
     }
+
+    /**
+     * Tap into the `Result` for a secondary action, returning the result
+     *
+     * @param callable(Result<TOK, TError>): mixed $f The function to run (return value is ignored)
+     * @param Result<TOK, TError> $it The result against which the function should be run
+     * @return Result<TOK, TError> The same result provided
+     */
+    public static function tap(callable $f, Result $it): Result
+    {
+        $f($it);
+        return $it;
+    }
 }