bunqueue-dashboard 0.0.14

package/dist/favicon.svg

@@ -0,0 +1,27 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none">
+  <title>bunqueue</title>
+  <defs>
+    <linearGradient id="box" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#f9a8d4"/>
+      <stop offset="100%" stop-color="#ec4899"/>
+    </linearGradient>
+    <linearGradient id="ear" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#fce7f3"/>
+      <stop offset="100%" stop-color="#fbcfe8"/>
+    </linearGradient>
+  </defs>
+  <rect x="2" y="2" width="96" height="96" rx="24" fill="url(#box)"/>
+  <g transform="translate(50,52) scale(0.86)">
+    <ellipse cx="-16" cy="-32" rx="8" ry="20" fill="#ffffff" opacity="0.92"/>
+    <ellipse cx="-16" cy="-32" rx="4" ry="14" fill="url(#ear)"/>
+    <ellipse cx="16" cy="-32" rx="8" ry="20" fill="#ffffff" opacity="0.92"/>
+    <ellipse cx="16" cy="-32" rx="4" ry="14" fill="url(#ear)"/>
+    <circle cx="0" cy="0" r="28" fill="#ffffff" opacity="0.97"/>
+    <ellipse cx="-10" cy="-4" rx="5" ry="6" fill="#18181b"/>
+    <ellipse cx="10" cy="-4" rx="5" ry="6" fill="#18181b"/>
+    <circle cx="-8" cy="-6" r="2" fill="#ffffff"/>
+    <circle cx="12" cy="-6" r="2" fill="#ffffff"/>
+    <ellipse cx="0" cy="8" rx="4" ry="3" fill="#be185d"/>
+    <path d="M -6 14 Q 0 20 6 14" stroke="#be185d" stroke-width="2.5" fill="none" stroke-linecap="round"/>
+  </g>
+</svg>

package/dist/index.html

@@ -0,0 +1,30 @@
+<!doctype html>
+<html lang="en" data-theme="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="color-scheme" content="dark light" />
+    <script>
+      // Pre-paint theme: apply the persisted choice before the bundle loads so
+      // light-theme users don't get a dark first-paint flash on every visit.
+      // Key + shape must match themeStore (zustand persist: {state:{theme}}).
+      try {
+        const t = JSON.parse(localStorage.getItem('bq-dash-theme')).state.theme;
+        if (t === 'light' || t === 'dark') {
+          document.documentElement.dataset.theme = t;
+          document.documentElement.style.colorScheme = t;
+        }
+      } catch {}
+    </script>
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <title>bunqueue · dashboard (beta)</title>
+    <script type="module" crossorigin src="/assets/index-ChJpSdwV.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/cn-CMFYpumL.js">
+    <link rel="modulepreload" crossorigin href="/assets/react-vendor-CHIHtdAC.js">
+    <link rel="modulepreload" crossorigin href="/assets/connectionStore-DI-LYcct.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-DNaP_bi8.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "bunqueue-dashboard",
+  "version": "0.0.14",
+  "type": "module",
+  "description": "Web dashboard for a bunqueue server (queues, jobs, DLQ, cron, metrics, workers, live activity). Run with `bunx bunqueue-dashboard` (requires Bun).",
+  "bin": {
+    "bunqueue-dashboard": "scripts/serve.ts"
+  },
+  "files": [
+    "dist",
+    "scripts/serve.ts",
+    "scripts/embedded.gen.ts",
+    "agent",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Egeo Minotti",
+  "homepage": "https://github.com/egeominotti/bunqueue-dashboard#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/egeominotti/bunqueue-dashboard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/egeominotti/bunqueue-dashboard/issues"
+  },
+  "keywords": [
+    "bunqueue",
+    "dashboard",
+    "queue",
+    "jobs",
+    "react",
+    "vite",
+    "bun"
+  ],
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "scripts": {
+    "prepack": "bun run build && bun scripts/gen-embed.ts",
+    "start": "bun run scripts/dev.ts",
+    "dev": "vite",
+    "agent": "bun run agent/index.ts",
+    "build": "tsc --noEmit && vite build",
+    "size": "bun run scripts/check-bundle.ts",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "build:bin": "bun run build && bun run scripts/gen-embed.ts && bun build scripts/serve.ts --compile --minify --outfile bunqueue-dashboard",
+    "preview": "vite preview",
+    "test": "bun test",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "format": "biome format --write ."
+  },
+  "dependencies": {
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^4.0.7",
+    "@ai-sdk/google": "^4.0.8",
+    "@ai-sdk/openai": "^4.0.7",
+    "@ai-sdk/openai-compatible": "^3.0.5",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@fontsource-variable/jetbrains-mono": "^5.2.8",
+    "ai": "^7.0.14",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "react-router-dom": "^7.18.1",
+    "zod": "^4.4.3",
+    "zustand": "^5.0.14",
+    "@biomejs/biome": "^2.5.2",
+    "@shikijs/vitepress-twoslash": "^4.3.0",
+    "@tailwindcss/vite": "^4.3.2",
+    "@types/node": "^26.0.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.3",
+    "mermaid": "^11.16.0",
+    "tailwindcss": "^4.3.2",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.2",
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-llms": "^1.13.2",
+    "vitepress-plugin-mermaid": "^2.0.17"
+  }
+}

