'use strict'; const fs = require('fs'); const os = require('os'); const path = require('path'); const SUBTITLE_DEBUG_LOG_DIR = path.join(os.tmpdir(), 'filemanager-subtitle-debug-logs'); const MAX_SUBTITLE_DEBUG_LOG_BYTES = 10 * 1024 * 1024; const MAX_SUBTITLE_LOG_CONTEXT_KEYS = parseContextLimit(process.env.SUBTITLE_DEBUG_LOG_CONTEXT_KEYS_MAX, 512); const subtitleLogFileByContext = new Map(); function parseContextLimit (value, fallback) { const parsed = Number.parseInt(String(value || ''), 10); if (Number.isInteger(parsed) && parsed >= 1) { return Math.min(parsed, 4096); } return fallback; } function normaliseTimestampMs (timestampMs) { const parsed = Number(timestampMs); return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : Date.now(); } function sanitiseVideoName (videoName) { const raw = path.basename(String(videoName || '').trim() || 'unknown-video'); const cleaned = raw.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/-+/g, '-').replace(/^-+|-+$/g, ''); return cleaned || 'unknown-video'; } function subtitleDebugLogFilePath (videoName, timestampMs = Date.now()) { const stamp = normaliseTimestampMs(timestampMs); const fileName = `${stamp}-${sanitiseVideoName(videoName)}-subtitlelog.txt`; return path.join(SUBTITLE_DEBUG_LOG_DIR, fileName); } function subtitleLogContextKey (videoName, context) { const source = context && context.source ? String(context.source) : 'unknown'; const sessionHint = context && (context.sessionId || context.shareToken) ? String(context.sessionId || context.shareToken) : 'no-session'; return `${sanitiseVideoName(videoName)}|${source}|${sessionHint}`; } function resolveSubtitleLogPath (videoName, timestampMs, context) { const key = subtitleLogContextKey(videoName, context); const existing = subtitleLogFileByContext.get(key); if (existing) { // LRU refresh for active contexts. subtitleLogFileByContext.delete(key); subtitleLogFileByContext.set(key, existing); return existing; } trimSubtitleLogContextMap(); const targetPath = subtitleDebugLogFilePath(videoName, timestampMs); subtitleLogFileByContext.set(key, targetPath); trimSubtitleLogContextMap(); return targetPath; } function trimSubtitleLogContextMap () { if (subtitleLogFileByContext.size <= MAX_SUBTITLE_LOG_CONTEXT_KEYS) return; // Remove oldest references first when they no longer point at existing files. for (const [key, filePath] of subtitleLogFileByContext) { if (subtitleLogFileByContext.size <= MAX_SUBTITLE_LOG_CONTEXT_KEYS) break; if (fs.existsSync(filePath)) continue; subtitleLogFileByContext.delete(key); } // Hard cap fallback: evict oldest entries (LRU order) until under limit. while (subtitleLogFileByContext.size > MAX_SUBTITLE_LOG_CONTEXT_KEYS) { const oldestKey = subtitleLogFileByContext.keys().next().value; if (!oldestKey) break; subtitleLogFileByContext.delete(oldestKey); } } function ensureSubtitleDebugLogDir () { fs.mkdirSync(SUBTITLE_DEBUG_LOG_DIR, { recursive: true }); } function serialiseLogEntry (entry) { const payload = entry && typeof entry === 'object' ? entry : { value: entry }; const timestamp = new Date(Number.isFinite(payload.loggedAtMs) ? payload.loggedAtMs : Date.now()).toISOString(); return `[${timestamp}] ${JSON.stringify(payload)}\n`; } function directoryEntriesWithStats (dirPath) { let entries = []; try { entries = fs.readdirSync(dirPath, { withFileTypes: true }); } catch { return []; } const out = []; for (const entry of entries) { if (!entry.isFile()) continue; const fullPath = path.join(dirPath, entry.name); try { const stat = fs.statSync(fullPath); out.push({ fullPath, name: entry.name, size: Number(stat.size) || 0, mtimeMs: Number(stat.mtimeMs) || 0 }); } catch { // Ignore files that disappear mid-scan. } } return out; } function getSubtitleDebugLogSnapshot () { const entries = directoryEntriesWithStats(SUBTITLE_DEBUG_LOG_DIR); const latestFile = entries.slice().sort((a, b) => b.mtimeMs - a.mtimeMs)[0] || null; return { path: SUBTITLE_DEBUG_LOG_DIR, exists: fs.existsSync(SUBTITLE_DEBUG_LOG_DIR), bytes: entries.reduce((sum, entry) => sum + entry.size, 0), files: entries.length, directories: 0, latestFile, }; } function pruneSubtitleDebugLogDir () { ensureSubtitleDebugLogDir(); const entries = directoryEntriesWithStats(SUBTITLE_DEBUG_LOG_DIR).sort((a, b) => a.mtimeMs - b.mtimeMs); let totalBytes = entries.reduce((sum, entry) => sum + entry.size, 0); for (const entry of entries) { if (totalBytes <= MAX_SUBTITLE_DEBUG_LOG_BYTES) break; try { fs.unlinkSync(entry.fullPath); totalBytes = Math.max(0, totalBytes - entry.size); } catch { // Ignore prune failures; logging must remain best-effort. } } } function appendSubtitleDebugEntries ({ videoName, entries, context = null }) { const rows = Array.isArray(entries) ? entries.filter(Boolean) : []; if (!rows.length) return null; const firstTimestamp = rows.find((entry) => entry && Number.isFinite(entry.loggedAtMs)); const targetPath = resolveSubtitleLogPath( videoName, firstTimestamp ? firstTimestamp.loggedAtMs : Date.now(), context, ); try { ensureSubtitleDebugLogDir(); const text = rows.map((entry) => { const payload = context && typeof context === 'object' ? { ...context, ...(entry && typeof entry === 'object' ? entry : { value: entry }) } : entry; return serialiseLogEntry(payload); }).join(''); fs.appendFileSync(targetPath, text, 'utf8'); pruneSubtitleDebugLogDir(); return targetPath; } catch { return null; } } function getSubtitleDebugLogContextCount () { return subtitleLogFileByContext.size; } module.exports = { SUBTITLE_DEBUG_LOG_DIR, MAX_SUBTITLE_DEBUG_LOG_BYTES, getSubtitleDebugLogSnapshot, getSubtitleDebugLogContextCount, subtitleDebugLogFilePath, pruneSubtitleDebugLogDir, appendSubtitleDebugEntries, };