From 0a7538965ed374b7e4ac9fc2c50156653863c8d4 Mon Sep 17 00:00:00 2001
From: Marissa <dev@princess.lgbt>
Date: Tue, 2 Jan 2024 15:31:10 -0500
Subject: [PATCH] Expose method to build generic middleware

Expose `ServerMiddleware#buildGenericTracedHttp` for users that
need it.
---
 .../otel4s/middleware/ServerMiddleware.scala       | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/core/src/main/scala/org/http4s/otel4s/middleware/ServerMiddleware.scala b/core/src/main/scala/org/http4s/otel4s/middleware/ServerMiddleware.scala
index 651be31..53df042 100644
--- a/core/src/main/scala/org/http4s/otel4s/middleware/ServerMiddleware.scala
+++ b/core/src/main/scala/org/http4s/otel4s/middleware/ServerMiddleware.scala
@@ -119,7 +119,15 @@ object ServerMiddleware {
     def withDoNotTrace(doNotTrace: RequestPrelude => Boolean): ServerMiddlewareBuilder[F] =
       copy(doNotTrace = doNotTrace)
 
-    private def buildTracedF[G[_]: MonadCancelThrow](
+    /** This method is used for building a middleware in a way that abstracts
+      * over [[org.http4s.HttpApp `HttpApp`]] and
+      * [[org.http4s.HttpRoutes `HttpRoutes`]]. In most cases, it is preferable
+      * to use the methods that directly build the specific desired type.
+      *
+      * @see [[buildHttpApp]]
+      * @see [[buildHttpRoutes]]
+      */
+    def buildGenericTracedHttp[G[_]: MonadCancelThrow](
         f: Http[G, F]
     )(implicit kt: KindTransformer[F, G]): Http[G, F] =
       Kleisli { (req: Request[F]) =>
@@ -170,10 +178,10 @@ object ServerMiddleware {
       }
 
     def buildHttpApp(f: HttpApp[F]): HttpApp[F] =
-      buildTracedF(f)
+      buildGenericTracedHttp(f)
 
     def buildHttpRoutes(f: HttpRoutes[F]): HttpRoutes[F] =
-      buildTracedF(f)
+      buildGenericTracedHttp(f)
   }
 
   private[middleware] def request[F[_]](