SMOODEV-2023: Go Fiber + Gin observability middleware

.github/workflows/pr-checks.yml

@@ -146,11 +146,21 @@ jobs:
                       exit 1
                   fi
 
+            # The Fiber/Gin adapters are separate Go modules (own go.mod) so the
+            # core stays dependency-free; vet/test must run per-module.
             - name: Vet
-              run: go vet ./...
+              run: |
+                  for m in . fiber gin; do
+                      [ -f "$m/go.mod" ] || continue
+                      echo "::group::go vet ($m)"; (cd "$m" && go vet ./...); echo "::endgroup::"
+                  done
 
             - name: Test
-              run: go test ./...
+              run: |
+                  for m in . fiber gin; do
+                      [ -f "$m/go.mod" ] || continue
+                      echo "::group::go test ($m)"; (cd "$m" && go test ./...); echo "::endgroup::"
+                  done
 
     # Python lane — ruff lint + format, pytest. Package in python/.
     python:

go/README.md

@@ -106,6 +106,39 @@ Establishes a request-scoped scope, records request context, and captures
 downstream panics (then re-panics so the host's recovery still runs; set
 `SwallowPanics: true` to write a 500 instead).
 
+## Fiber / Gin middleware
+
+Fiber and Gin adapters ship as their own Go modules under `go/fiber` and
+`go/gin` so the core SDK takes no dependency on either framework unless you
+import the adapter:
+
+```go
+// Fiber — github.com/SmooAI/observability/go/fiber
+import fiberobs "github.com/SmooAI/observability/go/fiber"
+
+app.Use(fiberobs.New(obs.Default, func(c *fiber.Ctx) *obs.User {
+    return &obs.User{ID: c.Get("X-User-Id")}
+}))
+```
+
+```go
+// Gin — github.com/SmooAI/observability/go/gin
+import ginobs "github.com/SmooAI/observability/go/gin"
+
+r.Use(ginobs.New(obs.Default, func(c *gin.Context) *obs.User {
+    return &obs.User{ID: c.GetHeader("X-User-Id")}
+}))
+```
+
+Both mirror the `net/http` middleware exactly: per-request scope on the request
+context, user/`request` context hydration (PII-scrubbed via the allowlist),
+and capture-then-rethrow on panic (`SwallowPanics: true` writes a 500 instead).
+They additionally capture handler-reported errors — the returned `error` for
+Fiber, `c.Errors` for Gin — tagged `source: fiber.middleware` / `gin.middleware`.
+Neither framework installs panic recovery by default in the way the host app
+expects, so pair the middleware with the framework's own recovery
+(`recover.New()` for Fiber, `gin.Recovery()` for Gin) when you rely on re-panic.
+
 ## Wire format
 
 `ObservabilityEvent` JSON is byte-compatible with the TS `ObservabilityEvent`
@@ -115,8 +148,9 @@ so one backend ingest endpoint (`type: "error"`) serves both SDKs. The SDK name
 
 ## Gaps / deferred
 
-- **Fiber / Gin / Echo adapters** — only `net/http` ships. They can be thin
-  adapters over the same `Scope` + `CaptureException` primitives.
+- **Echo adapter** — `net/http`, Fiber, and Gin ship (see above). Echo can be
+  added the same way: a thin adapter over the same `Scope` + `CaptureException`
+  primitives, as its own `go/echo` module.
 - **Span-implicit capture** — Go has no ambient span, so span-correlated
   capture uses `CaptureExceptionOnSpan(ctx, ...)` (reads the span off `ctx`).
   The plain `CaptureException` still records via transport + a synthetic span.

go/fiber/go.mod

