refactors HTTP server initialization, improves logging middleware, and updates documentation

pkg/srv/http/http_log.go

@@ -41,29 +41,29 @@ func loggingMiddleware(appCtx context.Context, next http.Handler) http.Handler {
 			Dur("duration", time.Since(start)).
 			Msg("http request served")
 
-		// Log response body
-		trcLog := log.Trace().
-			Str("path", r.URL.Path).
-			Int("statusCode", lrr.statusCode)
+		// Log response with body if not 204
+		if lrr.statusCode != http.StatusNoContent {
+			trcLog := log.Trace().
+				Str("path", r.URL.Path).
+				Int("statusCode", lrr.statusCode)
+			firstByte, err := lrr.body.ReadByte()
+			if err != nil {
+				trcLog.Err(errors.New("invalid response body")).Send()
+				return
+			}
+			lrr.body.UnreadByte()
 
-		// Check if it's JSON
-		firstByte, err := lrr.body.ReadByte()
-		if err != nil {
-			trcLog.Err(errors.New("invalid response body")).Send()
-			return
+			if firstByte == '{' {
+				trcLog = trcLog.RawJSON("response", lrr.body.Bytes())
+			} else {
+				trcLog = trcLog.Bytes("response", lrr.body.Bytes())
+			}
+			trcLog.Msg("http response")
 		}
-		lrr.body.UnreadByte()
-
-		if firstByte == '{' {
-			trcLog = trcLog.RawJSON("response", lrr.body.Bytes())
-		} else {
-			trcLog = trcLog.Bytes("response", lrr.body.Bytes())
-		}
-		trcLog.Msg("response payload")
 	})
 }
 
-// Implement Flush to support the http.Flusher interface
+// Flush implements the http.Flusher interface to allow flushing buffered data.
 func (w *LoggingResponseWriter) Flush() {
 	if flusher, ok := w.ResponseWriter.(http.Flusher); ok {
 		flusher.Flush()