Files

Test / test (push) Has been cancelled

Details

feat(observer): M-Obs 4-7 — widgets, dashboard, docs, integration example

M-Obs 4: @shade/widgets React library
- ShadeProvider context with observer URL + token + theme
- useShadeState (polling) + useShadeEvents (SSE) hooks
- 7 widgets: IdentityCard, SessionList, PrekeyStock, RecentActivity,
  ServerStatus, FingerprintCompare, WidgetCatalog (meta-widget for
  user-selectable layout with localStorage persistence)
- Self-contained CSS via inline styles, no external CSS conflicts
- Light/dark/auto theme via tokens

M-Obs 5: @shade/dashboard standalone SPA
- Vite + React app composing all widgets into a full debugger layout
- Login screen with token persistence to localStorage
- Build script copies dist/ to @shade/observer/dist/ for embedded serving
- 211 KB JS bundle (66 KB gzipped)

M-Obs 6: Documentation + integration example
- READMEs for @shade/observer and @shade/widgets
- examples/06-observer-dashboard runnable demo: spins up prekey server +
  observer, runs Alice ↔ Bob conversation loop, dashboard at :3901
- Updated root README and docker-compose.yml with observer integration

M-Obs 7: End-to-end verification
- StateAggregator now drains buffered events on subscription, so
  identity.initialized fires before observer construction are still seen
- Verified live: snapshot endpoint returns full state, dashboard serves,
  401 without auth, sessions/messages/ratchet steps all tracked

220 tests passing, 0 failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-10 19:00:21 +02:00

747 B

Raw Blame History

Example 06: Observer Dashboard

Spins up a Shade prekey server with the observer attached, runs Alice ↔ Bob conversations in a loop, and serves the dashboard at http://localhost:3901/dashboard/.

Run

cd packages/shade-dashboard && bun run build  # build the SPA once
cd ../../examples/06-observer-dashboard
bun run main.ts

Then open http://localhost:3901/dashboard/ and enter the bearer token printed in the console.

What you'll see

Identity card with the demo's fingerprint
Live session between Alice and Bob with message counters incrementing
Recent activity feed showing every X3DH handshake, encryption, and ratchet step
Prekey stock decreasing as Alice consumes them
Server stats updating in real time

747 B Raw Blame History

Example 06: Observer Dashboard

Run

What you'll see

747 B

Raw Blame History