package/scripts/embedded.gen.ts

@@ -0,0 +1,122 @@
+// AUTO-GENERATED by scripts/gen-embed.ts — do not edit, not committed.
+import f0 from "../dist/.vite/manifest.json" with { type: 'file' };
+import f1 from "../dist/favicon.svg" with { type: 'file' };
+import f2 from "../dist/assets/QueueDetail-D-C5SXxB.js" with { type: 'file' };
+import f3 from "../dist/assets/LogsPro-BPWf8AAv.js" with { type: 'file' };
+import f4 from "../dist/assets/UsagePro-BhhM0H05.js" with { type: 'file' };
+import f5 from "../dist/assets/Cron-DzeoQTpD.js" with { type: 'file' };
+import f6 from "../dist/assets/inter-greek-wght-normal-CkhJZR-_.woff2" with { type: 'file' };
+import f7 from "../dist/assets/Dlq-BzwhitJI.js" with { type: 'file' };
+import f8 from "../dist/assets/Logs-DjNLXK_r.js" with { type: 'file' };
+import f9 from "../dist/assets/AreaChart-DzUXW8u3.js" with { type: 'file' };
+import f10 from "../dist/assets/Diagnostics-BUeDbexv.js" with { type: 'file' };
+import f11 from "../dist/assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2" with { type: 'file' };
+import f12 from "../dist/assets/Overview-O67Y-R5x.js" with { type: 'file' };
+import f13 from "../dist/assets/ServerControl-BSLX2WeV.js" with { type: 'file' };
+import f14 from "../dist/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2" with { type: 'file' };
+import f15 from "../dist/assets/McpServer-BVxK5LwU.js" with { type: 'file' };
+import f16 from "../dist/assets/Usage-B_8T34Sp.js" with { type: 'file' };
+import f17 from "../dist/assets/form-PtDLk33Z.js" with { type: 'file' };
+import f18 from "../dist/assets/Benchmark-BKVE509y.js" with { type: 'file' };
+import f19 from "../dist/assets/QueuesOverview-ClZM34rT.js" with { type: 'file' };
+import f20 from "../dist/assets/react-vendor-CHIHtdAC.js" with { type: 'file' };
+import f21 from "../dist/assets/Workers-N6qIdxg1.js" with { type: 'file' };
+import f22 from "../dist/assets/DlqControl-BUCut0SS.js" with { type: 'file' };
+import f23 from "../dist/assets/JobInspector-dB68adRz.js" with { type: 'file' };
+import f24 from "../dist/assets/jobActions-CuOdMglt.js" with { type: 'file' };
+import f25 from "../dist/assets/WorkersPro-DzjKVhCO.js" with { type: 'file' };
+import f26 from "../dist/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2" with { type: 'file' };
+import f27 from "../dist/assets/Webhooks-B_qJ0bx1.js" with { type: 'file' };
+import f28 from "../dist/assets/CopilotPanel-Bn8gPZx_.js" with { type: 'file' };
+import f29 from "../dist/assets/connectionStore-DI-LYcct.js" with { type: 'file' };
+import f30 from "../dist/assets/JobsPro-BqIHonV6.js" with { type: 'file' };
+import f31 from "../dist/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2" with { type: 'file' };
+import f32 from "../dist/assets/QueueControl-BrHXeXPc.js" with { type: 'file' };
+import f33 from "../dist/assets/Pagination-B-nfZjQZ.js" with { type: 'file' };
+import f34 from "../dist/assets/Queues-5tq1o_1I.js" with { type: 'file' };
+import f35 from "../dist/assets/cn-CMFYpumL.js" with { type: 'file' };
+import f36 from "../dist/assets/CronManager-CI6wTFbe.js" with { type: 'file' };
+import f37 from "../dist/assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2" with { type: 'file' };
+import f38 from "../dist/assets/CopyButton-CSjndiY7.js" with { type: 'file' };
+import f39 from "../dist/assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2" with { type: 'file' };
+import f40 from "../dist/assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2" with { type: 'file' };
+import f41 from "../dist/assets/Database-Bjkl_O9n.js" with { type: 'file' };
+import f42 from "../dist/assets/AddJob-DOtZrwc-.js" with { type: 'file' };
+import f43 from "../dist/assets/Settings-BAELEgud.js" with { type: 'file' };
+import f44 from "../dist/assets/S3BackupPro-CteU25_J.js" with { type: 'file' };
+import f45 from "../dist/assets/Metrics-Bm_pwxzy.js" with { type: 'file' };
+import f46 from "../dist/assets/MetricsPro-DTsnXQVd.js" with { type: 'file' };
+import f47 from "../dist/assets/DlqPro-HoeGdD-B.js" with { type: 'file' };
+import f48 from "../dist/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2" with { type: 'file' };
+import f49 from "../dist/assets/index-ChJpSdwV.js" with { type: 'file' };
+import f50 from "../dist/assets/index-DNaP_bi8.css" with { type: 'file' };
+import f51 from "../dist/assets/inter-latin-wght-normal-Dx4kXJAl.woff2" with { type: 'file' };
+import f52 from "../dist/assets/install-BvB40Zk0.js" with { type: 'file' };
+import f53 from "../dist/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2" with { type: 'file' };
+import f54 from "../dist/assets/S3Backup-BZfckRKX.js" with { type: 'file' };
+import f55 from "../dist/assets/Flows-D9sVq4vd.js" with { type: 'file' };
+import f56 from "../dist/assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2" with { type: 'file' };
+import f57 from "../dist/assets/Jobs-CAHFY5qa.js" with { type: 'file' };
+import f58 from "../dist/index.html" with { type: 'file' };
+
+export const ASSETS: Record<string, string> = {
+  "/.vite/manifest.json": f0,
+  "/favicon.svg": f1,
+  "/assets/QueueDetail-D-C5SXxB.js": f2,
+  "/assets/LogsPro-BPWf8AAv.js": f3,
+  "/assets/UsagePro-BhhM0H05.js": f4,
+  "/assets/Cron-DzeoQTpD.js": f5,
+  "/assets/inter-greek-wght-normal-CkhJZR-_.woff2": f6,
+  "/assets/Dlq-BzwhitJI.js": f7,
+  "/assets/Logs-DjNLXK_r.js": f8,
+  "/assets/AreaChart-DzUXW8u3.js": f9,
+  "/assets/Diagnostics-BUeDbexv.js": f10,
+  "/assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2": f11,
+  "/assets/Overview-O67Y-R5x.js": f12,
+  "/assets/ServerControl-BSLX2WeV.js": f13,
+  "/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2": f14,
+  "/assets/McpServer-BVxK5LwU.js": f15,
+  "/assets/Usage-B_8T34Sp.js": f16,
+  "/assets/form-PtDLk33Z.js": f17,
+  "/assets/Benchmark-BKVE509y.js": f18,
+  "/assets/QueuesOverview-ClZM34rT.js": f19,
+  "/assets/react-vendor-CHIHtdAC.js": f20,
+  "/assets/Workers-N6qIdxg1.js": f21,
+  "/assets/DlqControl-BUCut0SS.js": f22,
+  "/assets/JobInspector-dB68adRz.js": f23,
+  "/assets/jobActions-CuOdMglt.js": f24,
+  "/assets/WorkersPro-DzjKVhCO.js": f25,
+  "/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2": f26,
+  "/assets/Webhooks-B_qJ0bx1.js": f27,
+  "/assets/CopilotPanel-Bn8gPZx_.js": f28,
+  "/assets/connectionStore-DI-LYcct.js": f29,
+  "/assets/JobsPro-BqIHonV6.js": f30,
+  "/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2": f31,
+  "/assets/QueueControl-BrHXeXPc.js": f32,
+  "/assets/Pagination-B-nfZjQZ.js": f33,
+  "/assets/Queues-5tq1o_1I.js": f34,
+  "/assets/cn-CMFYpumL.js": f35,
+  "/assets/CronManager-CI6wTFbe.js": f36,
+  "/assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2": f37,
+  "/assets/CopyButton-CSjndiY7.js": f38,
+  "/assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2": f39,
+  "/assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2": f40,
+  "/assets/Database-Bjkl_O9n.js": f41,
+  "/assets/AddJob-DOtZrwc-.js": f42,
+  "/assets/Settings-BAELEgud.js": f43,
+  "/assets/S3BackupPro-CteU25_J.js": f44,
+  "/assets/Metrics-Bm_pwxzy.js": f45,
+  "/assets/MetricsPro-DTsnXQVd.js": f46,
+  "/assets/DlqPro-HoeGdD-B.js": f47,
+  "/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2": f48,
+  "/assets/index-ChJpSdwV.js": f49,
+  "/assets/index-DNaP_bi8.css": f50,
+  "/assets/inter-latin-wght-normal-Dx4kXJAl.woff2": f51,
+  "/assets/install-BvB40Zk0.js": f52,
+  "/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2": f53,
+  "/assets/S3Backup-BZfckRKX.js": f54,
+  "/assets/Flows-D9sVq4vd.js": f55,
+  "/assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2": f56,
+  "/assets/Jobs-CAHFY5qa.js": f57,
+  "/index.html": f58,
+};

