matterbridge 3.4.2-dev-20251206-00998e1 → 3.4.3-dev-20251206-06686b7

package/frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend",
-  "version": "3.3.3",
+  "version": "3.3.4",
   "private": true,
   "homepage": "./",
   "type": "module",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
   "name": "matterbridge",
-  "version": "3.4.2-dev-20251206-00998e1",
+  "version": "3.4.3-dev-20251206-06686b7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.4.2-dev-20251206-00998e1",
+      "version": "3.4.3-dev-20251206-06686b7",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.15.6",
         "archiver": "7.0.1",
-        "express": "5.1.0",
+        "express": "5.2.1",
         "glob": "13.0.0",
         "multer": "2.0.2",
         "node-ansi-logger": "3.1.1",
@@ -870,18 +870,19 @@
       }
     },
     "node_modules/express": {
-      "version": "5.1.0",
-      "resolved": "https://registry.npmjs.org/express/-/express-5.1.0.tgz",
-      "integrity": "sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==",
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
+      "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==",
       "license": "MIT",
       "dependencies": {
         "accepts": "^2.0.0",
-        "body-parser": "^2.2.0",
+        "body-parser": "^2.2.1",
         "content-disposition": "^1.0.0",
         "content-type": "^1.0.5",
         "cookie": "^0.7.1",
         "cookie-signature": "^1.2.1",
         "debug": "^4.4.0",
+        "depd": "^2.0.0",
         "encodeurl": "^2.0.0",
         "escape-html": "^1.0.3",
         "etag": "^1.8.1",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "matterbridge",
-  "version": "3.4.2-dev-20251206-00998e1",
+  "version": "3.4.3-dev-20251206-06686b7",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
-  "homepage": "https://github.com/Luligu/matterbridge/blob/main/README.md",
+  "homepage": "https://matterbridge.io/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Luligu/matterbridge.git"
@@ -105,7 +105,7 @@
   "dependencies": {
     "@matter/main": "0.15.6",
     "archiver": "7.0.1",
-    "express": "5.1.0",
+    "express": "5.2.1",
     "glob": "13.0.0",
     "multer": "2.0.2",
     "node-ansi-logger": "3.1.1",

package/scripts/marked.mjs

@@ -0,0 +1,132 @@
+/* eslint-disable no-console */
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { Marked, TextRenderer } from 'marked';
+
+const ROOT_DIR = fileURLToPath(new URL('.', import.meta.url));
+const MD_DIR = join(ROOT_DIR, '..');
+console.log(`Generating marked HTML files from ${MD_DIR}`);
+const DOCS_DIR = join(ROOT_DIR, '..', 'docs');
+console.log(`Generating marked HTML files in ${DOCS_DIR}`);
+const HEADER_PATH = join(ROOT_DIR, 'markedHeader.html');
+const FOOTER_PATH = join(ROOT_DIR, 'markedFooter.html');
+
+const HEADING_FALLBACK_PREFIX = 'heading';
+
+const slugifyHeading = (text) => {
+  const normalized = text
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/gu, '')
+    .toLowerCase();
+
+  return normalized
+    .replace(/[^a-z0-9\s-]/g, '')
+    .trim()
+    .replace(/[\s_-]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+};
+
+const createSlugGenerator = () => {
+  const counts = new Map();
+
+  return (rawText) => {
+    const base = slugifyHeading(rawText) || HEADING_FALLBACK_PREFIX;
+    const usage = counts.get(base) ?? 0;
+    counts.set(base, usage + 1);
+    return usage > 0 ? `${base}-${usage}` : base;
+  };
+};
+
+const createMarkdownParser = () => {
+  const textRenderer = new TextRenderer();
+  const nextSlug = createSlugGenerator();
+
+  return new Marked({
+    gfm: true,
+    mangle: false,
+    renderer: {
+      heading(token) {
+        const inlineHtml = this.parser.parseInline(token.tokens);
+        const plainText = this.parser.parseInline(token.tokens, textRenderer).trim();
+        const slug = nextSlug(plainText);
+        return `<h${token.depth} id="${slug}">${inlineHtml}</h${token.depth}>\n`;
+      },
+    },
+  });
+};
+
+// Replicates marked.ps1 targets for cross-platform doc generation.
+const FILES_TO_RENDER = [
+  { source: 'README-DEV.md', target: 'README-DEV.html' },
+  { source: 'README-DOCKER.md', target: 'README-DOCKER.html' },
+  { source: 'README-MACOS-PLIST.md', target: 'README-MACOS-PLIST.html' },
+  { source: 'README-NGINX.md', target: 'README-NGINX.html' },
+  { source: 'README-PODMAN.md', target: 'README-PODMAN.html' },
+  { source: 'README-SERVICE-LOCAL.md', target: 'README-SERVICE-LOCAL.html' },
+  { source: 'README-SERVICE-OPT.md', target: 'README-SERVICE-OPT.html' },
+  { source: 'README-SERVICE.md', target: 'README-SERVICE.html' },
+  { source: 'README.md', target: 'README.html' },
+  { source: 'CHANGELOG.md', target: 'CHANGELOG.html' },
+];
+
+/**
+ * Render configured markdown documents with the shared header and footer.
+ *
+ * @param {string} header HTML header template.
+ * @param {string} footer HTML footer template.
+ * @returns {Promise<void>} Resolves once all files are written.
+ */
+async function renderMarkdownFiles(header, footer) {
+  for (const { source, target } of FILES_TO_RENDER) {
+    const markdownPath = join(MD_DIR, source);
+    const targetPath = join(DOCS_DIR, target);
+    const markdown = await readFile(markdownPath, 'utf8');
+    const parser = createMarkdownParser();
+    const body = await parser.parse(markdown);
+
+    await writeFile(targetPath, `${header}${body}${footer}`, 'utf8');
+    console.log(`Rendered ${source} to ${target}`);
+  }
+}
+
+/**
+ * Apply post-processing replacements to generated HTML files.
+ *
+ * @param {string[]} htmlFiles HTML files to update.
+ * @returns {Promise<void>} Resolves when replacements are applied.
+ */
+async function applyReplacements(htmlFiles) {
+  for (const filePath of htmlFiles) {
+    const originalContent = await readFile(filePath, 'utf8');
+    let updatedContent = originalContent.replace(/\.md/g, '.html');
+    updatedContent = updatedContent.replace(/→/g, '->');
+    updatedContent = updatedContent.replace(/✅/g, '&#x2714;');
+
+    if (updatedContent !== originalContent) {
+      await writeFile(filePath, updatedContent, 'utf8');
+    }
+  }
+}
+
+/**
+ * Build HTML documentation mirroring the original PowerShell workflow.
+ *
+ * @returns {Promise<void>} Resolves on success.
+ */
+async function main() {
+  const header = await readFile(HEADER_PATH, 'utf8');
+  const footer = await readFile(FOOTER_PATH, 'utf8');
+
+  await renderMarkdownFiles(header, footer);
+
+  const htmlFiles = FILES_TO_RENDER.map(({ target }) => join(DOCS_DIR, target));
+  await applyReplacements(htmlFiles);
+}
+
+main().catch((error) => {
+  const message = error instanceof Error ? (error.stack ?? error.message) : String(error);
+  process.stderr.write(`Failed to generate marked HTML files: ${message}\n`);
+  process.exitCode = 1;
+});

package/scripts/markedFooter.html

@@ -0,0 +1,42 @@
+  <script>
+    const copyIcon = '<svg viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path d="M11 1H3c-.6 0-1 .4-1 1v10h2V3h7V1zm2 3H6c-.6 0-1 .4-1 1v10c0 .6.4 1 1 1h7c.6 0 1-.4 1-1V5c0-.6-.4-1-1-1zm-1 10H7V6h5v8z"></path></svg>';
+    const successIcon = '<svg viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path d="M6.5 10.7L4.3 8.5 3 9.8l3.5 3.5 6.5-6.5-1.3-1.3z"></path></svg>';
+
+    document.querySelectorAll('pre').forEach(block => {
+      const button = document.createElement('button');
+      button.type = 'button';
+      button.className = 'copy-btn';
+      button.setAttribute('aria-label', 'Copy code snippet');
+      button.innerHTML = copyIcon;
+
+      let resetTimer;
+      button.addEventListener('click', async () => {
+        const code = block.querySelector('code')?.innerText ?? '';
+        try {
+          await navigator.clipboard.writeText(code);
+        } catch {
+          const textarea = document.createElement('textarea');
+          textarea.value = code;
+          textarea.style.position = 'fixed';
+          textarea.style.opacity = '0';
+          document.body.appendChild(textarea);
+          textarea.focus();
+          textarea.select();
+          document.execCommand('copy');
+          textarea.remove();
+        }
+
+        clearTimeout(resetTimer);
+        button.innerHTML = successIcon;
+        button.classList.add('copied');
+        resetTimer = setTimeout(() => {
+          button.innerHTML = copyIcon;
+          button.classList.remove('copied');
+        }, 2000);
+      });
+
+      block.appendChild(button);
+    });
+  </script>
+</body>
+</html>

package/scripts/markedHeader.html

@@ -0,0 +1,78 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title>Matterbridge</title>
+  <link rel="icon" type="image/svg+xml" href="matterbridge.svg">
+  <style>
+    body {
+      font-family: Roboto, Arial, 'Helvetica Neue', sans-serif;
+      line-height: 1.6;
+      margin: 40px;
+    }
+    h1, h2, h3 {
+      font-family: 'Roboto Slab', Roboto, Arial, 'Helvetica Neue', sans-serif;
+      color: #263238;
+      scroll-margin-top: 90px;
+      margin-top: 2.5rem;
+      margin-bottom: 1rem;
+    }
+    h1 {
+      font-size: 2.4rem;
+      font-weight: 700;
+      letter-spacing: -0.01em;
+      position: relative;
+      padding-bottom: 1.1rem;
+    }
+    h2 {
+      font-size: 1.8rem;
+      font-weight: 600;
+      border-bottom: 2px solid #e0e0e0;
+      padding-bottom: 0.35rem;
+      color: #41535b;
+    }
+    h3 {
+      font-size: 1.10rem;
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+      color: #455a64;
+    }
+    pre {
+      background: #e4e7ec;
+      color: #000000;
+      padding: 10px 56px 10px 10px;
+      border-radius: 0.5rem;
+      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+      font-size: 0.875rem;
+      margin: 10px 20px 10px 0px;
+      position: relative;
+    }
+    .copy-btn {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      width: 24px;
+      height: 24px;
+      padding: 0;
+      cursor: pointer;
+      border: none;
+      border-radius: 4px;
+      background: #eee;
+      color: #333;
+      position: absolute;
+      top: 8px;
+      right: 8px;
+      transition: color 0.2s ease;
+    }
+    .copy-btn svg {
+      width: 16px;
+      height: 16px;
+      fill: currentColor;
+    }
+    .copy-btn.copied {
+      color: #1b5e20;
+    }
+  </style>
+</head>
+<body>