Skip to content

Changelog

All notable changes to Orphnet Logging are documented on this page. This project follows Keep a Changelog formatting.

[v0.0.alpha-2] -- 2026-03-08

Added

  • Dashboard SPA -- Vue 3 + TypeScript dashboard with workspace-scoped log exploration, project management, and settings
  • Live View -- Real-time log streaming via WebSocket + Durable Object. Filter by project, level, category, or search term. Follow other users' sessions collaboratively.
  • Session Timeline -- View logs grouped by session with vertical timeline UI
  • Saved Queries -- Save and reapply log filter configurations
  • Workspace invitations -- Invite members, accept/decline invitations with bell notification
  • Dashboard link -- Added "Dashboard" navigation link to the docs site

Fixed

  • Registration and demo login -- Fixed HMAC key error caused by empty JWT_SECRET in local dev. Added .dev.vars.example with sample configuration.
  • Dashboard dev proxy -- Added Vite proxy config so dashboard dev server routes API calls to the Hono Worker

Developer Experience

  • dev:all script -- Runs API, dashboard, and docs dev servers in parallel
  • preview script -- Builds all outputs and serves via Wrangler
  • dev:queue script -- Runs the Worker with scheduled/queue trigger support

Known Issues

  • OAuth providers (GitHub, Google) not yet configured for production
  • Magic link email delivery requires RESEND_API_KEY setup
  • Live View requires Durable Objects support (not available in wrangler dev --local without --remote)
  • Client SDK (@orphnet/logging-api-client) is experimental
  • API contracts may change before v1

[v0.0.alpha-1] -- 2026-03-07

Initial alpha release. Core functionality is working but APIs may change.

What's included

  • Workspace-scoped structured logging -- D1 for SQL queries, KV for edge reads, R2 for NDJSON archive. Smart query routing based on time window.
  • API key authentication -- Granular scopes (logs:read, logs:write, projects:manage, keys:manage). Write scope implies read.
  • Log ingestion and query -- Queue-based async ingestion (202 Accepted), query with filters and pagination.
  • Rate limiting -- KV-backed with cascading config: per-route, per-workspace, and preset defaults.
  • Interactive API playground -- Sandbox environment with demo key, guided wizard, and inline try-it widgets.
  • VitePress documentation site -- Guides, API reference, and Workers Static Assets deployment.

Authentication (experimental)

  • Email/password registration and login
  • Magic link passwordless auth
  • GitHub and Google OAuth with PKCE
  • Account linking (multiple providers per account)
  • JWT access tokens with refresh token rotation

Known limitations

  • OAuth providers (GitHub, Google) not yet configured for production
  • Magic link email delivery requires RESEND_API_KEY setup
  • Client SDK (@orphnet/logging-api-client) is experimental
  • No dashboard UI
  • API contracts may change before v0.0.alpha.1

For the full architecture, see Architecture. For endpoint details, see API Reference.

LogVista — Edge-native structured logging API