#!/usr/bin/env node /* eslint-disable no-console */ /** * Sync the Mintlify "Latest Product Updates" page to Contentful as * `changeLogItem` entries. * * **Create-only.** The slug (`mintlifySlug`) is the existence check. If an * entry with that slug already exists, the script skips it entirely — no * field comparisons, no updates. Once created, an entry is fully owned by * marketing: editors can edit any field in Contentful and their edits will * persist across syncs. * * Entries are created as drafts; marketing publishes them from Contentful * when ready. * * The docs MDX is the seed for new entries only. Docs corrections to existing * entries do not propagate; an editor would need to delete the entry in * Contentful and re-trigger the workflow to refresh. * * **Hero image seeding.** A trailing image at the bottom of a feature * sub-section (in `…`, link-wrapped, or bare markdown form) * is extracted, uploaded to Contentful as an Asset using the remote-URL * form (Contentful fetches the binary from `docs.mightynetworks.com`), and * linked via `heroImage`. Same create-only contract: editors can swap the * image afterwards in Contentful and the next sync run won't touch it. * If the asset upload fails, the image stays inline in `body` (with the * relative URL absolutized) so the marketing page still renders something. * Note: bare JSX `

` is not promoted to `heroImage` — it * stays inline in body markdown (with its `src` absolutized). Use a * `` wrapper or markdown `![]()` syntax for hero seeding. * * Source: for-hosts/meet-mighty/latest-product-updates.mdx * One entry per feature sub-heading within a `## Week of ` block. * `## Updated` and `## Bug Fixes` sub-headings are skipped. */ const fs = require('fs'); const path = require('path'); const SOURCE_FILE = path.join(__dirname, '..', 'for-hosts', 'meet-mighty', 'latest-product-updates.mdx'); const SOURCE_DOCS_URL = 'https://docs.mightynetworks.com/for-hosts/meet-mighty/latest-product-updates'; const SPACE_ID = process.env.CONTENTFUL_SPACE_ID; const ENVIRONMENT = process.env.CONTENTFUL_ENVIRONMENT || 'master-2021-08-25'; const TOKEN = process.env.CONTENTFUL_MANAGEMENT_TOKEN; const CONTENT_TYPE_ID = 'changeLogItem'; const DEFAULT_LOCALE = 'en-US'; const CMA_BASE = `https://api.contentful.com/spaces/${SPACE_ID}/environments/${ENVIRONMENT}`; const SKIP_HEADINGS = new Set(['updated', 'updates', 'bug fixes', 'bug fix']); // Hero image seeding configuration. const DOCS_HOST = 'https://docs.mightynetworks.com'; const ASSET_POLL_INTERVAL_MS = 1000; const ASSET_POLL_TIMEOUT_MS = 30000; // `heroImage` validation on the content type restricts to MIME group `image`. // We only attempt asset upload when we recognize the extension; otherwise the // image stays inline in body markdown. const IMAGE_EXT_TO_MIME = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif', '.webp': 'image/webp', '.svg': 'image/svg+xml', }; // Older entries (pre-2024) use `## Releases` instead of weekly // `## Week of ` markers, with non-standard sub-heading shapes. We skip // those blocks entirely for v1 — marketing can backfill manually if needed. const MONTHLY_HEADING_RE = /^([A-Z][a-z]+)\s+(\d{4})\s+Releases$/; const DRY_RUN = process.argv.includes('--dry-run'); const DRY_RUN_VERBOSE = process.argv.includes('--dry-run-verbose'); const SAMPLE = process.argv.includes('--sample'); if (!DRY_RUN && !DRY_RUN_VERBOSE && !SAMPLE && (!SPACE_ID || !TOKEN)) { console.error('Missing CONTENTFUL_SPACE_ID or CONTENTFUL_MANAGEMENT_TOKEN'); process.exit(1); } // ────────────────────────────────────────────────────────────────────────── // Parsing // ────────────────────────────────────────────────────────────────────────── const stripFrontmatter = (text) => text.replace(/^---\n[\s\S]*?\n---\n?/, ''); /** Lowercase, strip emojis/punctuation, collapse to hyphens. */ const slugify = (text) => text .toLowerCase() // Strip emoji and other non-printable / non-ASCII chars .replace(/[^\x00-\x7f]/g, '') .replace(/[^a-z0-9]+/g, '-') .replace(/^-+|-+$/g, ''); /** Mintlify heading anchors: same as slugify above. */ const headingAnchor = (text) => slugify(text); /** * Parse the file into period blocks. Each block is a `## Week of ` or * `## Releases` heading plus the lines that follow until the * next period heading. Monthly blocks are tagged `kind: 'monthly'` so the * caller can skip them. */ const parsePeriods = (text) => { const stripped = stripFrontmatter(text); const lines = stripped.split('\n'); const periods = []; let current = null; for (const line of lines) { const weekly = line.match(/^##\s+Week of\s+(.+?)\s*$/); if (weekly) { if (current) periods.push(current); current = { kind: 'weekly', label: weekly[1].trim(), bodyLines: [] }; continue; } const headingMatch = line.match(/^##\s+(.+?)\s*$/); const monthly = headingMatch && headingMatch[1].match(MONTHLY_HEADING_RE); if (monthly) { if (current) periods.push(current); current = { kind: 'monthly', label: headingMatch[1].trim(), bodyLines: [] }; continue; } if (current) current.bodyLines.push(line); } if (current) periods.push(current); return periods; }; /** * Normalize a heading for skip detection: lowercase, strip surrounding bold * markers, drop trailing punctuation (`:`), collapse whitespace. */ const normalizeHeading = (text) => text .replace(/^\*+|\*+$/g, '') .trim() .replace(/[:.]+$/g, '') .toLowerCase() .replace(/\s+/g, ' '); /** Strip markdown bold markers from a title for display. */ const cleanTitle = (text) => { // Remove a single pair of surrounding `**...**` if present. const bolded = text.match(/^\*\*(.+?)\*\*$/); return (bolded ? bolded[1] : text).replace(/[:.]+$/g, '').trim(); }; /** * Within a period's lines, split into feature sub-sections. Each sub-section * is a `## ` heading + the lines that follow until the next `##`. * Skips structural headings (`## Updated`, `## Updated:`, `## **Updated**`, * `## Bug Fixes`, etc.). Once a `## Bug Fixes` heading is hit, all remaining * sub-sections in the period are dropped. */ const parseFeatures = (bodyLines) => { const features = []; let current = null; let bugFixesSeen = false; for (const line of bodyLines) { const m = line.match(/^##\s+(.+?)\s*$/); if (m) { const headingText = m[1].trim(); const headingNorm = normalizeHeading(headingText); const isSkip = SKIP_HEADINGS.has(headingNorm); if (current) features.push(current); current = null; // Once Bug Fixes is hit, drop everything that follows in this period — // including subsequent feature-shaped headings. if (bugFixesSeen) continue; if (headingNorm === 'bug fixes' || headingNorm === 'bug fix') { bugFixesSeen = true; continue; } if (isSkip) continue; current = { title: cleanTitle(headingText), bodyLines: [] }; } else if (current) { current.bodyLines.push(line); } } if (current) features.push(current); return features .map((f) => ({ title: f.title, body: f.bodyLines.join('\n').trim() })) .filter((f) => f.body.length > 0 && f.title.length > 0); }; /** * Parse a date label like "4/27/26", "12/29", or "1/19/23" into a Date, * using `runningYear` as a fallback when the year is missing. */ const parseDate = (label, runningYear) => { const m = label.match(/^(\d{1,2})\/(\d{1,2})(?:\/(\d{2,4}))?$/); if (!m) return { error: `Cannot parse date: "${label}"` }; const month = parseInt(m[1], 10); const day = parseInt(m[2], 10); let year = m[3] ? parseInt(m[3], 10) : null; if (year !== null && year < 100) year += 2000; if (year === null) { if (!runningYear) return { error: `No year and no running year for "${label}"` }; year = runningYear; } if (month < 1 || month > 12 || day < 1 || day > 31) { return { error: `Invalid date components in "${label}"` }; } return { date: new Date(Date.UTC(year, month - 1, day)) }; }; const dateToISO = (date) => date.toISOString().slice(0, 10); /** * Walk periods (file is newest-first), resolve dates, and expand each weekly * period into one entry per feature. Monthly periods are skipped. */ const resolveEntries = (periods) => { let runningYear = null; const entries = []; const errors = []; let skippedMonthly = 0; for (let i = 0; i < periods.length; i++) { const p = periods[i]; if (p.kind === 'monthly') { skippedMonthly++; continue; } const out = parseDate(p.label, runningYear); if (out.error) { errors.push(`Week #${i + 1} ("Week of ${p.label}"): ${out.error}`); continue; } const year = out.date.getUTCFullYear(); if (runningYear && year > runningYear) { console.warn( `[warn] "Week of ${p.label}" parsed as ${year}, but running year is ${runningYear}. Year moved forward in a newest-first file.`, ); } const suspectedTypo = runningYear && runningYear - year > 1; if (suspectedTypo) { console.warn( `[warn] "Week of ${p.label}" parsed as ${year}, but running year is ${runningYear}. Possible typo; using literal value.`, ); } // Don't poison runningYear with a suspected typo year. if (!suspectedTypo) runningYear = year; const features = parseFeatures(p.bodyLines); for (const f of features) { entries.push({ weekLabel: p.label, date: out.date, title: f.title, body: f.body, }); } } return { entries, errors, skippedMonthly }; }; const buildSlug = (date, title) => `${dateToISO(date)}-${slugify(title)}`; const buildSourceUrl = (title) => `${SOURCE_DOCS_URL}#${headingAnchor(title)}`; // ──────────────────────────────────────

Fields