@@ -0,0 +1,45 @@
+module github.com/SmooAI/observability/go/fiber
+
+go 1.25.0
+
+require (
+	github.com/SmooAI/observability/go v0.0.0
+	github.com/gofiber/fiber/v2 v2.52.5
+)
+
+require (
+	github.com/andybalholm/brotli v1.0.5 // indirect
+	github.com/cenkalti/backoff/v5 v5.0.3 // indirect
+	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/go-logr/logr v1.4.3 // indirect
+	github.com/go-logr/stdr v1.2.2 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/grpc-ecosystem/grpc-gateway/v2 v2.29.0 // indirect
+	github.com/klauspost/compress v1.17.0 // indirect
+	github.com/mattn/go-colorable v0.1.13 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-runewidth v0.0.15 // indirect
+	github.com/rivo/uniseg v0.2.0 // indirect
+	github.com/valyala/bytebufferpool v1.0.0 // indirect
+	github.com/valyala/fasthttp v1.51.0 // indirect
+	github.com/valyala/tcplisten v1.0.0 // indirect
+	go.opentelemetry.io/auto/sdk v1.2.1 // indirect
+	go.opentelemetry.io/otel v1.44.0 // indirect
+	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp v1.44.0 // indirect
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.44.0 // indirect
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.44.0 // indirect
+	go.opentelemetry.io/otel/metric v1.44.0 // indirect
+	go.opentelemetry.io/otel/sdk v1.44.0 // indirect
+	go.opentelemetry.io/otel/sdk/metric v1.44.0 // indirect
+	go.opentelemetry.io/otel/trace v1.44.0 // indirect
+	go.opentelemetry.io/proto/otlp v1.10.0 // indirect
+	golang.org/x/net v0.55.0 // indirect
+	golang.org/x/sys v0.45.0 // indirect
+	golang.org/x/text v0.37.0 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20260526163538-3dc84a4a5aaa // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20260526163538-3dc84a4a5aaa // indirect
+	google.golang.org/grpc v1.81.1 // indirect
+	google.golang.org/protobuf v1.36.11 // indirect
+)
+
+replace github.com/SmooAI/observability/go => ../

go/fiber/go.sum

