Skip to content

feat: email check frontend (spec 03) - #30

Merged
fclairamb merged 12 commits into
mainfrom
feat/email-check-frontend
May 2, 2026
Merged

feat: email check frontend (spec 03)#30
fclairamb merged 12 commits into
mainfrom
feat/email-check-frontend

Conversation

@fclairamb

@fclairamb fclairamb commented May 2, 2026

Copy link
Copy Markdown
Owner

Summary

Implements spec 03 — email passive checks frontend & admin UX: surfaces the JMAP/email check work from specs 01–02 in the dash0 dashboard.

  • Backend addition: GET /api/v1/system/parameters/email_inbox/public (any authenticated user) returns just the addressDomain so per-check email addresses can be rendered without exposing the full credentials. Empty domain when the inbox isn't configured.
  • API hooks (web/dash0/src/api/email-inbox.ts): typed React Query hooks for public domain, status, save config, test, sync, plus emailCheckAddress(token, domain, status?) helper.
  • Check create form: new "Email" entry mirrors heartbeat's UX (Expected Interval, no config fields). Shows admin-pointer alert when inbox unconfigured, otherwise an explainer about plus-addressing/[STATUS] tags.
  • Check detail: new EmailEndpoint component renders <token>@<domain> with copy button, mailto: test link, and a collapsible "reporting failure" panel listing the three options (plus-address, X-SolidPing-Status header, [STATUS] subject).
  • Check list: Target column shows <token-prefix>…@<domain> for email checks with the full address as a hover tooltip.
  • Admin Email Inbox page (/orgs/$org/server/email-inbox, super-admin only): Configuration form, live Status (5s poll), Test/Sync action buttons. Wired into the Server tab nav.

Test plan

  • make build-backend passes
  • make lint-back clean
  • make test (backend) passes
  • make build-dash0 / build-dash / build-status0 all green
  • TanStack route tree regenerated
  • Manual smoke test against a real JMAP server (deferred — needs a configured inbox)

🤖 Generated with Claude Code

fclairamb added 10 commits May 2, 2026 04:40
@fclairamb
chore: start implementing Email Check Frontend (spec 03)
1c811e0
@fclairamb
docs: add implementation plan for Email Check Frontend
1c1ade1
@fclairamb
feat: add GET /system/parameters/email_inbox/public endpoint
a0f8b13 
Step 1 of email-check-frontend: any authenticated user needs to
read the inbox addressDomain so the per-check email address can
be rendered. The full email_inbox parameter stays super-admin-
only because it carries credentials.

Returns {addressDomain: ""} when the inbox isn't configured —
the UI uses that as the "configure first" placeholder signal.
@fclairamb
feat: add email-inbox API hooks and types in dash0
abd8c36 
Step 2 of email-check-frontend: typed React Query hooks for the
email_inbox endpoints — public addressDomain projection, live
status (5s poll), test connection, sync now, save config.
Plus the emailCheckAddress() helper that builds
<token>[+status]@<domain> for the per-check address.

Adds "email" to the Check.type union so the rest of the form /
list / detail code can switch on it.
@fclairamb
feat: add email check type to the create form
0650a2e 
Step 3 of email-check-frontend: extend check-form with an
"email" entry that mirrors heartbeat's UX (Expected Interval,
no config fields). When the email inbox isn't configured, show
an admin-pointer alert; otherwise show an explainer about plus-
addressing and the [STATUS] subject tag.

Refactored the inline `type === "heartbeat"` checks into an
isPassiveType() helper since heartbeat and email share the same
period semantics.
@fclairamb
feat: render email endpoint on check detail page
5af52fa 
Step 4 of email-check-frontend: when a check has type "email",
the configuration card now renders the per-check address with
a copy-to-clipboard button, a mailto: test link, and a
collapsible help panel listing the three failure-reporting
options (plus-address, header, subject prefix).

