const fs = require("fs"); const path = require("path"); const { changelogSection } = require("./lib/changelog-section.cjs"); // Apple caps the "What's New in This Version" field at 4000 characters. const MAX_LENGTH = 4000; function parseArgs(argv) { const args = {}; for (let i = 0; i < argv.length; i++) { const arg = argv[i]; if (!arg.startsWith("--")) continue; const key = arg.slice(2); const next = argv[i + 1]; if (next === undefined || next.startsWith("--")) { args[key] = true; } else { args[key] = next; i++; } } return args; } function fail(message) { console.error(`generate-appstore-notes: ${message}`); process.exit(1); } // Strip markdown that reads badly as plain text in App Store Connect. function toPlainText(markdown) { return markdown .split("\n") .map((line) => { let text = line.replace(/\r$/, ""); const indent = text.match(/^\s*/)[0].length; text = text.trim(); text = text.replace(/^[-*]\s+/, indent >= 2 ? " - " : "- "); text = text.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1"); text = text.replace(/`([^`]+)`/g, "$1"); text = text.replace(/\*\*([^*]+)\*\*/g, "$1"); if (/^#+\s/.test(text)) text = `${text.replace(/^#+\s*/, "")}:`; return text; }) .join("\n") .replace(/\n{3,}/g, "\n\n") .trim(); } // Drop whole trailing lines until the text fits, so we never cut a bullet // in half or leave a dangling section header. function truncate(text, limit) { if (text.length <= limit) return text; const lines = text.split("\n"); while (lines.length > 0 && lines.join("\n").length > limit) { lines.pop(); } while (lines.length > 0 && !lines[lines.length - 1].trim()) { lines.pop(); } // A section header left with no bullets under it is noise. while (lines.length > 0 && /^[A-Za-z ]+:$/.test(lines[lines.length - 1])) { lines.pop(); while (lines.length > 0 && !lines[lines.length - 1].trim()) lines.pop(); } return lines.join("\n").trim(); } function buildNotes(changelog, version) { const notes = changelogSection(changelog, version); if (!notes) fail(`CHANGELOG.md has no notes for ${version}`); const body = toPlainText(notes); if (!body) fail("release notes produced no text"); return truncate(body, MAX_LENGTH); } function main() { const args = parseArgs(process.argv.slice(2)); const changelogPath = args.changelog || "CHANGELOG.md"; const version = typeof args.version === "string" ? args.version : require(path.resolve("package.json")).version; const outDir = args["out-dir"]; const locales = String(args.locales || "en-US") .split(",") .map((locale) => locale.trim()) .filter(Boolean); if (!outDir || outDir === true) fail("--out-dir is required"); if (locales.length === 0) fail("--locales resolved to no locales"); const resolved = path.resolve(changelogPath); if (!fs.existsSync(resolved)) fail(`changelog not found: ${resolved}`); const notes = buildNotes(fs.readFileSync(resolved, "utf8"), version); for (const locale of locales) { const localeDir = path.join(path.resolve(outDir), locale); fs.mkdirSync(localeDir, { recursive: true }); fs.writeFileSync( path.join(localeDir, "release_notes.txt"), notes + "\n", "utf8", ); console.log(`Wrote ${locale}/release_notes.txt (${notes.length} chars)`); } } if (require.main === module) { main(); } module.exports = { buildNotes, toPlainText, truncate, MAX_LENGTH };