matterbridge 3.4.6 → 3.4.7-dev-20260103-3152357

package/scripts/fetch-chip.mjs

@@ -1,102 +0,0 @@
-/* eslint-disable */
-import { mkdir, writeFile } from 'node:fs/promises';
-import { dirname, join as pathJoin, sep as pathSep } from 'node:path';
-import https from 'node:https';
-
-/**
- * Fetch the canonical Matter ZCL JSON file from the connectedhomeip repository
- * and store it locally for offline / deterministic revision checks.
- *
- * Environment overrides:
- *  - ZCL_OUT: output path for zcl.json (default: chip/zcl.json)
- *  - ZCL_BRANCH: connectedhomeip branch to fetch from (default: v1.4-branch)
- */
-// Single branch strategy from online only
-const BRANCH = process.env.ZCL_BRANCH || 'v1.4.2-branch';
-const OUT_ZCL_PATH = process.env.ZCL_OUT || `chip/${BRANCH}/zcl.json`;
-const OUT_MANUFACTURERS_PATH = process.env.MANUFACTURERS_OUT || `chip/${BRANCH}/manufacturers.xml`;
-const ZCL_BASE_URL = `https://raw.githubusercontent.com/project-chip/connectedhomeip/${BRANCH}/src/app/zap-templates/zcl/`;
-const ZCL_JSON_URL = ZCL_BASE_URL + 'zcl.json';
-const MANUFACTURERS_URL = ZCL_BASE_URL + 'data-model/manufacturers.xml';
-const XML_BASE_URL = ZCL_BASE_URL + 'data-model/chip/';
-
-function fetchUrl(url) {
-  return new Promise((resolve, reject) => {
-    https
-      .get(url, (res) => {
-        if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          // Follow redirect
-          return resolve(fetchUrl(res.headers.location));
-        }
-        if (res.statusCode !== 200) {
-          return reject(new Error(`Failed to fetch ${url}: ${res.statusCode}`));
-        }
-        const chunks = [];
-        res.on('data', (c) => chunks.push(c));
-        res.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
-      })
-      .on('error', reject);
-  });
-}
-
-async function main() {
-  await mkdir(dirname(OUT_ZCL_PATH), { recursive: true });
-  // Always fetch online from the specified branch
-  const data = await fetchUrl(ZCL_JSON_URL);
-
-  // Structural sanity check: this is a ZAP ZCL properties file, expected to include xml roots and files
-  let parsed;
-  try {
-    parsed = JSON.parse(data);
-  } catch (e) {
-    throw new Error(`Downloaded content is not valid JSON: ${e.message}`);
-  }
-  if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.xmlFile)) {
-    process.stderr.write('Warning: zcl.json does not contain expected ZAP ZCL properties (xmlFile). Saving anyway for manual inspection.\n');
-  }
-
-  await writeFile(OUT_ZCL_PATH, JSON.stringify(parsed, null, 2));
-  process.stderr.write(`Saved ${OUT_ZCL_PATH}. Branch=${BRANCH}\n`);
-
-  // Also fetch manufacturers.xml to chip/manufacturers.xml from the same branch
-  try {
-    const manuContent = await fetchUrl(MANUFACTURERS_URL);
-    await writeFile(OUT_MANUFACTURERS_PATH, manuContent);
-    process.stderr.write(`Saved ${OUT_MANUFACTURERS_PATH}. Branch=${BRANCH}\n`);
-  } catch (e) {
-    process.stderr.write(`Warning: failed to fetch manufacturers.xml (${e.message}).\n`);
-  }
-
-  // Always fetch XMLs referenced by zcl.json from the same branch under data-model/chip
-  const xmlFiles = Array.isArray(parsed.xmlFile) ? parsed.xmlFile : [];
-  if (xmlFiles.length === 0) {
-    process.stderr.write('No xmlFile entries found; skipping XML fetch.\n');
-  } else {
-    const outXmlBase = `chip/${BRANCH}/xml`;
-    await mkdir(outXmlBase, { recursive: true });
-    let ok = 0;
-    let fail = 0;
-    for (const fileName of xmlFiles) {
-      const relative = fileName.trim();
-      try {
-        const url = XML_BASE_URL + relative;
-        const content = await fetchUrl(url);
-        const outPath = pathJoin(outXmlBase, relative.replaceAll('/', pathSep));
-        await mkdir(dirname(outPath), { recursive: true });
-        await writeFile(outPath, content);
-        ok++;
-      } catch (e) {
-        fail++;
-        process.stderr.write(`Failed XML: ${relative} (${e.message})\n`);
-      }
-    }
-    process.stderr.write(`Fetched XML files: ${ok} ok, ${fail} failed. Output under ${outXmlBase}. Branch=${BRANCH}\n`);
-  }
-  // Ensure success exit unless an unhandled error occurred
-  process.exit(0);
-}
-
-main().catch((err) => {
-  process.stderr.write(`Error: ${err.message}\n`);
-  process.exitCode = 1;
-});

package/scripts/marked.mjs

@@ -1,133 +0,0 @@
-/* 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' },
-  { source: 'docker-reflector/Docker reflector.md', target: 'docker-reflector/Docker reflector.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

@@ -1,42 +0,0 @@
-  <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

@@ -1,78 +0,0 @@
-<!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>