When the inbox isn't configured the component degrades to a
"contact your administrator" placeholder — the check itself
still exists, it just can't receive pings yet.
@fclairamb
feat: render truncated email address in checks list target column
bb150e4 
Step 5 of email-check-frontend: for email-type checks, the
Target column now shows <token-prefix>…@<domain> in monospace
with the full address as a hover tooltip. Falls back to the
slug when domain or token is missing.
@fclairamb
feat: add admin Email Inbox configuration page
ca9049f 
Step 6 of email-check-frontend: new super-admin route at
/orgs/$org/server/email-inbox with three sections:

- Configuration: form bound to the email_inbox system parameter
  (enable, JMAP session URL, credentials, address domain,
  mailbox names, retention windows, optional rewriteBaseUrl).
  Empty password field keeps the existing password.
- Status: live JMAP supervisor state polled every 5s — connected
  pill, last sync relative time, last error.
- Actions: Test Connection / Sync Now buttons with toast-style
  feedback.

Wired into the Server tab nav, so super-admins can reach it
from the same nav as Mail / Auth / Performance.
@fclairamb
chore: all checks passing for Email Check Frontend
d557812
@fclairamb
docs: archive completed spec Email Check Frontend
b17c755
@fclairamb
fclairamb enabled auto-merge (squash) May 2, 2026 02:50
fclairamb added 2 commits May 2, 2026 05:10
@fclairamb
test(e2e): disambiguate Mail tab locator from Email Inbox
6b99a4c 
The new Email Inbox tab makes name: "Mail" match both links by
substring. Switch the existing Mail-tab tests to exact: true so
they don't pick up the new tab.
@fclairamb
Merge branch 'main' into feat/email-check-frontend
c08f14d
@fclairamb
fclairamb merged commit aebd106 into main May 2, 2026
10 checks passed
@fclairamb
fclairamb deleted the feat/email-check-frontend branch May 2, 2026 03:20
@fclairamb fclairamb mentioned this pull request May 2, 2026
Merged
fclairamb added a commit that referenced this pull request Jun 23, 2026
@fclairamb
chore(release): v0.1.0 (#4)
3cd305f 
🤖 I have created a release *beep* *boop*
---


##
[0.1.0](v0.0.0...v0.1.0)
(2026-06-22)


### Features

* add check type registry, sample configs, notification senders, and
observability integrations
([eea049e](eea049e))
* batch — Warning/Degraded statuses, SSL/Docker check upgrades, MCP
OAuth 2.1, config-as-code
([#85](#85))
([936d830](936d830))
* batch spec implementations (dashboard UI, jobs, notifications, SaaS,
perf) ([#78](#78))
([fe003e4](fe003e4))
* bulk feature integration (discovery, web push, badges, webhooks, and
more) ([#73](#73))
([a976856](a976856))
* custom user-agent, refresh checks, vite plugin switch, CI updates
([#1](#1))
([cc00858](cc00858))
* documentation site served at /docs (co-located in web/docs)
([#88](#88))
([27d9ccd](27d9ccd))
* email check frontend (spec 03)
([#30](#30))
([aebd106](aebd106))
* email inbox foundation via JMAP (spec 01)
([#24](#24))
([0f3b0c1](0f3b0c1))
* email passive checks (spec 02)
([#27](#27))
([ba5536f](ba5536f))
* **entitlements:** trim to MaxSSOUsers + MaxChecksPerMinute + status
page history fixes
([#50](#50))
([a007de0](a007de0))
* **entitlements:** trim to MaxSSOUsers + MaxChecksPerMinute, enforce
both ([#49](#49))
([d25cc5f](d25cc5f))
* group incident correlation (spec 04 backend v1)
([#31](#31))
([1883986](1883986))
* **observability:** instrument hot path + add bench harness
([#60](#60))
([c6604cc](c6604cc))
* **oncall:** searchable timezone dropdown + sidebar logo polish
([#46](#46))
([4396898](4396898))
* per-IP HTTP rate limiting and concurrency limiting
([#59](#59))
([f9cc273](f9cc273))
* soften HTTP rate limits with bounded queues + request timeout
([#63](#63))
([025501b](025501b))
* SolidPing — distributed uptime monitoring platform
([eef4383](eef4383))
* **statuspages:** drag-and-drop resource reordering + dash conventions
([#41](#41))
([cf910d4](cf910d4))


### Bug Fixes

* **deps:** update dependency i18next to v26
([#26](#26))
([d5d1b7e](d5d1b7e))
* **deps:** update dependency lucide-react to v1
([#28](#28))
([cdc8e8c](cdc8e8c))
* **deps:** update dependency react-i18next to v17
([#29](#29))
([13135d8](13135d8))
* **deps:** update dependency recharts to v3.8.1
([#14](#14))
([5d95a3b](5d95a3b))
* **deps:** update go dependencies (non-major)
([#16](#16))
([2450f13](2450f13))
* **deps:** update go dependencies (non-major)
([#19](#19))
([f842310](f842310))
* **deps:** update go dependencies (non-major)
([#37](#37))
([c020eca](c020eca))
* **deps:** update go dependencies (non-major)
([#44](#44))
([ff0bcd0](ff0bcd0))
* **deps:** update go dependencies (non-major)
([#52](#52))
([2e3bc28](2e3bc28))
* **deps:** update go dependencies (non-major)
([#69](#69))
([a65ed4c](a65ed4c))
* **deps:** update go dependencies (non-major)
([#77](#77))
([a0920ff](a0920ff))
* **deps:** update go dependencies (non-major) to v1.4.2
([#86](#86))
([1eb7504](1eb7504))
* **deps:** update module github.com/aws/aws-sdk-go-v2/config to
v1.32.18 ([#72](#72))
([6406537](6406537))
* **deps:** update module github.com/aws/aws-sdk-go-v2/service/s3 to
v1.101.0 ([#39](#39))
([f9c9563](f9c9563))
* **deps:** update module github.com/go-webauthn/webauthn to v0.17.3
([#45](#45))
([593931a](593931a))
* **deps:** update module github.com/go-webauthn/webauthn to v0.17.4
([#70](#70))
([fca1c97](fca1c97))
* **deps:** update module github.com/ibm/sarama to v1.48.1
([#47](#47))
([93ccf3a](93ccf3a))
* **deps:** update module github.com/ibm/sarama to v1.48.2
([#54](#54))
([e84d868](e84d868))
* **deps:** update module github.com/ibm/sarama to v1.49.0
([#64](#64))
([fd61bd7](fd61bd7))
* **deps:** update module github.com/oapi-codegen/runtime to v1.4.1
([#65](#65))
([a3a3e9f](a3a3e9f))
* **deps:** update module github.com/prometheus/common to v0.67.5
([#61](#61))
([095dd6f](095dd6f))
* **deps:** update module github.com/slack-go/slack to v0.24.0
([#75](#75))
([6e86d5b](6e86d5b))
* **deps:** update module golang.org/x/sys to v0.44.0
([#42](#42))
([a245730](a245730))
* **deps:** update module golang.org/x/sys to v0.45.0
([#67](#67))
([49c3d90](49c3d90))
* **deps:** update module golang.org/x/term to v0.43.0
([#43](#43))
([4a934f1](4a934f1))
* **deps:** update module google.golang.org/grpc to v1.81.0
([#36](#36))
([1be183a](1be183a))
* **deps:** update module google.golang.org/grpc to v1.81.1
([#55](#55))
([6bfac2d](6bfac2d))
* status lifecycle improvements and created/running result handling
([#5](#5))
([fc64c7d](fc64c7d))
* **status0:** white page header and de-duplicated footer
([#48](#48))
([77506a7](77506a7))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
This was referenced Sep 8, 2026
Closed
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

automerge

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@fclairamb