@andrian.yablonskyy/thub-coordinator 1.0.37 → 1.0.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrian.yablonskyy/thub-coordinator",
-  "version": "1.0.37",
+  "version": "1.0.38",
   "description": "TestHub Coordinator — job queue, resource registry, scheduler, heartbeat monitor, log/artifact store and web dashboard",
   "main": "src/server.js",
   "engines": {
@@ -19,7 +19,7 @@
     "lint:fix": "eslint . --fix"
   },
   "dependencies": {
-    "@andrian.yablonskyy/thub-common": "^1.0.31",
+    "@andrian.yablonskyy/thub-common": "^1.0.32",
     "better-sqlite3": "^12.4.1",
     "express": "^5.1.0",
     "express-session": "^1.18.2",

package/public/css/thub.css

@@ -98,3 +98,132 @@
 .tab-content .tab-pane[data-config-pane].active {
   display: block;
 }
+
+/* Help page (views/help/): sticky table of contents, code blocks with a
+   copy button (public/js/help.js). */
+.thub-help-toc {
+  top: 1rem;
+  max-height: calc(100vh - 2rem);
+  overflow-y: auto;
+}
+
+.thub-help-toc .nav-link {
+  font-size: 0.875rem;
+}
+
+.thub-help-section {
+  scroll-margin-top: 1rem;
+}
+
+.thub-code {
+  position: relative;
+}
+
+.thub-code-caption {
+  font-size: 0.75rem;
+  color: var(--bs-secondary-color);
+  margin-bottom: 0.25rem;
+}
+
+.thub-code pre {
+  margin: 0;
+  padding: 0.75rem 3rem 0.75rem 0.75rem;
+  background: var(--bs-tertiary-bg);
+  border: 1px solid var(--bs-border-color);
+  border-radius: var(--bs-border-radius);
+  font-size: 0.8125rem;
+  white-space: pre;
+  overflow-x: auto;
+}
+
+.thub-code pre code {
+  color: var(--bs-body-color);
+}
+
+.thub-code-copy {
+  position: absolute;
+  right: 0.4rem;
+  bottom: 0.4rem;
+  padding: 0.1rem 0.4rem;
+  opacity: 0.7;
+}
+
+.thub-code-copy:hover,
+.thub-code-copy:focus {
+  opacity: 1;
+}
+
+.thub-help-steps > li {
+  margin-bottom: 1rem;
+}
+
+/* List search box (views/mixins/list-controls.pug +searchBox). */
+.thub-search {
+  width: 22rem;
+  max-width: 100%;
+}
+
+.col-12 > .thub-search {
+  width: 100%;
+}
+
+/* Job log search (public/js/log-viewer.js): every match, and the current one. */
+#log-viewer mark.thub-log-hit {
+  padding: 0;
+  background: rgba(255, 193, 7, 0.4);
+  color: inherit;
+}
+
+#log-viewer mark.thub-log-hit.current {
+  background: var(--bs-warning);
+  color: #000;
+  outline: 1px solid var(--bs-warning-border-subtle);
+}
+
+/* Live-update indicator in the navbar (public/js/live.js sets data-state). */
+.thub-live {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  cursor: default;
+  user-select: none;
+}
+
+.thub-live-dot {
+  width: 0.5rem;
+  height: 0.5rem;
+  border-radius: 50%;
+  background: var(--bs-secondary-color);
+}
+
+.thub-live[data-state="live"] .thub-live-dot {
+  background: var(--bs-success);
+  box-shadow: 0 0 0 0 rgba(var(--bs-success-rgb), 0.5);
+  animation: thub-live-pulse 2.5s ease-out infinite;
+}
+
+.thub-live[data-state="paused"] .thub-live-dot {
+  background: var(--bs-warning);
+}
+
+.thub-live[data-state="offline"] .thub-live-dot,
+.thub-live[data-state="ended"] .thub-live-dot {
+  background: var(--bs-danger);
+}
+
+.thub-live[data-state="ended"] {
+  cursor: pointer;
+  color: var(--bs-danger-text-emphasis) !important;
+}
+
+@keyframes thub-live-pulse {
+  0% { box-shadow: 0 0 0 0 rgba(var(--bs-success-rgb), 0.5); }
+  70% { box-shadow: 0 0 0 0.4rem rgba(var(--bs-success-rgb), 0); }
+  100% { box-shadow: 0 0 0 0 rgba(var(--bs-success-rgb), 0); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .thub-live[data-state="live"] .thub-live-dot {
+    animation: none;
+  }
+}

package/public/js/config-import.js

@@ -18,42 +18,46 @@
   const IGNORED = ['joinKey', 'coordinatorUrl', 'name'],
     MAX_BYTES = 64 * 1024;
 
-  document.querySelectorAll('form[data-config-import]').forEach((form) => {
-    const picker = form.querySelector('[data-config-import-file]');
-    form.querySelector('[data-config-import-pick]').addEventListener('click', () => {
+  // Delegated, so forms swapped in by live updates (live.js) work.
+  document.addEventListener('click', (e) => {
+    const pick = e.target.closest('[data-config-import-pick]'),
+      picker = pick?.closest('form[data-config-import]')?.querySelector('[data-config-import-file]');
+    if (picker){
       picker.value = ''; // the same file again still fires `change`
       picker.click();
-    });
+    }
+  });
 
-    picker.addEventListener('change', async () => {
-      const file = picker.files[0];
-      if (!file){
-        return;
-      }
-      const text = file.size > MAX_BYTES ? '' : await file.text();
-      form.querySelector('input[name="file"]').value = text;
-      form.querySelector('input[name="fileName"]').value = file.name;
+  document.addEventListener('change', async (e) => {
+    const picker = e.target.closest?.('[data-config-import-file]'),
+      form = picker?.closest('form[data-config-import]'),
+      file = picker?.files[0];
+    if (!form || !file){
+      return;
+    }
+    const text = file.size > MAX_BYTES ? '' : await file.text();
+    form.querySelector('input[name="file"]').value = text;
+    form.querySelector('input[name="fileName"]').value = file.name;
 
-      let parsed = null;
-      try {
-        parsed = JSON.parse(text);
-      }
-      catch {
-        parsed = null;
-      }
-      if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)){
-        // Nothing to confirm: the Coordinator says what's wrong with it.
-        delete form.dataset.confirm;
-      }
-      else {
-        const present = IGNORED.filter((k) => k in parsed);
-        form.dataset.confirm = `Import ${file.name} into ${form.dataset.resourceName}? ` +
-          'It replaces the Client\'s config (capabilities, labels, groups, heartbeat settings, …); the Client writes it on its next heartbeat ' +
-          'and restarts once it has no job running.\n\n' +
-          `Ignored: joinKey, coordinatorUrl and name${present.length ? ` (in this file: ${present.join(', ')})` : ''}, ` +
-          'and the Client\'s id, file paths and secrets — each Client keeps its own.';
-      }
-      form.requestSubmit();
-    });
+    let parsed = null;
+    try {
+      parsed = JSON.parse(text);
+    }
+    catch {
+      parsed = null;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)){
+      // Nothing to confirm: the Coordinator says what's wrong with it.
+      delete form.dataset.confirm;
+    }
+    else {
+      const present = IGNORED.filter((k) => k in parsed);
+      form.dataset.confirm = `Import ${file.name} into ${form.dataset.resourceName}? ` +
+        'It replaces the Client\'s config (capabilities, labels, groups, heartbeat settings, …); the Client writes it on its next heartbeat ' +
+        'and restarts once it has no job running.\n\n' +
+        `Ignored: joinKey, coordinatorUrl and name${present.length ? ` (in this file: ${present.join(', ')})` : ''}, ` +
+        'and the Client\'s id, file paths and secrets — each Client keeps its own.';
+    }
+    form.requestSubmit();
   });
 })();

