feat: add admin debug dashboard for streams and caches
Adds an admin-only Debug menu action in the top bar with a live dashboard for signed-in users, root usage, active stream footprint, and subtitle cache usage per video. The payload now includes videos that still have cached data even when nobody is watching. This helps monitor stream cleanup behaviour and detect lingering cache/segment data during sequential playback sessions.
@@ -16,6 +16,7 @@
16
16
- pruneOldImageSubtitleCaches(filePath, slowestViewerTimeSeconds) - Drops subtitle frame caches for events that have passed their retention threshold of end time + event duration + 5 seconds (e.g., event ending at 30s with 10s duration is dropped after slowest viewer reaches 45s); used during segment pruning to keep memory usage bounded on long videos, especially on resource-limited hardware like Raspberry Pi.
17
17
- purgeSubtitleCacheDir() - Removes the entire subtitle `.sup` file cache directory from disk; called once at server startup to clean up any files left over from a previous run.
18
18
- touchCachedEntry(cache, key, ttlMs) - Refreshes the TTL of an existing cache entry without changing its value; used to keep actively-watched subtitle tracks alive past their initial 5-minute TTL and prevent expensive full re-parses during long playback sessions.
19
- getImageSubtitleDebugSnapshot() - Returns event/frame cache totals and per-video cache usage ({event entries/bytes/count, frame entries/bytes}) so admin diagnostics can list cached subtitle data even when no viewer is connected.
19
20
- IMAGE_SUBTITLE_EVENT_CACHE_TTL_MS / IMAGE_SUBTITLE_FRAME_CACHE_TTL_MS / IMAGE_SUBTITLE_EVENT_CACHE_MAX_ITEMS / IMAGE_SUBTITLE_FRAME_CACHE_MAX_ITEMS / IMAGE_SUBTITLE_EVENT_CACHE_MAX_BYTES / IMAGE_SUBTITLE_FRAME_CACHE_MAX_BYTES / IMAGE_SUBTITLE_RENDER_SCALE / IMAGE_SUBTITLE_PRUNE_GRACE_SECONDS - Environment knobs for subtitle cache retention, item caps, byte caps, render resolution, and prune grace window.
20
21
21
22
## server/thumbnail-cache.js
@@ -62,6 +63,10 @@
62
63
- GET /api/admin/config - Returns admin config including userPath and userFolderSizeLimit (bytes, null for unlimited).
63
64
- PUT /api/admin/config - Persists paths plus userPath/userFolderSizeLimit and ensures per-user folders exist.
64
65
- GET /api/admin/update-status - Returns { underSystemd, commitsAhead[] } where commitsAhead contains non-merge commits as {hash, subject, body}; detects systemd via INVOCATION_ID env var and runs git fetch + git log against origin/HEAD for Restart & Update messaging.
66
- GET /api/admin/debug/stream-stats - Admin diagnostics payload with active signed-in users, per-root storage usage, active stream HLS footprint, subtitle cache totals, and per-video rows that also include cached-only videos with zero active viewers.
67
68
## server/routes/debug.js
69
- GET /api/admin/debug/stream-stats - Computes debug dashboard data by combining auth_sessions activity, root disk usage scans, stream snapshot data, and subtitle cache snapshot data into a per-video view for leak/performance monitoring.
65
70
66
71
## server/routes/files.js
67
72
- GET /api/files/roots - Returns readable roots with display label (alias when configured), originalName, and path.
@@ -124,6 +129,7 @@
124
129
- sendVideoStreamAsset(sessionId, assetPath, req, res) - Resolves viewer leases to a shared stream session, serves HLS assets, tracks lease activity, and prunes segments using the slowest active viewer position.
125
130
- releaseVideoStreamSession(sessionId) - Releases one viewer lease; only destroys the underlying transcode session when no active leases remain; cleanup also clears image subtitle frame/event caches to prevent memory accumulation.
126
131
- runSegmentPrune(session) - Removes HLS segment files that fall behind the slowest active viewer and calls pruneImageSubtitleCachesForSession() to drop old subtitle frames once they pass end time + duration + 30 seconds, so subtitle buffers follow the same retention rules as video chunks.
132
- getVideoStreamDebugSnapshot() - Returns active stream sessions with viewer counts and output-dir stats (segment counts/bytes), plus orphaned output directories left under the stream root for diagnostics.
127
133
- STREAM_ROOT_DIR - Temporary root directory for active ffmpeg-backed stream sessions.
128
134
- STREAM_SESSION_TTL_MS - Idle lifetime for a stream session before cleanup.
129
135
- STREAM_IDLE_STOP_MS - Maximum client inactivity window before an active stream session is terminated (5 minutes).
@@ -146,8 +152,10 @@
146
152
- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
147
153
- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
148
154
- User menu - Includes a Change Password action and a dedicated change-password modal with current/new/confirm fields.
155
- User menu - Admin users also get a Debug action that opens a live diagnostics dashboard modal.
149
156
- Admin panel - Includes an icon-only global favicon button that opens the shared icon picker modal.
150
157
- Admin panel - Users section includes a conditional orphaned-user-folders subsection that appears only when non-empty orphan folders exist.
158
- Debug dashboard modal - Shows active signed-in users, total/per-root storage usage, active stream footprint, cached subtitle usage by video, and orphaned stream output directories.
151
159
- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
152
160
- Import map - Maps `three` and `three/addons/` to local vendored modules for client-side STL/OBJ previews.
153
161
@@ -16,6 +16,7 @@16
- pruneOldImageSubtitleCaches(filePath, slowestViewerTimeSeconds) - Drops subtitle frame caches for events that have passed their retention threshold of end time + event duration + 5 seconds (e.g., event ending at 30s with 10s duration is dropped after slowest viewer reaches 45s); used during segment pruning to keep memory usage bounded on long videos, especially on resource-limited hardware like Raspberry Pi.
16
- pruneOldImageSubtitleCaches(filePath, slowestViewerTimeSeconds) - Drops subtitle frame caches for events that have passed their retention threshold of end time + event duration + 5 seconds (e.g., event ending at 30s with 10s duration is dropped after slowest viewer reaches 45s); used during segment pruning to keep memory usage bounded on long videos, especially on resource-limited hardware like Raspberry Pi.
17
- purgeSubtitleCacheDir() - Removes the entire subtitle `.sup` file cache directory from disk; called once at server startup to clean up any files left over from a previous run.
17
- purgeSubtitleCacheDir() - Removes the entire subtitle `.sup` file cache directory from disk; called once at server startup to clean up any files left over from a previous run.
18
- touchCachedEntry(cache, key, ttlMs) - Refreshes the TTL of an existing cache entry without changing its value; used to keep actively-watched subtitle tracks alive past their initial 5-minute TTL and prevent expensive full re-parses during long playback sessions.
18
- touchCachedEntry(cache, key, ttlMs) - Refreshes the TTL of an existing cache entry without changing its value; used to keep actively-watched subtitle tracks alive past their initial 5-minute TTL and prevent expensive full re-parses during long playback sessions.
19
- getImageSubtitleDebugSnapshot() - Returns event/frame cache totals and per-video cache usage ({event entries/bytes/count, frame entries/bytes}) so admin diagnostics can list cached subtitle data even when no viewer is connected.
19
- IMAGE_SUBTITLE_EVENT_CACHE_TTL_MS / IMAGE_SUBTITLE_FRAME_CACHE_TTL_MS / IMAGE_SUBTITLE_EVENT_CACHE_MAX_ITEMS / IMAGE_SUBTITLE_FRAME_CACHE_MAX_ITEMS / IMAGE_SUBTITLE_EVENT_CACHE_MAX_BYTES / IMAGE_SUBTITLE_FRAME_CACHE_MAX_BYTES / IMAGE_SUBTITLE_RENDER_SCALE / IMAGE_SUBTITLE_PRUNE_GRACE_SECONDS - Environment knobs for subtitle cache retention, item caps, byte caps, render resolution, and prune grace window.
20
- IMAGE_SUBTITLE_EVENT_CACHE_TTL_MS / IMAGE_SUBTITLE_FRAME_CACHE_TTL_MS / IMAGE_SUBTITLE_EVENT_CACHE_MAX_ITEMS / IMAGE_SUBTITLE_FRAME_CACHE_MAX_ITEMS / IMAGE_SUBTITLE_EVENT_CACHE_MAX_BYTES / IMAGE_SUBTITLE_FRAME_CACHE_MAX_BYTES / IMAGE_SUBTITLE_RENDER_SCALE / IMAGE_SUBTITLE_PRUNE_GRACE_SECONDS - Environment knobs for subtitle cache retention, item caps, byte caps, render resolution, and prune grace window.
20
21
21
## server/thumbnail-cache.js
22
## server/thumbnail-cache.js
@@ -62,6 +63,10 @@62
- GET /api/admin/config - Returns admin config including userPath and userFolderSizeLimit (bytes, null for unlimited).
63
- GET /api/admin/config - Returns admin config including userPath and userFolderSizeLimit (bytes, null for unlimited).
63
- PUT /api/admin/config - Persists paths plus userPath/userFolderSizeLimit and ensures per-user folders exist.
64
- PUT /api/admin/config - Persists paths plus userPath/userFolderSizeLimit and ensures per-user folders exist.
64
- GET /api/admin/update-status - Returns { underSystemd, commitsAhead[] } where commitsAhead contains non-merge commits as {hash, subject, body}; detects systemd via INVOCATION_ID env var and runs git fetch + git log against origin/HEAD for Restart & Update messaging.
65
- GET /api/admin/update-status - Returns { underSystemd, commitsAhead[] } where commitsAhead contains non-merge commits as {hash, subject, body}; detects systemd via INVOCATION_ID env var and runs git fetch + git log against origin/HEAD for Restart & Update messaging.
66
- GET /api/admin/debug/stream-stats - Admin diagnostics payload with active signed-in users, per-root storage usage, active stream HLS footprint, subtitle cache totals, and per-video rows that also include cached-only videos with zero active viewers.
67
68
## server/routes/debug.js
69
- GET /api/admin/debug/stream-stats - Computes debug dashboard data by combining auth_sessions activity, root disk usage scans, stream snapshot data, and subtitle cache snapshot data into a per-video view for leak/performance monitoring.
65
70
66
## server/routes/files.js
71
## server/routes/files.js
67
- GET /api/files/roots - Returns readable roots with display label (alias when configured), originalName, and path.
72
- GET /api/files/roots - Returns readable roots with display label (alias when configured), originalName, and path.
@@ -124,6 +129,7 @@124
- sendVideoStreamAsset(sessionId, assetPath, req, res) - Resolves viewer leases to a shared stream session, serves HLS assets, tracks lease activity, and prunes segments using the slowest active viewer position.
129
- sendVideoStreamAsset(sessionId, assetPath, req, res) - Resolves viewer leases to a shared stream session, serves HLS assets, tracks lease activity, and prunes segments using the slowest active viewer position.
125
- releaseVideoStreamSession(sessionId) - Releases one viewer lease; only destroys the underlying transcode session when no active leases remain; cleanup also clears image subtitle frame/event caches to prevent memory accumulation.
130
- releaseVideoStreamSession(sessionId) - Releases one viewer lease; only destroys the underlying transcode session when no active leases remain; cleanup also clears image subtitle frame/event caches to prevent memory accumulation.
126
- runSegmentPrune(session) - Removes HLS segment files that fall behind the slowest active viewer and calls pruneImageSubtitleCachesForSession() to drop old subtitle frames once they pass end time + duration + 30 seconds, so subtitle buffers follow the same retention rules as video chunks.
131
- runSegmentPrune(session) - Removes HLS segment files that fall behind the slowest active viewer and calls pruneImageSubtitleCachesForSession() to drop old subtitle frames once they pass end time + duration + 30 seconds, so subtitle buffers follow the same retention rules as video chunks.
132
- getVideoStreamDebugSnapshot() - Returns active stream sessions with viewer counts and output-dir stats (segment counts/bytes), plus orphaned output directories left under the stream root for diagnostics.
127
- STREAM_ROOT_DIR - Temporary root directory for active ffmpeg-backed stream sessions.
133
- STREAM_ROOT_DIR - Temporary root directory for active ffmpeg-backed stream sessions.
128
- STREAM_SESSION_TTL_MS - Idle lifetime for a stream session before cleanup.
134
- STREAM_SESSION_TTL_MS - Idle lifetime for a stream session before cleanup.
129
- STREAM_IDLE_STOP_MS - Maximum client inactivity window before an active stream session is terminated (5 minutes).
135
- STREAM_IDLE_STOP_MS - Maximum client inactivity window before an active stream session is terminated (5 minutes).
@@ -146,8 +152,10 @@146
- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
152
- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
147
- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
153
- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
148
- User menu - Includes a Change Password action and a dedicated change-password modal with current/new/confirm fields.
154
- User menu - Includes a Change Password action and a dedicated change-password modal with current/new/confirm fields.
155
- User menu - Admin users also get a Debug action that opens a live diagnostics dashboard modal.
149
- Admin panel - Includes an icon-only global favicon button that opens the shared icon picker modal.
156
- Admin panel - Includes an icon-only global favicon button that opens the shared icon picker modal.
150
- Admin panel - Users section includes a conditional orphaned-user-folders subsection that appears only when non-empty orphan folders exist.
157
- Admin panel - Users section includes a conditional orphaned-user-folders subsection that appears only when non-empty orphan folders exist.
158
- Debug dashboard modal - Shows active signed-in users, total/per-root storage usage, active stream footprint, cached subtitle usage by video, and orphaned stream output directories.
151
- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
159
- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
152
- Import map - Maps `three` and `three/addons/` to local vendored modules for client-side STL/OBJ previews.
160
- Import map - Maps `three` and `three/addons/` to local vendored modules for client-side STL/OBJ previews.
153
161
@@ -12,6 +12,7 @@
12
12
- `DELETE /api/admin/users/:id`
13
13
- `GET /api/admin/orphan-userfolders`
14
14
- `GET /api/admin/config`
15
- `GET /api/admin/debug/stream-stats`
15
16
- `PUT /api/admin/config`
16
17
- `POST /api/admin/shutdown`
17
18
- `GET /api/admin/update-status`
@@ -12,6 +12,7 @@12
- `DELETE /api/admin/users/:id`12
- `DELETE /api/admin/users/:id`13
- `GET /api/admin/orphan-userfolders`13
- `GET /api/admin/orphan-userfolders`14
- `GET /api/admin/config`14
- `GET /api/admin/config`15
- `GET /api/admin/debug/stream-stats`15
- `PUT /api/admin/config`16
- `PUT /api/admin/config`16
- `POST /api/admin/shutdown`17
- `POST /api/admin/shutdown`17
- `GET /api/admin/update-status`18
- `GET /api/admin/update-status`@@ -1694,6 +1694,7 @@ async function openShareModal (item)
1694
1694
function showAuthOverlay (setupMode = false)
1695
1695
{
1696
1696
if (typeof document === 'undefined' || typeof document.getElementById !== 'function') return;
1697
closeDebugModal();
1697
1698
document.getElementById('app').classList.add('hidden');
1698
1699
const overlay = document.getElementById('auth-overlay');
1699
1700
const usernameInput = document.getElementById('auth-username');
@@ -1726,6 +1727,7 @@ function showApp ()
1726
1727
openFolderSidebar();
1727
1728
}
1728
1729
document.getElementById('btn-admin').classList.toggle('hidden', !STATE.isAdmin);
1730
document.getElementById('btn-debug').classList.toggle('hidden', !STATE.isAdmin);
1729
1731
const userLabel = document.getElementById('user-menu-label');
1730
1732
if (userLabel) userLabel.textContent = STATE.username || 'User';
1731
1733
void refreshGlobalFavicon();
@@ -5790,6 +5792,141 @@ async function deleteItem (item)
5790
5792
// ───────────────────────────────────────────────────────────────────────────
5791
5793
5792
5794
let _adminUpdateStatus = null;
5795
let _debugRefreshTimer = null;
5796
5797
function formatTimestamp (ms)
5798
{
5799
const value = Number(ms || 0);
5800
if (!Number.isFinite(value) || value <= 0) return '—';
5801
try
5802
{
5803
return new Date(value).toLocaleString();
5804
} catch
5805
{
5806
return '—';
5807
}
5808
}
5809
5810
function renderDebugTable (containerId, columns, rows)
5811
{
5812
const container = document.getElementById(containerId);
5813
if (!container) return;
5814
5815
if (!Array.isArray(rows) || rows.length === 0)
5816
{
5817
container.innerHTML = '<div class="muted" style="padding:0.7rem">No data.</div>';
5818
return;
5819
}
5820
5821
const headHtml = columns.map((col) => `<th>${escapeHtml(col.label)}</th>`).join('');
5822
const bodyHtml = rows.map((row) =>
5823
`<tr>${columns.map((col) => `<td>${col.render(row)}</td>`).join('')}</tr>`).join('');
5824
5825
container.innerHTML = `<table class="debug-table"><thead><tr>${headHtml}</tr></thead><tbody>${bodyHtml}</tbody></table>`;
5826
}
5827
5828
function renderDebugDashboardData (data)
5829
{
5830
const generatedAt = document.getElementById('debug-generated-at');
5831
if (generatedAt) generatedAt.textContent = `Last update: ${formatTimestamp(data.generatedAt)}`;
5832
5833
const usersEl = document.getElementById('debug-users');
5834
if (usersEl)
5835
{
5836
const users = Array.isArray(data.loggedInUsers) ? data.loggedInUsers : [];
5837
usersEl.innerHTML = users.length
5838
? users.map((user) => `<span class="debug-chip">${escapeHtml(user.username || 'Unknown')} · ${escapeHtml(formatTimestamp(user.lastSeenAt))}</span>`).join('')
5839
: '<span class="muted">No active sessions.</span>';
5840
}
5841
5842
const summary = document.getElementById('debug-storage-summary');
5843
if (summary)
5844
{
5845
const storage = data.storage || {};
5846
const roots = Array.isArray(storage.roots) ? storage.roots.length : 0;
5847
const activeStreams = Number(data.videoStream && data.videoStream.activeSessionCount) || 0;
5848
const activeLeases = Number(data.videoStream && data.videoStream.activeLeaseCount) || 0;
5849
summary.innerHTML = [
5850
['Configured roots', String(roots)],
5851
['Total used', formatBytes(storage.totalBytes || 0)],
5852
['Total files', String(storage.totalFiles || 0)],
5853
['Active streams', String(activeStreams)],
5854
['Active viewers', String(activeLeases)],
5855
].map(([k, v]) => `<div class="debug-summary-item"><span class="k">${escapeHtml(k)}</span><span class="v">${escapeHtml(v)}</span></div>`).join('');
5856
}
5857
5858
renderDebugTable(
5859
'debug-roots',
5860
[
5861
{ label: 'Root', render: (row) => `<span class="debug-path">${escapeHtml(row.path || '')}</span>` },
5862
{ label: 'Exists', render: (row) => row.exists ? 'Yes' : 'No' },
5863
{ label: 'Used', render: (row) => escapeHtml(formatBytes(row.bytes || 0)) },
5864
{ label: 'Files', render: (row) => escapeHtml(String(row.files || 0)) },
5865
{ label: 'Folders', render: (row) => escapeHtml(String(row.directories || 0)) },
5866
],
5867
Array.isArray(data.storage && data.storage.roots) ? data.storage.roots : [],
5868
);
5869
5870
renderDebugTable(
5871
'debug-video-files',
5872
[
5873
{ label: 'Video file', render: (row) => `<span class="debug-path">${escapeHtml(row.filePath || '')}</span>` },
5874
{ label: 'Viewers', render: (row) => escapeHtml(String(row.viewers || 0)) },
5875
{ label: 'Segments', render: (row) => escapeHtml(String(row.stream && row.stream.output ? row.stream.output.segmentFiles : 0)) },
5876
{ label: 'Segment bytes', render: (row) => escapeHtml(formatBytes(row.stream && row.stream.output ? row.stream.output.segmentBytes : 0)) },
5877
{ label: 'Event cache', render: (row) => escapeHtml(String(row.subtitleCache ? row.subtitleCache.eventEntries : 0)) },
5878
{ label: 'Event bytes', render: (row) => escapeHtml(formatBytes(row.subtitleCache ? row.subtitleCache.eventBytes : 0)) },
5879
{ label: 'Event PNG bytes', render: (row) => escapeHtml(formatBytes(row.subtitleCache ? row.subtitleCache.eventImageBytes : 0)) },
5880
{ label: 'Frame cache', render: (row) => escapeHtml(String(row.subtitleCache ? row.subtitleCache.frameEntries : 0)) },
5881
{ label: 'Frame bytes', render: (row) => escapeHtml(formatBytes(row.subtitleCache ? row.subtitleCache.frameBytes : 0)) },
5882
{ label: 'Session ID', render: (row) => escapeHtml((row.activeSessionIds || []).join(', ') || '—') },
5883
],
5884
Array.isArray(data.videoFiles) ? data.videoFiles : [],
5885
);
5886
5887
renderDebugTable(
5888
'debug-orphaned-streams',
5889
[
5890
{ label: 'Output directory', render: (row) => `<span class="debug-path">${escapeHtml(row.outputDir || '')}</span>` },
5891
{ label: 'Files', render: (row) => escapeHtml(String(row.output && row.output.totalFiles || 0)) },
5892
{ label: 'Bytes', render: (row) => escapeHtml(formatBytes(row.output && row.output.totalBytes || 0)) },
5893
{ label: 'Segments', render: (row) => escapeHtml(String(row.output && row.output.segmentFiles || 0)) },
5894
],
5895
Array.isArray(data.videoStream && data.videoStream.orphanedOutputDirs) ? data.videoStream.orphanedOutputDirs : [],
5896
);
5897
}
5898
5899
async function refreshDebugDashboard ()
5900
{
5901
const data = await api('GET', '/admin/debug/stream-stats');
5902
if (!data) return;
5903
renderDebugDashboardData(data);
5904
}
5905
5906
async function openDebugModal ()
5907
{
5908
const modal = document.getElementById('debug-modal');
5909
if (!modal) return;
5910
modal.classList.remove('hidden');
5911
await refreshDebugDashboard();
5912
5913
if (_debugRefreshTimer) clearInterval(_debugRefreshTimer);
5914
_debugRefreshTimer = setInterval(() =>
5915
{
5916
void refreshDebugDashboard();
5917
}, 5000);
5918
}
5919
5920
function closeDebugModal ()
5921
{
5922
const modal = document.getElementById('debug-modal');
5923
if (modal) modal.classList.add('hidden');
5924
if (_debugRefreshTimer)
5925
{
5926
clearInterval(_debugRefreshTimer);
5927
_debugRefreshTimer = null;
5928
}
5929
}
5793
5930
5794
5931
function animateBadgeToTarget (targetEl)
5795
5932
{
@@ -7021,16 +7158,30 @@ function wireEvents ()
7021
7158
document.addEventListener('keydown', (e) =>
7022
7159
{
7023
7160
if (e.key === 'Escape') closeCustomContextMenu();
7161
if (e.key === 'Escape') closeDebugModal();
7024
7162
});
7025
7163
7026
7164
// Admin panel
7027
7165
document.getElementById('btn-admin').addEventListener('click', openAdminModal);
7166
document.getElementById('btn-debug').addEventListener('click', () =>
7167
{
7168
void openDebugModal();
7169
});
7028
7170
document.getElementById('btn-admin-favicon').addEventListener('click', () =>
7029
7171
{
7030
7172
void openGlobalFaviconPicker();
7031
7173
});
7032
7174
document.getElementById('admin-modal-close').addEventListener('click', () =>
7033
7175
document.getElementById('admin-modal').classList.add('hidden'));
7176
document.getElementById('debug-modal-close').addEventListener('click', closeDebugModal);
7177
document.getElementById('debug-refresh').addEventListener('click', () =>
7178
{
7179
void refreshDebugDashboard();
7180
});
7181
document.getElementById('debug-modal').addEventListener('click', (e) =>
7182
{
7183
if (e.target && e.target.id === 'debug-modal') closeDebugModal();
7184
});
7034
7185
7035
7186
// Add path
7036
7187
document.getElementById('admin-add-path').addEventListener('click', () =>
@@ -1694,6 +1694,7 @@ async function openShareModal (item)1694
function showAuthOverlay (setupMode = false)1694
function showAuthOverlay (setupMode = false)1695
{1695
{1696
if (typeof document === 'undefined' || typeof document.getElementById !== 'function') return;1696
if (typeof document === 'undefined' || typeof document.getElementById !== 'function') return;1697
closeDebugModal();1697
document.getElementById('app').classList.add('hidden');1698
document.getElementById('app').classList.add('hidden');1698
const overlay = document.getElementById('auth-overlay');1699
const overlay = document.getElementById('auth-overlay');1699
const usernameInput = document.getElementById('auth-username');1700
const usernameInput = document.getElementById('auth-username');@@ -1726,6 +1727,7 @@ function showApp ()1726
openFolderSidebar();1727
openFolderSidebar();1727
}1728
}1728
document.getElementById('btn-admin').classList.toggle('hidden', !STATE.isAdmin);1729
document.getElementById('btn-admin').classList.toggle('hidden', !STATE.isAdmin);1730
document.getElementById('btn-debug').classList.toggle('hidden', !STATE.isAdmin);1729
const userLabel = document.getElementById('user-menu-label');1731
const userLabel = document.getElementById('user-menu-label');1730
if (userLabel) userLabel.textContent = STATE.username || 'User';1732
if (userLabel) userLabel.textContent = STATE.username || 'User';1731
void refreshGlobalFavicon();1733
void refreshGlobalFavicon();@@ -5790,6 +5792,141 @@ async function deleteItem (item)5790
// ───────────────────────────────────────────────────────────────────────────5792
// ───────────────────────────────────────────────────────────────────────────5791
5793
5792
let _adminUpdateStatus = null;5794
let _adminUpdateStatus = null;5795
let _debugRefreshTimer = null;5796
5797
function formatTimestamp (ms)5798
{5799
const value = Number(ms || 0);5800
if (!Number.isFinite(value) || value <= 0) return '—';5801
try5802
{5803
return new Date(value).toLocaleString();5804
} catch5805
{5806
return '—';5807
}5808
}5809
5810
function renderDebugTable (containerId, columns, rows)5811
{5812
const container = document.getElementById(containerId);5813
if (!container) return;5814
5815
if (!Array.isArray(rows) || rows.length === 0)5816
{5817
container.innerHTML = '<div class="muted" style="padding:0.7rem">No data.</div>';5818
return;5819
}5820
5821
const headHtml = columns.map((col) => `<th>${escapeHtml(col.label)}</th>`).join('');5822
const bodyHtml = rows.map((row) =>5823
`<tr>${columns.map((col) => `<td>${col.render(row)}</td>`).join('')}</tr>`).join('');5824
5825
container.innerHTML = `<table class="debug-table"><thead><tr>${headHtml}</tr></thead><tbody>${bodyHtml}</tbody></table>`;5826
}5827
5828
function renderDebugDashboardData (data)5829
{5830
const generatedAt = document.getElementById('debug-generated-at');5831
if (generatedAt) generatedAt.textContent = `Last update: ${formatTimestamp(data.generatedAt)}`;5832
5833
const usersEl = document.getElementById('debug-users');5834
if (usersEl)5835
{5836
const users = Array.isArray(data.loggedInUsers) ? data.loggedInUsers : [];5837
usersEl.innerHTML = users.length5838
? users.map((user) => `<span class="debug-chip">${escapeHtml(user.username || 'Unknown')} · ${escapeHtml(formatTimestamp(user.lastSeenAt))}</span>`).join('')5839
: '<span class="muted">No active sessions.</span>';5840
}5841
5842
const summary = document.getElementById('debug-storage-summary');5843
if (summary)5844
{5845
const storage = data.storage || {};5846
const roots = Array.isArray(storage.roots) ? storage.roots.length : 0;5847
const activeStreams = Number(data.videoStream && data.videoStream.activeSessionCount) || 0;5848
const activeLeases = Number(data.videoStream && data.videoStream.activeLeaseCount) || 0;5849
summary.innerHTML = [5850
['Configured roots', String(roots)],5851
['Total used', formatBytes(storage.totalBytes || 0)],5852
['Total files', String(storage.totalFiles || 0)],5853
['Active streams', String(activeStreams)],5854
['Active viewers', String(activeLeases)],5855
].map(([k, v]) => `<div class="debug-summary-item"><span class="k">${escapeHtml(k)}</span><span class="v">${escapeHtml(v)}</span></div>`).join('');5856
}5857
5858
renderDebugTable(5859
'debug-roots',5860
[5861
{ label: 'Root', render: (row) => `<span class="debug-path">${escapeHtml(row.path || '')}</span>` },5862
{ label: 'Exists', render: (row) => row.exists ? 'Yes' : 'No' },5863
{ label: 'Used', render: (row) => escapeHtml(formatBytes(row.bytes || 0)) },5864
{ label: 'Files', render: (row) => escapeHtml(String(row.files || 0)) },5865
{ label: 'Folders', render: (row) => escapeHtml(String(row.directories || 0)) },5866
],5867
Array.isArray(data.storage && data.storage.roots) ? data.storage.roots : [],5868
);5869
5870
renderDebugTable(5871
'debug-video-files',5872
[5873
{ label: 'Video file', render: (row) => `<span class="debug-path">${escapeHtml(row.filePath || '')}</span>` },5874
{ label: 'Viewers', render: (row) => escapeHtml(String(row.viewers || 0)) },5875
{ label: 'Segments', render: (row) => escapeHtml(String(row.stream && row.stream.output ? row.stream.output.segmentFiles : 0)) },5876
{ label: 'Segment bytes', render: (row) => escapeHtml(formatBytes(row.stream && row.stream.output ? row.stream.output.segmentBytes : 0)) },5877
{ label: 'Event cache', render: (row) => escapeHtml(String(row.subtitleCache ? row.subtitleCache.eventEntries : 0)) },5878
{ label: 'Event bytes', render: (row) => escapeHtml(formatBytes(row.subtitleCache ? row.subtitleCache.eventBytes : 0)) },5879
{ label: 'Event PNG bytes', render: (row) => escapeHtml(formatBytes(row.subtitleCache ? row.subtitleCache.eventImageBytes : 0)) },5880
{ label: 'Frame cache', render: (row) => escapeHtml(String(row.subtitleCache ? row.subtitleCache.frameEntries : 0)) },5881
{ label: 'Frame bytes', render: (row) => escapeHtml(formatBytes(row.subtitleCache ? row.subtitleCache.frameBytes : 0)) },5882
{ label: 'Session ID', render: (row) => escapeHtml((row.activeSessionIds || []).join(', ') || '—') },5883
],5884
Array.isArray(data.videoFiles) ? data.videoFiles : [],5885
);5886
5887
renderDebugTable(5888
'debug-orphaned-streams',5889
[5890
{ label: 'Output directory', render: (row) => `<span class="debug-path">${escapeHtml(row.outputDir || '')}</span>` },5891
{ label: 'Files', render: (row) => escapeHtml(String(row.output && row.output.totalFiles || 0)) },5892
{ label: 'Bytes', render: (row) => escapeHtml(formatBytes(row.output && row.output.totalBytes || 0)) },5893
{ label: 'Segments', render: (row) => escapeHtml(String(row.output && row.output.segmentFiles || 0)) },5894
],5895
Array.isArray(data.videoStream && data.videoStream.orphanedOutputDirs) ? data.videoStream.orphanedOutputDirs : [],5896
);5897
}5898
5899
async function refreshDebugDashboard ()5900
{5901
const data = await api('GET', '/admin/debug/stream-stats');5902
if (!data) return;5903
renderDebugDashboardData(data);5904
}5905
5906
async function openDebugModal ()5907
{5908
const modal = document.getElementById('debug-modal');5909
if (!modal) return;5910
modal.classList.remove('hidden');5911
await refreshDebugDashboard();5912
5913
if (_debugRefreshTimer) clearInterval(_debugRefreshTimer);5914
_debugRefreshTimer = setInterval(() =>5915
{5916
void refreshDebugDashboard();5917
}, 5000);5918
}5919
5920
function closeDebugModal ()5921
{5922
const modal = document.getElementById('debug-modal');5923
if (modal) modal.classList.add('hidden');5924
if (_debugRefreshTimer)5925
{5926
clearInterval(_debugRefreshTimer);5927
_debugRefreshTimer = null;5928
}5929
}5793
5930
5794
function animateBadgeToTarget (targetEl)5931
function animateBadgeToTarget (targetEl)5795
{5932
{@@ -7021,16 +7158,30 @@ function wireEvents ()7021
document.addEventListener('keydown', (e) =>7158
document.addEventListener('keydown', (e) =>7022
{7159
{7023
if (e.key === 'Escape') closeCustomContextMenu();7160
if (e.key === 'Escape') closeCustomContextMenu();7161
if (e.key === 'Escape') closeDebugModal();7024
});7162
});7025
7163
7026
// Admin panel7164
// Admin panel7027
document.getElementById('btn-admin').addEventListener('click', openAdminModal);7165
document.getElementById('btn-admin').addEventListener('click', openAdminModal);7166
document.getElementById('btn-debug').addEventListener('click', () =>7167
{7168
void openDebugModal();7169
});7028
document.getElementById('btn-admin-favicon').addEventListener('click', () =>7170
document.getElementById('btn-admin-favicon').addEventListener('click', () =>7029
{7171
{7030
void openGlobalFaviconPicker();7172
void openGlobalFaviconPicker();7031
});7173
});7032
document.getElementById('admin-modal-close').addEventListener('click', () =>7174
document.getElementById('admin-modal-close').addEventListener('click', () =>7033
document.getElementById('admin-modal').classList.add('hidden'));7175
document.getElementById('admin-modal').classList.add('hidden'));7176
document.getElementById('debug-modal-close').addEventListener('click', closeDebugModal);7177
document.getElementById('debug-refresh').addEventListener('click', () =>7178
{7179
void refreshDebugDashboard();7180
});7181
document.getElementById('debug-modal').addEventListener('click', (e) =>7182
{7183
if (e.target && e.target.id === 'debug-modal') closeDebugModal();7184
});7034
7185
7035
// Add path7186
// Add path7036
document.getElementById('admin-add-path').addEventListener('click', () =>7187
document.getElementById('admin-add-path').addEventListener('click', () =>@@ -106,6 +106,16 @@
106
106
</svg>
107
107
Admin
108
108
</button>
109
<button id="btn-debug" class="topbar-menu-item hidden" type="button" role="menuitem" title="Debug dashboard"
110
aria-label="Debug dashboard">
111
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
112
stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
113
<rect x="3" y="4" width="18" height="12" rx="2" ry="2" />
114
<line x1="8" y1="20" x2="16" y2="20" />
115
<line x1="12" y1="16" x2="12" y2="20" />
116
</svg>
117
Debug
118
</button>
109
119
<button id="btn-change-password" class="topbar-menu-item" type="button" role="menuitem" title="Change Password"
110
120
aria-label="Change Password">
111
121
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
@@ -220,6 +230,42 @@
220
230
</div>
221
231
</div>
222
232
233
<!-- DEBUG MODAL -->
234
<div id="debug-modal" class="modal-overlay hidden">
235
<div class="modal debug-modal">
236
<button class="modal-close" id="debug-modal-close" aria-label="Close debug dashboard">✕</button>
237
<h2>Debug Dashboard</h2>
238
<p class="muted">Live diagnostics for active streams, cache usage and signed-in users.</p>
239
240
<div class="debug-toolbar">
241
<span id="debug-generated-at" class="muted">Last update: —</span>
242
<button id="debug-refresh" class="primary" type="button">Refresh</button>
243
</div>
244
245
<section>
246
<h3>Signed-in Users</h3>
247
<div id="debug-users" class="debug-chips"></div>
248
</section>
249
250
<section>
251
<h3>Storage Usage</h3>
252
<div id="debug-storage-summary" class="debug-summary-grid"></div>
253
<div id="debug-roots" class="debug-table-wrap"></div>
254
</section>
255
256
<section>
257
<h3>Video Streams and Caches</h3>
258
<p class="muted">Includes files with cached subtitle data even if no viewers are currently watching.</p>
259
<div id="debug-video-files" class="debug-table-wrap"></div>
260
</section>
261
262
<section>
263
<h3>Orphaned Stream Output Directories</h3>
264
<div id="debug-orphaned-streams" class="debug-table-wrap"></div>
265
</section>
266
</div>
267
</div>
268
223
269
<!-- NEW / EDIT USER MODAL -->
224
270
<div id="user-modal" class="modal-overlay hidden">
225
271
<div class="modal">
@@ -106,6 +106,16 @@106
</svg>106
</svg>107
Admin107
Admin108
</button>108
</button>109
<button id="btn-debug" class="topbar-menu-item hidden" type="button" role="menuitem" title="Debug dashboard"110
aria-label="Debug dashboard">111
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"112
stroke-width="2" stroke-linecap="round" stroke-linejoin="round">113
<rect x="3" y="4" width="18" height="12" rx="2" ry="2" />114
<line x1="8" y1="20" x2="16" y2="20" />115
<line x1="12" y1="16" x2="12" y2="20" />116
</svg>117
Debug118
</button>109
<button id="btn-change-password" class="topbar-menu-item" type="button" role="menuitem" title="Change Password"119
<button id="btn-change-password" class="topbar-menu-item" type="button" role="menuitem" title="Change Password"110
aria-label="Change Password">120
aria-label="Change Password">111
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"121
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"@@ -220,6 +230,42 @@220
</div>230
</div>221
</div>231
</div>222
232
233
<!-- DEBUG MODAL -->234
<div id="debug-modal" class="modal-overlay hidden">235
<div class="modal debug-modal">236
<button class="modal-close" id="debug-modal-close" aria-label="Close debug dashboard">✕</button>237
<h2>Debug Dashboard</h2>238
<p class="muted">Live diagnostics for active streams, cache usage and signed-in users.</p>239
240
<div class="debug-toolbar">241
<span id="debug-generated-at" class="muted">Last update: —</span>242
<button id="debug-refresh" class="primary" type="button">Refresh</button>243
</div>244
245
<section>246
<h3>Signed-in Users</h3>247
<div id="debug-users" class="debug-chips"></div>248
</section>249
250
<section>251
<h3>Storage Usage</h3>252
<div id="debug-storage-summary" class="debug-summary-grid"></div>253
<div id="debug-roots" class="debug-table-wrap"></div>254
</section>255
256
<section>257
<h3>Video Streams and Caches</h3>258
<p class="muted">Includes files with cached subtitle data even if no viewers are currently watching.</p>259
<div id="debug-video-files" class="debug-table-wrap"></div>260
</section>261
262
<section>263
<h3>Orphaned Stream Output Directories</h3>264
<div id="debug-orphaned-streams" class="debug-table-wrap"></div>265
</section>266
</div>267
</div>268
223
<!-- NEW / EDIT USER MODAL -->269
<!-- NEW / EDIT USER MODAL -->224
<div id="user-modal" class="modal-overlay hidden">270
<div id="user-modal" class="modal-overlay hidden">225
<div class="modal">271
<div class="modal">@@ -981,6 +981,97 @@ button.danger.admin-update-highlight {
981
981
border-color: var(--accent);
982
982
}
983
983
984
.debug-modal {
985
width: min(980px, 96vw);
986
max-height: 92vh;
987
}
988
989
.debug-toolbar {
990
display: flex;
991
justify-content: space-between;
992
align-items: center;
993
gap: 0.8rem;
994
margin: 0.75rem 0 1rem;
995
}
996
997
.debug-summary-grid {
998
display: grid;
999
grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
1000
gap: 0.6rem;
1001
margin-bottom: 0.8rem;
1002
}
1003
1004
.debug-summary-item {
1005
background: var(--bg);
1006
border: 1px solid var(--border);
1007
border-radius: 10px;
1008
padding: 0.55rem 0.7rem;
1009
}
1010
1011
.debug-summary-item .k {
1012
display: block;
1013
color: var(--text-muted);
1014
font-size: 0.82rem;
1015
}
1016
1017
.debug-summary-item .v {
1018
display: block;
1019
color: var(--text);
1020
font-weight: 650;
1021
margin-top: 0.12rem;
1022
}
1023
1024
.debug-chips {
1025
display: flex;
1026
flex-wrap: wrap;
1027
gap: 0.45rem;
1028
}
1029
1030
.debug-chip {
1031
border: 1px solid var(--border);
1032
border-radius: 999px;
1033
padding: 0.22rem 0.6rem;
1034
background: var(--bg);
1035
font-size: 0.82rem;
1036
}
1037
1038
.debug-table-wrap {
1039
border: 1px solid var(--border);
1040
border-radius: 10px;
1041
overflow: auto;
1042
background: var(--bg);
1043
}
1044
1045
.debug-table {
1046
width: 100%;
1047
border-collapse: collapse;
1048
font-size: 0.85rem;
1049
}
1050
1051
.debug-table th,
1052
.debug-table td {
1053
border-bottom: 1px solid var(--border);
1054
text-align: left;
1055
vertical-align: top;
1056
padding: 0.45rem 0.55rem;
1057
}
1058
1059
.debug-table thead th {
1060
position: sticky;
1061
top: 0;
1062
z-index: 1;
1063
background: var(--surface);
1064
}
1065
1066
.debug-table tr:last-child td {
1067
border-bottom: 0;
1068
}
1069
1070
.debug-path {
1071
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
1072
word-break: break-word;
1073
}
1074
984
1075
.folder-icon-cell {
985
1076
display: flex;
986
1077
flex-direction: column;
@@ -981,6 +981,97 @@ button.danger.admin-update-highlight {981
border-color: var(--accent);
981
border-color: var(--accent);
982
}
982
}
983
983
984
.debug-modal {
985
width: min(980px, 96vw);
986
max-height: 92vh;
987
}
988
989
.debug-toolbar {
990
display: flex;
991
justify-content: space-between;
992
align-items: center;
993
gap: 0.8rem;
994
margin: 0.75rem 0 1rem;
995
}
996
997
.debug-summary-grid {
998
display: grid;
999
grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
1000
gap: 0.6rem;
1001
margin-bottom: 0.8rem;
1002
}
1003
1004
.debug-summary-item {
1005
background: var(--bg);
1006
border: 1px solid var(--border);
1007
border-radius: 10px;
1008
padding: 0.55rem 0.7rem;
1009
}
1010
1011
.debug-summary-item .k {
1012
display: block;
1013
color: var(--text-muted);
1014
font-size: 0.82rem;
1015
}
1016
1017
.debug-summary-item .v {
1018
display: block;
1019
color: var(--text);
1020
font-weight: 650;
1021
margin-top: 0.12rem;
1022
}
1023
1024
.debug-chips {
1025
display: flex;
1026
flex-wrap: wrap;
1027
gap: 0.45rem;
1028
}
1029
1030
.debug-chip {
1031
border: 1px solid var(--border);
1032
border-radius: 999px;
1033
padding: 0.22rem 0.6rem;
1034
background: var(--bg);
1035
font-size: 0.82rem;
1036
}
1037
1038
.debug-table-wrap {
1039
border: 1px solid var(--border);
1040
border-radius: 10px;
1041
overflow: auto;
1042
background: var(--bg);
1043
}
1044
1045
.debug-table {
1046
width: 100%;
1047
border-collapse: collapse;
1048
font-size: 0.85rem;
1049
}
1050
1051
.debug-table th,
1052
.debug-table td {
1053
border-bottom: 1px solid var(--border);
1054
text-align: left;
1055
vertical-align: top;
1056
padding: 0.45rem 0.55rem;
1057
}
1058
1059
.debug-table thead th {
1060
position: sticky;
1061
top: 0;
1062
z-index: 1;
1063
background: var(--surface);
1064
}
1065
1066
.debug-table tr:last-child td {
1067
border-bottom: 0;
1068
}
1069
1070
.debug-path {
1071
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
1072
word-break: break-word;
1073
}
1074
984
.folder-icon-cell {
1075
.folder-icon-cell {
985
display: flex;
1076
display: flex;
986
flex-direction: column;
1077
flex-direction: column;
@@ -670,10 +670,95 @@ function clearCachesForFile (filePath)
670
670
}
671
671
}
672
672
673
function filePathFromCacheKey (key)
674
{
675
const raw = String(key || '');
676
const divider = raw.indexOf('|');
677
if (divider < 0) return '';
678
return raw.slice(0, divider);
679
}
680
681
function getImageSubtitleDebugSnapshot ()
682
{
683
const byFile = {};
684
685
for (const [key, entry] of eventCache.map.entries())
686
{
687
const filePath = filePathFromCacheKey(key);
688
if (!filePath) continue;
689
690
const row = byFile[filePath] || {
691
filePath,
692
eventEntries: 0,
693
eventBytes: 0,
694
eventCount: 0,
695
eventImageBytes: 0,
696
frameEntries: 0,
697
frameBytes: 0,
698
};
699
700
row.eventEntries += 1;
701
row.eventBytes += Number(entry && entry.sizeBytes) || 0;
702
703
const value = entry && entry.value;
704
if (value && Array.isArray(value.events))
705
{
706
row.eventCount += value.events.length;
707
for (const event of value.events)
708
{
709
if (event && Buffer.isBuffer(event.imagePng))
710
{
711
row.eventImageBytes += event.imagePng.length;
712
}
713
}
714
}
715
716
byFile[filePath] = row;
717
}
718
719
for (const [key, entry] of frameCache.map.entries())
720
{
721
const filePath = filePathFromCacheKey(key);
722
if (!filePath) continue;
723
724
const row = byFile[filePath] || {
725
filePath,
726
eventEntries: 0,
727
eventBytes: 0,
728
eventCount: 0,
729
eventImageBytes: 0,
730
frameEntries: 0,
731
frameBytes: 0,
732
};
733
734
row.frameEntries += 1;
735
row.frameBytes += Number(entry && entry.sizeBytes) || 0;
736
737
byFile[filePath] = row;
738
}
739
740
return {
741
eventCache: {
742
entries: eventCache.map.size,
743
bytes: eventCache.totalBytes,
744
maxItems: eventCache.maxItems,
745
maxBytes: eventCache.maxBytes,
746
},
747
frameCache: {
748
entries: frameCache.map.size,
749
bytes: frameCache.totalBytes,
750
maxItems: frameCache.maxItems,
751
maxBytes: frameCache.maxBytes,
752
},
753
byFile,
754
};
755
}
756
673
757
module.exports = {
674
758
parseRenderOptions,
675
759
renderImageSubtitleFrame,
676
760
clearCachesForFile,
677
761
pruneOldImageSubtitleCaches,
678
762
purgeSubtitleCacheDir,
763
getImageSubtitleDebugSnapshot,
679
764
};
@@ -670,10 +670,95 @@ function clearCachesForFile (filePath)670
}670
}671
}671
}672
672
673
function filePathFromCacheKey (key)674
{675
const raw = String(key || '');676
const divider = raw.indexOf('|');677
if (divider < 0) return '';678
return raw.slice(0, divider);679
}680
681
function getImageSubtitleDebugSnapshot ()682
{683
const byFile = {};684
685
for (const [key, entry] of eventCache.map.entries())686
{687
const filePath = filePathFromCacheKey(key);688
if (!filePath) continue;689
690
const row = byFile[filePath] || {691
filePath,692
eventEntries: 0,693
eventBytes: 0,694
eventCount: 0,695
eventImageBytes: 0,696
frameEntries: 0,697
frameBytes: 0,698
};699
700
row.eventEntries += 1;701
row.eventBytes += Number(entry && entry.sizeBytes) || 0;702
703
const value = entry && entry.value;704
if (value && Array.isArray(value.events))705
{706
row.eventCount += value.events.length;707
for (const event of value.events)708
{709
if (event && Buffer.isBuffer(event.imagePng))710
{711
row.eventImageBytes += event.imagePng.length;712
}713
}714
}715
716
byFile[filePath] = row;717
}718
719
for (const [key, entry] of frameCache.map.entries())720
{721
const filePath = filePathFromCacheKey(key);722
if (!filePath) continue;723
724
const row = byFile[filePath] || {725
filePath,726
eventEntries: 0,727
eventBytes: 0,728
eventCount: 0,729
eventImageBytes: 0,730
frameEntries: 0,731
frameBytes: 0,732
};733
734
row.frameEntries += 1;735
row.frameBytes += Number(entry && entry.sizeBytes) || 0;736
737
byFile[filePath] = row;738
}739
740
return {741
eventCache: {742
entries: eventCache.map.size,743
bytes: eventCache.totalBytes,744
maxItems: eventCache.maxItems,745
maxBytes: eventCache.maxBytes,746
},747
frameCache: {748
entries: frameCache.map.size,749
bytes: frameCache.totalBytes,750
maxItems: frameCache.maxItems,751
maxBytes: frameCache.maxBytes,752
},753
byFile,754
};755
}756
673
module.exports = {757
module.exports = {674
parseRenderOptions,758
parseRenderOptions,675
renderImageSubtitleFrame,759
renderImageSubtitleFrame,676
clearCachesForFile,760
clearCachesForFile,677
pruneOldImageSubtitleCaches,761
pruneOldImageSubtitleCaches,678
purgeSubtitleCacheDir,762
purgeSubtitleCacheDir,763
getImageSubtitleDebugSnapshot,679
};764
};@@ -45,6 +45,7 @@ function ensureUserFolders (userPath)
45
45
const { getDb } = require('../db');
46
46
const { requireAuth, requireAdmin } = require('../auth');
47
47
const { loadConfig, saveConfig, getEffectivePaths } = require('../config');
48
const debugRouter = require('./debug');
48
49
49
50
const BCRYPT_ROUNDS = 12;
50
51
@@ -141,6 +142,7 @@ function listOrphanUserFolders (userFolderRoot, options = {})
141
142
142
143
// All admin routes require authentication + admin privilege
143
144
router.use(requireAuth, requireAdmin);
145
router.use(debugRouter);
144
146
145
147
// ---------------------------------------------------------------------------
146
148
// GET /api/admin/users
@@ -45,6 +45,7 @@ function ensureUserFolders (userPath)45
const { getDb } = require('../db');45
const { getDb } = require('../db');46
const { requireAuth, requireAdmin } = require('../auth');46
const { requireAuth, requireAdmin } = require('../auth');47
const { loadConfig, saveConfig, getEffectivePaths } = require('../config');47
const { loadConfig, saveConfig, getEffectivePaths } = require('../config');48
const debugRouter = require('./debug');48
49
49
const BCRYPT_ROUNDS = 12;50
const BCRYPT_ROUNDS = 12;50
51
@@ -141,6 +142,7 @@ function listOrphanUserFolders (userFolderRoot, options = {})141
142
142
// All admin routes require authentication + admin privilege143
// All admin routes require authentication + admin privilege143
router.use(requireAuth, requireAdmin);144
router.use(requireAuth, requireAdmin);145
router.use(debugRouter);144
146
145
// ---------------------------------------------------------------------------147
// ---------------------------------------------------------------------------146
// GET /api/admin/users148
// GET /api/admin/users@@ -0,0 +1,202 @@
1
'use strict';
2
3
const express = require('express');
4
const fs = require('fs');
5
const path = require('path');
6
7
const router = express.Router();
8
9
const { getDb } = require('../db');
10
const { loadConfig, getEffectivePaths } = require('../config');
11
const { getImageSubtitleDebugSnapshot } = require('../image-subtitles');
12
const { getVideoStreamDebugSnapshot } = require('../video-stream');
13
14
const AUTH_IDLE_TIMEOUT_MS = 60 * 60 * 1000;
15
16
function safeResolve (value)
17
{
18
return path.resolve(String(value || '').trim());
19
}
20
21
function normaliseRootsForUsage (config)
22
{
23
const rawRoots = Array.isArray(config.paths) ? config.paths : [];
24
const effective = getEffectivePaths(rawRoots);
25
const roots = new Set(effective.map((root) => safeResolve(root)));
26
27
const userPath = String(config.userPath || '').trim();
28
if (userPath)
29
{
30
const resolvedUserPath = safeResolve(userPath);
31
const isCovered = [...roots].some((root) =>
32
resolvedUserPath === root || resolvedUserPath.startsWith(`${root}${path.sep}`));
33
if (!isCovered) roots.add(resolvedUserPath);
34
}
35
36
return [...roots];
37
}
38
39
function walkDirectorySize (rootPath)
40
{
41
let bytes = 0;
42
let files = 0;
43
let directories = 0;
44
const stack = [rootPath];
45
46
while (stack.length > 0)
47
{
48
const current = stack.pop();
49
let entries = [];
50
try
51
{
52
entries = fs.readdirSync(current, { withFileTypes: true });
53
} catch
54
{
55
continue;
56
}
57
58
for (const entry of entries)
59
{
60
const fullPath = path.join(current, entry.name);
61
if (entry.isDirectory())
62
{
63
directories += 1;
64
stack.push(fullPath);
65
continue;
66
}
67
68
if (!entry.isFile()) continue;
69
try
70
{
71
const stat = fs.statSync(fullPath);
72
bytes += Number.isFinite(stat.size) ? stat.size : 0;
73
files += 1;
74
} catch
75
{
76
// Best effort; skip unreadable files.
77
}
78
}
79
}
80
81
return { bytes, files, directories };
82
}
83
84
function collectRootUsageStats ()
85
{
86
const config = loadConfig();
87
const roots = normaliseRootsForUsage(config);
88
89
const perRoot = [];
90
let totalBytes = 0;
91
let totalFiles = 0;
92
93
for (const root of roots)
94
{
95
const row = {
96
path: root,
97
exists: fs.existsSync(root),
98
bytes: 0,
99
files: 0,
100
directories: 0,
101
};
102
103
if (row.exists)
104
{
105
const usage = walkDirectorySize(root);
106
row.bytes = usage.bytes;
107
row.files = usage.files;
108
row.directories = usage.directories;
109
totalBytes += usage.bytes;
110
totalFiles += usage.files;
111
}
112
113
perRoot.push(row);
114
}
115
116
return {
117
roots: perRoot,
118
totalBytes,
119
totalFiles,
120
};
121
}
122
123
function getLoggedInUsersSnapshot ()
124
{
125
const db = getDb();
126
const now = Date.now();
127
const activeSince = now - AUTH_IDLE_TIMEOUT_MS;
128
129
const rows = db.prepare(
130
`SELECT username, MAX(last_seen_at) AS lastSeenAt
131
FROM auth_sessions
132
WHERE revoked_at IS NULL
133
AND last_seen_at >= ?
134
GROUP BY username
135
ORDER BY username COLLATE NOCASE ASC`,
136
).all([activeSince]);
137
138
return rows.map((row) => ({
139
username: String(row.username || ''),
140
lastSeenAt: Number(row.lastSeenAt || 0),
141
}));
142
}
143
144
function buildVideoDebugRows (videoSnapshot, subtitleSnapshot)
145
{
146
const perFile = new Map();
147
148
const activeStreams = Array.isArray(videoSnapshot.activeStreams) ? videoSnapshot.activeStreams : [];
149
for (const stream of activeStreams)
150
{
151
const key = safeResolve(stream.sourcePath);
152
perFile.set(key, {
153
filePath: key,
154
viewers: Number(stream.viewers || 0),
155
activeSessionIds: [stream.sessionId],
156
stream: stream,
157
subtitleCache: null,
158
});
159
}
160
161
const subtitleByFile = subtitleSnapshot && subtitleSnapshot.byFile ? subtitleSnapshot.byFile : {};
162
for (const [filePath, subtitleRow] of Object.entries(subtitleByFile))
163
{
164
const key = safeResolve(filePath);
165
const existing = perFile.get(key);
166
if (existing)
167
{
168
existing.subtitleCache = subtitleRow;
169
continue;
170
}
171
172
perFile.set(key, {
173
filePath: key,
174
viewers: 0,
175
activeSessionIds: [],
176
stream: null,
177
subtitleCache: subtitleRow,
178
});
179
}
180
181
return [...perFile.values()].sort((a, b) => a.filePath.localeCompare(b.filePath));
182
}
183
184
router.get('/debug/stream-stats', (req, res) =>
185
{
186
const rootUsage = collectRootUsageStats();
187
const loggedInUsers = getLoggedInUsersSnapshot();
188
const videoStream = getVideoStreamDebugSnapshot();
189
const subtitleCache = getImageSubtitleDebugSnapshot();
190
const videoFiles = buildVideoDebugRows(videoStream, subtitleCache);
191
192
res.json({
193
generatedAt: Date.now(),
194
loggedInUsers,
195
storage: rootUsage,
196
videoStream,
197
subtitleCache,
198
videoFiles,
199
});
200
});
201
202
module.exports = router;
@@ -0,0 +1,202 @@1
'use strict';2
3
const express = require('express');4
const fs = require('fs');5
const path = require('path');6
7
const router = express.Router();8
9
const { getDb } = require('../db');10
const { loadConfig, getEffectivePaths } = require('../config');11
const { getImageSubtitleDebugSnapshot } = require('../image-subtitles');12
const { getVideoStreamDebugSnapshot } = require('../video-stream');13
14
const AUTH_IDLE_TIMEOUT_MS = 60 * 60 * 1000;15
16
function safeResolve (value)17
{18
return path.resolve(String(value || '').trim());19
}20
21
function normaliseRootsForUsage (config)22
{23
const rawRoots = Array.isArray(config.paths) ? config.paths : [];24
const effective = getEffectivePaths(rawRoots);25
const roots = new Set(effective.map((root) => safeResolve(root)));26
27
const userPath = String(config.userPath || '').trim();28
if (userPath)29
{30
const resolvedUserPath = safeResolve(userPath);31
const isCovered = [...roots].some((root) =>32
resolvedUserPath === root || resolvedUserPath.startsWith(`${root}${path.sep}`));33
if (!isCovered) roots.add(resolvedUserPath);34
}35
36
return [...roots];37
}38
39
function walkDirectorySize (rootPath)40
{41
let bytes = 0;42
let files = 0;43
let directories = 0;44
const stack = [rootPath];45
46
while (stack.length > 0)47
{48
const current = stack.pop();49
let entries = [];50
try51
{52
entries = fs.readdirSync(current, { withFileTypes: true });53
} catch54
{55
continue;56
}57
58
for (const entry of entries)59
{60
const fullPath = path.join(current, entry.name);61
if (entry.isDirectory())62
{63
directories += 1;64
stack.push(fullPath);65
continue;66
}67
68
if (!entry.isFile()) continue;69
try70
{71
const stat = fs.statSync(fullPath);72
bytes += Number.isFinite(stat.size) ? stat.size : 0;73
files += 1;74
} catch75
{76
// Best effort; skip unreadable files.77
}78
}79
}80
81
return { bytes, files, directories };82
}83
84
function collectRootUsageStats ()85
{86
const config = loadConfig();87
const roots = normaliseRootsForUsage(config);88
89
const perRoot = [];90
let totalBytes = 0;91
let totalFiles = 0;92
93
for (const root of roots)94
{95
const row = {96
path: root,97
exists: fs.existsSync(root),98
bytes: 0,99
files: 0,100
directories: 0,101
};102
103
if (row.exists)104
{105
const usage = walkDirectorySize(root);106
row.bytes = usage.bytes;107
row.files = usage.files;108
row.directories = usage.directories;109
totalBytes += usage.bytes;110
totalFiles += usage.files;111
}112
113
perRoot.push(row);114
}115
116
return {117
roots: perRoot,118
totalBytes,119
totalFiles,120
};121
}122
123
function getLoggedInUsersSnapshot ()124
{125
const db = getDb();126
const now = Date.now();127
const activeSince = now - AUTH_IDLE_TIMEOUT_MS;128
129
const rows = db.prepare(130
`SELECT username, MAX(last_seen_at) AS lastSeenAt131
FROM auth_sessions132
WHERE revoked_at IS NULL133
AND last_seen_at >= ?134
GROUP BY username135
ORDER BY username COLLATE NOCASE ASC`,136
).all([activeSince]);137
138
return rows.map((row) => ({139
username: String(row.username || ''),140
lastSeenAt: Number(row.lastSeenAt || 0),141
}));142
}143
144
function buildVideoDebugRows (videoSnapshot, subtitleSnapshot)145
{146
const perFile = new Map();147
148
const activeStreams = Array.isArray(videoSnapshot.activeStreams) ? videoSnapshot.activeStreams : [];149
for (const stream of activeStreams)150
{151
const key = safeResolve(stream.sourcePath);152
perFile.set(key, {153
filePath: key,154
viewers: Number(stream.viewers || 0),155
activeSessionIds: [stream.sessionId],156
stream: stream,157
subtitleCache: null,158
});159
}160
161
const subtitleByFile = subtitleSnapshot && subtitleSnapshot.byFile ? subtitleSnapshot.byFile : {};162
for (const [filePath, subtitleRow] of Object.entries(subtitleByFile))163
{164
const key = safeResolve(filePath);165
const existing = perFile.get(key);166
if (existing)167
{168
existing.subtitleCache = subtitleRow;169
continue;170
}171
172
perFile.set(key, {173
filePath: key,174
viewers: 0,175
activeSessionIds: [],176
stream: null,177
subtitleCache: subtitleRow,178
});179
}180
181
return [...perFile.values()].sort((a, b) => a.filePath.localeCompare(b.filePath));182
}183
184
router.get('/debug/stream-stats', (req, res) =>185
{186
const rootUsage = collectRootUsageStats();187
const loggedInUsers = getLoggedInUsersSnapshot();188
const videoStream = getVideoStreamDebugSnapshot();189
const subtitleCache = getImageSubtitleDebugSnapshot();190
const videoFiles = buildVideoDebugRows(videoStream, subtitleCache);191
192
res.json({193
generatedAt: Date.now(),194
loggedInUsers,195
storage: rootUsage,196
videoStream,197
subtitleCache,198
videoFiles,199
});200
});201
202
module.exports = router;@@ -1058,6 +1058,116 @@ function releaseVideoStreamSession (sessionId)
1058
1058
return true;
1059
1059
}
1060
1060
1061
function collectOutputDirStats (outputDir)
1062
{
1063
const stats = {
1064
exists: false,
1065
totalBytes: 0,
1066
totalFiles: 0,
1067
segmentFiles: 0,
1068
segmentBytes: 0,
1069
playlistFiles: 0,
1070
subtitleFiles: 0,
1071
};
1072
1073
if (!outputDir || !fs.existsSync(outputDir)) return stats;
1074
stats.exists = true;
1075
1076
let entries = [];
1077
try
1078
{
1079
entries = fs.readdirSync(outputDir, { withFileTypes: true });
1080
} catch
1081
{
1082
return stats;
1083
}
1084
1085
for (const entry of entries)
1086
{
1087
if (!entry.isFile()) continue;
1088
const name = entry.name;
1089
const fullPath = path.join(outputDir, name);
1090
let size = 0;
1091
try
1092
{
1093
const fileStat = fs.statSync(fullPath);
1094
size = Number(fileStat.size) || 0;
1095
} catch
1096
{
1097
size = 0;
1098
}
1099
1100
stats.totalFiles += 1;
1101
stats.totalBytes += size;
1102
1103
if (/\.ts$/i.test(name))
1104
{
1105
stats.segmentFiles += 1;
1106
stats.segmentBytes += size;
1107
continue;
1108
}
1109
1110
if (/\.m3u8$/i.test(name))
1111
{
1112
stats.playlistFiles += 1;
1113
continue;
1114
}
1115
1116
if (/\.(sup|vtt)$/i.test(name))
1117
{
1118
stats.subtitleFiles += 1;
1119
}
1120
}
1121
1122
return stats;
1123
}
1124
1125
function getVideoStreamDebugSnapshot ()
1126
{
1127
const activeStreams = [];
1128
1129
for (const [sessionId, session] of sessions.entries())
1130
{
1131
activeStreams.push({
1132
sessionId,
1133
sourcePath: session.sourcePath,
1134
outputDir: session.outputDir,
1135
viewers: session.leaseIds ? session.leaseIds.size : 0,
1136
activeRequests: Number(session.activeRequests || 0),
1137
expiresAt: Number(session.expiresAt || 0),
1138
output: collectOutputDirStats(session.outputDir),
1139
});
1140
}
1141
1142
const knownSessionDirs = new Set(activeStreams.map((stream) => path.resolve(stream.outputDir || '')));
1143
const orphanedOutputDirs = [];
1144
try
1145
{
1146
const entries = fs.readdirSync(STREAM_ROOT_DIR, { withFileTypes: true });
1147
for (const entry of entries)
1148
{
1149
if (!entry.isDirectory()) continue;
1150
const dirPath = path.resolve(path.join(STREAM_ROOT_DIR, entry.name));
1151
if (knownSessionDirs.has(dirPath)) continue;
1152
orphanedOutputDirs.push({
1153
outputDir: dirPath,
1154
output: collectOutputDirStats(dirPath),
1155
});
1156
}
1157
} catch
1158
{
1159
// Stream root may not exist yet.
1160
}
1161
1162
return {
1163
streamRootDir: STREAM_ROOT_DIR,
1164
activeSessionCount: sessions.size,
1165
activeLeaseCount: leases.size,
1166
activeStreams,
1167
orphanedOutputDirs,
1168
};
1169
}
1170
1061
1171
module.exports = {
1062
1172
STREAM_ROOT_DIR,
1063
1173
STREAM_SESSION_TTL_MS,
@@ -1066,4 +1176,5 @@ module.exports = {
1066
1176
createVideoStreamSession,
1067
1177
sendVideoStreamAsset,
1068
1178
releaseVideoStreamSession,
1179
getVideoStreamDebugSnapshot,
1069
1180
};
@@ -1058,6 +1058,116 @@ function releaseVideoStreamSession (sessionId)1058
return true;1058
return true;1059
}1059
}1060
1060
1061
function collectOutputDirStats (outputDir)1062
{1063
const stats = {1064
exists: false,1065
totalBytes: 0,1066
totalFiles: 0,1067
segmentFiles: 0,1068
segmentBytes: 0,1069
playlistFiles: 0,1070
subtitleFiles: 0,1071
};1072
1073
if (!outputDir || !fs.existsSync(outputDir)) return stats;1074
stats.exists = true;1075
1076
let entries = [];1077
try1078
{1079
entries = fs.readdirSync(outputDir, { withFileTypes: true });1080
} catch1081
{1082
return stats;1083
}1084
1085
for (const entry of entries)1086
{1087
if (!entry.isFile()) continue;1088
const name = entry.name;1089
const fullPath = path.join(outputDir, name);1090
let size = 0;1091
try1092
{1093
const fileStat = fs.statSync(fullPath);1094
size = Number(fileStat.size) || 0;1095
} catch1096
{1097
size = 0;1098
}1099
1100
stats.totalFiles += 1;1101
stats.totalBytes += size;1102
1103
if (/\.ts$/i.test(name))1104
{1105
stats.segmentFiles += 1;1106
stats.segmentBytes += size;1107
continue;1108
}1109
1110
if (/\.m3u8$/i.test(name))1111
{1112
stats.playlistFiles += 1;1113
continue;1114
}1115
1116
if (/\.(sup|vtt)$/i.test(name))1117
{1118
stats.subtitleFiles += 1;1119
}1120
}1121
1122
return stats;1123
}1124
1125
function getVideoStreamDebugSnapshot ()1126
{1127
const activeStreams = [];1128
1129
for (const [sessionId, session] of sessions.entries())1130
{1131
activeStreams.push({1132
sessionId,1133
sourcePath: session.sourcePath,1134
outputDir: session.outputDir,1135
viewers: session.leaseIds ? session.leaseIds.size : 0,1136
activeRequests: Number(session.activeRequests || 0),1137
expiresAt: Number(session.expiresAt || 0),1138
output: collectOutputDirStats(session.outputDir),1139
});1140
}1141
1142
const knownSessionDirs = new Set(activeStreams.map((stream) => path.resolve(stream.outputDir || '')));1143
const orphanedOutputDirs = [];1144
try1145
{1146
const entries = fs.readdirSync(STREAM_ROOT_DIR, { withFileTypes: true });1147
for (const entry of entries)1148
{1149
if (!entry.isDirectory()) continue;1150
const dirPath = path.resolve(path.join(STREAM_ROOT_DIR, entry.name));1151
if (knownSessionDirs.has(dirPath)) continue;1152
orphanedOutputDirs.push({1153
outputDir: dirPath,1154
output: collectOutputDirStats(dirPath),1155
});1156
}1157
} catch1158
{1159
// Stream root may not exist yet.1160
}1161
1162
return {1163
streamRootDir: STREAM_ROOT_DIR,1164
activeSessionCount: sessions.size,1165
activeLeaseCount: leases.size,1166
activeStreams,1167
orphanedOutputDirs,1168
};1169
}1170
1061
module.exports = {1171
module.exports = {1062
STREAM_ROOT_DIR,1172
STREAM_ROOT_DIR,1063
STREAM_SESSION_TTL_MS,1173
STREAM_SESSION_TTL_MS,@@ -1066,4 +1176,5 @@ module.exports = {1066
createVideoStreamSession,1176
createVideoStreamSession,1067
sendVideoStreamAsset,1177
sendVideoStreamAsset,1068
releaseVideoStreamSession,1178
releaseVideoStreamSession,1179
getVideoStreamDebugSnapshot,1069
};1180
};@@ -12,6 +12,20 @@ const fs = require('fs');
12
12
const os = require('os');
13
13
const path = require('path');
14
14
15
let mockVideoStreamSnapshot = {
16
streamRootDir: '/tmp/filemanager-video-streams',
17
activeSessionCount: 0,
18
activeLeaseCount: 0,
19
activeStreams: [],
20
orphanedOutputDirs: [],
21
};
22
23
let mockSubtitleSnapshot = {
24
eventCache: { entries: 0, bytes: 0, maxItems: 3, maxBytes: 0 },
25
frameCache: { entries: 0, bytes: 0, maxItems: 50, maxBytes: 0 },
26
byFile: {},
27
};
28
15
29
// ── child_process mock — controlled per test ──────────────────────────────────
16
30
let mockExecFileImpl = null;
17
31
jest.mock('child_process', () =>
@@ -56,6 +70,16 @@ jest.mock('../server/db', () =>
56
70
uploader TEXT NOT NULL DEFAULT '',
57
71
downloaders TEXT NOT NULL DEFAULT '[]'
58
72
);
73
CREATE TABLE IF NOT EXISTS auth_sessions (
74
session_id TEXT PRIMARY KEY,
75
username TEXT NOT NULL,
76
ip TEXT NOT NULL,
77
region TEXT NOT NULL,
78
fp_hash TEXT NOT NULL,
79
created_at INTEGER NOT NULL,
80
last_seen_at INTEGER NOT NULL,
81
revoked_at INTEGER
82
);
59
83
`);
60
84
}
61
85
return db;
@@ -63,6 +87,14 @@ jest.mock('../server/db', () =>
63
87
return { getDb, initDb: getDb };
64
88
});
65
89
90
jest.mock('../server/video-stream', () => ({
91
getVideoStreamDebugSnapshot: () => mockVideoStreamSnapshot,
92
}));
93
94
jest.mock('../server/image-subtitles', () => ({
95
getImageSubtitleDebugSnapshot: () => mockSubtitleSnapshot,
96
}));
97
66
98
// ── config mock ─────────────────────────────────────────────────────────────
67
99
const mockConfig = { port: 3000, paths: ['/mnt/data', '/mnt/docs'], userPath: null };
68
100
jest.mock('../server/config', () => ({
@@ -409,6 +441,78 @@ describe('GET /api/admin/config', () =>
409
441
});
410
442
});
411
443
444
describe('GET /api/admin/debug/stream-stats', () =>
445
{
446
test('includes active streams and cached-only video files with zero viewers', async () =>
447
{
448
const now = Date.now();
449
mockVideoStreamSnapshot = {
450
streamRootDir: '/tmp/filemanager-video-streams',
451
activeSessionCount: 1,
452
activeLeaseCount: 2,
453
activeStreams: [
454
{
455
sessionId: 'lease-live',
456
sourcePath: '/videos/live.mkv',
457
outputDir: '/tmp/filemanager-video-streams/live',
458
viewers: 2,
459
output: {
460
totalFiles: 12,
461
totalBytes: 12000000,
462
segmentFiles: 10,
463
segmentBytes: 11000000,
464
},
465
},
466
],
467
orphanedOutputDirs: [],
468
};
469
470
mockSubtitleSnapshot = {
471
eventCache: { entries: 2, bytes: 4096, maxItems: 3, maxBytes: 52428800 },
472
frameCache: { entries: 4, bytes: 8192, maxItems: 50, maxBytes: 50331648 },
473
byFile: {
474
'/videos/live.mkv': {
475
filePath: '/videos/live.mkv',
476
eventEntries: 1,
477
eventBytes: 2048,
478
eventCount: 30,
479
eventImageBytes: 1500,
480
frameEntries: 2,
481
frameBytes: 4096,
482
},
483
'/videos/cached-only.mkv': {
484
filePath: '/videos/cached-only.mkv',
485
eventEntries: 1,
486
eventBytes: 2048,
487
eventCount: 20,
488
eventImageBytes: 1300,
489
frameEntries: 2,
490
frameBytes: 4096,
491
},
492
},
493
};
494
495
const db = getDb();
496
db.prepare(`INSERT OR REPLACE INTO auth_sessions (
497
session_id, username, ip, region, fp_hash, created_at, last_seen_at, revoked_at
498
) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
499
.run(['sess-debug', 'admin', '127.0.0.1', 'EU', 'fp', now - 1000, now - 1000, null]);
500
501
const { status, body } = await req('GET', '/api/admin/debug/stream-stats');
502
expect(status).toBe(200);
503
expect(Array.isArray(body.videoFiles)).toBe(true);
504
505
const live = body.videoFiles.find((row) => row.filePath === '/videos/live.mkv');
506
expect(live).toBeTruthy();
507
expect(live.viewers).toBe(2);
508
509
const cachedOnly = body.videoFiles.find((row) => row.filePath === '/videos/cached-only.mkv');
510
expect(cachedOnly).toBeTruthy();
511
expect(cachedOnly.viewers).toBe(0);
512
expect(cachedOnly.subtitleCache.eventEntries).toBe(1);
513
});
514
});
515
412
516
describe('PUT /api/admin/config', () =>
413
517
{
414
518
test('saves new paths', async () =>
@@ -12,6 +12,20 @@ const fs = require('fs');12
const os = require('os');12
const os = require('os');13
const path = require('path');13
const path = require('path');14
14
15
let mockVideoStreamSnapshot = {16
streamRootDir: '/tmp/filemanager-video-streams',17
activeSessionCount: 0,18
activeLeaseCount: 0,19
activeStreams: [],20
orphanedOutputDirs: [],21
};22
23
let mockSubtitleSnapshot = {24
eventCache: { entries: 0, bytes: 0, maxItems: 3, maxBytes: 0 },25
frameCache: { entries: 0, bytes: 0, maxItems: 50, maxBytes: 0 },26
byFile: {},27
};28
15
// ── child_process mock — controlled per test ──────────────────────────────────29
// ── child_process mock — controlled per test ──────────────────────────────────16
let mockExecFileImpl = null;30
let mockExecFileImpl = null;17
jest.mock('child_process', () =>31
jest.mock('child_process', () =>@@ -56,6 +70,16 @@ jest.mock('../server/db', () =>56
uploader TEXT NOT NULL DEFAULT '',70
uploader TEXT NOT NULL DEFAULT '',57
downloaders TEXT NOT NULL DEFAULT '[]'71
downloaders TEXT NOT NULL DEFAULT '[]'58
);72
);73
CREATE TABLE IF NOT EXISTS auth_sessions (74
session_id TEXT PRIMARY KEY,75
username TEXT NOT NULL,76
ip TEXT NOT NULL,77
region TEXT NOT NULL,78
fp_hash TEXT NOT NULL,79
created_at INTEGER NOT NULL,80
last_seen_at INTEGER NOT NULL,81
revoked_at INTEGER82
);59
`);83
`);60
}84
}61
return db;85
return db;@@ -63,6 +87,14 @@ jest.mock('../server/db', () =>63
return { getDb, initDb: getDb };87
return { getDb, initDb: getDb };64
});88
});65
89
90
jest.mock('../server/video-stream', () => ({91
getVideoStreamDebugSnapshot: () => mockVideoStreamSnapshot,92
}));93
94
jest.mock('../server/image-subtitles', () => ({95
getImageSubtitleDebugSnapshot: () => mockSubtitleSnapshot,96
}));97
66
// ── config mock ─────────────────────────────────────────────────────────────98
// ── config mock ─────────────────────────────────────────────────────────────67
const mockConfig = { port: 3000, paths: ['/mnt/data', '/mnt/docs'], userPath: null };99
const mockConfig = { port: 3000, paths: ['/mnt/data', '/mnt/docs'], userPath: null };68
jest.mock('../server/config', () => ({100
jest.mock('../server/config', () => ({@@ -409,6 +441,78 @@ describe('GET /api/admin/config', () =>409
});441
});410
});442
});411
443
444
describe('GET /api/admin/debug/stream-stats', () =>445
{446
test('includes active streams and cached-only video files with zero viewers', async () =>447
{448
const now = Date.now();449
mockVideoStreamSnapshot = {450
streamRootDir: '/tmp/filemanager-video-streams',451
activeSessionCount: 1,452
activeLeaseCount: 2,453
activeStreams: [454
{455
sessionId: 'lease-live',456
sourcePath: '/videos/live.mkv',457
outputDir: '/tmp/filemanager-video-streams/live',458
viewers: 2,459
output: {460
totalFiles: 12,461
totalBytes: 12000000,462
segmentFiles: 10,463
segmentBytes: 11000000,464
},465
},466
],467
orphanedOutputDirs: [],468
};469
470
mockSubtitleSnapshot = {471
eventCache: { entries: 2, bytes: 4096, maxItems: 3, maxBytes: 52428800 },472
frameCache: { entries: 4, bytes: 8192, maxItems: 50, maxBytes: 50331648 },473
byFile: {474
'/videos/live.mkv': {475
filePath: '/videos/live.mkv',476
eventEntries: 1,477
eventBytes: 2048,478
eventCount: 30,479
eventImageBytes: 1500,480
frameEntries: 2,481
frameBytes: 4096,482
},483
'/videos/cached-only.mkv': {484
filePath: '/videos/cached-only.mkv',485
eventEntries: 1,486
eventBytes: 2048,487
eventCount: 20,488
eventImageBytes: 1300,489
frameEntries: 2,490
frameBytes: 4096,491
},492
},493
};494
495
const db = getDb();496
db.prepare(`INSERT OR REPLACE INTO auth_sessions (497
session_id, username, ip, region, fp_hash, created_at, last_seen_at, revoked_at498
) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)499
.run(['sess-debug', 'admin', '127.0.0.1', 'EU', 'fp', now - 1000, now - 1000, null]);500
501
const { status, body } = await req('GET', '/api/admin/debug/stream-stats');502
expect(status).toBe(200);503
expect(Array.isArray(body.videoFiles)).toBe(true);504
505
const live = body.videoFiles.find((row) => row.filePath === '/videos/live.mkv');506
expect(live).toBeTruthy();507
expect(live.viewers).toBe(2);508
509
const cachedOnly = body.videoFiles.find((row) => row.filePath === '/videos/cached-only.mkv');510
expect(cachedOnly).toBeTruthy();511
expect(cachedOnly.viewers).toBe(0);512
expect(cachedOnly.subtitleCache.eventEntries).toBe(1);513
});514
});515
412
describe('PUT /api/admin/config', () =>516
describe('PUT /api/admin/config', () =>413
{517
{414
test('saves new paths', async () =>518
test('saves new paths', async () =>