@@ -0,0 +1,88 @@
+github.com/andybalholm/brotli v1.0.5 h1:8uQZIdzKmjc/iuPu7O2ioW48L81FgatrcpfFmiq/cCs=
+github.com/andybalholm/brotli v1.0.5/go.mod h1:fO7iG3H7G2nSZ7m0zPUDn85XEX2GTukHGRSepvi9Eig=
+github.com/cenkalti/backoff/v5 v5.0.3 h1:ZN+IMa753KfX5hd8vVaMixjnqRZ3y8CuJKRKj1xcsSM=
+github.com/cenkalti/backoff/v5 v5.0.3/go.mod h1:rkhZdG3JZukswDf7f0cwqPNk4K0sa+F97BxZthm/crw=
+github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
+github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
+github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI=
+github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
+github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
+github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
+github.com/gofiber/fiber/v2 v2.52.5 h1:tWoP1MJQjGEe4GB5TUGOi7P2E0ZMMRx5ZTG4rT+yGMo=
+github.com/gofiber/fiber/v2 v2.52.5/go.mod h1:KEOE+cXMhXG0zHc9d8+E38hoX+ZN7bhOtgeF2oT6jrQ=
+github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
+github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/grpc-ecosystem/grpc-gateway/v2 v2.29.0 h1:5VipnvEpbqr2gA2VbM+nYVbkIF28c5ZQfqCBQ5g2xfk=
+github.com/grpc-ecosystem/grpc-gateway/v2 v2.29.0/go.mod h1:Hyl3n6Twe1hvtd9XUXDec4pTvgMSEixRuQKPTMH2bNs=
+github.com/klauspost/compress v1.17.0 h1:Rnbp4K9EjcDuVuHtd0dgA4qNuv9yKDYKK1ulpJwgrqM=
+github.com/klauspost/compress v1.17.0/go.mod h1:ntbaceVETuRiXiv4DpjP66DpAtAGkEQskQzEyD//IeE=
+github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
+github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
+github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-runewidth v0.0.15 h1:UNAjwbU9l54TA3KzvqLGxwWjHmMgBUVhBiTjelZgg3U=
+github.com/mattn/go-runewidth v0.0.15/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rivo/uniseg v0.2.0 h1:S1pD9weZBuJdFmowNwbpi7BJ8TNftyUImj/0WQi72jY=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/valyala/bytebufferpool v1.0.0 h1:GqA5TC/0021Y/b9FG4Oi9Mr3q7XYx6KllzawFIhcdPw=
+github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc=
+github.com/valyala/fasthttp v1.51.0 h1:8b30A5JlZ6C7AS81RsWjYMQmrZG6feChmgAolCl1SqA=
+github.com/valyala/fasthttp v1.51.0/go.mod h1:oI2XroL+lI7vdXyYoQk03bXBThfFl2cVdIA3Xl7cH8g=
+github.com/valyala/tcplisten v1.0.0 h1:rBHj/Xf+E1tRGZyWIWwJDiRY0zc1Js+CV5DqwacVSA8=
+github.com/valyala/tcplisten v1.0.0/go.mod h1:T0xQ8SeCZGxckz9qRXTfG43PvQ/mcWh7FwZEA7Ioqkc=
+go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=
+go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
+go.opentelemetry.io/otel v1.44.0 h1:JjwHmHpA4iZ3wBxluu2fbbE7j4kqlE8jXyAyPXH7HqU=
+go.opentelemetry.io/otel v1.44.0/go.mod h1:BMgjTHL9WPRlRjL2oZCBTL4whCGtXch2H4BhOPIAyYc=
+go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp v1.44.0 h1:RuynHbfU8JUEw7DyONgkVYg2SVtsoF28y0LGIr69jgA=
+go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp v1.44.0/go.mod h1:qZF+/lBs71APw8mlnEZcqZHMzqrYrsFiJOv83lX1OGo=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.44.0 h1:4YsVu3B8+3qtWYYrsUYgn0OG78pN0rnNPRGX4SbokQI=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.44.0/go.mod h1:+wnlSn0mD1ADVMe3v9Z/WIaiz6q6gL2J/ejaAmdmv80=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.44.0 h1:lgh3PiVrRUWMLOVSkQicxzZll5NjF1r+AtsX1XRIHw0=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.44.0/go.mod h1:5Cnhth3m/AgOeTgE3ex12pPmiu/gGtZit03kSzx9X7s=
+go.opentelemetry.io/otel/metric v1.44.0 h1:1w0gILTcHdr3YI+ixLyjemwrVnsMURbTZFrSYCdDdmc=
+go.opentelemetry.io/otel/metric v1.44.0/go.mod h1:8O7hanEPBNgEMmybD3s2VBKcgWOCsA6tzHBPODAiquo=
+go.opentelemetry.io/otel/metric/x v0.66.0 h1:YkCrx1zLOChi9ZcZ6euupOcsgzbVlec7D/xoEU1+cTA=
+go.opentelemetry.io/otel/metric/x v0.66.0/go.mod h1:d1+BDj9t96do0/1LoU1ayfCv79ZgNE41qbhBvnMOBZk=
+go.opentelemetry.io/otel/sdk v1.44.0 h1:nHYwb9lK+fJPU/dnT6s7W7Z8itMWyqrnVfbheVYrZ58=
+go.opentelemetry.io/otel/sdk v1.44.0/go.mod h1:Osuydd3Se74nqjAKxid74N5eC+jfEqfTegHRnq58oK0=
+go.opentelemetry.io/otel/sdk/metric v1.44.0 h1:3LlKgI+VjbVsjNRFZJZAJ30WjXC5VkNRks6si09iEfI=
+go.opentelemetry.io/otel/sdk/metric v1.44.0/go.mod h1:5B5pMARnXxKhltooO4xUuCBorl65a4EpnTalObqOigA=
+go.opentelemetry.io/otel/trace v1.44.0 h1:jxF5CsGYCe74MCRx2X4g7WsY/VBKRqqpNvXlX/6gtIk=
+go.opentelemetry.io/otel/trace v1.44.0/go.mod h1:oLl1jrMQAVo6v3GAggN+1VH9VIz9iUSvW53sW1Q8PIE=
+go.opentelemetry.io/proto/otlp v1.10.0 h1:IQRWgT5srOCYfiWnpqUYz9CVmbO8bFmKcwYxpuCSL2g=
+go.opentelemetry.io/proto/otlp v1.10.0/go.mod h1:/CV4QoCR/S9yaPj8utp3lvQPoqMtxXdzn7ozvvozVqk=
+go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
+go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
+golang.org/x/net v0.55.0 h1:bcvxaJn3e1U6InsFWt1JUq1aSjnRxLzT2rtD2KfkDF8=
+golang.org/x/net v0.55.0/go.mod h1:L5U2KuzuOe1lY7Z+aWVIKK6qEeJXnXV9yzGA+WCHJww=
+golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.45.0 h1:dO4czNzziLiiXplLQgBCEpCvXQ3dnkn0SdaZSYdQ+FY=
+golang.org/x/sys v0.45.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.37.0 h1:Cqjiwd9eSg8e0QAkyCaQTNHFIIzWtidPahFWR83rTrc=
+golang.org/x/text v0.37.0/go.mod h1:a5sjxXGs9hsn/AJVwuElvCAo9v8QYLzvavO5z2PiM38=
+gonum.org/v1/gonum v0.17.0 h1:VbpOemQlsSMrYmn7T2OUvQ4dqxQXU+ouZFQsZOx50z4=
+gonum.org/v1/gonum v0.17.0/go.mod h1:El3tOrEuMpv2UdMrbNlKEh9vd86bmQ6vqIcDwxEOc1E=
+google.golang.org/genproto/googleapis/api v0.0.0-20260526163538-3dc84a4a5aaa h1:Kjn0N0tCrDgiAFW+lGO4JZ3ck44CehvJQMAwj9QF0G8=
+google.golang.org/genproto/googleapis/api v0.0.0-20260526163538-3dc84a4a5aaa/go.mod h1:q4lMZS6kskjT5HvCPrnnypcDPVJqT/f4nfxmkE7gryY=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20260526163538-3dc84a4a5aaa h1:mZHHdPZl0dbGHCflZgAq/Q468DWVFcU2whhB2KAo8fk=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20260526163538-3dc84a4a5aaa/go.mod h1:4Hqkh8ycfw05ld/3BWL7rJOSfebL2Q+DVDeRgYgxUU8=
+google.golang.org/grpc v1.81.1 h1:VnnIIZ88UzOOKLukQi+ImGz8O1Wdp8nAGGnvOfEIWQQ=
+google.golang.org/grpc v1.81.1/go.mod h1:xGH9GfzOyMTGIOXBJmXt+BX/V0kcdQbdcuwQ/zNw42I=
+google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
+google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