package/public/js/copy-to-clipboard.js

@@ -13,24 +13,27 @@
 
 'use strict';
 
+// Delegated, so buttons swapped in by live updates (live.js) work.
 (function (){
-  document.querySelectorAll('[data-copy]').forEach((btn) => {
-    btn.addEventListener('click', async () => {
-      try {
-        await navigator.clipboard.writeText(btn.dataset.copy);
-      }
-      catch {
-        return; // clipboard unavailable (e.g. non-secure context) — fail quietly
-      }
-      const icon = btn.querySelector('i');
-      if (!icon){
-        return;
-      }
-      const original = icon.className;
-      icon.className = 'bi bi-check2';
-      setTimeout(() => {
-        icon.className = original;
-      }, 1200);
-    });
+  document.addEventListener('click', async (e) => {
+    const btn = e.target.closest('[data-copy]');
+    if (!btn){
+      return;
+    }
+    try {
+      await navigator.clipboard.writeText(btn.dataset.copy);
+    }
+    catch {
+      return; // clipboard unavailable (e.g. non-secure context) — fail quietly
+    }
+    const icon = btn.querySelector('i');
+    if (!icon){
+      return;
+    }
+    const original = icon.className;
+    icon.className = 'bi bi-check2';
+    setTimeout(() => {
+      icon.className = original;
+    }, 1200);
   });
 })();

package/public/js/help.js

@@ -0,0 +1,93 @@
+/**
+ * @file        packages/coordinator/public/js/help.js
+ * @description Dashboard Help page: copy buttons on code blocks, table-of-contents scrollspy, section filter
+ *
+ * @author      Andrian Yablonskyy
+ * @copyright   Copyright (c) 2026 Andrian Yablonskyy. All rights reserved.
+ *
+ * This file is part of TestHub and is proprietary and confidential.
+ * Unauthorized copying, modification, distribution, or use of this file,
+ * via any medium, is strictly prohibited without prior written permission
+ * from AdSystem.PRO.
+ */
+
+'use strict';
+
+(function (){
+  // Copy button on every code block (views/help/_mixins.pug +code). Copies
+  // the decoded text, so `&lt;` placeholders come out as `<`.
+  document.querySelectorAll('.thub-code').forEach((figure) => {
+    const code = figure.querySelector('code');
+    if (!code){
+      return;
+    }
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className = 'btn btn-sm btn-outline-secondary thub-code-copy';
+    btn.setAttribute('aria-label', 'Copy to clipboard');
+    btn.title = 'Copy to clipboard';
+    btn.innerHTML = '<i class="bi bi-clipboard"></i>';
+    btn.addEventListener('click', async () => {
+      try {
+        await navigator.clipboard.writeText(code.textContent);
+      }
+      catch {
+        return; // clipboard unavailable (e.g. non-secure context) — fail quietly
+      }
+      const icon = btn.querySelector('i');
+      icon.className = 'bi bi-check2';
+      setTimeout(() => {
+        icon.className = 'bi bi-clipboard';
+      }, 1200);
+    });
+    figure.appendChild(btn);
+  });
+
+  // Highlight the table-of-contents entry of the section in view.
+  if (window.bootstrap && document.getElementById('help-toc')){
+    new window.bootstrap.ScrollSpy(document.body, { target: '#help-toc', rootMargin: '0px 0px -60%' });
+  }
+
+  // Small screens: the jump menu replaces the sidebar.
+  const jump = document.getElementById('help-jump');
+  if (jump){
+    jump.addEventListener('change', () => {
+      document.getElementById(jump.value)?.scrollIntoView({ behavior: 'smooth' });
+    });
+  }
+
+  // Filter: hide sections (and their TOC entries) that don't contain every
+  // word typed. Both filter boxes (sidebar, small screens) stay in sync.
+  const sections = [...document.querySelectorAll('[data-help-section]')],
+    inputs = ['help-filter', 'help-filter-sm'].map((id) => document.getElementById(id)).filter(Boolean),
+    noMatch = document.getElementById('help-no-match'),
+    texts = new Map(sections.map((s) => [s, s.textContent.toLowerCase()]));
+
+  function applyFilter(value){
+    const words = value.toLowerCase().split(/\s+/).filter(Boolean);
+    let shown = 0;
+    for (const section of sections){
+      const match = words.every((w) => texts.get(section).includes(w));
+      section.hidden = !match;
+      shown += match ? 1 : 0;
+      const tocLink = document.querySelector(`[data-help-toc="${section.id}"]`);
+      if (tocLink){
+        tocLink.hidden = !match;
+      }
+    }
+    if (noMatch){
+      noMatch.hidden = shown > 0;
+    }
+  }
+
+  inputs.forEach((input) => {
+    input.addEventListener('input', () => {
+      inputs.forEach((other) => {
+        if (other !== input){
+          other.value = input.value;
+        }
+      });
+      applyFilter(input.value);
+    });
+  });
+})();

package/public/js/list-search.js

@@ -0,0 +1,51 @@
+/**
+ * @file        packages/coordinator/public/js/list-search.js
+ * @description Dashboard list search (views/mixins/list-controls.pug +searchBox): "/" focuses it, Esc clears it
+ *
+ * @author      Andrian Yablonskyy
+ * @copyright   Copyright (c) 2026 Andrian Yablonskyy. All rights reserved.
+ *
+ * This file is part of TestHub and is proprietary and confidential.
+ * Unauthorized copying, modification, distribution, or use of this file,
+ * via any medium, is strictly prohibited without prior written permission
+ * from AdSystem.PRO.
+ */
+
+'use strict';
+
+(function (){
+  const input = document.querySelector('[data-list-search]');
+  if (!input){
+    return;
+  }
+
+  // "/" anywhere outside a text field jumps to the search box (as on GitHub).
+  document.addEventListener('keydown', (e) => {
+    if (e.key !== '/' || e.ctrlKey || e.metaKey || e.altKey){
+      return;
+    }
+    const t = e.target;
+    if (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName)){
+      return;
+    }
+    e.preventDefault();
+    input.focus();
+    input.select();
+  });
+
+  // Esc: empty the box; if the page is showing search results, go back to
+  // the full list (the Clear link keeps the page's other filters).
+  input.addEventListener('keydown', (e) => {
+    if (e.key !== 'Escape'){
+      return;
+    }
+    const clear = input.closest('.thub-search')?.querySelector('[data-list-search-clear]');
+    if (clear){
+      window.location.href = clear.href;
+    }
+    else {
+      input.value = '';
+      input.blur();
+    }
+  });
+})();