Files
silo-server/internal/api/handlers/webhook_sync.go
T
Silo Server Migration 5f5e404d93 Rename webhook sync actors to profile mappings
- Rename actor-oriented API, storage, and webhook fields to user/profile terminology
- Switch dev compose helpers to use docker-compose.yml
- Update frontend types and webhook sync settings for the new endpoints
2026-05-24 00:04:25 -04:00

666 lines
22 KiB
Go

package handlers
import (
"encoding/json"
"errors"
"log/slog"
"net/http"
"strconv"
"strings"
"time"
"github.com/go-chi/chi/v5"
apimw "github.com/Silo-Server/silo-server/internal/api/middleware"
"github.com/Silo-Server/silo-server/internal/historyimport"
"github.com/Silo-Server/silo-server/internal/webhooksync"
)
type WebhookSyncHandler struct {
service *webhooksync.Service
}
type legacyPlexSyncConnection struct {
ID string `json:"id"`
PlexServerID string `json:"plex_server_id"`
PlexServerName string `json:"plex_server_name"`
WebhookURL string `json:"webhook_url,omitempty"`
BindingsReady bool `json:"bindings_ready"`
ActorCount int `json:"actor_count"`
AccountDiscoveryAvailable bool `json:"account_discovery_available"`
LastWebhookReceivedAt *time.Time `json:"last_webhook_received_at,omitempty"`
LastWebhookErrorAt *time.Time `json:"last_webhook_error_at,omitempty"`
LastWebhookErrorMessage string `json:"last_webhook_error_message,omitempty"`
LastWritebackAt *time.Time `json:"last_writeback_at,omitempty"`
LastWritebackErrorAt *time.Time `json:"last_writeback_error_at,omitempty"`
LastWritebackErrorMessage string `json:"last_writeback_error_message,omitempty"`
LastBindingRefreshAt *time.Time `json:"last_binding_refresh_at,omitempty"`
LastBindingRefreshErrorAt *time.Time `json:"last_binding_refresh_error_at,omitempty"`
LastBindingRefreshErrorMessage string `json:"last_binding_refresh_error_message,omitempty"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
type legacyPlexSyncActorMapping struct {
ID int `json:"id"`
ConnectionID string `json:"connection_id"`
PlexAccountID int64 `json:"plex_account_id"`
PlexAccountTitle string `json:"plex_account_title"`
SiloProfileID string `json:"silo_profile_id"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
type legacyPlexSyncDiscoveredActor struct {
PlexAccountID int64 `json:"plex_account_id"`
PlexAccountTitle string `json:"plex_account_title"`
}
type legacyCreatePlexSyncConnectionRequest struct {
PlexServerID string `json:"plex_server_id"`
PlexServerName string `json:"plex_server_name"`
PlexBaseURL string `json:"plex_base_url"`
PlexToken string `json:"plex_token"`
DefaultProfileID string `json:"default_profile_id"`
}
type legacyCreatePlexSyncConnectionResponse struct {
Connection legacyPlexSyncConnection `json:"connection"`
DefaultActorMapping legacyPlexSyncActorMapping `json:"default_actor_mapping"`
WebhookURL string `json:"webhook_url"`
}
type legacyRotatePlexSyncWebhookResponse struct {
WebhookURL string `json:"webhook_url"`
}
type legacyPlexSyncActorsResponse struct {
Mappings []legacyPlexSyncActorMapping `json:"mappings"`
DiscoveredActors []legacyPlexSyncDiscoveredActor `json:"discovered_actors"`
AccountDiscoveryAvailable bool `json:"account_discovery_available"`
}
type legacyUpdatePlexSyncActorsRequest struct {
Mappings []struct {
PlexAccountID int64 `json:"plex_account_id"`
PlexAccountTitle string `json:"plex_account_title"`
SiloProfileID string `json:"silo_profile_id"`
} `json:"mappings"`
}
func NewWebhookSyncHandler(service *webhooksync.Service) *WebhookSyncHandler {
return &WebhookSyncHandler{service: service}
}
func (h *WebhookSyncHandler) HandleListConnections(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
connections, err := h.service.ListConnections(r.Context(), userID)
if err != nil {
writeError(w, http.StatusInternalServerError, "internal_error", "Failed to list webhook sync connections")
return
}
baseURL := requestBaseURL(r)
for i := range connections {
connections[i].WebhookURL = requestWebhookURL(baseURL, connections[i].WebhookSecret)
}
writeJSON(w, http.StatusOK, connections)
}
func (h *WebhookSyncHandler) HandleLegacyListConnections(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
connections, err := h.service.ListConnections(r.Context(), userID)
if err != nil {
writeError(w, http.StatusInternalServerError, "internal_error", "Failed to list Plex sync connections")
return
}
baseURL := requestBaseURL(r)
legacyConnections := make([]legacyPlexSyncConnection, 0, len(connections))
for _, connection := range connections {
if connection.Provider != webhooksync.ProviderPlex {
continue
}
legacyConnections = append(legacyConnections, toLegacyPlexConnection(connection, requestWebhookURLWithPrefix(baseURL, legacyPlexSyncPathPrefix, connection.WebhookSecret)))
}
writeJSON(w, http.StatusOK, legacyConnections)
}
func (h *WebhookSyncHandler) HandleCreateConnection(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
if userID == 0 {
writeError(w, http.StatusUnauthorized, "unauthorized", "Authentication required")
return
}
var req webhooksync.CreateConnectionInput
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeError(w, http.StatusBadRequest, "bad_request", "Invalid request body")
return
}
resp, err := h.service.CreateConnection(r.Context(), userID, req, requestBaseURL(r))
if err != nil {
h.writeError(w, err)
return
}
resp.Connection.WebhookURL = resp.WebhookURL
writeJSON(w, http.StatusCreated, resp)
}
func (h *WebhookSyncHandler) HandleLegacyCreateConnection(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
if userID == 0 {
writeError(w, http.StatusUnauthorized, "unauthorized", "Authentication required")
return
}
var req legacyCreatePlexSyncConnectionRequest
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeError(w, http.StatusBadRequest, "bad_request", "Invalid request body")
return
}
resp, err := h.service.CreateConnection(r.Context(), userID, webhooksync.CreateConnectionInput{
Provider: webhooksync.ProviderPlex,
ServerID: req.PlexServerID,
ServerName: req.PlexServerName,
BaseURL: req.PlexBaseURL,
AccessToken: req.PlexToken,
DefaultProfileID: req.DefaultProfileID,
}, requestBaseURL(r))
if err != nil {
h.writeError(w, err)
return
}
actors, err := h.service.GetProfileMappings(r.Context(), userID, resp.Connection.ID)
if err != nil {
h.writeError(w, err)
return
}
webhookURL := requestWebhookURLWithPrefix(requestBaseURL(r), legacyPlexSyncPathPrefix, resp.Connection.WebhookSecret)
writeJSON(w, http.StatusCreated, legacyCreatePlexSyncConnectionResponse{
Connection: toLegacyPlexConnection(resp.Connection, webhookURL),
DefaultActorMapping: firstLegacyMappedActor(actors.Mappings),
WebhookURL: webhookURL,
})
}
func (h *WebhookSyncHandler) HandleUpdateConnection(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
var req webhooksync.UpdateConnectionInput
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeError(w, http.StatusBadRequest, "bad_request", "Invalid request body")
return
}
conn, err := h.service.UpdateConnection(r.Context(), userID, id, req)
if err != nil {
h.writeError(w, err)
return
}
conn.WebhookURL = requestWebhookURL(requestBaseURL(r), conn.WebhookSecret)
writeJSON(w, http.StatusOK, conn)
}
func (h *WebhookSyncHandler) HandleDeleteConnection(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
if err := h.service.DeleteConnection(r.Context(), userID, id); err != nil {
h.writeError(w, err)
return
}
w.WriteHeader(http.StatusNoContent)
}
func (h *WebhookSyncHandler) HandleLegacyDeleteConnection(w http.ResponseWriter, r *http.Request) {
h.HandleDeleteConnection(w, r)
}
func (h *WebhookSyncHandler) HandleRotateWebhook(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
resp, err := h.service.RotateWebhook(r.Context(), userID, id, requestBaseURL(r))
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, resp)
}
func (h *WebhookSyncHandler) HandleLegacyRotateWebhook(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
resp, err := h.service.RotateWebhook(r.Context(), userID, id, requestBaseURL(r))
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, legacyRotatePlexSyncWebhookResponse{
WebhookURL: strings.TrimRight(requestBaseURL(r), "/") + legacyPlexSyncPathPrefix + secretFromWebhookURL(resp.WebhookURL),
})
}
func (h *WebhookSyncHandler) HandleGetProfileMappings(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
resp, err := h.service.GetProfileMappings(r.Context(), userID, id)
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, resp)
}
func (h *WebhookSyncHandler) HandleListEvents(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
limit := parseLimit(r, 50)
if limit > 200 {
limit = 200
}
resp, err := h.service.ListEventLogs(r.Context(), userID, id, limit)
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, resp)
}
func (h *WebhookSyncHandler) HandleLegacyGetActors(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
resp, err := h.service.GetProfileMappings(r.Context(), userID, id)
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, toLegacyPlexActorsResponse(resp))
}
func (h *WebhookSyncHandler) HandleUpdateProfileMappings(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
var req webhooksync.UpdateProfileMappingsInput
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeError(w, http.StatusBadRequest, "bad_request", "Invalid request body")
return
}
resp, err := h.service.UpdateProfileMappings(r.Context(), userID, id, req)
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, resp)
}
func (h *WebhookSyncHandler) HandleLegacyUpdateActors(w http.ResponseWriter, r *http.Request) {
userID := apimw.GetUserID(r.Context())
id := chi.URLParam(r, "id")
if id == "" {
writeError(w, http.StatusBadRequest, "bad_request", "Connection ID is required")
return
}
var req legacyUpdatePlexSyncActorsRequest
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeError(w, http.StatusBadRequest, "bad_request", "Invalid request body")
return
}
input := webhooksync.UpdateProfileMappingsInput{
Mappings: make([]webhooksync.UpdateProfileMapping, 0, len(req.Mappings)),
}
for _, mapping := range req.Mappings {
profileID := mapping.SiloProfileID
input.Mappings = append(input.Mappings, webhooksync.UpdateProfileMapping{
ExternalUserID: strconv.FormatInt(mapping.PlexAccountID, 10),
ExternalUserName: mapping.PlexAccountTitle,
SiloProfileID: &profileID,
})
}
resp, err := h.service.UpdateProfileMappings(r.Context(), userID, id, input)
if err != nil {
h.writeError(w, err)
return
}
writeJSON(w, http.StatusOK, toLegacyPlexActorMappings(resp))
}
func (h *WebhookSyncHandler) HandleWebhook(w http.ResponseWriter, r *http.Request) {
secret := chi.URLParam(r, "secret")
if secret == "" {
http.NotFound(w, r)
return
}
capture := webhooksync.NewBodyCaptureReadCloser(r.Body, webhooksync.WebhookBodyCaptureLimit)
r.Body = capture
result, err := h.service.ProcessWebhook(r.Context(), secret, r)
logContext := webhooksync.BuildWebhookRequestLogContext(
r,
webhooksync.SanitizeWebhookBodyExcerpt(r.Header.Get("Content-Type"), capture.Captured()),
)
statusCode := http.StatusNoContent
if err != nil {
statusCode = webhookErrorStatus(err)
}
if result != nil {
if _, logErr := h.service.CreateEventLog(r.Context(), webhooksync.WebhookEventLog{
ConnectionID: result.ConnectionID,
RequestID: logContext.RequestID,
HTTPStatus: statusCode,
Outcome: result.Outcome,
Summary: result.Summary,
ErrorMessage: result.ErrorMessage,
BodyExcerpt: logContext.BodyExcerpt,
Attrs: webhookEventAttrs(logContext, result),
}); logErr != nil {
slog.Warn("webhook sync: failed to persist webhook event log", "connection_id", result.ConnectionID, "error", logErr)
}
}
logWebhookDelivery(result, logContext, statusCode, err)
if err != nil {
h.writeError(w, err)
return
}
w.WriteHeader(http.StatusNoContent)
}
func (h *WebhookSyncHandler) writeError(w http.ResponseWriter, err error) {
statusCode := webhookErrorStatus(err)
switch {
case errors.Is(err, webhooksync.ErrConnectionNotFound), errors.Is(err, historyimport.ErrProfileNotFound):
writeError(w, statusCode, "not_found", err.Error())
default:
message := err.Error()
switch {
case message == "invalid multipart request",
message == "missing payload",
message == "invalid Plex payload",
message == "invalid Plex webhook payload",
message == "invalid Emby payload",
message == "invalid Emby webhook payload",
message == "invalid Jellyfin payload",
message == "invalid Jellyfin webhook payload",
strings.Contains(message, "are required"),
strings.Contains(message, "cannot be empty"),
strings.Contains(message, "unsupported provider"):
writeError(w, statusCode, "bad_request", err.Error())
default:
writeError(w, statusCode, "internal_error", err.Error())
}
}
}
func webhookErrorStatus(err error) int {
switch {
case errors.Is(err, webhooksync.ErrConnectionNotFound), errors.Is(err, historyimport.ErrProfileNotFound):
return http.StatusNotFound
default:
message := err.Error()
switch {
case message == "invalid multipart request",
message == "missing payload",
message == "invalid Plex payload",
message == "invalid Plex webhook payload",
message == "invalid Emby payload",
message == "invalid Emby webhook payload",
message == "invalid Jellyfin payload",
message == "invalid Jellyfin webhook payload",
strings.Contains(message, "are required"),
strings.Contains(message, "cannot be empty"),
strings.Contains(message, "unsupported provider"):
return http.StatusBadRequest
default:
return http.StatusInternalServerError
}
}
}
func webhookEventAttrs(meta webhooksync.WebhookRequestLogContext, result *webhooksync.ProcessWebhookResult) map[string]any {
attrs := map[string]any{
"client_ip": meta.ClientIP,
"content_type": meta.ContentType,
"user_agent": meta.UserAgent,
"path_pattern": meta.PathPattern,
}
if result == nil {
return attrs
}
if result.EventKind != "" {
attrs["event_kind"] = result.EventKind
}
if result.Action != "" {
attrs["action"] = result.Action
}
if result.UserID != "" {
attrs["external_user_id"] = result.UserID
}
if result.UserName != "" {
attrs["external_user_name"] = result.UserName
}
if result.ExternalItemID != "" {
attrs["external_item_id"] = result.ExternalItemID
}
if result.MediaKind != "" {
attrs["media_kind"] = result.MediaKind
}
if result.MatchedMediaItemID != "" {
attrs["matched_media_item_id"] = result.MatchedMediaItemID
}
if result.MatchedMediaItemTitle != "" {
attrs["matched_media_item_title"] = result.MatchedMediaItemTitle
}
if result.ProfileID != "" {
attrs["profile_id"] = result.ProfileID
}
return attrs
}
func logWebhookDelivery(result *webhooksync.ProcessWebhookResult, meta webhooksync.WebhookRequestLogContext, statusCode int, err error) {
args := []any{
"component", "webhook_sync",
"request_id", meta.RequestID,
"http_status", statusCode,
"path_pattern", meta.PathPattern,
"client_ip", meta.ClientIP,
"content_type", meta.ContentType,
}
if result != nil {
args = append(args,
"connection_id", result.ConnectionID,
"provider", result.Provider,
"outcome", result.Outcome,
"summary", result.Summary,
)
if result.EventKind != "" {
args = append(args, "event_kind", result.EventKind)
}
if result.Action != "" {
args = append(args, "action", result.Action)
}
if result.UserID != "" {
args = append(args, "external_user_id", result.UserID)
}
if result.ExternalItemID != "" {
args = append(args, "external_item_id", result.ExternalItemID)
}
if result.MatchedMediaItemID != "" {
args = append(args, "matched_media_item_id", result.MatchedMediaItemID)
}
if result.ErrorMessage != "" {
args = append(args, "error", result.ErrorMessage)
}
} else {
args = append(args,
"outcome", webhooksync.OutcomeRejected,
"summary", "Rejected webhook request because the secret was not found",
)
if err != nil {
args = append(args, "error", err.Error())
}
}
switch {
case statusCode >= 500:
slog.Error("webhook delivery", args...)
case statusCode >= 400:
slog.Warn("webhook delivery", args...)
default:
slog.Info("webhook delivery", args...)
}
}
func requestBaseURL(r *http.Request) string {
scheme := "http"
if r.TLS != nil {
scheme = "https"
}
if forwarded := strings.TrimSpace(r.Header.Get("X-Forwarded-Proto")); forwarded != "" {
scheme = forwarded
}
host := r.Host
if forwardedHost := strings.TrimSpace(r.Header.Get("X-Forwarded-Host")); forwardedHost != "" {
host = forwardedHost
}
return scheme + "://" + host
}
func requestWebhookURL(baseURL, secret string) string {
return requestWebhookURLWithPrefix(baseURL, webhookSyncPathPrefix, secret)
}
func requestWebhookURLWithPrefix(baseURL, prefix, secret string) string {
if secret == "" {
return ""
}
return strings.TrimRight(baseURL, "/") + prefix + secret
}
const (
webhookSyncPathPrefix = "/api/v1/webhook-sync/webhooks/"
legacyPlexSyncPathPrefix = "/api/v1/plex-sync/webhooks/"
)
func toLegacyPlexConnection(connection webhooksync.Connection, webhookURL string) legacyPlexSyncConnection {
return legacyPlexSyncConnection{
ID: connection.ID,
PlexServerID: connection.ServerID,
PlexServerName: connection.ServerName,
WebhookURL: webhookURL,
BindingsReady: false,
ActorCount: connection.UserCount,
AccountDiscoveryAvailable: connection.AccountDiscoveryAvailable,
LastWebhookReceivedAt: connection.LastWebhookReceivedAt,
LastWebhookErrorAt: connection.LastWebhookErrorAt,
LastWebhookErrorMessage: connection.LastWebhookErrorMessage,
CreatedAt: connection.CreatedAt,
UpdatedAt: connection.UpdatedAt,
}
}
func toLegacyPlexActorsResponse(resp *webhooksync.ProfileMappingsResponse) legacyPlexSyncActorsResponse {
if resp == nil {
return legacyPlexSyncActorsResponse{}
}
return legacyPlexSyncActorsResponse{
Mappings: toLegacyPlexActorMappings(resp.Mappings),
DiscoveredActors: toLegacyPlexDiscoveredActors(resp.DiscoveredUsers),
AccountDiscoveryAvailable: resp.AccountDiscoveryAvailable,
}
}
func toLegacyPlexActorMappings(mappings []webhooksync.ProfileMapping) []legacyPlexSyncActorMapping {
if len(mappings) == 0 {
return nil
}
out := make([]legacyPlexSyncActorMapping, 0, len(mappings))
for _, mapping := range mappings {
accountID, err := strconv.ParseInt(mapping.ExternalUserID, 10, 64)
if err != nil {
continue
}
out = append(out, legacyPlexSyncActorMapping{
ID: mapping.ID,
ConnectionID: mapping.ConnectionID,
PlexAccountID: accountID,
PlexAccountTitle: mapping.ExternalUserName,
SiloProfileID: valueOrEmpty(mapping.SiloProfileID),
CreatedAt: mapping.CreatedAt,
UpdatedAt: mapping.UpdatedAt,
})
}
return out
}
func toLegacyPlexDiscoveredActors(actors []webhooksync.DiscoveredUser) []legacyPlexSyncDiscoveredActor {
if len(actors) == 0 {
return nil
}
out := make([]legacyPlexSyncDiscoveredActor, 0, len(actors))
for _, actor := range actors {
accountID, err := strconv.ParseInt(actor.ExternalUserID, 10, 64)
if err != nil {
continue
}
out = append(out, legacyPlexSyncDiscoveredActor{
PlexAccountID: accountID,
PlexAccountTitle: actor.ExternalUserName,
})
}
return out
}
func firstLegacyMappedActor(mappings []webhooksync.ProfileMapping) legacyPlexSyncActorMapping {
legacyMappings := toLegacyPlexActorMappings(mappings)
if len(legacyMappings) == 0 {
return legacyPlexSyncActorMapping{}
}
return legacyMappings[0]
}
func valueOrEmpty(value *string) string {
if value == nil {
return ""
}
return *value
}
func secretFromWebhookURL(raw string) string {
if raw == "" {
return ""
}
idx := strings.LastIndex(raw, "/")
if idx < 0 || idx == len(raw)-1 {
return ""
}
return raw[idx+1:]
}