Function writeEnvelope

internal/httpapi/ratelimit.go:106–111

writeEnvelope serializes an error envelope directly to the response from a middleware, where there is no handler return value for Huma to render. It stamps the request id so the body matches the stampRequestID transformer on the handler path, and sets headers before the status line.

(ctx huma.Context, env *ErrorEnvelope)

// stamps the request id so the body matches the stampRequestID transformer on
// the handler path, and sets headers before the status line.
func writeEnvelope(ctx huma.Context, env *ErrorEnvelope) {
	env.Err.RequestID = RequestIDFromContext(ctx.Context())
	ctx.SetHeader("Content-Type", "application/json")
	ctx.SetStatus(env.status)
	_ = json.NewEncoder(ctx.BodyWriter()).Encode(env)
}

// principalCtxKey carries a principal resolved by the rate-limit middleware so
// the downstream handler's requireUser/requirePrincipal can skip a second auth.