Skip to content

armgit / boop

Public Imported from GitHub
0

A tiny, self-hosted notification inbox for developers. Something happened in one of your apps; Boop tells you on your phone.

HTML

feat: silence rules to keep noisy events off your phone

Chris Gregorib034fdf9db0a
diff --git a/README.md b/README.md
index 77ee6e6..56e3483 100644
--- a/README.md
+++ b/README.md
@@ -165,7 +165,7 @@ All endpoints are under `/api/v1`. Errors are JSON: `{"error": "code", "message"
| --- | --- | --- | --- |
| GET | `/health` | none | `{"status":"ok"}` |
| POST | `/api/v1/events` | project key | Create event, returns `{id, created_at}` |
-| GET | `/api/v1/events?project=&level=&source=&before=&limit=` | device or none | List, newest first; `next_cursor` feeds `before` |
+| GET | `/api/v1/events?project=&level=&source=&silenced=&before=&limit=` | device or none | List, newest first; `next_cursor` feeds `before`; `silenced=true\|false` filters |
| GET | `/api/v1/events/:id` | device or none | Full event |
| GET | `/api/v1/events/:id/deliveries` | device or none | Push attempts for an event |
| GET/POST | `/api/v1/projects` | admin | List / create (returns `api_key` once) |
@@ -179,6 +179,10 @@ All endpoints are under `/api/v1`. Errors are JSON: `{"error": "code", "message"
| GET | `/api/v1/devices` | admin | List paired devices |
| GET | `/api/v1/status` | admin | Health, APNs state, counts, last push |
| GET/PATCH | `/api/v1/settings` | admin | `retention_days`, `redact_keys`, `setup_completed` |
+| GET/POST | `/api/v1/silences` | admin | Rules that stop matching events from being pushed: `{field: fingerprint\|title\|source, value, project_id?, note?}` |
+| GET | `/api/v1/silences/:id` | admin | One rule |
+| DELETE | `/api/v1/silences/:id` | admin | Remove a rule (already-silenced events keep their flag) |
+| POST | `/api/v1/events/:id/unsilence` | admin | Clear the flag and push the event now |
| POST | `/api/v1/test` | admin | Create a test event and push it |
Credentials: project keys (`boop_proj_...`) can only create events; device credentials (`boop_dev_...`) can only read events and manage their own device. Only SHA-256 hashes are stored.
@@ -236,6 +240,10 @@ The web UI generates a one-time token (10 minutes, single use, revocable) and sh
The app posts the token to `/api/v1/pairing/exchange`, stores the returned device credential, registers for APNs, and posts its token to `/api/v1/devices`. Registering the same APNs token twice updates the existing device instead of creating a duplicate.
+## Silences
+
+Some events you want stored but not on your phone: a known flaky job, a noisy warning. On any event's page click **Silence events like this** and pick what to match — its fingerprint, its title, or its source — for that project or every project. Matching events still arrive in the inbox (marked *silenced*) and in the iOS app, but no push is sent. Filter the inbox to **Silenced only** to review them; a silenced event's page shows the rule that caught it with **Remove rule** and **Unsilence and push now**. Manage all rules under **Settings → Silences**. Fingerprint and source match exactly; title ignores case.
+
## Redaction
Values under these keys are replaced with `[REDACTED]` anywhere in `data` before storage: `password`, `password_confirmation`, `secret`, `token`, `access_token`, `refresh_token`, `api_key`, `authorization`, `cookie`, `set-cookie`, `private_key`. Matching is case-insensitive and treats `-` and `_` alike. Add your own keys in Settings.
diff --git a/integration-llms.md b/integration-llms.md
index d1a01b5..d76f070 100644
--- a/integration-llms.md
+++ b/integration-llms.md
@@ -95,7 +95,7 @@ Errors are JSON with the same shape everywhere:
| 5xx | `internal` | Server fault | Retry with backoff |
| — | (network error / timeout) | Server unreachable | Retry with backoff |
-Push delivery happens asynchronously after the 201; the response does not tell you whether a phone received it.
+Push delivery happens asynchronously after the 201; the response does not tell you whether a phone received it. The user may have silence rules (by fingerprint, title, or source) that store an event without pushing it — a stable `fingerprint` per distinct problem is what makes those rules useful, so send one when you can.
## Behaviour a good client has
diff --git a/ios/Boop.xcodeproj/project.pbxproj b/ios/Boop.xcodeproj/project.pbxproj
index 02a5b13..913efd0 100644
--- a/ios/Boop.xcodeproj/project.pbxproj
+++ b/ios/Boop.xcodeproj/project.pbxproj
@@ -513,7 +513,7 @@
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
IPHONEOS_DEPLOYMENT_TARGET = 26.0;
- MARKETING_VERSION = 1.0.0;
+ MARKETING_VERSION = 1.1.0;
MTL_ENABLE_DEBUG_INFO = NO;
MTL_FAST_MATH = YES;
PRODUCT_NAME = "$(TARGET_NAME)";
@@ -603,7 +603,7 @@
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
IPHONEOS_DEPLOYMENT_TARGET = 26.0;
- MARKETING_VERSION = 1.0.0;
+ MARKETING_VERSION = 1.1.0;
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = YES;
diff --git a/ios/Boop/Models/Event.swift b/ios/Boop/Models/Event.swift
index 2ad3f9e..2b97011 100644
--- a/ios/Boop/Models/Event.swift
+++ b/ios/Boop/Models/Event.swift
@@ -16,6 +16,8 @@ struct Event: Codable, Identifiable, Hashable, Sendable {
let data: JSONValue
let occurredAt: Date
let createdAt: Date
+ /// True when a silence rule stopped this event from being pushed.
+ let silenced: Bool
enum CodingKeys: String, CodingKey {
case id
@@ -27,6 +29,7 @@ struct Event: Codable, Identifiable, Hashable, Sendable {
case source, type, level, title, body, fingerprint, data
case occurredAt = "occurred_at"
case createdAt = "created_at"
+ case silenced
}
init(from decoder: any Decoder) throws {
@@ -46,11 +49,12 @@ struct Event: Codable, Identifiable, Hashable, Sendable {
data = try c.decodeIfPresent(JSONValue.self, forKey: .data) ?? .object([:])
occurredAt = try c.decode(Date.self, forKey: .occurredAt)
createdAt = try c.decode(Date.self, forKey: .createdAt)
+ silenced = try c.decodeIfPresent(Bool.self, forKey: .silenced) ?? false
}
init(id: String, projectID: String, projectName: String, projectIcon: String = "", source: String = "", type: String = "",
level: Level, title: String, body: String = "", fingerprint: String = "", data: JSONValue = .object([:]),
- occurredAt: Date, createdAt: Date) {
+ occurredAt: Date, createdAt: Date, silenced: Bool = false) {
self.id = id
self.externalID = nil
self.projectID = projectID
@@ -66,6 +70,7 @@ struct Event: Codable, Identifiable, Hashable, Sendable {
self.data = data
self.occurredAt = occurredAt
self.createdAt = createdAt
+ self.silenced = silenced
}
func hash(into hasher: inout Hasher) { hasher.combine(id) }
diff --git a/ios/Boop/Screens/EventDetailView.swift b/ios/Boop/Screens/EventDetailView.swift
index e94680d..0c49894 100644
--- a/ios/Boop/Screens/EventDetailView.swift
+++ b/ios/Boop/Screens/EventDetailView.swift
@@ -34,6 +34,9 @@ struct EventDetailView: View {
ScrollView {
VStack(alignment: .leading, spacing: DS.Space.s4) {
if let event {
+ if event.silenced {
+ Notice(tone: .info, text: "Matched a silence rule, so it was not pushed. Manage silences in the web UI.")
+ }
summary(event)
sections(event)
raw(event)
diff --git a/ios/Boop/Screens/InboxView.swift b/ios/Boop/Screens/InboxView.swift
index 0ae9acb..fbdc4df 100644
--- a/ios/Boop/Screens/InboxView.swift
+++ b/ios/Boop/Screens/InboxView.swift
@@ -221,6 +221,9 @@ struct EventRow: View {
Text(event.projectName).font(DS.Text.caption).foregroundStyle(DS.Colors.textSecondary)
Text("·").foregroundStyle(DS.Colors.textFaint).font(DS.Text.caption)
LevelBadge(level: event.level)
+ if event.silenced {
+ Text("· silenced").font(DS.Text.caption).foregroundStyle(DS.Colors.textInactive)
+ }
}
Text(event.title)
.font(DS.Text.rowTitle)
diff --git a/ios/BoopTests/EventTests.swift b/ios/BoopTests/EventTests.swift
index b020398..4baa481 100644
--- a/ios/BoopTests/EventTests.swift
+++ b/ios/BoopTests/EventTests.swift
@@ -15,13 +15,15 @@ final class EventTests: XCTestCase {
"custom": {"deep": [1, 2, {"k": "v"}]}
},
"occurred_at": "2026-08-28T12:51:44Z",
- "created_at": "2026-08-28T14:10:46.627043000Z"
+ "created_at": "2026-08-28T14:10:46.627043000Z",
+ "silenced": true
}
"""
func testDecodesRichEventAndSections() throws {
let e = try APIClient.decoder.decode(Event.self, from: Data(rich.utf8))
XCTAssertEqual(e.level, .error)
+ XCTAssertTrue(e.silenced)
XCTAssertEqual(e.externalID, "4f9d")
XCTAssertEqual(Calendar(identifier: .gregorian).component(.year, from: e.createdAt), 2026)
// Nanosecond timestamps are accepted and keep millisecond precision.
@@ -45,6 +47,7 @@ final class EventTests: XCTestCase {
let json = #"{"id":"evt_2","project_id":"prj_1","title":"Hi","level":"bogus","occurred_at":"2026-08-28T12:51:44Z","created_at":"2026-08-28T12:51:44Z"}"#
let e = try APIClient.decoder.decode(Event.self, from: Data(json.utf8))
XCTAssertEqual(e.level, .info)
+ XCTAssertFalse(e.silenced)
XCTAssertEqual(e.body, "")
XCTAssertEqual(e.data, .object([:]))
XCTAssertTrue(e.sections.isEmpty)
diff --git a/ios/project.yml b/ios/project.yml
index 24b69ad..ecc31ff 100644
--- a/ios/project.yml
+++ b/ios/project.yml
@@ -9,7 +9,7 @@ options:
settings:
base:
SWIFT_VERSION: "6.0"
- MARKETING_VERSION: "1.0.0"
+ MARKETING_VERSION: "1.1.0"
CURRENT_PROJECT_VERSION: "1"
# Users set their own team in Xcode (Signing & Capabilities).
DEVELOPMENT_TEAM: ""
diff --git a/server/Dockerfile b/server/Dockerfile
index ff3a507..5a90666 100644
--- a/server/Dockerfile
+++ b/server/Dockerfile
@@ -16,7 +16,7 @@ COPY go.mod go.sum ./
RUN go mod download
COPY . .
COPY --from=web /internal/web/dist ./internal/web/dist
-ARG VERSION=1.0.0
+ARG VERSION=1.1.0
RUN CGO_ENABLED=0 go build -trimpath -ldflags="-s -w -X github.com/chrisgreg/boop/server/internal/api.Version=${VERSION}" -o /boop ./cmd/boop
# ---- runtime: binary + CA certificates only ----
diff --git a/server/cmd/boop/main.go b/server/cmd/boop/main.go
index 1221b9a..5fd081c 100644
--- a/server/cmd/boop/main.go
+++ b/server/cmd/boop/main.go
@@ -25,6 +25,7 @@ import (
"github.com/chrisgreg/boop/server/internal/pairing"
"github.com/chrisgreg/boop/server/internal/projects"
"github.com/chrisgreg/boop/server/internal/settings"
+ "github.com/chrisgreg/boop/server/internal/silences"
"github.com/chrisgreg/boop/server/internal/web"
)
@@ -91,7 +92,7 @@ func run() error {
evStore := events.New(db)
srv := &api.Server{
Config: cfg, DB: db, Log: log, Settings: st,
- Projects: projects.New(db), Devices: devStore, Pairing: pairing.New(db, devStore), Events: evStore,
+ Projects: projects.New(db), Devices: devStore, Pairing: pairing.New(db, devStore), Events: evStore, Silences: silences.New(db),
Dispatcher: dispatcher, APNS: client, APNSError: apnsErr, Admin: admin, StartedAt: time.Now(), Web: web.Handler(),
}
diff --git a/server/internal/api/api.go b/server/internal/api/api.go
index 7bf2535..4599a5e 100644
--- a/server/internal/api/api.go
+++ b/server/internal/api/api.go
@@ -24,10 +24,11 @@ import (
"github.com/chrisgreg/boop/server/internal/pairing"
"github.com/chrisgreg/boop/server/internal/projects"
"github.com/chrisgreg/boop/server/internal/settings"
+ "github.com/chrisgreg/boop/server/internal/silences"
)
// Version is the server version, overridden at build time via -ldflags.
-var Version = "1.0.0"
+var Version = "1.1.0"
// Server holds every dependency the handlers need.
type Server struct {
@@ -39,6 +40,7 @@ type Server struct {
Devices *devices.Store
Pairing *pairing.Store
Events *events.Store
+ Silences *silences.Store
Dispatcher *delivery.Dispatcher
APNS *apns.Client // nil when not configured
APNSError string // why APNS is nil
@@ -85,6 +87,11 @@ func (s *Server) Handler() http.Handler {
mux.Handle("PATCH /api/v1/projects/{id}", s.adminAuth(s.updateProject))
mux.Handle("DELETE /api/v1/projects/{id}", s.adminAuth(s.deleteProject))
mux.Handle("POST /api/v1/projects/{id}/rotate-key", s.adminAuth(s.rotateProjectKey))
+ mux.Handle("POST /api/v1/events/{id}/unsilence", s.adminAuth(s.unsilenceEvent))
+ mux.Handle("GET /api/v1/silences/{id}", s.adminAuth(s.getSilence))
+ mux.Handle("GET /api/v1/silences", s.adminAuth(s.listSilences))
+ mux.Handle("POST /api/v1/silences", s.adminAuth(s.createSilence))
+ mux.Handle("DELETE /api/v1/silences/{id}", s.adminAuth(s.deleteSilence))
mux.Handle("GET /api/v1/status", s.adminAuth(s.status))
mux.Handle("GET /api/v1/settings", s.adminAuth(s.getSettings))
mux.Handle("PATCH /api/v1/settings", s.adminAuth(s.updateSettings))
@@ -306,9 +313,9 @@ func readJSON(w http.ResponseWriter, r *http.Request, v any) bool {
// fail maps domain errors to HTTP responses.
func (s *Server) fail(w http.ResponseWriter, err error) {
switch {
- case errors.Is(err, projects.ErrNotFound), errors.Is(err, events.ErrNotFound), errors.Is(err, devices.ErrNotFound), errors.Is(err, pairing.ErrNotFound):
+ case errors.Is(err, projects.ErrNotFound), errors.Is(err, events.ErrNotFound), errors.Is(err, devices.ErrNotFound), errors.Is(err, pairing.ErrNotFound), errors.Is(err, silences.ErrNotFound):
writeError(w, http.StatusNotFound, "not_found", err.Error())
- case errors.Is(err, projects.ErrInvalid), errors.Is(err, events.ErrInvalid), errors.Is(err, devices.ErrInvalid):
+ case errors.Is(err, projects.ErrInvalid), errors.Is(err, events.ErrInvalid), errors.Is(err, devices.ErrInvalid), errors.Is(err, silences.ErrInvalid):
writeError(w, http.StatusUnprocessableEntity, "invalid", err.Error())
case errors.Is(err, pairing.ErrInvalidToken):
writeError(w, http.StatusUnauthorized, "invalid_pairing_token", err.Error())
@@ -523,7 +530,9 @@ func (s *Server) createEvent(w http.ResponseWriter, r *http.Request) {
return
}
s.Log.Info("event.created", "event_id", e.ID, "project_id", p.ID, "event_level", e.Level)
- s.Dispatcher.Enqueue(e, p)
+ if silenced := s.applySilence(r.Context(), &e); !silenced {
+ s.Dispatcher.Enqueue(e, p)
+ }
writeJSON(w, http.StatusCreated, map[string]string{"id": e.ID, "created_at": e.CreatedAt})
}
@@ -534,6 +543,10 @@ func (s *Server) listEvents(w http.ResponseWriter, r *http.Request) {
writeError(w, http.StatusUnprocessableEntity, "invalid", "level must be one of "+strings.Join(levels.All, ", "))
return
}
+ if v := q.Get("silenced"); v != "" {
+ b := v == "true" || v == "1"
+ f.Silenced = &b
+ }
if l := q.Get("limit"); l != "" {
n, err := strconv.Atoi(l)
if err != nil || n <= 0 {
@@ -572,6 +585,102 @@ func (s *Server) eventDeliveries(w http.ResponseWriter, r *http.Request) {
writeJSON(w, http.StatusOK, map[string]any{"deliveries": d})
}
+// applySilence marks e as silenced when a rule matches and reports whether it did.
+func (s *Server) applySilence(ctx context.Context, e *events.Event) bool {
+ rule, err := s.Silences.Match(ctx, e.ProjectID, e.Fingerprint, e.Title, e.Source)
+ if err != nil {
+ s.Log.Error("silence.match_failed", "error", err.Error())
+ return false
+ }
+ if rule == nil {
+ return false
+ }
+ if err := s.Events.SetSilence(ctx, e.ID, rule.ID); err != nil {
+ s.Log.Error("silence.record_failed", "error", err.Error())
+ }
+ e.SilenceID, e.Silenced = rule.ID, true
+ s.Log.Info("event.silenced", "event_id", e.ID, "silence_id", rule.ID)
+ return true
+}
+
+// ---- silences ----
+
+// unsilenceEvent clears the flag and pushes the event now.
+func (s *Server) unsilenceEvent(w http.ResponseWriter, r *http.Request) {
+ ctx := r.Context()
+ e, err := s.Events.Get(ctx, r.PathValue("id"))
+ if err != nil {
+ s.fail(w, err)
+ return
+ }
+ if !e.Silenced {
+ writeError(w, http.StatusUnprocessableEntity, "not_silenced", "this event was not silenced")
+ return
+ }
+ p, err := s.Projects.Get(ctx, e.ProjectID)
+ if err != nil {
+ s.fail(w, err)
+ return
+ }
+ if err := s.Events.ClearSilence(ctx, e.ID); err != nil {
+ s.fail(w, err)
+ return
+ }
+ e.SilenceID, e.Silenced = "", false
+ dl := s.Dispatcher.Deliver(ctx, e, p)
+ if dl == nil {
+ dl = []delivery.Delivery{}
+ }
+ s.Log.Info("event.unsilenced", "event_id", e.ID)
+ writeJSON(w, http.StatusOK, map[string]any{"event": e, "deliveries": dl})
+}
+
+func (s *Server) getSilence(w http.ResponseWriter, r *http.Request) {
+ sil, err := s.Silences.Get(r.Context(), r.PathValue("id"))
+ if err != nil {
+ s.fail(w, err)
+ return
+ }
+ writeJSON(w, http.StatusOK, sil)
+}
+
+func (s *Server) listSilences(w http.ResponseWriter, r *http.Request) {
+ list, err := s.Silences.List(r.Context())
+ if err != nil {
+ s.fail(w, err)
+ return
+ }
+ n, err := s.Events.CountSilenced(r.Context())
+ if err != nil {
+ s.fail(w, err)
+ return
+ }
+ writeJSON(w, http.StatusOK, map[string]any{"silences": list, "fields": silences.Fields, "silenced_events": n})
+}
+
+func (s *Server) createSilence(w http.ResponseWriter, r *http.Request) {
+ var in silences.Input
+ if !readJSON(w, r, &in) {
+ return
+ }
+ sil, err := s.Silences.Create(r.Context(), in)
+ if err != nil {
+ s.fail(w, err)
+ return
+ }
+ s.Log.Info("silence.created", "silence_id", sil.ID, "field", sil.Field)
+ writeJSON(w, http.StatusCreated, sil)
+}
+
+func (s *Server) deleteSilence(w http.ResponseWriter, r *http.Request) {
+ if err := s.Silences.Delete(r.Context(), r.PathValue("id")); err != nil {
+ s.fail(w, err)
+ return
+ }
+ s.Log.Info("silence.deleted", "silence_id", r.PathValue("id"))
+ w.WriteHeader(http.StatusNoContent)
+}
+
// ---- projects ----
func (s *Server) projectIcons(w http.ResponseWriter, r *http.Request) {
@@ -788,7 +897,10 @@ func (s *Server) testNotification(w http.ResponseWriter, r *http.Request) {
return
}
s.Log.Info("event.created", "event_id", e.ID, "project_id", p.ID, "event_level", e.Level, "test", true)
- dl := s.Dispatcher.Deliver(ctx, e, p)
+ var dl []delivery.Delivery
+ if !s.applySilence(ctx, &e) {
+ dl = s.Dispatcher.Deliver(ctx, e, p)
+ }
if dl == nil {
dl = []delivery.Delivery{}
}
diff --git a/server/internal/api/api_test.go b/server/internal/api/api_test.go
index 120a48e..556d901 100644
--- a/server/internal/api/api_test.go
+++ b/server/internal/api/api_test.go
@@ -24,6 +24,7 @@ import (
"github.com/chrisgreg/boop/server/internal/pairing"
"github.com/chrisgreg/boop/server/internal/projects"
"github.com/chrisgreg/boop/server/internal/settings"
+ "github.com/chrisgreg/boop/server/internal/silences"
)
// fakeSender records notifications instead of talking to APNs.
@@ -71,6 +72,7 @@ func newEnv(t *testing.T) *env {
Devices: dev,
Pairing: pairing.New(db, dev),
Events: events.New(db),
+ Silences: silences.New(db),
Dispatcher: delivery.New(db, dev, sender, log),
Admin: auth.NewAdmin("", ""),
StartedAt: time.Now(),
@@ -820,3 +822,152 @@ func TestAdminAuth(t *testing.T) {
t.Errorf("session should be revoked: %d", r.status)
}
}
+
+func TestSilences(t *testing.T) {
+ e := newEnv(t)
+ pid, key := e.createProject("Uini")
+ _, key2 := e.createProject("Infra")
+ _, c := e.pairDevice("phone")
+ e.do("POST", "/api/v1/devices", c, map[string]string{"device_token": "t1"})
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+ e.server.Dispatcher.Start(ctx)
+
+ // Validation.
+ if r := e.do("POST", "/api/v1/silences", "", map[string]string{"field": "regex", "value": "x"}); r.status != 422 {
+ t.Errorf("bad field: %d %s", r.status, r.raw)
+ }
+ if r := e.do("POST", "/api/v1/silences", "", map[string]string{"field": "title", "value": " "}); r.status != 422 {
+ t.Errorf("empty value: %d", r.status)
+ }
+ if r := e.do("POST", "/api/v1/silences", "", map[string]string{"field": "title", "value": "x", "project_id": "prj_nope"}); r.status != 422 {
+ t.Errorf("unknown project: %d %s", r.status, r.raw)
+ }
+
+ // A project-scoped fingerprint rule and a global, case-insensitive title rule.
+ r := e.do("POST", "/api/v1/silences", "", map[string]string{"field": "fingerprint", "value": "noisy-1", "project_id": pid, "note": "known flake"})
+ if r.status != 201 || r.body["project_name"] != "Uini" || r.body["note"] != "known flake" {
+ t.Fatalf("create: %d %s", r.status, r.raw)
+ }
+ fpRule := r.body["id"].(string)
+ r = e.do("POST", "/api/v1/silences", "", map[string]string{"field": "title", "value": "Disk Usage High"})
+ if r.status != 201 {
+ t.Fatalf("create title rule: %d %s", r.status, r.raw)
+ }
+ titleRule := r.body["id"].(string)
+ if r := e.do("GET", "/api/v1/silences", "", nil); len(r.body["silences"].([]any)) != 2 || len(r.body["fields"].([]any)) != 3 {
+ t.Errorf("list: %s", r.raw)
+ }
+
+ sent := func() int { return len(e.sender.sent) }
+ wait := func(n int) {
+ deadline := time.Now().Add(2 * time.Second)
+ for sent() < n && time.Now().Before(deadline) {
+ time.Sleep(10 * time.Millisecond)
+ }
+ }
+ post := func(k string, body map[string]string) map[string]any {
+ r := e.do("POST", "/api/v1/events", k, body)
+ if r.status != 201 {
+ t.Fatalf("post: %d %s", r.status, r.raw)
+ }
+ return e.do("GET", "/api/v1/events/"+r.body["id"].(string), "", nil).body
+ }
+
+ // Silenced by fingerprint in its project: stored, flagged, not pushed.
+ ev := post(key, map[string]string{"title": "Flaky test", "fingerprint": "noisy-1"})
+ time.Sleep(100 * time.Millisecond)
+ if ev["silenced"] != true || ev["silence_id"] != fpRule || sent() != 0 {
+ t.Errorf("fingerprint silence: silenced=%v sent=%d", ev["silenced"], sent())
+ }
+ // Same fingerprint in another project is not covered by the scoped rule.
+ ev = post(key2, map[string]string{"title": "Flaky test", "fingerprint": "noisy-1"})
+ wait(1)
+ if ev["silenced"] != false || sent() != 1 {
+ t.Errorf("scoped rule leaked: silenced=%v sent=%d", ev["silenced"], sent())
+ }
+ // Global title rule, case-insensitive, any project.
+ ev = post(key2, map[string]string{"title": "disk usage HIGH", "level": "warning"})
+ time.Sleep(100 * time.Millisecond)
+ if ev["silenced"] != true || ev["silence_id"] != titleRule || sent() != 1 {
+ t.Errorf("title silence: %v sent=%d", ev, sent())
+ }
+ // Unrelated event still pushes.
+ post(key, map[string]string{"title": "Deploy complete"})
+ wait(2)
+ if sent() != 2 {
+ t.Errorf("unsilenced event should push: sent=%d", sent())
+ }
+ // The inbox exposes the flag.
+ r = e.do("GET", "/api/v1/events?limit=10", "", nil)
+ silencedCount := 0
+ for _, x := range r.body["events"].([]any) {
+ if x.(map[string]any)["silenced"] == true {
+ silencedCount++
+ }
+ }
+ if silencedCount != 2 {
+ t.Errorf("silenced in list = %d", silencedCount)
+ }
+ // Test notifications honour silences too.
+ r = e.do("POST", "/api/v1/silences", "", map[string]string{"field": "title", "value": "Test boop"})
+ testRule := r.body["id"].(string)
+ r = e.do("POST", "/api/v1/test", "", nil)
+ if r.body["event"].(map[string]any)["silenced"] != true || len(r.body["deliveries"].([]any)) != 0 {
+ t.Errorf("test event should be silenced: %s", r.raw)
+ }
+ // Delete: rule gone, later events push again; history keeps its flag.
+ if r := e.do("DELETE", "/api/v1/silences/"+testRule, "", nil); r.status != 204 {
+ t.Errorf("delete: %d", r.status)
+ }
+ if r := e.do("DELETE", "/api/v1/silences/"+testRule, "", nil); r.status != 404 {
+ t.Errorf("double delete: %d", r.status)
+ }
+ e.do("DELETE", "/api/v1/silences/"+fpRule, "", nil)
+ before := sent()
+ post(key, map[string]string{"title": "Flaky test", "fingerprint": "noisy-1"})
+ wait(before + 1)
+ if sent() != before+1 {
+ t.Errorf("after deleting the rule the event should push: %d", sent()-before)
+ }
+ if ev := e.do("GET", "/api/v1/events/"+ev["id"].(string), "", nil).body; ev["silenced"] != true {
+ t.Errorf("history should keep the silenced flag")
+ }
+ // Device credentials cannot manage silences.
+ if r := e.do("GET", "/api/v1/silences", c, nil); r.status != 403 {
+ t.Errorf("device on silences: %d", r.status)
+ }
+
+ // Listing silenced events only, and unsilencing one pushes it now.
+ r = e.do("GET", "/api/v1/events?silenced=true", "", nil)
+ silencedOnly := r.body["events"].([]any)
+ if len(silencedOnly) != 3 {
+ t.Fatalf("silenced=true list: %d %s", len(silencedOnly), r.raw)
+ }
+ for _, x := range silencedOnly {
+ if x.(map[string]any)["silenced"] != true {
+ t.Errorf("non-silenced event in silenced list")
+ }
+ }
+ if r := e.do("GET", "/api/v1/events?silenced=false", "", nil); len(r.body["events"].([]any)) != 3 {
+ t.Errorf("silenced=false list: %s", r.raw)
+ }
+ if r := e.do("GET", "/api/v1/silences", "", nil); r.body["silenced_events"] != float64(3) {
+ t.Errorf("silenced_events count: %s", r.raw)
+ }
+ target := silencedOnly[0].(map[string]any)["id"].(string)
+ if r := e.do("GET", "/api/v1/silences/"+titleRule, "", nil); r.status != 200 || r.body["field"] != "title" {
+ t.Errorf("get silence: %d %s", r.status, r.raw)
+ }
+ before = sent()
+ r = e.do("POST", "/api/v1/events/"+target+"/unsilence", "", nil)
+ if r.status != 200 || r.body["event"].(map[string]any)["silenced"] != false || len(r.body["deliveries"].([]any)) != 1 || sent() != before+1 {
+ t.Errorf("unsilence: %d %s sent=%d", r.status, r.raw, sent()-before)
+ }
+ if r := e.do("POST", "/api/v1/events/"+target+"/unsilence", "", nil); r.status != 422 {
+ t.Errorf("unsilence twice: %d", r.status)
+ }
+ if r := e.do("GET", "/api/v1/events?silenced=true", "", nil); len(r.body["events"].([]any)) != 2 {
+ t.Errorf("after unsilence: %s", r.raw)
+ }
+}
diff --git a/server/internal/events/events.go b/server/internal/events/events.go
index c5a0174..903602e 100644
--- a/server/internal/events/events.go
+++ b/server/internal/events/events.go
@@ -59,6 +59,9 @@ type Event struct {
Data json.RawMessage `json:"data"`
OccurredAt string `json:"occurred_at"`
CreatedAt string `json:"created_at"`
+ // SilenceID is set when a silence rule stopped this event from being pushed.
+ SilenceID string `json:"silence_id,omitempty"`
+ Silenced bool `json:"silenced"`
}
// Filter narrows List.
@@ -68,6 +71,7 @@ type Filter struct {
Source string
Before string // cursor: id of the last event seen
Limit int
+ Silenced *bool // nil = any
}
// Page is a page of events plus the cursor for the next page ("" when exhausted).
@@ -167,14 +171,15 @@ func (s *Store) Create(ctx context.Context, projectID string, in Input, r *redac
return s.Get(ctx, e.ID)
}
-const selectCols = `e.id, COALESCE(e.external_id, ''), e.project_id, p.name, p.slug, p.icon, e.source, e.type, e.level, e.title, e.body, e.fingerprint, e.payload_json, e.occurred_at, e.created_at
+const selectCols = `e.id, COALESCE(e.external_id, ''), e.project_id, p.name, p.slug, p.icon, e.source, e.type, e.level, e.title, e.body, e.fingerprint, e.payload_json, e.occurred_at, e.created_at, COALESCE(e.silence_id, '')
FROM events e JOIN projects p ON p.id = e.project_id`
func scan(row interface{ Scan(...any) error }) (Event, error) {
var e Event
var data string
- err := row.Scan(&e.ID, &e.ExternalID, &e.ProjectID, &e.ProjectName, &e.ProjectSlug, &e.ProjectIcon, &e.Source, &e.Type, &e.Level, &e.Title, &e.Body, &e.Fingerprint, &data, &e.OccurredAt, &e.CreatedAt)
+ err := row.Scan(&e.ID, &e.ExternalID, &e.ProjectID, &e.ProjectName, &e.ProjectSlug, &e.ProjectIcon, &e.Source, &e.Type, &e.Level, &e.Title, &e.Body, &e.Fingerprint, &data, &e.OccurredAt, &e.CreatedAt, &e.SilenceID)
e.Data = json.RawMessage(data)
+ e.Silenced = e.SilenceID != ""
return e, err
}
@@ -209,6 +214,13 @@ func (s *Store) List(ctx context.Context, f Filter) (Page, error) {
where = append(where, "e.source = ?")
args = append(args, f.Source)
}
+ if f.Silenced != nil {
+ if *f.Silenced {
+ where = append(where, "e.silence_id IS NOT NULL")
+ } else {
+ where = append(where, "e.silence_id IS NULL")
+ }
+ }
if f.Before != "" {
var createdAt string
err := s.db.QueryRowContext(ctx, `SELECT created_at FROM events WHERE id = ?`, f.Before).Scan(&createdAt)
@@ -245,6 +257,25 @@ func (s *Store) List(ctx context.Context, f Filter) (Page, error) {
return page, nil
}
+// SetSilence records which rule silenced an event.
+func (s *Store) SetSilence(ctx context.Context, eventID, silenceID string) error {
+ _, err := s.db.ExecContext(ctx, `UPDATE events SET silence_id = ? WHERE id = ?`, silenceID, eventID)
+ return err
+}
+
+// ClearSilence removes the silenced flag from an event.
+func (s *Store) ClearSilence(ctx context.Context, eventID string) error {
+ _, err := s.db.ExecContext(ctx, `UPDATE events SET silence_id = NULL WHERE id = ?`, eventID)
+ return err
+}
+
+// CountSilenced returns how many stored events were silenced.
+func (s *Store) CountSilenced(ctx context.Context) (int, error) {
+ var n int
+ err := s.db.QueryRowContext(ctx, `SELECT COUNT(*) FROM events WHERE silence_id IS NOT NULL`).Scan(&n)
+ return n, err
+}
+
// Count returns the total number of stored events.
func (s *Store) Count(ctx context.Context) (int, error) {
var n int
diff --git a/server/internal/silences/silences.go b/server/internal/silences/silences.go
new file mode 100644
index 0000000..af1c999
--- /dev/null
+++ b/server/internal/silences/silences.go
@@ -0,0 +1,169 @@
+// Package silences stores rules that stop matching events from triggering a push.
+// Silenced events are still stored and shown; they just never reach a phone.
+package silences
+
+import (
+ "context"
+ "database/sql"
+ "errors"
+ "fmt"
+ "strings"
+
+ "github.com/chrisgreg/boop/server/internal/ids"
+)
+
+// ErrNotFound is returned for unknown silence ids.
+var ErrNotFound = errors.New("silence not found")
+
+// ErrInvalid wraps validation failures.
+var ErrInvalid = errors.New("invalid silence")
+
+// Fields a silence can match on.
+const (
+ FieldFingerprint = "fingerprint"
+ FieldTitle = "title"
+ FieldSource = "source"
+)
+
+// Fields lists the supported match fields.
+var Fields = []string{FieldFingerprint, FieldTitle, FieldSource}
+
+// Silence is one rule. ProjectID empty means every project.
+type Silence struct {
+ ID string `json:"id"`
+ ProjectID string `json:"project_id,omitempty"`
+ ProjectName string `json:"project_name,omitempty"`
+ Field string `json:"field"`
+ Value string `json:"value"`
+ Note string `json:"note"`
+ CreatedAt string `json:"created_at"`
+}
+
+// Input creates a silence.
+type Input struct {
+ ProjectID string `json:"project_id"`
+ Field string `json:"field"`
+ Value string `json:"value"`
+ Note string `json:"note"`
+}
+
+// Store persists silences.
+type Store struct {
+ db *sql.DB
+}
+
+// New returns a Store.
+func New(db *sql.DB) *Store { return &Store{db: db} }
+
+const cols = `s.id, COALESCE(s.project_id, ''), COALESCE(p.name, ''), s.field, s.value, s.note, s.created_at
+ FROM silences s LEFT JOIN projects p ON p.id = s.project_id`
+
+func scan(row interface{ Scan(...any) error }) (Silence, error) {
+ var s Silence
+ err := row.Scan(&s.ID, &s.ProjectID, &s.ProjectName, &s.Field, &s.Value, &s.Note, &s.CreatedAt)
+ return s, err
+}
+
+// Create validates and inserts a rule.
+func (st *Store) Create(ctx context.Context, in Input) (Silence, error) {
+ field := strings.ToLower(strings.TrimSpace(in.Field))
+ if !contains(Fields, field) {
+ return Silence{}, fmt.Errorf("%w: field must be one of %s", ErrInvalid, strings.Join(Fields, ", "))
+ }
+ value := strings.TrimSpace(in.Value)
+ if value == "" {
+ return Silence{}, fmt.Errorf("%w: value is required", ErrInvalid)
+ }
+ if len(value) > 200 {
+ return Silence{}, fmt.Errorf("%w: value must be 200 characters or fewer", ErrInvalid)
+ }
+ if len(in.Note) > 500 {
+ return Silence{}, fmt.Errorf("%w: note must be 500 characters or fewer", ErrInvalid)
+ }
+ s := Silence{ID: ids.New("sil"), ProjectID: strings.TrimSpace(in.ProjectID), Field: field, Value: value, Note: strings.TrimSpace(in.Note), CreatedAt: ids.Now()}
+ var project any
+ if s.ProjectID != "" {
+ project = s.ProjectID
+ }
+ _, err := st.db.ExecContext(ctx, `INSERT INTO silences (id, project_id, field, value, note, created_at) VALUES (?,?,?,?,?,?)`,
+ s.ID, project, s.Field, s.Value, s.Note, s.CreatedAt)
+ if err != nil {
+ if strings.Contains(err.Error(), "FOREIGN KEY") {
+ return Silence{}, fmt.Errorf("%w: unknown project", ErrInvalid)
+ }
+ return Silence{}, err
+ }
+ return st.Get(ctx, s.ID)
+}
+
+// Get returns one silence.
+func (st *Store) Get(ctx context.Context, id string) (Silence, error) {
+ s, err := scan(st.db.QueryRowContext(ctx, `SELECT `+cols+` WHERE s.id = ?`, id))
+ if errors.Is(err, sql.ErrNoRows) {
+ return Silence{}, ErrNotFound
+ }
+ return s, err
+}
+
+// List returns every silence, newest first.
+func (st *Store) List(ctx context.Context) ([]Silence, error) {
+ rows, err := st.db.QueryContext(ctx, `SELECT `+cols+` ORDER BY s.created_at DESC`)
+ if err != nil {
+ return nil, err
+ }
+ defer rows.Close()
+ out := []Silence{}
+ for rows.Next() {
+ s, err := scan(rows)
+ if err != nil {
+ return nil, err
+ }
+ out = append(out, s)
+ }
+ return out, rows.Err()
+}
+
+// Delete removes a rule. Events it silenced keep their history.
+func (st *Store) Delete(ctx context.Context, id string) error {
+ res, err := st.db.ExecContext(ctx, `DELETE FROM silences WHERE id = ?`, id)
+ if err != nil {
+ return err
+ }
+ if n, _ := res.RowsAffected(); n == 0 {
+ return ErrNotFound
+ }
+ return nil
+}
+
+// Match returns the first silence that applies to an event with these values
+// (fingerprint and source exact, title case-insensitive), scoped to projectID
+// or global. Returns nil when nothing matches.
+func (st *Store) Match(ctx context.Context, projectID, fingerprint, title, source string) (*Silence, error) {
+ rows, err := st.db.QueryContext(ctx, `SELECT `+cols+` WHERE (s.project_id IS NULL OR s.project_id = ?) AND (
+ (s.field = 'fingerprint' AND ? <> '' AND s.value = ?) OR
+ (s.field = 'source' AND ? <> '' AND s.value = ?) OR
+ (s.field = 'title' AND lower(s.value) = lower(?)))
+ ORDER BY s.project_id IS NULL, s.created_at LIMIT 1`,
+ projectID, fingerprint, fingerprint, source, source, title)
+ if err != nil {
+ return nil, err
+ }
+ defer rows.Close()
+ if !rows.Next() {
+ return nil, rows.Err()
+ }
+ s, err := scan(rows)
+ if err != nil {
+ return nil, err
+ }
+ return &s, nil
+}
+
+func contains(list []string, s string) bool {
+ for _, x := range list {
+ if x == s {
+ return true
+ }
+ }
+ return false
+}
diff --git a/server/migrations/0002_silences.sql b/server/migrations/0002_silences.sql
new file mode 100644
index 0000000..88d2522
--- /dev/null
+++ b/server/migrations/0002_silences.sql
@@ -0,0 +1,11 @@
+CREATE TABLE silences (
+ id TEXT PRIMARY KEY,
+ project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+ field TEXT NOT NULL,
+ value TEXT NOT NULL,
+ note TEXT NOT NULL DEFAULT '',
+ created_at TEXT NOT NULL
+);
+CREATE INDEX silences_lookup ON silences(field, value);
+
+ALTER TABLE events ADD COLUMN silence_id TEXT;
diff --git a/server/web/src/lib/api.ts b/server/web/src/lib/api.ts
index 7cb2cf0..6fb130d 100644
--- a/server/web/src/lib/api.ts
+++ b/server/web/src/lib/api.ts
@@ -34,6 +34,20 @@ export interface Event {
data: Record<string, unknown>
occurred_at: string
created_at: string
+ silenced: boolean
+ silence_id?: string
+}
+
+export type SilenceField = 'fingerprint' | 'title' | 'source'
+
+export interface Silence {
+ id: string
+ project_id?: string
+ project_name?: string
+ field: SilenceField
+ value: string
+ note: string
+ created_at: string
}
export interface EventPage {
@@ -151,7 +165,7 @@ export const api = {
settings: () => request<Settings>('GET', '/api/v1/settings'),
updateSettings: (patch: Partial<Settings>) => request<Settings>('PATCH', '/api/v1/settings', patch),
- events: (params: { project?: string; level?: string; source?: string; before?: string; limit?: number } = {}) => {
+ events: (params: { project?: string; level?: string; source?: string; before?: string; limit?: number; silenced?: string } = {}) => {
const q = new URLSearchParams()
for (const [k, v] of Object.entries(params)) if (v !== undefined && v !== '') q.set(k, String(v))
const qs = q.toString()
@@ -175,6 +189,12 @@ export const api = {
pendingPairings: () => request<{ pairing_tokens: PairingToken[] }>('GET', '/api/v1/pairing'),
revokePairing: (id: string) => request<void>('DELETE', `/api/v1/pairing/${id}`),
+ silences: () => request<{ silences: Silence[]; fields: SilenceField[]; silenced_events: number }>('GET', '/api/v1/silences'),
+ silence: (id: string) => request<Silence>('GET', `/api/v1/silences/${id}`),
+ unsilence: (eventId: string) => request<{ event: Event; deliveries: Delivery[] }>('POST', `/api/v1/events/${encodeURIComponent(eventId)}/unsilence`),
+ createSilence: (input: { field: SilenceField; value: string; project_id?: string; note?: string }) => request<Silence>('POST', '/api/v1/silences', input),
+ deleteSilence: (id: string) => request<void>('DELETE', `/api/v1/silences/${id}`),
+
test: (project_id?: string) =>
request<{ event: Event; deliveries: Delivery[]; apns_configured: boolean }>('POST', '/api/v1/test', project_id ? { project_id } : {}),
}
diff --git a/server/web/src/pages/EventDetail.svelte b/server/web/src/pages/EventDetail.svelte
index 1d6e62f..7d8e2f9 100644
--- a/server/web/src/pages/EventDetail.svelte
+++ b/server/web/src/pages/EventDetail.svelte
@@ -1,5 +1,5 @@
<script lang="ts">
- import { api, type Event, type Delivery } from '../lib/api'
+ import { api, type Event, type Delivery, type Silence } from '../lib/api'
import { link } from '../lib/router.svelte'
import { fullDate, relative } from '../lib/format'
import Card from '../lib/ui/Card.svelte'
@@ -10,7 +10,8 @@
import Empty from '../lib/ui/Empty.svelte'
import StatusDot from '../lib/ui/StatusDot.svelte'
import ProjectIcon from '../lib/ui/ProjectIcon.svelte'
- import { panel } from '../lib/motion'
+ import { panel, pop } from '../lib/motion'
+ import Button from '../lib/ui/Button.svelte'
import Skeleton from '../lib/ui/Skeleton.svelte'
let { id }: { id: string } = $props()
@@ -18,11 +19,70 @@
let deliveries = $state<Delivery[]>([])
let error = $state('')
let showRaw = $state(false)
+ let silenceOpen = $state(false)
+ let silenceDone = $state<string | null>(null)
+ let silenceBusy = $state(false)
+ let rule = $state<Silence | null>(null)
+
+ async function loadRule(e: Event) {
+ rule = null
+ if (e.silence_id) rule = await api.silence(e.silence_id).catch(() => null)
+ }
+
+ async function removeRule() {
+ if (!rule) return
+ silenceBusy = true
+ try {
+ await api.deleteSilence(rule.id)
+ silenceDone = `Removed the ${rule.field} rule. Future matches will be pushed again; this event stays marked as silenced.`
+ rule = null
+ } catch (e: any) {
+ error = e.message
+ } finally {
+ silenceBusy = false
+ }
+ }
+
+ async function unsilence() {
+ if (!event) return
+ silenceBusy = true
+ try {
+ const r = await api.unsilence(event.id)
+ event = r.event
+ deliveries = r.deliveries
+ silenceDone = r.deliveries.length ? `Pushed to ${r.deliveries.length} device${r.deliveries.length === 1 ? '' : 's'}.` : 'Unsilenced. No paired phones with push registered, so nothing was sent.'
+ } catch (e: any) {
+ error = e.message
+ } finally {
+ silenceBusy = false
+ }
+ }
+
+ async function silence(field: 'fingerprint' | 'title' | 'source', scoped: boolean) {
+ if (!event) return
+ silenceBusy = true
+ try {
+ const value = field === 'fingerprint' ? event.fingerprint : field === 'title' ? event.title : event.source
+ const s = await api.createSilence({ field, value, project_id: scoped ? event.project_id : undefined, note: `From event ${event.id}` })
+ silenceDone = `Silenced ${field} "${s.value}"${scoped ? ` in ${event.project_name}` : ' in every project'}. Future matches are stored but not pushed.`
+ silenceOpen = false
+ } catch (e: any) {
+ error = e.message
+ } finally {
+ silenceBusy = false
+ }
+ }
$effect(() => {
event = null
error = ''
- api.event(id).then((e) => (event = e)).catch((e) => (error = e.message))
+ api
+ .event(id)
+ .then((e) => {
+ event = e
+ loadRule(e)
+ })
+ .catch((e) => (error = e.message))
api.eventDeliveries(id).then((r) => (deliveries = r.deliveries)).catch(() => {})
})
@@ -43,7 +103,25 @@
</script>
<div class="stack">
- <div class="crumb"><a href="/" onclick={link}>Inbox</a><span class="faint">/</span><span class="muted mono">{id}</span></div>
+ <div class="crumb-row">
+ <div class="crumb"><a href="/" onclick={link}>Inbox</a><span class="faint">/</span><span class="muted mono">{id}</span></div>
+ {#if event}
+ <Button variant="secondary" size="sm" onclick={() => (silenceOpen = !silenceOpen)} disabled={silenceBusy}>{silenceOpen ? 'Cancel' : 'Silence events like this'}</Button>
+ {/if}
+ </div>
+ {#if event && silenceOpen}
+ <div class="silence-menu" in:pop>
+ <span class="caption muted">Stop pushes for future events matching:</span>
+ {#if event.fingerprint}
+ <button type="button" onclick={() => silence('fingerprint', true)}>fingerprint <span class="mono">{event.fingerprint}</span> <span class="muted">· {event.project_name}</span></button>
+ {/if}
+ <button type="button" onclick={() => silence('title', true)}>title “{event.title}” <span class="muted">· {event.project_name}</span></button>
+ <button type="button" onclick={() => silence('title', false)}>title “{event.title}” <span class="muted">· every project</span></button>
+ {#if event.source}
+ <button type="button" onclick={() => silence('source', true)}>source <span class="mono">{event.source}</span> <span class="muted">· {event.project_name}</span></button>
+ {/if}
+ </div>
+ {/if}
{#if error}
<Notice tone="bad">{error}</Notice>
@@ -61,6 +139,28 @@
<Card><Skeleton lines={4} height={12} widths={['30%', '95%', '85%', '60%']} /></Card>
{:else}
<div class="stack rise">
+ {#if event.silenced}
+ <Card title="Silenced">
+ <p class="secondary lead">This event matched a silence rule and was not pushed to any phone.</p>
+ {#if rule}
+ <div class="rule">
+ <span class="pill">{rule.field}</span>
+ <span class="mono">{rule.value}</span>
+ <span class="muted caption">· {rule.project_name || 'every project'}{rule.note ? ` · ${rule.note}` : ''}</span>
+ </div>
+ {:else}
+ <p class="muted caption">The rule that silenced it has since been removed.</p>
+ {/if}
+ <div class="row" style="margin-top: 12px; flex-wrap: wrap">
+ <Button variant="secondary" size="sm" onclick={unsilence} disabled={silenceBusy}>Unsilence and push now</Button>
+ {#if rule}<Button variant="danger" size="sm" onclick={removeRule} disabled={silenceBusy}>Remove rule</Button>{/if}
+ <a href="/?silenced=true" onclick={link} class="small">All silenced events</a>
+ </div>
+ </Card>
+ {/if}
+ {#if silenceDone}
+ <div transition:panel><Notice tone="good">{silenceDone}</Notice></div>
+ {/if}
<Card>
<div class="head">
<div class="meta">
@@ -73,6 +173,7 @@
<h1>{event.title}</h1>
{#if event.body}<p class="body">{event.body}</p>{/if}
</div>
+
<div class="facts">
<div><span class="k">Occurred</span><span title={event.occurred_at}>{fullDate(event.occurred_at)}</span></div>
<div><span class="k">Received</span><span title={event.created_at}>{fullDate(event.created_at)} · {relative(event.created_at)}</span></div>
@@ -208,6 +309,13 @@
.meta { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; font: var(--up-type-meta); }
h1 { font: var(--up-type-metric); letter-spacing: -0.01em; word-break: break-word; }
.body { font: var(--up-type-status-line); color: var(--up-text-secondary); white-space: pre-wrap; word-break: break-word; }
+ .crumb-row { display: flex; align-items: center; justify-content: space-between; gap: var(--up-space-3); }
+ .silence-menu { display: flex; flex-direction: column; gap: 4px; padding: 10px; border: 1px solid var(--up-border-hairline); border-radius: var(--up-radius-tooltip); background: var(--up-bg); }
+ .rule { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; font: var(--up-type-meta); }
+ .pill { font: var(--up-type-code); padding: 3px 10px; border-radius: var(--up-radius-pill); background: var(--up-accent-tint); color: var(--up-accent-hover); }
+ .lead { font: var(--up-type-meta); line-height: 1.6; }
+ .silence-menu button { text-align: left; background: none; border: none; cursor: pointer; font: var(--up-type-meta); color: var(--up-ink); padding: 8px 10px; border-radius: var(--up-radius-control); transition: background 120ms ease-out; }
+ .silence-menu button:hover { background: var(--up-bg-hover); }
.facts { display: grid; grid-template-columns: 1fr 1fr; gap: 8px 24px; margin-top: var(--up-space-5); padding-top: var(--up-space-4); border-top: 1px solid var(--up-border-hairline); }
.facts > div { display: flex; flex-direction: column; gap: 2px; font: var(--up-type-meta); min-width: 0; }
.facts span:last-child { overflow: hidden; text-overflow: ellipsis; }
diff --git a/server/web/src/pages/Inbox.svelte b/server/web/src/pages/Inbox.svelte
index 13d096a..9ddc9b9 100644
--- a/server/web/src/pages/Inbox.svelte
+++ b/server/web/src/pages/Inbox.svelte
@@ -21,6 +21,7 @@
let error = $state('')
let project = $state('')
let level = $state('')
+ let silenced = $state(typeof location !== 'undefined' ? new URLSearchParams(location.search).get('silenced') ?? '' : '')
let now = $state(new Date())
async function load(reset = true) {
@@ -28,7 +29,7 @@
error = ''
if (reset) loading = true
else loadingMore = true
- const page = await api.events({ project, level, before: reset ? undefined : cursor, limit: 50 })
+ const page = await api.events({ project, level, silenced, before: reset ? undefined : cursor, limit: 50 })
events = reset ? page.events : [...events, ...page.events]
cursor = page.next_cursor
now = new Date()
@@ -43,6 +44,7 @@
$effect(() => {
project
level
+ silenced
load(true)
})
$effect(() => {
@@ -75,6 +77,7 @@
aria-label="Project"
/>
<Select bind:value={level} options={[{ value: '', label: 'All levels' }, ...LEVELS.map((l) => ({ value: l, label: LEVEL_LABEL[l] }))]} aria-label="Level" />
+ <Select bind:value={silenced} options={[{ value: '', label: 'Pushed and silenced' }, { value: 'true', label: 'Silenced only' }, { value: 'false', label: 'Pushed only' }]} aria-label="Silenced" />
<span class="spacer"></span>
<Button variant="secondary" size="sm" onclick={() => load(true)} disabled={loading}>Refresh</Button>
</div>
@@ -88,7 +91,7 @@
<div class="group">&nbsp;</div>
<Skeleton rows={6} />
{:else if events.length === 0}
- <Empty title="No events yet">
+ <Empty title={silenced === 'true' ? 'No silenced events' : 'No events yet'}>
{#if projects.length === 0}
<a href="/projects" onclick={link}>Create a project</a> to get an API key, then send your first boop.
{:else}
@@ -108,7 +111,10 @@
<div class="title">{e.title}</div>
{#if e.body}<div class="body">{e.body}</div>{/if}
</div>
- <div class="lvl"><LevelBadge level={e.level} /></div>
+ <div class="lvl">
+ <LevelBadge level={e.level} />
+ {#if e.silenced}<span class="silenced caption">silenced</span>{/if}
+ </div>
<div class="time" title={e.created_at}>{relative(e.created_at, now)}</div>
</a>
{/each}
@@ -149,6 +155,8 @@
.title { font: var(--up-type-row-title); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.body { font: var(--up-type-meta); color: var(--up-text-muted); margin-top: 2px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.time { font: var(--up-type-caption); color: var(--up-text-muted); text-align: right; }
+ .lvl { display: flex; flex-direction: column; align-items: flex-start; gap: 2px; }
+ .silenced { color: var(--up-text-inactive); }
.more { display: flex; justify-content: center; padding: 10px 0 4px; }
@media (max-width: 600px) {
.ev { grid-template-columns: 1fr auto; grid-template-rows: auto auto; }
diff --git a/server/web/src/pages/Settings.svelte b/server/web/src/pages/Settings.svelte
index 5d128d8..2f62e1d 100644
--- a/server/web/src/pages/Settings.svelte
+++ b/server/web/src/pages/Settings.svelte
@@ -1,5 +1,5 @@
<script lang="ts">
- import { api, type Status, type Settings, type Project, type Delivery } from '../lib/api'
+ import { api, type Status, type Settings, type Project, type Delivery, type Silence, type SilenceField } from '../lib/api'
import { relative, duration, retentionLabel, compact } from '../lib/format'
import Card from '../lib/ui/Card.svelte'
import Button from '../lib/ui/Button.svelte'
@@ -12,6 +12,7 @@
import Metric from '../lib/ui/Metric.svelte'
import { panel, pop, reorder, soft } from '../lib/motion'
import Skeleton from '../lib/ui/Skeleton.svelte'
+ import { link } from '../lib/router.svelte'
let status = $state<Status | null>(null)
let settings = $state<Settings | null>(null)
@@ -21,11 +22,49 @@
let testResult = $state<{ deliveries: Delivery[]; apns_configured: boolean } | null>(null)
let newKey = $state('')
let testProject = $state('')
+ let silences = $state<Silence[]>([])
+ let silencedEvents = $state(0)
+ let silField = $state<SilenceField>('title')
+ let silValue = $state('')
+ let silProject = $state('')
+ let silNote = $state('')
+
+ async function loadSilences() {
+ try {
+ const r = await api.silences()
+ silences = r.silences
+ silencedEvents = r.silenced_events
+ } catch (e: any) {
+ error = e.message
+ }
+ }
+
+ async function addSilence() {
+ if (!silValue.trim()) return
+ try {
+ await api.createSilence({ field: silField, value: silValue.trim(), project_id: silProject || undefined, note: silNote.trim() || undefined })
+ silValue = ''
+ silNote = ''
+ await loadSilences()
+ } catch (e: any) {
+ error = e.message
+ }
+ }
+
+ async function removeSilence(s: Silence) {
+ try {
+ await api.deleteSilence(s.id)
+ silences = silences.filter((x) => x.id !== s.id)
+ } catch (e: any) {
+ error = e.message
+ }
+ }
async function load() {
try {
;[status, settings] = await Promise.all([api.status(), api.settings()])
projects = (await api.projects()).projects
+ await loadSilences()
} catch (e: any) {
error = e.message
}
@@ -195,6 +234,40 @@
</SettingRow>
</Card>
+ <Card title="Silences">
+ <p class="secondary lead">Events matching a rule are still stored and shown, but never pushed to a phone. Add rules from an event's page or here. Fingerprint and source match exactly; title ignores case.</p>
+ <p class="lead" style="margin-top: 8px"><a href="/?silenced=true" onclick={link}>{silencedEvents} silenced event{silencedEvents === 1 ? '' : 's'}</a> · open one to unsilence it or push it now.</p>
+ {#if silences.length === 0}
+ <p class="muted" style="margin-top: 12px">No silences.</p>
+ {:else}
+ <div class="sils" style="margin-top: 12px">
+ {#each silences as s (s.id)}
+ <div class="sil" animate:reorder out:soft>
+ <div class="sil-main">
+ <span class="pill custom">{s.field}</span>
+ <span class="mono sv">{s.value}</span>
+ <span class="muted caption">· {s.project_name || 'every project'}{s.note ? ` · ${s.note}` : ''} · {relative(s.created_at)}</span>
+ </div>
+ <Button variant="danger" size="sm" onclick={() => removeSilence(s)}>Remove</Button>
+ </div>
+ {/each}
+ </div>
+ {/if}
+ <form
+ class="sil-form"
+ onsubmit={(e) => {
+ e.preventDefault()
+ addSilence()
+ }}
+ >
+ <Select bind:value={silField} options={[{ value: 'title', label: 'Title' }, { value: 'fingerprint', label: 'Fingerprint' }, { value: 'source', label: 'Source' }]} style="width: 130px" aria-label="Field" />
+ <Input bind:value={silValue} placeholder="Value to match" aria-label="Value" mono />
+ <Select bind:value={silProject} options={[{ value: '', label: 'Every project' }, ...projects.map((p) => ({ value: p.id, label: p.name }))]} style="width: 160px" aria-label="Project" />
+ <Input bind:value={silNote} placeholder="Note (optional)" aria-label="Note" style="width: 180px" />
+ <Button variant="secondary" type="submit" disabled={!silValue.trim()}>Add</Button>
+ </form>
+ </Card>
+
<Card title="Redaction">
<p class="secondary lead">Values under these keys are replaced with [REDACTED] anywhere in event data before it is stored. Matching ignores case and treats - and _ the same.</p>
<div class="keys" style="margin-top: 12px">
@@ -228,6 +301,13 @@
.k { font: var(--up-type-caption); color: var(--up-text-muted); }
.lead { font: var(--up-type-meta); line-height: 1.6; }
.keys { display: flex; flex-wrap: wrap; gap: 8px; }
+ .sils { display: flex; flex-direction: column; gap: 6px; }
+ .sil { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 8px 10px; border-radius: var(--up-radius-control); transition: background 120ms ease-out; }
+ .sil:hover { background: var(--up-bg-hover); }
+ .sil-main { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; min-width: 0; font: var(--up-type-meta); }
+ .sv { word-break: break-all; }
+ .sil-form { display: flex; gap: 8px; margin-top: 16px; flex-wrap: wrap; align-items: center; }
+ .sil-form :global(input:nth-of-type(1)) { flex: 1; min-width: 160px; }
.pill { display: inline-flex; align-items: center; gap: 6px; font: var(--up-type-code); padding: 4px 10px; border-radius: var(--up-radius-pill); background: var(--up-bg-hover); box-shadow: var(--up-ring-inset); }
.pill.custom { background: var(--up-accent-tint); color: var(--up-accent-hover); }
.pill button { background: none; border: none; cursor: pointer; color: inherit; font-size: 14px; line-height: 1; padding: 0; }