';
html += '
Latest decoded image
';
html += '
' + escapeHtml(meta) + '
';
if (imgSrc) {
@@ -151,11 +195,11 @@ function renderWefaxLatestCard() {
// ── History view: table ─────────────────────────────────────────────
function getWefaxFilteredHistory() {
- var items = wefaxImageHistory;
+ let items = wefaxImageHistory;
if (wefaxFilterText) {
items = items.filter(function (i) {
- var haystack = [
+ const haystack = [
String(i.ioc || ''),
String(i.lpm || ''),
String(i.line_count || ''),
@@ -164,28 +208,28 @@ function getWefaxFilteredHistory() {
});
}
- var sortVal = wefaxDom.sortSelect ? wefaxDom.sortSelect.value : 'newest';
+ const sortVal = wefaxDom.sortSelect ? wefaxDom.sortSelect.value : 'newest';
if (sortVal === 'oldest') items = items.slice().reverse();
return items;
}
-function renderWefaxHistoryRow(img) {
- var row = document.createElement('div');
+function renderWefaxHistoryRow(img: WefaxImage): HTMLElement {
+ const row = document.createElement('div');
row.className = 'sat-history-row';
- var ts = img._ts || '--';
- var date = img._tsMs ? new Date(img._tsMs).toLocaleDateString([], { month: 'short', day: 'numeric' }) : '';
- var ioc = img.ioc || '--';
- var lpm = img.lpm || '--';
- var lines = img.line_count || 0;
+ const ts = img._ts || '--';
+ const date = img._tsMs ? new Date(img._tsMs).toLocaleDateString([], { month: 'short', day: 'numeric' }) : '';
+ const ioc = img.ioc || '--';
+ const lpm = img.lpm || '--';
+ const lines = img.line_count || 0;
- var imgSrc = img._dataUrl
+ const imgSrc = img._dataUrl
? img._dataUrl
: img.path
? '/images/' + escapeHtml(img.path.split('/').pop())
: null;
- var link = imgSrc
+ const link = imgSrc
? '
View'
: '--';
@@ -193,7 +237,7 @@ function renderWefaxHistoryRow(img) {
'
' + escapeHtml(date + ' ' + ts) + '',
'
' + escapeHtml(String(ioc)) + '',
'
' + escapeHtml(String(lpm)) + '',
- '
' + lines + '',
+ `
${String(lines)}`,
'
' + link + '',
].join('');
@@ -203,28 +247,28 @@ function renderWefaxHistoryRow(img) {
function renderWefaxHistoryTable() {
if (!wefaxDom.historyList) return;
pruneWefaxHistory();
- var items = getWefaxFilteredHistory();
- var fragment = document.createDocumentFragment();
- for (var i = 0; i < items.length; i++) {
- fragment.appendChild(renderWefaxHistoryRow(items[i]));
+ const items = getWefaxFilteredHistory();
+ const fragment = document.createDocumentFragment();
+ for (const item of items) {
+ fragment.appendChild(renderWefaxHistoryRow(item));
}
wefaxDom.historyList.replaceChildren(fragment);
if (wefaxDom.historyCount) {
- var total = wefaxImageHistory.length;
- var shown = items.length;
+ const total = wefaxImageHistory.length;
+ const shown = items.length;
wefaxDom.historyCount.textContent =
total === 0
? 'No images yet'
: shown === total
- ? total + ' image' + (total === 1 ? '' : 's')
- : shown + ' of ' + total + ' images';
+ ? `${String(total)} image${total === 1 ? '' : 's'}`
+ : `${String(shown)} of ${String(total)} images`;
}
}
// ── Add image to history ────────────────────────────────────────────
-function addWefaxImage(msg) {
- var tsMs = Number.isFinite(msg.ts_ms) ? Number(msg.ts_ms) : Date.now();
+function addWefaxImage(msg: WefaxImage): void {
+ const tsMs = Number.isFinite(msg.ts_ms) ? Number(msg.ts_ms) : Date.now();
msg._tsMs = tsMs;
msg._ts = new Date(tsMs).toLocaleTimeString([], {
hour: '2-digit',
@@ -233,11 +277,14 @@ function addWefaxImage(msg) {
});
// Capture the live canvas as a data URI for thumbnails.
- if (wefaxLiveCtx && wefaxLiveLineCount > 0) {
- var trimmed = wefaxLiveCtx.getImageData(0, 0, wefaxDom.liveCanvas.width, wefaxLiveLineCount);
- wefaxDom.liveCanvas.height = wefaxLiveLineCount;
+ const canvas = wefaxDom.liveCanvas;
+ if (wefaxLiveCtx && canvas && wefaxLiveLineCount > 0) {
+ const trimmed = wefaxLiveCtx.getImageData(0, 0, canvas.width, wefaxLiveLineCount);
+ canvas.height = wefaxLiveLineCount;
+ wefaxLiveCtx = canvas.getContext('2d');
+ if (!wefaxLiveCtx) return;
wefaxLiveCtx.putImageData(trimmed, 0, 0);
- try { msg._dataUrl = wefaxDom.liveCanvas.toDataURL('image/png'); } catch (e) {}
+ try { msg._dataUrl = canvas.toDataURL('image/png'); } catch {}
}
wefaxImageHistory.unshift(msg);
@@ -252,7 +299,7 @@ function addWefaxImage(msg) {
}
// ── SSE event handlers (public API) ─────────────────────────────────
-window.onServerWefaxProgress = function (msg) {
+wefaxWindow.onServerWefaxProgress = function (msg: WefaxProgress) {
// State-only update (no image data): show decoder state in status.
if (msg.state && !msg.line_data) {
if (wefaxDom.status) {
@@ -263,43 +310,43 @@ window.onServerWefaxProgress = function (msg) {
return;
}
- if (msg.line_count <= 1 || !wefaxLiveCtx) {
+ if ((msg.line_count ?? 0) <= 1 || !wefaxLiveCtx) {
resetLiveCanvas(msg.pixels_per_line || 1809);
}
if (msg.line_data) {
- var binary = atob(msg.line_data);
- var bytes = new Uint8Array(binary.length);
- for (var i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+ const binary = atob(msg.line_data);
+ const bytes = new Uint8Array(binary.length);
+ for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
paintLine(bytes);
}
if (wefaxDom.liveInfo) {
wefaxDom.liveInfo.textContent =
- 'Line ' + msg.line_count + ' \u00b7 ' + msg.ioc + ' IOC \u00b7 ' + msg.lpm + ' LPM';
+ `Line ${String(msg.line_count ?? 0)} \u00b7 ${String(msg.ioc ?? '--')} IOC \u00b7 ${String(msg.lpm ?? '--')} LPM`;
}
if (wefaxDom.status) {
- wefaxDom.status.textContent = 'Receiving \u2014 line ' + msg.line_count;
+ wefaxDom.status.textContent = `Receiving \u2014 line ${String(msg.line_count ?? 0)}`;
wefaxDom.status.style.color = 'var(--text-accent)';
}
};
-window.onServerWefax = function (msg) {
+wefaxWindow.onServerWefax = function (msg: WefaxImage) {
addWefaxImage(msg);
if (wefaxDom.liveContainer) wefaxDom.liveContainer.style.display = 'none';
if (wefaxDom.status) {
- wefaxDom.status.textContent = 'Complete \u2014 ' + msg.line_count + ' lines';
+ wefaxDom.status.textContent = `Complete \u2014 ${String(msg.line_count ?? 0)} lines`;
wefaxDom.status.style.color = '';
}
};
-window.restoreWefaxHistory = function (messages) {
- if (!messages || !messages.length) return;
- for (var i = 0; i < messages.length; i++) {
- var tsMs = Number.isFinite(messages[i].ts_ms) ? Number(messages[i].ts_ms) : Date.now();
- messages[i]._tsMs = tsMs;
- messages[i]._ts = new Date(tsMs).toLocaleTimeString([], {
+wefaxWindow.restoreWefaxHistory = function (messages: WefaxImage[]) {
+ if (!messages.length) return;
+ for (const message of messages) {
+ const tsMs = Number.isFinite(message.ts_ms) ? Number(message.ts_ms) : Date.now();
+ message._tsMs = tsMs;
+ message._ts = new Date(tsMs).toLocaleTimeString([], {
hour: '2-digit',
minute: '2-digit',
second: '2-digit',
@@ -313,13 +360,13 @@ window.restoreWefaxHistory = function (messages) {
}
};
-window.pruneWefaxHistoryView = function () {
+wefaxWindow.pruneWefaxHistoryView = function () {
pruneWefaxHistory();
renderWefaxHistoryTable();
renderWefaxLatestCard();
};
-window.resetWefaxHistoryView = function () {
+wefaxWindow.resetWefaxHistoryView = function () {
wefaxImageHistory = [];
if (wefaxDom.historyList) wefaxDom.historyList.innerHTML = '';
if (wefaxDom.liveContainer) wefaxDom.liveContainer.style.display = 'none';
@@ -335,8 +382,9 @@ window.resetWefaxHistoryView = function () {
// ── Filter / sort handlers ──────────────────────────────────────────
if (wefaxDom.filterInput) {
+ const filterInput = wefaxDom.filterInput;
wefaxDom.filterInput.addEventListener('input', function () {
- wefaxFilterText = wefaxDom.filterInput.value.trim().toUpperCase();
+ wefaxFilterText = filterInput.value.trim().toUpperCase();
scheduleWefaxUi('wefax-history', renderWefaxHistoryTable);
});
}
@@ -350,7 +398,7 @@ if (wefaxDom.sortSelect) {
// Sync the Enable/Disable button from the SSE state update. This is
// belt-and-suspenders alongside app.js _decoderToggles — guarantees the
// WEFAX button always reflects the server state.
-window.syncWefaxToggle = function (enabled) {
+wefaxWindow.syncWefaxToggle = function (enabled: boolean) {
if (!wefaxDom.toggleBtn) return;
wefaxDom.toggleBtn.dataset.enabled = enabled ? 'true' : 'false';
wefaxDom.toggleBtn.textContent = enabled ? 'Disable WEFAX' : 'Enable WEFAX';
@@ -360,26 +408,27 @@ window.syncWefaxToggle = function (enabled) {
// ── Button handlers ─────────────────────────────────────────────────
if (wefaxDom.toggleBtn) {
- wefaxDom.toggleBtn.addEventListener('click', async function () {
+ const toggleButton = wefaxDom.toggleBtn;
+ wefaxDom.toggleBtn.addEventListener('click', () => { void (async () => {
try {
- if (window.takeSchedulerControlForDecoderDisable) {
- await window.takeSchedulerControlForDecoderDisable(wefaxDom.toggleBtn);
+ if (wefaxWindow.takeSchedulerControlForDecoderDisable) {
+ await wefaxWindow.takeSchedulerControlForDecoderDisable(toggleButton);
}
- await postPath('/toggle_wefax_decode');
+ await wefaxWindow.postPath?.('/toggle_wefax_decode');
} catch (e) {
console.error('WEFAX toggle failed', e);
}
- });
+ })(); });
}
if (wefaxDom.clearBtn) {
- wefaxDom.clearBtn.addEventListener('click', async function () {
+ wefaxDom.clearBtn.addEventListener('click', () => { void (async () => {
try {
- await postPath('/clear_wefax_decode');
- window.resetWefaxHistoryView();
+ await wefaxWindow.postPath?.('/clear_wefax_decode');
+ wefaxWindow.resetWefaxHistoryView?.();
} catch (e) {
console.error('WEFAX clear failed', e);
}
- });
+ })(); });
}
// ── Initial render ──────────────────────────────────────────────────
diff --git a/src/trx-client/trx-frontend/trx-frontend-http/frontend/tests/wefax.test.mjs b/src/trx-client/trx-frontend/trx-frontend-http/frontend/tests/wefax.test.mjs
new file mode 100644
index 00000000..08c41edf
--- /dev/null
+++ b/src/trx-client/trx-frontend/trx-frontend-http/frontend/tests/wefax.test.mjs
@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: 2026 Stan Grams
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import test from "node:test";
+import vm from "node:vm";
+
+test("WEFAX entry exposes typed lifecycle handlers and renders decoder state", async () => {
+ const status = { textContent: "", style: { color: "" } };
+ const window = {};
+ const context = vm.createContext({
+ window,
+ document: { getElementById: (id) => id === "wefax-status" ? status : null },
+ Date,
+ Number,
+ String,
+ Uint8Array,
+ console,
+ });
+ const source = await readFile(new URL("../../assets/web/generated/wefax.js", import.meta.url), "utf8");
+ new vm.Script(source).runInContext(context);
+
+ assert.equal(typeof window.onServerWefaxProgress, "function");
+ assert.equal(typeof window.restoreWefaxHistory, "function");
+ window.onServerWefaxProgress({ state: "Scanning 12 MHz" });
+ assert.equal(status.textContent, "Scanning 12 MHz");
+ assert.equal(status.style.color, "var(--text-accent)");
+});