Implement handleErrorCauseZIO for executing ZIO effects on error

[SHSongs]

• Error Handling in Routes: Implemented the handleErrorCauseZIO function that is triggered upon encountering an error, ensuring that side effects are performed.

• Testing: Added tests to check that handleErrorCauseZIO correctly executes ZIO effects using TestConsole, when handling errors.

cc: @guersam

[codecov-commenter]

Codecov Report

Attention: 5 lines in your changes are missing coverage. Please review.

Comparison is base (735d9b7) 64.95% compared to head (e5efa2b) 65.06%.
Report is 6 commits behind head on main.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2513      +/-   ##
==========================================
+ Coverage   64.95%   65.06%   +0.11%     
==========================================
  Files         137      137              
  Lines        7208     7243      +35     
  Branches     1288     1248      -40     
==========================================
+ Hits         4682     4713      +31     
- Misses       2526     2530       +4     

Files	Coverage Δ
zio-http/src/main/scala/zio/http/Handler.scala	63.28% <100.00%> (+0.17%)	⬆️
zio-http/src/main/scala/zio/http/Routes.scala	72.22% <0.00%> (-4.25%)	⬇️
zio-http/src/main/scala/zio/http/Route.scala	74.19% <66.66%> (-1.81%)	⬇️

... and 4 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[jdegoes]

These code paths do not differ, they both create the handler from f(err). You shouldn't need the cast or the branch.

[SHSongs]

  /**
   * Transforms all failures except pure interruption.
   */
  final def mapErrorCause[Err2](f: Cause[Err] => Err2)(implicit trace: Trace): Handler[R, Err2, In, Out] =
    self.foldCauseHandler(
      err => if (err.isInterruptedOnly) Handler.failCause(err.asInstanceOf[Cause[Nothing]]) else Handler.fail(f(err)),
      Handler.succeed(_),
    )

I have referred to mapErrorCause. mapErrorCause casts Cause[Nothing] if isInterruptedOnly is true. Do you have more information about its origin?
Additionally, do you recommend any modifications to the mapErrorCause?

[guersam]

@SHSongs f should not be applied when it's interrupt only. Please double check the usage of f in the original code.

[SHSongs]

I reviewed the usage of f. The f used transforms all failures, except for pure interruption. I also made changes to the code, following the original.