package/scripts/serve.ts

@@ -0,0 +1,92 @@
+#!/usr/bin/env bun
+/**
+ * Standalone bunqueue-dashboard executable (built with `bun build --compile`).
+ *
+ * One binary, three jobs:
+ *   1. Serves the dashboard SPA from assets embedded at compile time.
+ *   2. Proxies /api/* to the bunqueue server (BUNQUEUE_URL, default :6790) —
+ *      same-origin like the dev proxy, so no CORS and SSE streams through.
+ *   3. Runs the control agent (start/stop/restart bunqueue) on 127.0.0.1:6800
+ *      with the same Origin-allowlist security as agent/index.ts.
+ *
+ * Env: PORT (dashboard, default 8080) · BIND_ADDR (default 127.0.0.1) ·
+ *      BUNQUEUE_URL · AGENT_PORT · AGENT_ALLOWED_ORIGINS · AGENT_TOKEN ·
+ *      BUNQUEUE_START_CMD · HTTP_PORT · TCP_PORT · BUNQUEUE_DATA_PATH ·
+ *      LOG_LEVEL (pino level, default info)
+ */
+import { logger } from '../agent/logger';
+import { ProcessManager } from '../agent/manager';
+import { createFetchHandler, resolveAllowedOrigins } from '../agent/server';
+import { ASSETS } from './embedded.gen';
+
+const PORT = Number(process.env.PORT) || 8080;
+// Bind loopback by default: the /api proxy forwards to bunqueue's admin API, so
+// listening on all interfaces would expose it to the whole network. Set
+// BIND_ADDR=0.0.0.0 for direct LAN access (e.g. no reverse proxy in front).
+const HOST = process.env.BIND_ADDR || '127.0.0.1';
+const API = (process.env.BUNQUEUE_URL || 'http://localhost:6790').replace(/\/$/, '');
+const AGENT_PORT = Number(process.env.AGENT_PORT) || 6800;
+
+// Control agent — loopback only, allowlisted CORS; the origins this binary
+// serves the dashboard from are allowed automatically.
+const allowedOrigins = Array.from(
+  new Set([
+    ...resolveAllowedOrigins(),
+    `http://localhost:${PORT}`,
+    `http://127.0.0.1:${PORT}`,
+  ])
+);
+const mgr = new ProcessManager();
+const agentHandle = createFetchHandler(mgr, {
+  allowedOrigins,
+  token: process.env.AGENT_TOKEN || undefined,
+});
+Bun.serve({ port: AGENT_PORT, hostname: '127.0.0.1', fetch: agentHandle });
+
+// Dashboard + /api proxy.
+Bun.serve({
+  port: PORT,
+  hostname: HOST,
+  async fetch(req) {
+    const url = new URL(req.url);
+
+    // Same-origin proxy to the bunqueue server (mirrors the Vite dev proxy).
+    if (url.pathname === '/api' || url.pathname.startsWith('/api/')) {
+      const target = API + (url.pathname.slice(4) || '/') + url.search;
+      const res = await fetch(target, {
+        method: req.method,
+        headers: req.headers,
+        body: req.body,
+        redirect: 'manual',
+      });
+      // Bun's fetch advertises accept-encoding upstream and transparently
+      // DECOMPRESSES the body, but leaves the upstream headers intact. If the
+      // bunqueue server sits behind any gzip-compressing proxy, forwarding
+      // those headers labels plaintext as gzip and the browser fails to decode
+      // every /api response (ERR_CONTENT_DECODING_FAILED) — strip them.
+      const headers = new Headers(res.headers);
+      headers.delete('content-encoding');
+      headers.delete('content-length');
+      headers.delete('transfer-encoding');
+      return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
+    }
+
+    // Embedded static assets with SPA history fallback. A missing fingerprinted
+    // /assets/* file must 404 (as docker/Caddyfile does) — falling back to
+    // index.html would feed HTML to a stale chunk import() and mask the miss.
+    const key = url.pathname === '/' ? '/index.html' : url.pathname;
+    const asset =
+      ASSETS[key] ?? (url.pathname.startsWith('/assets/') ? undefined : ASSETS['/index.html']);
+    if (!asset) return new Response('Not found', { status: 404 });
+    return new Response(Bun.file(asset));
+  },
+});
+
+logger.info(
+  {
+    dashboard: `http://${HOST}:${PORT}`,
+    apiProxy: API,
+    agent: `http://127.0.0.1:${AGENT_PORT}/control`,
+  },
+  'bunqueue dashboard (standalone) ready'
+);