go/fiber/middleware.go

@@ -0,0 +1,124 @@
+// Package fiberobs provides a Fiber (github.com/gofiber/fiber/v2) middleware for
+// the Smoo observability SDK. It is a thin adapter over the same Scope +
+// CaptureException primitives as the core net/http middleware, with identical
+// semantics:
+//
+//  1. Establishes a fresh request-scoped Scope on the request's user context
+//     (Fiber's c.UserContext()), so any CaptureExceptionOnSpan / scope mutation
+//     fired from a downstream handler picks up this request's identity.
+//  2. Resolves user identity (via ResolveUser) and records a "request" context
+//     block (method, path, allowlisted headers). Hydration is wrapped so a
+//     failure there never breaks the request.
+//  3. Captures downstream panics AND returned errors as exceptions (tagged
+//     source "fiber.middleware") before propagating them. Panics are re-panicked
+//     by default so Fiber's own recovery still runs; set SwallowPanics to write a
+//     500 instead. Returned errors are always re-returned so Fiber's ErrorHandler
+//     renders the response.
+//
+// Lives in its own Go module so the core SDK does not take a hard dependency on
+// Fiber unless this adapter is imported.
+package fiberobs
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/gofiber/fiber/v2"
+
+	obs "github.com/SmooAI/observability/go"
+)
+
+// Options configures Middleware.
+type Options struct {
+	// Client to capture on. Defaults to the package obs.Default client.
+	Client *obs.Client
+	// ResolveUser extracts user identity from the request. Return nil to skip.
+	ResolveUser func(c *fiber.Ctx) *obs.User
+	// RequestHeaderAllowlist names headers recorded on the request context.
+	// Defaults to a conservative, safe-to-send set.
+	RequestHeaderAllowlist []string
+	// SwallowPanics, when true, makes the middleware capture a downstream panic,
+	// write a 500, and NOT re-panic. The default (false) re-panics after
+	// capturing so the host's own recovery middleware still runs.
+	SwallowPanics bool
+}
+
+var defaultHeaderAllowlist = []string{"user-agent", "referer", "x-request-id", "x-trace-id", "x-correlation-id"}
+
+// Middleware returns a Fiber handler that establishes per-request scope and
+// captures downstream panics/errors.
+func Middleware(opts Options) fiber.Handler {
+	client := opts.Client
+	if client == nil {
+		client = obs.Default
+	}
+	allowlist := opts.RequestHeaderAllowlist
+	if allowlist == nil {
+		allowlist = defaultHeaderAllowlist
+	}
+	rethrow := !opts.SwallowPanics
+
+	return func(c *fiber.Ctx) (err error) {
+		if !client.IsInitialized() {
+			return c.Next()
+		}
+
+		scope := obs.NewScope()
+		ctx := obs.ContextWithScope(c.UserContext(), scope)
+		c.SetUserContext(ctx)
+
+		hydrateScope(c, scope, opts.ResolveUser, allowlist)
+
+		defer func() {
+			if rec := recover(); rec != nil {
+				client.CaptureExceptionOnSpan(ctx, panicToError(rec), map[string]string{"source": "fiber.middleware"})
+				if rethrow {
+					panic(rec)
+				}
+				err = c.SendStatus(http.StatusInternalServerError)
+			}
+		}()
+
+		err = c.Next()
+		if err != nil {
+			client.CaptureExceptionOnSpan(ctx, err, map[string]string{"source": "fiber.middleware"})
+		}
+		return err
+	}
+}
+
+// New is the convenience constructor — captures panics then re-panics so the
+// host's recovery still runs.
+func New(client *obs.Client, resolveUser func(c *fiber.Ctx) *obs.User) fiber.Handler {
+	return Middleware(Options{Client: client, ResolveUser: resolveUser})
+}
+
+// hydrateScope sets user + request context on the scope. Wrapped so a panic in
+// ResolveUser or header reads never breaks the request, mirroring the core
+// middleware's recoverSilently guard.
+func hydrateScope(c *fiber.Ctx, scope *obs.Scope, resolveUser func(c *fiber.Ctx) *obs.User, allowlist []string) {
+	defer func() { _ = recover() }()
+	if resolveUser != nil {
+		if u := resolveUser(c); u != nil {
+			scope.SetUser(u)
+		}
+	}
+	headers := map[string]string{}
+	for _, name := range allowlist {
+		if v := c.Get(name); v != "" {
+			headers[name] = v
+		}
+	}
+	scope.SetContext("request", map[string]any{
+		"method":  c.Method(),
+		"path":    c.Path(),
+		"headers": headers,
+	})
+}
+
+func panicToError(rec any) error {
+	if err, ok := rec.(error); ok {
+		return err
+	}
+	return fmt.Errorf("panic: %v", rec)
+}