@prsm/devtools 1.0.0

package/dist/client/assets/index-p_4czaPS.css

@@ -0,0 +1 @@
+:root{--bg: #0a0a0a;--bg-surface: #111111;--bg-raised: #1a1a1a;--bg-hover: #222222;--bg-active: #2a2a2a;--border: #2a2a2a;--border-subtle: #1e1e1e;--text: #d4d4d4;--text-bright: #e8e8e8;--text-muted: #555555;--accent: #34d399;--accent-dim: rgba(52, 211, 153, .12);--accent-text: #2dd4a2;--color-blue: #6ad;--color-red: #c55;--color-yellow: #b93;--color-green: #5a9;--syn-string: #a5d6a7;--syn-number: #4dd0e1;--syn-boolean: #ce93d8;--syn-null: #666666;--syn-key: #b0b0b0;--syn-bracket: #555555}*{box-sizing:border-box;margin:0;padding:0}body{font-family:SF Mono,Fira Code,JetBrains Mono,Cascadia Code,monospace;font-size:12px;line-height:1.5;color:var(--text);background:var(--bg);-webkit-font-smoothing:antialiased}::selection{background:var(--accent-dim);color:var(--accent-text)}::-webkit-scrollbar{width:6px;height:6px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:var(--border);border-radius:3px}::-webkit-scrollbar-thumb:hover{background:#3a3a3a}.app{display:flex;flex-direction:column;height:100vh;overflow:hidden}.top-bar{display:flex;align-items:center;justify-content:space-between;padding:0 16px;height:40px;border-bottom:1px solid var(--border);background:var(--bg-surface);flex-shrink:0}.top-bar-left{display:flex;align-items:center;gap:12px}.logo{font-size:11px;font-weight:600;letter-spacing:.5px;text-transform:uppercase;color:var(--text-muted)}.logo span{color:var(--accent)}.top-bar-right{display:flex;align-items:center;gap:12px}.nav-bar{display:flex;align-items:center;gap:0;border-bottom:1px solid var(--border);background:var(--bg-surface);flex-shrink:0;padding:0 16px}.nav-bar a{padding:8px 16px;font-size:11px;color:var(--text-muted);cursor:pointer;border-bottom:2px solid transparent;-webkit-user-select:none;user-select:none;text-decoration:none}.nav-bar a:hover{color:var(--text)}.nav-bar a.active{color:var(--accent-text);border-bottom-color:var(--accent)}.page-scroll{flex:1;overflow-y:auto}.page-content{max-width:1100px;padding:20px 24px 40px}.tab-bar{display:flex;align-items:center;gap:0;border-bottom:1px solid var(--border);background:var(--bg-surface);flex-shrink:0;padding:0 16px}.tab{padding:8px 16px;font-size:11px;color:var(--text-muted);cursor:pointer;border-bottom:2px solid transparent;-webkit-user-select:none;user-select:none}.tab:hover{color:var(--text)}.tab.active{color:var(--accent-text);border-bottom-color:var(--accent)}.tab .count{margin-left:6px;font-size:10px;color:var(--text-muted)}.tab.active .count{color:var(--accent)}.sidebar{width:280px;min-width:280px;border-right:1px solid var(--border);overflow-y:auto;background:var(--bg-surface)}.content{flex:1;overflow-y:auto;padding:16px}.sidebar-section{border-bottom:1px solid var(--border-subtle)}.sidebar-header{padding:8px 12px;font-size:10px;text-transform:uppercase;letter-spacing:.5px;color:var(--text-muted);background:var(--bg)}.sidebar-item{display:flex;align-items:center;justify-content:space-between;padding:6px 12px;cursor:pointer;border-left:2px solid transparent}.sidebar-item:hover{background:var(--bg-hover)}.sidebar-item.active{background:var(--accent-dim);border-left-color:var(--accent)}.sidebar-item .label{font-size:11px;color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.sidebar-item.active .label{color:var(--accent-text)}.sidebar-item .meta{font-size:10px;color:var(--text-muted);flex-shrink:0;margin-left:8px}.badge{display:inline-flex;align-items:center;justify-content:center;min-width:18px;height:18px;padding:0 5px;font-size:10px;border-radius:9px;background:#1f1f1f;color:#999}.badge.accent{background:var(--accent-dim);color:var(--accent)}.section{margin-bottom:20px}.section-title{font-size:10px;text-transform:uppercase;letter-spacing:.5px;color:var(--text-muted);margin-bottom:8px}.card{background:var(--bg-surface);border:1px solid var(--border);border-radius:4px;overflow:hidden}.card+.card{margin-top:8px}.card-header{display:flex;align-items:center;justify-content:space-between;padding:8px 12px;background:var(--bg);border-bottom:1px solid var(--border-subtle);font-size:11px}.card-header .name{color:var(--text-bright)}.card-body{padding:8px 12px}.kv-row{display:flex;align-items:baseline;padding:2px 0;font-size:11px}.kv-key{color:var(--text-muted);min-width:100px;flex-shrink:0}.kv-value{color:var(--text);word-break:break-all}.member-row{display:flex;align-items:center;justify-content:space-between;padding:4px 12px;font-size:11px;border-bottom:1px solid var(--border-subtle)}.member-row:last-child{border-bottom:none}.member-id{color:var(--text);font-size:11px}.member-presence{font-size:10px;color:var(--accent)}.tag{display:inline-block;padding:1px 6px;font-size:10px;border-radius:3px;background:#1f1f1f;color:#999;margin:1px 2px}.tag.accent{background:var(--accent-dim);color:var(--accent)}.empty{padding:24px;text-align:center;color:var(--text-muted);font-size:11px}.view-hint{font-size:11px;color:var(--text-muted);margin-bottom:12px;padding-bottom:8px;border-bottom:1px solid var(--border-subtle)}.no-presence{font-size:10px;color:#333}.pattern-list{display:flex;flex-wrap:wrap;gap:4px;margin-top:4px}.json-view{font-size:11px;line-height:1.6;white-space:pre-wrap;word-break:break-all}.json-view .shiki{background:transparent!important;padding:0;margin:0}.json-view .shiki code{font-family:inherit;font-size:inherit}.select{background:var(--bg-raised);border:1px solid var(--border);color:var(--text);font-family:inherit;font-size:11px;padding:4px 8px;border-radius:3px;outline:none;cursor:pointer}.select:focus{border-color:var(--accent)}.conn-link{cursor:pointer;text-decoration:underline;text-decoration-color:var(--border);text-underline-offset:2px}.conn-link:hover{color:var(--accent-text);text-decoration-color:var(--accent)}.exposed-row{display:flex;align-items:center;flex-wrap:wrap;gap:3px;padding:4px 12px;border-bottom:1px solid var(--border-subtle)}.exposed-row:last-child{border-bottom:none}.exposed-label{font-size:10px;color:var(--text-muted);min-width:70px;flex-shrink:0}.pulse{width:6px;height:6px;border-radius:50%;background:var(--accent)}.pulse.disconnected{background:#ef4444}.instance-id{font-size:10px;color:var(--text-muted)}section[data-v-1330d5ac]{margin-top:28px}.subsystems[data-v-1330d5ac]{display:flex;gap:8px;margin-bottom:20px}.chip[data-v-1330d5ac]{padding:5px 14px;font-size:11px;font-weight:500;color:var(--text-muted);background:var(--bg-surface);border:1px solid var(--border);border-radius:4px;font-family:inherit;cursor:pointer}.chip.on[data-v-1330d5ac]{color:var(--text);border-color:#333}.chip.off[data-v-1330d5ac]{color:var(--text-muted);border-color:var(--border-subtle);opacity:.55}.chip[data-v-1330d5ac]:disabled{cursor:default;opacity:.35}.stream[data-v-1330d5ac]{background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:4px;max-height:520px;overflow-y:auto}.event-row[data-v-1330d5ac]{display:flex;gap:0;align-items:center;padding:0;border-bottom:1px solid var(--bg-raised);font-size:11px}.event-row[data-v-1330d5ac]:last-child{border-bottom:none}.event-source[data-v-1330d5ac]{width:72px;padding:6px 8px;color:var(--text-muted);text-align:right;border-right:1px solid var(--bg-raised);flex-shrink:0}.event-action[data-v-1330d5ac]{width:152px;padding:6px 8px;color:var(--text-muted);flex-shrink:0}.event-action.complete[data-v-1330d5ac],.event-action.fire[data-v-1330d5ac],.event-action.execution-succeeded[data-v-1330d5ac],.event-action.step-succeeded[data-v-1330d5ac]{color:var(--color-green)}.event-action.step-routed[data-v-1330d5ac]{color:var(--color-blue)}.event-action.failed[data-v-1330d5ac],.event-action.error[data-v-1330d5ac],.event-action.execution-failed[data-v-1330d5ac],.event-action.step-failed[data-v-1330d5ac],.event-action.execution-lease-lost[data-v-1330d5ac]{color:var(--color-red)}.event-action.retry[data-v-1330d5ac],.event-action.step-retry[data-v-1330d5ac]{color:var(--color-yellow)}.event-data[data-v-1330d5ac]{flex:1;min-width:0;padding:6px 8px;color:#666;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.event-time[data-v-1330d5ac]{width:80px;padding:6px 8px;color:var(--text-muted);text-align:right;flex-shrink:0}.gauges[data-v-74a2dfa0]{display:flex;gap:12px;margin-bottom:8px}.gauge[data-v-74a2dfa0]{flex:1;padding:16px;background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:4px}.gauge-value[data-v-74a2dfa0]{display:block;font-size:28px;font-weight:600;color:var(--text-muted)}.gauge-value.lit[data-v-74a2dfa0]{color:var(--color-blue)}.gauge-value.warn[data-v-74a2dfa0]{color:var(--color-red)}.gauge-label[data-v-74a2dfa0]{display:block;font-size:10px;color:var(--text-muted);margin-top:4px;letter-spacing:.3px;text-transform:uppercase}.session-note[data-v-74a2dfa0]{font-size:10px;color:#333;margin-bottom:24px}section[data-v-74a2dfa0]{margin-top:24px}.stream[data-v-74a2dfa0]{background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:4px;max-height:400px;overflow-y:auto}.event-row[data-v-74a2dfa0]{display:flex;gap:0;align-items:center;border-bottom:1px solid var(--bg-raised);font-size:11px}.event-row[data-v-74a2dfa0]:last-child{border-bottom:none}.event-action[data-v-74a2dfa0]{width:72px;padding:6px 10px;color:var(--text-muted);flex-shrink:0}.event-action.complete[data-v-74a2dfa0]{color:var(--color-green)}.event-action.failed[data-v-74a2dfa0]{color:var(--color-red)}.event-action.retry[data-v-74a2dfa0]{color:var(--color-yellow)}.event-action.new[data-v-74a2dfa0]{color:var(--text-muted)}.event-action.drain[data-v-74a2dfa0]{color:#666}.event-data[data-v-74a2dfa0]{flex:1;padding:6px 8px;color:var(--text-muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.event-time[data-v-74a2dfa0]{width:80px;padding:6px 8px;color:#333;text-align:right;flex-shrink:0}.job-row[data-v-6d545d29]{display:flex;align-items:center;padding:0;border-bottom:1px solid var(--border-subtle);font-size:11px}.job-row[data-v-6d545d29]:last-child{border-bottom:none}.job-row.header[data-v-6d545d29]{font-size:10px;color:var(--text-muted);letter-spacing:.3px;text-transform:uppercase;border-bottom:1px solid var(--border)}.job-row.header span[data-v-6d545d29]{padding:8px 12px}.col-name[data-v-6d545d29]{flex:1;padding:10px 12px}.col-next[data-v-6d545d29]{width:100px;padding:10px 12px;color:#666;text-align:right}.col-in[data-v-6d545d29]{width:60px;padding:10px 12px;color:var(--text-muted);text-align:right}.col-in.soon[data-v-6d545d29]{color:var(--color-blue)}.stream[data-v-6d545d29]{background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:4px;max-height:400px;overflow-y:auto}.event-row[data-v-6d545d29]{display:flex;align-items:center;border-bottom:1px solid var(--bg-raised);font-size:11px}.event-row[data-v-6d545d29]:last-child{border-bottom:none}.event-action[data-v-6d545d29]{width:52px;padding:6px 10px;color:var(--text-muted);flex-shrink:0}.event-action.fire[data-v-6d545d29]{color:var(--color-green)}.event-action.error[data-v-6d545d29]{color:var(--color-red)}.event-name[data-v-6d545d29]{flex:1;padding:6px 8px;color:#666}.event-time[data-v-6d545d29]{width:80px;padding:6px 8px;color:#333;text-align:right;flex-shrink:0}.limiter-list[data-v-22c855ec]{display:flex;gap:8px;flex-wrap:wrap;margin-bottom:24px}section[data-v-22c855ec]{margin-top:24px}.desc[data-v-22c855ec]{font-size:11px;color:var(--text-muted);margin-bottom:12px}.peek-form[data-v-22c855ec]{display:flex;gap:8px}.input[data-v-22c855ec]{padding:6px 10px;background:var(--bg-surface);border:1px solid var(--border);border-radius:4px;font-size:11px;color:var(--text);flex:1;font-family:inherit;outline:none}.input[data-v-22c855ec]::placeholder{color:#333}.input[data-v-22c855ec]:focus{border-color:var(--accent)}.btn[data-v-22c855ec]{padding:6px 16px;background:var(--bg-raised);color:#999;border:1px solid var(--border);border-radius:4px;cursor:pointer;font-size:11px;font-family:inherit}.btn[data-v-22c855ec]:hover{color:var(--text)}.btn[data-v-22c855ec]:disabled{opacity:.3;cursor:default}.error[data-v-22c855ec]{margin-top:10px;color:var(--color-red);font-size:11px}.graph-shell[data-v-6098c89d]{background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:4px;overflow:hidden;position:relative;cursor:grab;touch-action:none}.graph-shell[data-v-6098c89d]:active{cursor:grabbing}.graph-shell svg[data-v-6098c89d]{user-select:none;-webkit-user-select:none}.graph-shell.fullscreen[data-v-6098c89d]{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1000;border-radius:0;border:none;background:var(--bg)}.graph-controls[data-v-6098c89d]{position:absolute;top:10px;right:10px;z-index:2;display:flex;gap:4px}.graph-controls button[data-v-6098c89d]{padding:4px 10px;background:var(--bg-raised);border:1px solid var(--border);border-radius:4px;color:#888;font-size:11px;font-family:inherit;cursor:pointer}.graph-controls button[data-v-6098c89d]:hover{background:var(--bg-hover);color:#ccc}.graph[data-v-6098c89d]{width:100%;min-height:420px;display:block}.fullscreen .graph[data-v-6098c89d]{min-height:100vh}.edge[data-v-6098c89d]{fill:none;stroke:#232323;stroke-width:3}.edge-seen[data-v-6098c89d]{stroke:#3b3b3b}.edge-active[data-v-6098c89d]{stroke:#8fb3ff}.edge-label[data-v-6098c89d]{fill:#4a4a4a;font-size:11px;font-family:inherit}.node[data-v-6098c89d]{cursor:pointer}.node rect[data-v-6098c89d]{fill:#151515;stroke:#262626;stroke-width:1.5}.node.selected rect[data-v-6098c89d]{stroke:#6b7280}.node.current rect[data-v-6098c89d],.node.running rect[data-v-6098c89d]{stroke:#5b8cff}.node.succeeded rect[data-v-6098c89d],.node.decision-success rect[data-v-6098c89d]{stroke:#3d8f63}.node.failed rect[data-v-6098c89d]{stroke:#a14a4a}.node.activity .node-type[data-v-6098c89d]{fill:#7aa2f7}.node.decision .node-type[data-v-6098c89d]{fill:#e0af68}.node.succeed .node-type[data-v-6098c89d]{fill:#73daca}.node.fail .node-type[data-v-6098c89d]{fill:#f7768e}.node-name[data-v-6098c89d]{fill:var(--text-bright);font-size:13px;font-weight:600}.node-type[data-v-6098c89d],.node-meta[data-v-6098c89d]{font-family:inherit;font-size:11px}.node-meta[data-v-6098c89d]{fill:#5f5f5f}.workflow-layout[data-v-124a0c49]{display:grid;grid-template-columns:280px 1fr;gap:16px}.wf-sidebar[data-v-124a0c49]{display:flex;flex-direction:column;gap:8px}.wf-sidebar .card.active[data-v-124a0c49]{border-color:var(--accent)}.detail[data-v-124a0c49]{display:flex;flex-direction:column;gap:16px}.headline[data-v-124a0c49]{display:flex;justify-content:space-between;align-items:flex-end}.headline-name[data-v-124a0c49]{font-size:14px;font-weight:600;color:var(--text-bright)}.headline-sub[data-v-124a0c49]{margin-top:2px;color:var(--text-muted);font-size:11px}.headline-stats[data-v-124a0c49]{display:flex;gap:10px;color:var(--text-muted);font-size:11px}.filters[data-v-24631062]{display:flex;gap:8px;margin-bottom:16px}.execution-layout[data-v-24631062]{display:grid;grid-template-columns:240px minmax(0,1fr) 340px;gap:14px;align-items:start}.list[data-v-24631062]{background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:4px;overflow:hidden;max-height:calc(100vh - 240px);overflow-y:auto}.execution-row[data-v-24631062]{padding:10px 12px;border-bottom:1px solid var(--bg-raised);cursor:pointer}.execution-row[data-v-24631062]:last-child{border-bottom:none}.execution-row.active[data-v-24631062]{background:var(--bg-raised)}.execution-main[data-v-24631062]{display:flex;justify-content:space-between;gap:8px}.execution-workflow[data-v-24631062]{color:var(--text-bright);font-size:12px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.execution-id[data-v-24631062]{color:#666;font-size:11px;flex-shrink:0}.execution-meta[data-v-24631062]{display:flex;justify-content:space-between;gap:6px;margin-top:4px;color:var(--text-muted);font-size:10px}.execution-row.running .execution-workflow[data-v-24631062]{color:#8fb3ff}.execution-row.failed .execution-workflow[data-v-24631062]{color:#d87a7a}.execution-row.succeeded .execution-workflow[data-v-24631062]{color:#7ec49b}.headline[data-v-24631062]{margin-bottom:14px}.headline-name[data-v-24631062]{font-size:14px;font-weight:600;color:var(--text-bright)}.headline-sub[data-v-24631062]{margin-top:2px;color:var(--text-muted);font-size:11px}.center[data-v-24631062]{display:flex;flex-direction:column;gap:12px;min-width:0}.inspector[data-v-24631062]{display:flex;flex-direction:column;gap:10px;max-height:calc(100vh - 240px);overflow-y:auto}.step-hint[data-v-24631062]{color:#383838;font-size:10px;margin-bottom:8px;font-style:italic}.timeline[data-v-24631062]{max-height:420px;overflow-y:auto}.timeline-row[data-v-24631062]{display:flex;gap:6px;align-items:baseline;border-bottom:1px solid var(--border-subtle);padding:6px 12px;font-size:10px;white-space:nowrap}.timeline-row[data-v-24631062]:last-child{border-bottom:none}.timeline-type[data-v-24631062]{color:#b1b1b1;flex-shrink:0}.timeline-step[data-v-24631062]{color:#666;flex:1;overflow:hidden;text-overflow:ellipsis}.timeline-time[data-v-24631062]{color:var(--text-muted);flex-shrink:0}.realtime-shell[data-v-d6b8bed2]{display:flex;flex-direction:column;flex:1;overflow:hidden}.rt-main[data-v-d6b8bed2]{display:flex;flex:1;overflow:hidden}.tab-bar-right[data-v-d6b8bed2]{margin-left:auto;display:flex;align-items:center;gap:8px}.tab-bar a[data-v-d6b8bed2]{text-decoration:none}

package/dist/client/index.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>prsm devtools</title>
+    <style>
+      body { margin: 0; background: #0a0a0a; }
+    </style>
+    <script type="module" crossorigin src="./assets/index-CkwmeR8W.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-p_4czaPS.css">
+  </head>
+  <body>
+    <div id="app"></div>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@prsm/devtools",
+  "version": "1.0.0",
+  "description": "Read-only Express middleware dashboard for observing @prsm infrastructure at runtime",
+  "type": "module",
+  "exports": {
+    ".": {
+      "default": "./src/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "dist/client"
+  ],
+  "scripts": {
+    "build:client": "cd client && npm run build",
+    "prepublishOnly": "npm run build:client"
+  },
+  "keywords": [
+    "devtools",
+    "dashboard",
+    "queue",
+    "cron",
+    "rate-limit",
+    "realtime",
+    "websocket",
+    "observability"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.21.0"
+  },
+  "devDependencies": {
+    "@prsm/cron": "^1.0.0",
+    "@prsm/limit": "^1.1.0",
+    "@prsm/queue": "^2.0.0",
+    "cors": "^2.8.6",
+    "dotenv": "^16.4.7"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/index.js

@@ -0,0 +1,339 @@
+import { Router, static as serveStatic } from 'express'
+import { fileURLToPath } from 'node:url'
+import { resolve, dirname } from 'node:path'
+import { existsSync } from 'node:fs'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const clientDir = resolve(__dirname, '..', 'dist', 'client')
+
+function patternToString(p) {
+  if (typeof p === 'string') return p
+  if (p instanceof RegExp) return p.toString()
+  return String(p)
+}
+
+/**
+ * @param {Object} options
+ * @param {import('@prsm/queue').default} [options.queue]
+ * @param {import('@prsm/cron').Cron} [options.cron]
+ * @param {Object<string, Object>} [options.limit] - named limiters
+ * @param {import('@prsm/workflow').WorkflowEngine} [options.workflow]
+ * @param {Object} [options.realtime] - RealtimeServer instance
+ * @returns {import('express').Router}
+ */
+export function prsmDevtools(options = {}) {
+  const router = Router()
+  const { queue, cron, limit, workflow, realtime } = options
+  const sseClients = new Set()
+
+  function broadcast(event, data) {
+    const msg = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`
+    for (const res of sseClients) {
+      res.write(msg)
+    }
+  }
+
+  if (queue) {
+    for (const event of ['new', 'complete', 'retry', 'failed', 'drain']) {
+      queue.on(event, (data) => broadcast(`queue:${event}`, data ?? {}))
+    }
+  }
+
+  if (cron) {
+    cron.on('fire', (data) => broadcast('cron:fire', { name: data.name, tickId: data.tickId }))
+    cron.on('error', (data) => broadcast('cron:error', { name: data.name, error: data.error?.message }))
+  }
+
+  if (workflow) {
+    for (const event of [
+      'execution:queued',
+      'execution:succeeded',
+      'execution:failed',
+      'execution:canceled',
+      'execution:lease-lost',
+      'step:started',
+      'step:succeeded',
+      'step:routed',
+      'step:retry',
+      'step:failed',
+    ]) {
+      workflow.on(event, (data) => broadcast(`workflow:${event}`, data ?? {}))
+    }
+  }
+
+  router.get('/api/config', (_req, res) => {
+    res.json({
+      queue: !!queue,
+      cron: !!cron,
+      limit: limit ? Object.keys(limit) : [],
+      workflow: !!workflow,
+      realtime: !!realtime,
+    })
+  })
+
+  router.get('/api/events', (req, res) => {
+    res.setHeader('Content-Type', 'text/event-stream')
+    res.setHeader('Cache-Control', 'no-cache')
+    res.setHeader('Connection', 'keep-alive')
+    res.flushHeaders()
+
+    sseClients.add(res)
+    req.on('close', () => sseClients.delete(res))
+  })
+
+  if (queue) {
+    router.get('/api/queue', (_req, res) => {
+      res.json({ inFlight: queue.inFlight })
+    })
+  }
+
+  if (cron) {
+    router.get('/api/cron', (_req, res) => {
+      const jobs = cron.jobs.map((name) => ({
+        name,
+        nextFireTime: cron.nextFireTime(name),
+      }))
+      res.json({ jobs })
+    })
+  }
+
+  if (limit) {
+    router.get('/api/limits', (_req, res) => {
+      res.json({ limiters: Object.keys(limit) })
+    })
+
+    router.get('/api/limits/:name/peek/:key', async (req, res) => {
+      const limiter = limit[req.params.name]
+      if (!limiter) return res.status(404).json({ error: 'Limiter not found' })
+      if (!limiter.peek) return res.status(400).json({ error: 'Limiter does not support peek' })
+
+      const result = await limiter.peek(req.params.key)
+      res.json(result)
+    })
+  }
+
+  if (workflow) {
+    router.get('/api/workflows', (_req, res) => {
+      const workflows = workflow.listWorkflows().map((item) => ({
+        ...item,
+        graph: workflow.describe(item.name, item.version).graph,
+      }))
+      res.json({ workflows })
+    })
+
+    router.get('/api/workflows/describe', (req, res) => {
+      const name = req.query.name
+      const version = req.query.version
+
+      if (!name || typeof name !== 'string') {
+        return res.status(400).json({ error: 'name is required' })
+      }
+
+      try {
+        const data = workflow.describe(name, typeof version === 'string' ? version : undefined)
+        res.json(data)
+      } catch (error) {
+        res.status(404).json({ error: error.message })
+      }
+    })
+
+    router.get('/api/workflow/executions', async (req, res) => {
+      const filter = {}
+      if (typeof req.query.workflow === 'string' && req.query.workflow) filter.workflow = req.query.workflow
+      if (typeof req.query.status === 'string' && req.query.status) filter.status = req.query.status
+      if (typeof req.query.limit === 'string' && req.query.limit) filter.limit = Number(req.query.limit)
+
+      const executions = await workflow.listExecutions(filter)
+      res.json({ executions })
+    })
+
+    router.get('/api/workflow/executions/:id', async (req, res) => {
+      const execution = await workflow.getExecution(req.params.id)
+      if (!execution) return res.status(404).json({ error: 'Execution not found' })
+      res.json({ execution })
+    })
+  }
+
+  if (realtime) {
+    realtime.onRecordUpdate(({ recordId, value }) => {
+      broadcast('realtime:record:update', { recordId, data: value })
+    })
+
+    realtime.onRecordRemoved(({ recordId }) => {
+      broadcast('realtime:record:removed', { recordId })
+    })
+
+    router.get('/api/realtime/state', async (_req, res) => {
+      try {
+        const connIds = await realtime.connectionManager.getAllConnectionIds()
+        const allMeta = await realtime.connectionManager._getMetadataForConnectionIds(connIds)
+        const localConns = realtime.connectionManager.getLocalConnections()
+        const localMap = {}
+        for (const conn of localConns) {
+          localMap[conn.id] = conn
+        }
+
+        const connections = allMeta.map(({ id, metadata }) => {
+          const local = localMap[id]
+          return {
+            id,
+            metadata,
+            local: !!local,
+            latency: local?.latency?.ms ?? null,
+            alive: local?.alive ?? null,
+            remoteAddress: local?.remoteAddress ?? null,
+          }
+        })
+
+        const roomNames = await realtime.roomManager.getAllRooms()
+        const rooms = []
+        for (const name of roomNames) {
+          const members = await realtime.roomManager.getRoomConnectionIds(name)
+          const statesMap = await realtime.presenceManager.getAllPresenceStates(name)
+          const presence = {}
+          statesMap.forEach((state, connId) => { presence[connId] = state })
+          rooms.push({ name, members, presence })
+        }
+
+        const channels = {}
+        for (const [channel, subscribers] of Object.entries(realtime.channelManager.channelSubscriptions)) {
+          if (channel.startsWith('mesh:presence:updates:')) continue
+          channels[channel] = [...subscribers].map((c) => c.id)
+        }
+
+        const collections = {}
+        realtime.collectionManager.collectionSubscriptions.forEach((subs, collId) => {
+          const subscribers = {}
+          subs.forEach((info, connId) => { subscribers[connId] = info })
+          collections[collId] = { subscribers }
+        })
+
+        const records = {}
+        realtime.recordSubscriptionManager.recordSubscriptions.forEach((subs, recordId) => {
+          const subscribers = {}
+          subs.forEach((mode, connId) => { subscribers[connId] = mode })
+          records[recordId] = { subscribers }
+        })
+
+        const exposed = {
+          channels: realtime.channelManager.exposedChannels.map(patternToString),
+          records: realtime.recordSubscriptionManager.exposedRecords.map(patternToString),
+          writableRecords: realtime.recordSubscriptionManager.exposedWritableRecords.map(patternToString),
+          collections: realtime.collectionManager.exposedCollections.map((e) => patternToString(e.pattern)),
+          presence: realtime.presenceManager.trackedRooms.map(patternToString),
+          commands: realtime.commandManager.commands
+            ? Object.keys(realtime.commandManager.commands).filter((c) => !c.startsWith('mesh/'))
+            : [],
+        }
+
+        res.json({ instanceId: realtime.instanceId, connections, rooms, channels, collections, records, exposed })
+      } catch (err) {
+        res.status(500).json({ error: err.message })
+      }
+    })
+
+    router.get('/api/realtime/connection/:id', async (req, res) => {
+      try {
+        const { id } = req.params
+        const metadata = await realtime.connectionManager.getMetadata(id)
+        const rooms = await realtime.roomManager.getRoomsForConnection(id)
+
+        const presence = {}
+        for (const room of rooms) {
+          const state = await realtime.presenceManager.getPresenceState(id, room)
+          if (state) presence[room] = state
+        }
+
+        const channels = []
+        for (const [channel, subscribers] of Object.entries(realtime.channelManager.channelSubscriptions)) {
+          if (channel.startsWith('mesh:presence:updates:')) continue
+          for (const conn of subscribers) {
+            if (conn.id === id) { channels.push(channel); break }
+          }
+        }
+
+        const collections = []
+        realtime.collectionManager.collectionSubscriptions.forEach((subs, collId) => {
+          if (subs.has(id)) collections.push({ id: collId, ...subs.get(id) })
+        })
+
+        const records = []
+        realtime.recordSubscriptionManager.recordSubscriptions.forEach((subs, recordId) => {
+          if (subs.has(id)) records.push({ id: recordId, mode: subs.get(id) })
+        })
+
+        const local = realtime.connectionManager.getLocalConnection(id)
+
+        res.json({
+          id,
+          metadata,
+          rooms,
+          presence,
+          channels,
+          collections,
+          records,
+          local: !!local,
+          latency: local?.latency?.ms ?? null,
+          alive: local?.alive ?? null,
+          remoteAddress: local?.remoteAddress ?? null,
+        })
+      } catch (err) {
+        res.status(500).json({ error: err.message })
+      }
+    })
+
+    router.get('/api/realtime/room/:name', async (req, res) => {
+      try {
+        const { name } = req.params
+        const membersWithMeta = await realtime.getRoomMembersWithMetadata(name)
+        const statesMap = await realtime.presenceManager.getAllPresenceStates(name)
+        const presence = {}
+        statesMap.forEach((state, connId) => { presence[connId] = state })
+        res.json({ name, members: membersWithMeta, presence })
+      } catch (err) {
+        res.status(500).json({ error: err.message })
+      }
+    })
+
+    router.get('/api/realtime/record/:id', async (req, res) => {
+      try {
+        const data = await realtime.recordManager.getRecord(req.params.id)
+        res.json({ id: req.params.id, data })
+      } catch (err) {
+        res.status(500).json({ error: err.message })
+      }
+    })
+
+    router.get('/api/realtime/collection/:id/records', async (req, res) => {
+      try {
+        const collId = req.params.id
+        const connId = req.query.connId
+        if (!connId) return res.status(400).json({ error: 'connId query param required' })
+
+        const raw = await realtime.redisManager.redis.get(`mesh:collection:${collId}:${connId}`)
+        if (!raw) return res.json({ recordIds: [], records: [] })
+
+        const recordIds = JSON.parse(raw)
+        const records = []
+        for (const rid of recordIds) {
+          const data = await realtime.recordManager.getRecord(rid)
+          records.push({ id: rid, data })
+        }
+        res.json({ recordIds, records })
+      } catch (err) {
+        res.status(500).json({ error: err.message })
+      }
+    })
+  }
+
+  if (existsSync(clientDir)) {
+    router.use(serveStatic(clientDir))
+    router.get('*', (_req, res) => {
+      res.sendFile(resolve(clientDir, 'index.html'))
+    })
+  }
+
+  return router
+}
+
+export default prsmDevtools