QuickandClaude Fable 5
d9e27da59e
Notify the requesting profile once its media request is actually present in the catalog (roadmap 06, item 2). Completion transitions stay notification-agnostic; a presence-gated pass at the end of each reconcile run fires the notice, so it means "watchable in Silo", not "download finished". - New System.DispatchOperational: delivery insert + webhook/web-push outbox enqueue in one transaction, post-commit multi-dispatch. The webhook auto-disable notice now rides the same path (replacing its hand-rolled hub publish and the now-removed InsertOperational), which also delivers auto-disable notices over web push. - At-most-once delivery: partial unique index on (profile_id, reason_flags->>'request_id') plus a fulfilled_notified_at marker on media_requests, backfilled for pre-existing completed requests so deploys never flood. - Per-webhook notify_requests toggle (default on) through repo, service, API, and settings UI; gated independently of the episode reason flags. - request.fulfilled rendering in web inbox, realtime toast, web push payload, and Discord/generic webhook payloads, deep-linking to the matched catalog item. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
119 lines
4.1 KiB
Go
119 lines
4.1 KiB
Go
package notifications
|
|
|
|
import (
|
|
"crypto/hmac"
|
|
"crypto/sha256"
|
|
"encoding/hex"
|
|
"encoding/json"
|
|
"fmt"
|
|
"strconv"
|
|
"time"
|
|
)
|
|
|
|
// genericWebhookBody is the canonical Silo webhook JSON
|
|
// (docs/superpowers/plans/notifications/04, "Generic"). The HMAC signature is
|
|
// computed over the literal bytes Silo sends; receivers verify against the
|
|
// literal bytes they received, so no canonicalization is required on either
|
|
// side. No server URL, no absolute artwork URLs, no library name.
|
|
type genericWebhookBody struct {
|
|
Event string `json:"event"`
|
|
DeliveryID string `json:"delivery_id"`
|
|
WebhookID string `json:"webhook_id"`
|
|
Timestamp string `json:"timestamp"`
|
|
Version int `json:"version"`
|
|
Test bool `json:"test"`
|
|
ProfileID string `json:"profile_id"`
|
|
LibraryID *int `json:"library_id,omitempty"`
|
|
Type string `json:"type"`
|
|
Reasons ReasonFlags `json:"reason_flags"`
|
|
Series *genericWebhookSeries `json:"series,omitempty"`
|
|
Episode *genericWebhookEpisode `json:"episode,omitempty"`
|
|
// Request is present for request.fulfilled deliveries; the catalog item is
|
|
// in Series (movies included — the field carries the matched item).
|
|
Request *genericWebhookRequest `json:"request,omitempty"`
|
|
}
|
|
|
|
type genericWebhookSeries struct {
|
|
ID string `json:"id"`
|
|
Title string `json:"title"`
|
|
}
|
|
|
|
type genericWebhookEpisode struct {
|
|
ID string `json:"id"`
|
|
Title string `json:"title"`
|
|
SeasonNumber *int `json:"season_number,omitempty"`
|
|
EpisodeNumber *int `json:"episode_number,omitempty"`
|
|
}
|
|
|
|
type genericWebhookRequest struct {
|
|
ID string `json:"id"`
|
|
TMDBID int `json:"tmdb_id,omitempty"`
|
|
MediaType string `json:"media_type,omitempty"`
|
|
}
|
|
|
|
// BuildGenericWebhookPayload renders a delivery as canonical Silo JSON. Pure
|
|
// function.
|
|
func BuildGenericWebhookPayload(row DeliveryRow, webhookID string, test bool) ([]byte, error) {
|
|
createdAt := row.CreatedAt
|
|
if createdAt.IsZero() {
|
|
createdAt = time.Now()
|
|
}
|
|
body := genericWebhookBody{
|
|
Event: EventNotificationCreated,
|
|
DeliveryID: row.ID,
|
|
WebhookID: webhookID,
|
|
Timestamp: createdAt.UTC().Format(time.RFC3339),
|
|
Version: 1,
|
|
Test: test,
|
|
ProfileID: row.ProfileID,
|
|
LibraryID: row.LibraryID,
|
|
Type: row.Type,
|
|
Reasons: parseReasonFlags(row.ReasonFlags),
|
|
}
|
|
if row.SeriesID != nil {
|
|
body.Series = &genericWebhookSeries{ID: *row.SeriesID, Title: row.SeriesTitle}
|
|
}
|
|
if row.EpisodeID != nil {
|
|
body.Episode = &genericWebhookEpisode{
|
|
ID: *row.EpisodeID,
|
|
Title: row.EpisodeTitle,
|
|
SeasonNumber: row.SeasonNumber,
|
|
EpisodeNumber: row.EpisodeNumber,
|
|
}
|
|
}
|
|
if row.Type == DeliveryTypeRequestFulfilled {
|
|
flags := parseRequestFulfilledFlags(row.ReasonFlags)
|
|
body.Request = &genericWebhookRequest{
|
|
ID: flags.RequestID,
|
|
TMDBID: flags.TMDBID,
|
|
MediaType: flags.MediaType,
|
|
}
|
|
}
|
|
return json.Marshal(body)
|
|
}
|
|
|
|
// SignGenericWebhook computes the X-Silo-Signature header value for a body:
|
|
// "t=<epoch>,v1=<hex(hmac_sha256(secret, "<epoch>.<body>"))>", following
|
|
// Stripe's signing convention so receivers can reuse existing verifiers.
|
|
func SignGenericWebhook(secret string, timestamp int64, body []byte) string {
|
|
mac := hmac.New(sha256.New, []byte(secret))
|
|
mac.Write(strconv.AppendInt(nil, timestamp, 10))
|
|
mac.Write([]byte{'.'})
|
|
mac.Write(body)
|
|
return fmt.Sprintf("t=%d,v1=%s", timestamp, hex.EncodeToString(mac.Sum(nil)))
|
|
}
|
|
|
|
// genericWebhookHeaders builds the delivery headers for a generic webhook
|
|
// POST. The timestamp participating in the HMAC is the Unix-epoch header
|
|
// value, not the body's RFC3339 timestamp.
|
|
func genericWebhookHeaders(webhookID, deliveryID, secret string, now time.Time, body []byte) map[string]string {
|
|
timestamp := now.Unix()
|
|
return map[string]string{
|
|
"X-Silo-Event": EventNotificationCreated,
|
|
"X-Silo-Webhook-Id": webhookID,
|
|
"X-Silo-Delivery-Id": deliveryID,
|
|
"X-Silo-Timestamp": fmt.Sprintf("%d", timestamp),
|
|
"X-Silo-Signature": SignGenericWebhook(secret, timestamp, body),
|
|
}
|
|
}
|