#!/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)}`; // ────────────────────────────────────────────────────────────────────────── // Hero image extraction // ────────────────────────────────────────────────────────────────────────── /** Resolve a docs-relative image path to its absolute docs.mightynetworks.com URL. */ const absolutizeUrl = (url) => { if (!url) return url; if (/^(https?:|data:|mailto:)/i.test(url)) return url; if (url.startsWith('/')) return `${DOCS_HOST}${url}`; return url; }; /** * Trailing image at the very end of a feature body. Captures alt + URL. * Handles three patterns Mintlify authors use: * \n ![alt](url)\n (most common) * ![alt](url) (bare markdown) * [![alt](url)](href) (link-wrapped image, sometimes seen) * Anchored to end-of-string with optional trailing whitespace; the regex * intentionally does NOT match a mid-body image followed by more text. * Bare JSX `` is not matched — those stay inline in body markdown. */ const TRAILING_IMAGE_RE = /\n*(?:\s*\n?\s*)?(?:\[\s*)?!\[([^\]]*)\]$([^)\s]+)(?:\s+"[^"]*")?$(?:\s*\]$[^)]+$)?\s*(?:\n?\s*<\/Frame>)?\s*$/; /** * Pull a trailing image off the end of a feature body. Returns the rest of * the body (with trailing whitespace trimmed) and the extracted hero, or * `{ body, hero: null }` if no trailing image is present. */ const extractHeroImage = (body) => { const m = body.match(TRAILING_IMAGE_RE); if (!m) return { body, hero: null }; const alt = (m[1] || '').trim(); const url = absolutizeUrl(m[2]); const remaining = body.slice(0, m.index).replace(/\s+$/, ''); return { body: remaining, hero: { url, alt } }; }; /** * Rewrite docs-relative image URLs in markdown body to absolute URLs so the * marketing site can fetch them. Covers both `![](/path)` and `

