72 lines
2.2 KiB
Go
72 lines
2.2 KiB
Go
package httpx
|
|
|
|
import (
|
|
"net/http"
|
|
"time"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
|
|
"messenger/internal/platform/apperr"
|
|
)
|
|
|
|
type errorEnvelope struct {
|
|
Error errorDetail `json:"error"`
|
|
}
|
|
|
|
type errorDetail struct {
|
|
Code string `json:"code"`
|
|
Message string `json:"message"`
|
|
RequestID string `json:"request_id"`
|
|
}
|
|
|
|
type statusCode struct {
|
|
status int
|
|
code string
|
|
}
|
|
|
|
var kinds = map[apperr.Kind]statusCode{
|
|
apperr.KindInvalid: {http.StatusBadRequest, "invalid_request"},
|
|
apperr.KindUnauthorized: {http.StatusUnauthorized, "unauthorized"},
|
|
apperr.KindNotFound: {http.StatusNotFound, "not_found"},
|
|
apperr.KindConflict: {http.StatusConflict, "conflict"},
|
|
apperr.KindPayloadTooLarge: {http.StatusRequestEntityTooLarge, "payload_too_large"},
|
|
apperr.KindUnsupportedMedia: {http.StatusUnsupportedMediaType, "unsupported_media_type"},
|
|
apperr.KindUnavailable: {http.StatusServiceUnavailable, "unavailable"},
|
|
}
|
|
|
|
// JSON is the single place that fixes the response media type; PureJSON
|
|
// keeps non-ASCII and HTML characters verbatim.
|
|
func JSON(c *gin.Context, status int, body any) {
|
|
c.PureJSON(status, body)
|
|
}
|
|
|
|
// Fail writes the contract error body and stops the handler chain.
|
|
func Fail(c *gin.Context, status int, code, message string) {
|
|
JSON(c, status, errorEnvelope{Error: errorDetail{
|
|
Code: code,
|
|
Message: message,
|
|
RequestID: RequestID(c),
|
|
}})
|
|
c.Abort()
|
|
}
|
|
|
|
// Error maps an application error to its status. Anything that is not an
|
|
// application error is logged with its text and reported as an opaque 500,
|
|
// so internal details never reach the client.
|
|
func Error(c *gin.Context, err error) {
|
|
mapped, known := kinds[apperr.KindOf(err)]
|
|
if !known {
|
|
logger(c).Error("request failed", "request_id", RequestID(c), "error", err.Error())
|
|
Fail(c, http.StatusInternalServerError, "internal_error", "internal error")
|
|
return
|
|
}
|
|
Fail(c, mapped.status, mapped.code, err.Error())
|
|
}
|
|
|
|
// Timestamp renders RFC 3339 UTC with a fixed millisecond width: Python 3.9
|
|
// (the oldest version the public tests support) only parses 3 or 6 fractional
|
|
// digits, and RFC3339Nano would trim trailing zeros to a variable width.
|
|
func Timestamp(t time.Time) string {
|
|
return t.UTC().Format("2006-01-02T15:04:05.000Z")
|
|
}
|