euparliamentmonitor 0.8.4

package/scripts/utils/file-utils.js

@@ -0,0 +1,374 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Utils/FileUtils
+ * @description Shared file system utilities for news article operations
+ */
+import { randomUUID } from 'crypto';
+import fs from 'fs';
+import path from 'path';
+import { NEWS_DIR, ARTICLE_FILENAME_PATTERN } from '../constants/config.js';
+import { ALL_LANGUAGES } from '../constants/language-core.js';
+/**
+ * Get all news article HTML files from the news directory
+ *
+ * @param newsDir - News directory path (defaults to NEWS_DIR)
+ * @returns List of article filenames
+ */
+export function getNewsArticles(newsDir = NEWS_DIR) {
+    if (!fs.existsSync(newsDir)) {
+        console.log('📁 News directory does not exist yet');
+        return [];
+    }
+    const files = fs.readdirSync(newsDir);
+    return files.filter((f) => f.endsWith('.html') && !f.startsWith('index-'));
+}
+/**
+ * Parse article filename to extract metadata
+ *
+ * @param filename - Article filename (e.g., "2025-01-15-week-ahead-en.html")
+ * @returns Parsed metadata or null if filename doesn't match pattern
+ */
+export function parseArticleFilename(filename) {
+    const match = filename.match(ARTICLE_FILENAME_PATTERN);
+    if (!match) {
+        return null;
+    }
+    const langCandidate = match[3];
+    if (!ALL_LANGUAGES.includes(langCandidate)) {
+        return null;
+    }
+    return {
+        date: match[1],
+        slug: match[2],
+        lang: langCandidate,
+        filename,
+    };
+}
+/**
+ * Group articles by language code
+ *
+ * @param articles - List of article filenames
+ * @param languages - Supported language codes
+ * @returns Articles grouped by language, sorted newest first
+ */
+export function groupArticlesByLanguage(articles, languages) {
+    const grouped = {};
+    for (const lang of languages) {
+        grouped[lang] = [];
+    }
+    for (const article of articles) {
+        const parsed = parseArticleFilename(article);
+        if (parsed && grouped[parsed.lang] !== undefined) {
+            grouped[parsed.lang].push(parsed);
+        }
+    }
+    // Sort by date (newest first)
+    for (const lang in grouped) {
+        grouped[lang].sort((a, b) => b.date.localeCompare(a.date));
+    }
+    return grouped;
+}
+/**
+ * Format slug for display (hyphen-separated to Title Case)
+ *
+ * @param slug - Hyphen-separated slug string
+ * @returns Formatted title string
+ */
+export function formatSlug(slug) {
+    return slug
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Get file modification time as YYYY-MM-DD string
+ *
+ * @param filepath - Path to file
+ * @returns Last modified date in YYYY-MM-DD format
+ */
+export function getModifiedDate(filepath) {
+    const stats = fs.statSync(filepath);
+    // split('T') on an ISO string always produces at least one element
+    return stats.mtime.toISOString().split('T')[0];
+}
+/**
+ * Format date for article slug
+ *
+ * @param date - Date to format (defaults to now)
+ * @returns Formatted date string (YYYY-MM-DD)
+ */
+export function formatDateForSlug(date = new Date()) {
+    // split('T') on an ISO string always produces at least one element
+    return date.toISOString().split('T')[0];
+}
+/**
+ * Calculate read time estimate from content
+ *
+ * @param content - Article content text
+ * @param wordsPerMinute - Reading speed (default 250)
+ * @returns Estimated read time in minutes
+ */
+export function calculateReadTime(content, wordsPerMinute = 250) {
+    const words = content.split(/\s+/).length;
+    return Math.ceil(words / wordsPerMinute);
+}
+/**
+ * Ensure a directory exists, creating it recursively if needed
+ *
+ * @param dirPath - Directory path to ensure
+ */
+export function ensureDirectoryExists(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Write content to a file with UTF-8 encoding
+ *
+ * @param filepath - Output file path
+ * @param content - File content
+ */
+export function writeFileContent(filepath, content) {
+    const dir = path.dirname(filepath);
+    ensureDirectoryExists(dir);
+    fs.writeFileSync(filepath, content, 'utf-8');
+}
+/**
+ * Remove a file, ignoring ENOENT (file already deleted by another writer).
+ *
+ * @param filepath - Path to the file to remove
+ */
+function unlinkIfExists(filepath) {
+    try {
+        fs.unlinkSync(filepath);
+    }
+    catch (err) {
+        const code = err instanceof Error ? err.code : '';
+        if (code !== 'ENOENT') {
+            throw err;
+        }
+    }
+}
+/**
+ * Attempt to rename `src` to `dest` with a bounded retry loop.
+ *
+ * On each attempt the existing destination is removed first, then
+ * `renameSync` is retried.  `EEXIST`/`EPERM` failures from concurrent
+ * writers are tolerated for up to `maxRetries` attempts.
+ *
+ * @param src - Source (temp) file path
+ * @param dest - Final destination path
+ * @param maxRetries - Maximum number of unlink-then-rename attempts
+ */
+function renameWithRetry(src, dest, maxRetries) {
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        unlinkIfExists(dest);
+        try {
+            fs.renameSync(src, dest);
+            return;
+        }
+        catch (retryErr) {
+            const retryCode = retryErr instanceof Error ? retryErr.code : '';
+            if ((retryCode === 'EEXIST' || retryCode === 'EPERM') && attempt < maxRetries - 1) {
+                continue;
+            }
+            throw retryErr;
+        }
+    }
+}
+/**
+ * Best-effort removal of a temporary file.  Ignores ENOENT (the file was
+ * already renamed or never created) but logs a warning for other errors
+ * (e.g. EBUSY, EACCES) so operators can detect leaked temp files.
+ *
+ * @param tempPath - Path to the temp file to remove
+ */
+function cleanupTempFile(tempPath) {
+    try {
+        fs.unlinkSync(tempPath);
+    }
+    catch (unlinkErr) {
+        const errno = unlinkErr && typeof unlinkErr === 'object' ? unlinkErr : undefined;
+        if (errno?.code !== 'ENOENT') {
+            const message = errno && typeof errno.message === 'string' ? errno.message : String(unlinkErr);
+            const code = errno?.code ?? 'UNKNOWN';
+            console.warn(`atomicWrite: failed to remove temporary file "${tempPath}" (code: ${code}): ${message}`);
+        }
+    }
+}
+/**
+ * Write content to a file atomically.
+ *
+ * Writes to a uniquely-named temporary file in the same directory first, then
+ * renames it to the final path. The temp filename includes the PID and a random
+ * UUID so that concurrent callers targeting the same destination never collide
+ * on the intermediate file. If the rename fails the temp file is cleaned up in
+ * a `finally` block. On platforms where `renameSync` does not overwrite an
+ * existing destination (e.g. Windows), the error is caught and the target is
+ * removed before retrying the rename.
+ *
+ * @param filepath - Final output file path
+ * @param content - File content to write
+ */
+export function atomicWrite(filepath, content) {
+    const dir = path.dirname(filepath);
+    ensureDirectoryExists(dir);
+    const uniqueSuffix = `${process.pid}-${randomUUID()}`;
+    const tempPath = `${filepath}.${uniqueSuffix}.tmp`;
+    try {
+        fs.writeFileSync(tempPath, content, 'utf-8');
+        try {
+            fs.renameSync(tempPath, filepath);
+        }
+        catch (err) {
+            const code = err instanceof Error ? err.code : '';
+            if (code === 'EEXIST' || code === 'EPERM') {
+                renameWithRetry(tempPath, filepath, 3);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    finally {
+        cleanupTempFile(tempPath);
+    }
+}
+/**
+ * Check whether a news article file already exists on disk.
+ *
+ * This is used by generation pipelines to skip work when a prior workflow run
+ * (or the same run) has already produced the article, avoiding unnecessary
+ * regeneration and potential merge conflicts.
+ *
+ * @param slug - Article slug including date prefix (e.g. `"2025-01-15-week-ahead"`)
+ * @param lang - Language code (e.g. `"en"`)
+ * @param newsDir - Absolute path to the news output directory (defaults to NEWS_DIR)
+ * @returns `true` when the article file exists
+ */
+export function checkArticleExists(slug, lang, newsDir = NEWS_DIR) {
+    const filename = `${slug}-${lang}.html`;
+    return fs.existsSync(path.join(newsDir, filename));
+}
+/**
+ * Decode the 5 HTML entities produced by escapeHTML() back to plain text.
+ * Used when extracting text from our own generated HTML to obtain unescaped values.
+ *
+ * IMPORTANT: `&amp;` MUST be decoded last. Decoding it first would convert
+ * `&amp;lt;` to `&lt;` before the `&lt;` → `<` replacement runs, causing
+ * double-decoding. The correct order is: decode all specific entities first,
+ * then decode `&amp;` as the final step.
+ *
+ * @param str - HTML string with entities
+ * @returns Plain text with entities decoded
+ */
+function decodeHtmlEntities(str) {
+    return str
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&');
+}
+/**
+ * Extract title and description from a generated article HTML file.
+ * Reads the predictable template structure produced by article-template.ts.
+ * Falls back to empty strings when the file cannot be read.
+ * HTML entities from the template are decoded to produce plain text.
+ *
+ * NOTE: The meta description regex relies on the template's use of escapeHTML(),
+ * which converts `"` to `&quot;`. Because descriptions are always stored with
+ * double-quote delimiters and inner quotes are HTML-encoded, the `[^"]+` pattern
+ * safely captures the full value. If the template ever changes its quoting
+ * convention this regex must be updated accordingly.
+ *
+ * @param filepath - Path to the article HTML file
+ * @returns Object with title (from first h1) and description (from meta description)
+ */
+export function extractArticleMeta(filepath) {
+    let title = '';
+    let description = '';
+    try {
+        const content = fs.readFileSync(filepath, 'utf-8');
+        // Matches h1 with any attributes but only plain-text content (no nested tags).
+        // The template always writes plain escaped text in h1, so this is correct.
+        const titleMatch = content.match(/<h1[^>]*>([^<]+)<\/h1>/u);
+        if (titleMatch?.[1]) {
+            title = decodeHtmlEntities(titleMatch[1].trim());
+        }
+        const descMatch = content.match(/<meta name="description" content="([^"]+)"/u);
+        if (descMatch?.[1]) {
+            description = decodeHtmlEntities(descMatch[1]);
+        }
+    }
+    catch {
+        // File not readable – return empty strings
+    }
+    return { title, description };
+}
+/**
+ * Escape special HTML characters to prevent XSS
+ *
+ * @param str - Raw string to escape
+ * @returns HTML-safe string
+ */
+export function escapeHTML(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * Validate that a URL uses a safe scheme (http or https)
+ *
+ * @param url - URL string to validate
+ * @returns true if URL has a safe scheme
+ */
+export function isSafeURL(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/** Required structural elements that every article must contain */
+const REQUIRED_ARTICLE_ELEMENTS = [
+    {
+        selector: ['class="site-header__langs"', 'class="language-switcher"'],
+        label: 'language switcher nav',
+    },
+    { selector: 'class="article-top-nav"', label: 'article-top-nav (back button)' },
+    { selector: 'class="site-header"', label: 'site-header' },
+    { selector: 'class="skip-link"', label: 'skip-link' },
+    { selector: 'class="reading-progress"', label: 'reading-progress bar' },
+    { selector: '<main id="main"', label: 'main content wrapper' },
+    { selector: 'class="site-footer"', label: 'site-footer' },
+];
+/**
+ * Validate that generated article HTML includes all required structural elements.
+ *
+ * This is the primary validation gate — articles must be generated correctly
+ * by the template. The fix-articles script is only a fallback for legacy articles.
+ *
+ * @param html - Complete HTML string of the article
+ * @returns Validation result with errors list (empty if valid)
+ */
+export function validateArticleHTML(html) {
+    const errors = [];
+    for (const element of REQUIRED_ARTICLE_ELEMENTS) {
+        const sel = element.selector;
+        const found = Array.isArray(sel)
+            ? sel.some((s) => html.includes(s))
+            : html.includes(sel);
+        if (!found) {
+            errors.push(`Missing required element: ${element.label}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=file-utils.js.map

package/scripts/utils/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"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"}

package/scripts/utils/fix-articles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Fix a single article file by injecting missing structural elements.
+ *
+ * @param filepath - Absolute path to article HTML file
+ * @param dryRun - If true, only report what would change
+ * @returns Object with changed flag and description
+ */
+export declare function fixArticle(filepath: string, dryRun?: boolean): {
+    changed: boolean;
+    description: string;
+};
+/**
+ * Fix all articles in the news directory.
+ *
+ * @param dryRun - If true, only report what would change
+ * @returns Summary of changes
+ */
+export declare function fixAllArticles(dryRun?: boolean): {
+    total: number;
+    fixed: number;
+    skipped: number;
+    results: Array<{
+        changed: boolean;
+        description: string;
+    }>;
+};
+//# sourceMappingURL=fix-articles.d.ts.map

package/scripts/utils/fix-articles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-articles.d.ts","sourceRoot":"","sources":["../../src/utils/fix-articles.ts"],"names":[],"mappings":"AA4fA;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,OAAe,GACtB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAoE3C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,OAAe,GAAG;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D,CAcA"}