`. */ const absolutizeBodyImages = (body) => body .replace(/!\[([^\]]*)\]$(\/[^)\s]+)([^)]*)$/g, (_, alt, p, rest) => `![${alt}](${absolutizeUrl(p)}${rest})`) .replace(/]*?)src=(["'])(\/[^"'\s]+)\2/g, (_, pre, q, p) => ` { let pathname; try { pathname = new URL(url).pathname; } catch { return null; } const fileName = path.basename(pathname) || 'asset'; const ext = path.extname(fileName).toLowerCase(); const contentType = IMAGE_EXT_TO_MIME[ext]; if (!contentType) return null; return { fileName, contentType }; }; // ────────────────────────────────────────────────────────────────────────── // Sample output (for PR review) // ────────────────────────────────────────────────────────────────────────── const escapeMd = (s) => s.replace(/\|/g, '\\|').replace(/\n/g, ' '); const emitSampleMarkdown = ({ entries, weeks, monthly }) => { const out = []; const generated = new Date().toISOString().slice(0, 19) + 'Z'; out.push('# Sync Changelog — Parser Sample'); out.push(''); out.push(`Generated: ${generated} via \`node scripts/sync-changelog.js --sample > scripts/sync-changelog.sample.md\``); out.push(''); out.push('This file is a checked-in dry-run snapshot of every Contentful entry the sync would produce against the current `for-hosts/meet-mighty/latest-product-updates.mdx`. It is for **review verification only** — the workflow does not consume it. Regenerate after any meaningful source-MDX or parser change.'); out.push(''); out.push('## Totals'); out.push(''); out.push(`- Weekly periods: **${weeks}**`); out.push(`- Monthly periods skipped: **${monthly}**`); out.push(`- Feature entries resolved: **${entries.length}**`); out.push(''); out.push('## What gets written per entry'); out.push(''); out.push('**Create-only.** Each field below is written exactly once, when an entry is first created. Subsequent sync runs detect the existing slug and skip without touching any field.'); out.push(''); out.push('Seed values written from the docs MDX:'); out.push(''); out.push('- `mintlifySlug` — unique match key, shape `YYYY-MM-DD-`'); out.push('- `title` — feature heading text (with leading emoji preserved, surrounding `**` stripped)'); out.push('- `publishedAt` — the week\'s date in ISO `YYYY-MM-DD`'); out.push('- `body` — markdown content between this `## ` heading and the next `##`, with relative `/images/...` URLs absolutized to `docs.mightynetworks.com`'); out.push('- `sourceUrl` — `…/latest-product-updates#`'); out.push('- `sourceUpdatedAt` — sync run timestamp at creation'); out.push('- `heroImage` — only when the feature body ends with an image (``-wrapped, link-wrapped, or bare `![](...)`); the image is uploaded to Contentful as an Asset (remote URL form) and linked. Stripped from `body` on success.'); out.push(''); out.push('Left empty by sync (editor-controlled in Contentful):'); out.push(''); out.push('- `tags` (Members/iOS/Android/Web/Admin chips)'); out.push('- `featured`, `hidden`, `ctaLabel`, `ctaUrl`'); out.push(''); out.push('After creation, **all** fields are editable in Contentful — sync will not overwrite anything, including `heroImage`.'); out.push(''); // Worked example using the first entry with a non-trivial body. const example = entries.find((e) => e.body.length >= 150) || entries[0]; if (example) { const slug = buildSlug(example.date, example.title); const url = buildSourceUrl(example.title); out.push(`## Worked example: \`${slug}\``); out.push(''); out.push('```json'); out.push('{'); out.push(' "fields": {'); out.push(` "mintlifySlug": { "en-US": "${slug}" },`); out.push(` "title": { "en-US": ${JSON.stringify(example.title)} },`); out.push(` "publishedAt": { "en-US": "${dateToISO(example.date)}" },`); out.push(` "sourceUrl": { "en-US": "${url}" },`); out.push(` "sourceUpdatedAt": { "en-US": "" },`); out.push(` "body": { "en-US": ${JSON.stringify(example.body)} }`); out.push(' }'); out.push('}'); out.push('```'); out.push(''); out.push(`Source: from \`## Week of ${example.weekLabel}\` block in the MDX, sub-heading \`## ${example.title}\`.`); out.push(''); } out.push('## All entries'); out.push(''); out.push('| # | Slug | Title | Date | Body chars | Hero | Source URL |'); out.push('|--:|------|-------|------|-----------:|------|------------|'); entries.forEach((e, i) => { const slug = buildSlug(e.date, e.title); const url = buildSourceUrl(e.title); const { hero } = extractHeroImage(e.body); const heroCell = hero ? `[asset](${hero.url})` : '—'; out.push(`| ${i + 1} | \`${slug}\` | ${escapeMd(e.title)} | ${dateToISO(e.date)} | ${e.body.length} | ${heroCell} | [link](${url}) |`); }); out.push(''); process.stdout.write(out.join('\n')); }; // ────────────────────────────────────────────────────────────────────────── // Contentful CMA // ────────────────────────────────────────────────────────────────────────── const sleep = (ms) => new Promise((r) => setTimeout(r, ms)); const cma = async (method, urlPath, { body, version, contentType } = {}) => { const headers = { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/vnd.contentful.management.v1+json', }; if (version !== undefined) headers['X-Contentful-Version'] = String(version); if (contentType) headers['X-Contentful-Content-Type'] = contentType; const res = await fetch(`${CMA_BASE}${urlPath}`, { method, headers, body: body ? JSON.stringify(body) : undefined, }); const text = await res.text(); const json = text ? JSON.parse(text) : null; if (!res.ok) { const reason = json?.message || res.statusText; throw new Error(`CMA ${method} ${urlPath} → ${res.status}: ${reason}`); } // Stay under Contentful's CMA rate limit (~7 req/s sustained). await sleep(150); return json; }; const entryExistsBySlug = async (slug) => { // Use the `select` param so the response is small — we only care about existence. const q = new URLSearchParams({ content_type: CONTENT_TYPE_ID, 'fields.mintlifySlug': slug, select: 'sys.id', limit: '1', }); const res = await cma('GET', `/entries?${q}`); return res.items.length > 0; }; const createEntry = async (fields) => cma('POST', '/entries', { body: { fields }, contentType: CONTENT_TYPE_ID, }); // Asset pipeline. Uses the CMA "remote URL" form: Contentful pulls the binary // from `upload`, eliminating any binary handling on our side. Sequence is // create → process → poll until file.url appears → publish. const createAssetFromUrl = async ({ url, alt, fallbackTitle }) => { const meta = inferAssetMeta(url); if (!meta) throw new Error(`Unsupported image extension for ${url}`); const fields = { title: { [DEFAULT_LOCALE]: (alt && alt.length ? alt : fallbackTitle).slice(0, 256) }, description: { [DEFAULT_LOCALE]: alt || '' }, file: { [DEFAULT_LOCALE]: { contentType: meta.contentType, fileName: meta.fileName, upload: url, }, }, }; return cma('POST', '/assets', { body: { fields } }); }; const processAssetFile = (assetId, version, locale = DEFAULT_LOCALE) => cma('PUT', `/assets/${assetId}/files/${locale}/process`, { version }); /** * Poll the asset until Contentful finishes pulling and processing the file. * Done = `fields.file[locale].url` is populated. Throws on timeout. */ const waitAssetReady = async (assetId, locale = DEFAULT_LOCALE) => { const start = Date.now(); while (Date.now() - start < ASSET_POLL_TIMEOUT_MS) { const asset = await cma('GET', `/assets/${assetId}`); const fileUrl = asset.fields?.file?.[locale]?.url; if (fileUrl) return asset; await sleep(ASSET_POLL_INTERVAL_MS); } throw new Error(`Asset ${assetId} did not finish processing within ${ASSET_POLL_TIMEOUT_MS}ms`); }; const publishAsset = (assetId, version) => cma('PUT', `/assets/${assetId}/published`, { version }); // Best-effort cleanup. Contentful rejects DELETE /assets/:id on a published // asset, so unpublish first when the asset has already been published. Any // failure is swallowed — leaving an orphan is acceptable; failing the whole // run for a cleanup blip is not. const deleteAsset = async (assetId) => { try { await cma('DELETE', `/assets/${assetId}/published`); } catch { // Asset wasn't published (or unpublish failed) — fall through to delete. } await cma('DELETE', `/assets/${assetId}`).catch(() => null); }; /** * End-to-end: turn a docs image URL into a published Contentful Asset. * Returns the asset ID on success, or null on any failure (with the orphan * draft cleaned up). The caller falls back to leaving the image inline in * body markdown on null. */ const ensureAssetForUrl = async ({ url, alt, fallbackTitle }) => { let assetId = null; try { const created = await createAssetFromUrl({ url, alt, fallbackTitle }); assetId = created.sys.id; await processAssetFile(assetId, created.sys.version); const ready = await waitAssetReady(assetId); await publishAsset(assetId, ready.sys.version); return assetId; } catch (err) { console.error(`! asset upload failed for ${url}: ${err.message}`); if (assetId) await deleteAsset(assetId); return null; } }; // ────────────────────────────────────────────────────────────────────────── // Main // ────────────────────────────────────────────────────────────────────────── const main = async () => { // Route progress to stderr when emitting machine-readable sample output. const info = SAMPLE ? (msg) => console.error(msg) : (msg) => console.log(msg); info(`Reading ${SOURCE_FILE}`); const raw = fs.readFileSync(SOURCE_FILE, 'utf8'); const periods = parsePeriods(raw); const weekly = periods.filter((p) => p.kind === 'weekly').length; const monthly = periods.filter((p) => p.kind === 'monthly').length; info(`Found ${weekly} weekly + ${monthly} monthly period blocks`); const { entries, errors, skippedMonthly } = resolveEntries(periods); if (errors.length) { console.error('Date parsing errors:'); errors.forEach((e) => console.error(` - ${e}`)); process.exit(1); } info(`Resolved ${entries.length} feature entries (skipped ${skippedMonthly} monthly periods, Bug Fixes ignored)`); // Detect duplicate slugs. const slugCounts = {}; for (const e of entries) { const slug = buildSlug(e.date, e.title); slugCounts[slug] = (slugCounts[slug] || 0) + 1; } const dupes = Object.entries(slugCounts).filter(([, n]) => n > 1); if (dupes.length) { console.error('Duplicate slugs detected:'); dupes.forEach(([s, n]) => console.error(` - ${s} (${n} occurrences)`)); process.exit(1); } if (SAMPLE) { emitSampleMarkdown({ entries, weeks: weekly, monthly: skippedMonthly }); return; } if (DRY_RUN || DRY_RUN_VERBOSE) { const sample = DRY_RUN_VERBOSE ? entries : [...entries.slice(0, 5), ...entries.slice(-5)]; const heroCount = entries.filter((e) => extractHeroImage(e.body).hero).length; console.log(`\n[dry-run] ${DRY_RUN_VERBOSE ? 'All' : 'First 5 and last 5'} entries (${heroCount} would seed heroImage):`); for (const e of sample) { const slug = buildSlug(e.date, e.title); const url = buildSourceUrl(e.title); const { hero } = extractHeroImage(e.body); const preview = e.body.length > 80 ? e.body.slice(0, 77).replace(/\n/g, ' ') + '...' : e.body.replace(/\n/g, ' '); console.log(` - ${slug}`); console.log(` title: "${e.title}"`); console.log(` week: "Week of ${e.weekLabel}" date: ${dateToISO(e.date)}`); console.log(` url: ${url}`); console.log(` body: ${e.body.length}c "${preview}"`); if (hero) console.log(` hero: ${hero.url}${hero.alt ? ` alt="${hero.alt}"` : ''}`); } // Synthesize a manifest so the workflow's Slack-notify step can be // exercised end-to-end in dry-run via workflow_dispatch. Cap at 5 entries // to keep the test message short — formatting validation only. const manifestPath = process.env.SYNC_CHANGELOG_MANIFEST; if (manifestPath) { const synthetic = entries.slice(0, 5).map((e, i) => { const fakeId = `dryrun-${String(i + 1).padStart(3, '0')}`; return { slug: buildSlug(e.date, e.title), title: e.title, publishedAt: dateToISO(e.date), entryId: fakeId, contentfulUrl: `https://app.contentful.com/spaces/${SPACE_ID || 'DRYRUN'}/environments/${ENVIRONMENT}/entries/${fakeId}`, sourceUrl: buildSourceUrl(e.title), }; }); fs.writeFileSync(manifestPath, JSON.stringify({ created: synthetic, dryRun: true }, null, 2)); console.log(`\n[dry-run] Wrote synthetic manifest with ${synthetic.length} entries → ${manifestPath}`); } console.log(`\n[dry-run] Skipped Contentful sync. Re-run without --dry-run to apply.`); return; } const now = new Date().toISOString(); const createdEntries = []; let skipped = 0; for (const e of entries) { const slug = buildSlug(e.date, e.title); try { if (await entryExistsBySlug(slug)) { skipped++; console.log(`= exists ${slug}`); continue; } // Pull a trailing image off the body for heroImage seeding. If the // upload pipeline fails, fall back to leaving the image inline in body // (with the URL absolutized) so the page still renders. const { body: bodyWithoutHero, hero } = extractHeroImage(e.body); let heroAssetId = null; let bodyForEntry = absolutizeBodyImages(e.body); if (hero) { heroAssetId = await ensureAssetForUrl({ url: hero.url, alt: hero.alt, fallbackTitle: e.title, }); if (heroAssetId) { bodyForEntry = absolutizeBodyImages(bodyWithoutHero); } else { console.warn(` warn: heroImage upload failed for ${slug}; keeping image inline in body`); } } const fields = { mintlifySlug: { [DEFAULT_LOCALE]: slug }, title: { [DEFAULT_LOCALE]: e.title }, publishedAt: { [DEFAULT_LOCALE]: dateToISO(e.date) }, body: { [DEFAULT_LOCALE]: bodyForEntry }, sourceUrl: { [DEFAULT_LOCALE]: buildSourceUrl(e.title) }, sourceUpdatedAt: { [DEFAULT_LOCALE]: now }, }; if (heroAssetId) { fields.heroImage = { [DEFAULT_LOCALE]: { sys: { type: 'Link', linkType: 'Asset', id: heroAssetId } }, }; } let res; try { res = await createEntry(fields); } catch (err) { // Don't leave a published asset orphaned if the entry create itself // fails — the next run will rebuild from the docs source. if (heroAssetId) await deleteAsset(heroAssetId); throw err; } createdEntries.push({ slug, title: e.title, publishedAt: dateToISO(e.date), entryId: res.sys.id, contentfulUrl: `https://app.contentful.com/spaces/${SPACE_ID}/environments/${ENVIRONMENT}/entries/${res.sys.id}`, sourceUrl: buildSourceUrl(e.title), heroImageAssetId: heroAssetId, }); console.log(`+ drafted ${slug}${heroAssetId ? ` (hero=${heroAssetId})` : ''}`); } catch (err) { console.error(`! failed ${slug}: ${err.message}`); throw err; } } const manifestPath = process.env.SYNC_CHANGELOG_MANIFEST; if (manifestPath) { fs.writeFileSync(manifestPath, JSON.stringify({ created: createdEntries }, null, 2)); } console.log(`\nDone. created=${createdEntries.length} skipped=${skipped} total=${entries.length}`); }; main().catch((err) => { console.error(err); process.exit(1); });

​For more information, check out our Admin API website

For more information, check out our Admin API website