In-App Notifications

experimental

Per-user in-app notification feed: user-scoped lists/counts, read/unread state, polymorphic typed payloads, reconnect catch-up (listSince), and idempotent delivery via dedupKey. Owns persistence; the realtime push layer is the host's concern.

2 hooks 2 events 3 permissions

In-App Notifications is source-visible, contract-first code — your agent reads the whole interface before it composes, never a black box.

Every hook has typed I/O and required tests, and the composition is pinned in microservices.lock.json — what you inspect here is exactly what pnpm microservices check verifies and deploys.

Typed hooks

Extension points with typed input/output and required tests — customize behavior without forking the module.

  • beforeNotify
  • renderNotification

Events emitted

A stable, documented event surface other modules can subscribe to.

  • notification.created
  • notification.read

Permissions

Scoped capabilities the module declares; the gateway enforces them at the boundary.

  • notifications.read
  • notifications.write
  • notifications.admin

Experimental listing. Generated from the canonical module manifest via `registry build`.