wehub-resource-sync
72 lines
3.3 KiB
TypeScript
72 lines
3.3 KiB
TypeScript
// Unit tests for the pure helpers in scripts/docs/sync-wiki.mjs (the GitHub wiki sync).
|
||
import { test } from "node:test";
|
||
import assert from "node:assert/strict";
|
||
|
||
import {
|
||
normKey,
|
||
toWikiName,
|
||
toWikiContent,
|
||
syncHomeCounts,
|
||
parseWikiPage,
|
||
WIKI_BANNER,
|
||
NEW_PAGE_EXCLUDE,
|
||
} from "../../scripts/docs/sync-wiki.mjs";
|
||
|
||
test("normKey: case/separator-insensitive fuzzy key (matches docs basename to curated wiki name)", () => {
|
||
// The wiki names are hand-curated and not deterministic — normKey is what lets us
|
||
// match e.g. FLY_IO_DEPLOYMENT_GUIDE.md to the existing "Fly-io-Deployment-Guide" page.
|
||
assert.equal(normKey("FLY_IO_DEPLOYMENT_GUIDE.md"), normKey("Fly-io-Deployment-Guide"));
|
||
assert.equal(normKey("API_REFERENCE"), normKey("API-Reference"));
|
||
assert.equal(normKey("A2A-SERVER.md"), "a2aserver");
|
||
});
|
||
|
||
test("toWikiName: acronym-aware Title-Case-dashed name for NEW pages", () => {
|
||
assert.equal(toWikiName("SUPPLY_CHAIN.md"), "Supply-Chain");
|
||
assert.equal(toWikiName("API_REFERENCE"), "API-Reference");
|
||
assert.equal(toWikiName("QUOTA_SHARE"), "Quota-Share");
|
||
assert.equal(toWikiName("ACP"), "ACP");
|
||
});
|
||
|
||
test("toWikiContent: strips YAML frontmatter and prepends the language banner", () => {
|
||
const doc = '---\ntitle: "X"\nversion: 3.8.2\n---\n\n# Heading\n\nBody text.\n';
|
||
const out = toWikiContent(doc);
|
||
assert.ok(out.startsWith(WIKI_BANNER), "must start with the wiki language banner");
|
||
assert.ok(!out.includes("version: 3.8.2"), "frontmatter must be removed");
|
||
assert.ok(out.includes("# Heading"), "content body must be preserved");
|
||
assert.ok(out.endsWith("Body text.\n"), "trailing newline normalized");
|
||
});
|
||
|
||
test("toWikiContent: a document without frontmatter is kept intact (plus banner)", () => {
|
||
const doc = "# No Frontmatter\n\nHello.\n";
|
||
const out = toWikiContent(doc);
|
||
assert.equal(out, WIKI_BANNER + "# No Frontmatter\n\nHello.\n");
|
||
});
|
||
|
||
test("syncHomeCounts: rewrites the cover-page provider/strategy counts", () => {
|
||
const home = "Connect every AI tool to 177 providers.\n**177 AI Providers** · **14 Routing Strategies**\n";
|
||
const out = syncHomeCounts(home, { providers: 226, strategies: 15, mcpTools: null, locales: 42 });
|
||
assert.ok(out.includes("226 providers"));
|
||
assert.ok(out.includes("**226 AI Providers**"));
|
||
assert.ok(out.includes("**15 Routing Strategies**"));
|
||
assert.ok(!out.includes("177"));
|
||
});
|
||
|
||
test("syncHomeCounts: leaves text untouched when a count is null (best-effort MCP)", () => {
|
||
const home = "| **MCP Server** | 87 tools |\n";
|
||
const out = syncHomeCounts(home, { providers: null, strategies: null, mcpTools: null, locales: null });
|
||
assert.equal(out, home);
|
||
});
|
||
|
||
test("parseWikiPage: splits the locale prefix (U+2010) from the page name", () => {
|
||
assert.deepEqual(parseWikiPage("Architecture"), { locale: null, name: "Architecture" });
|
||
// U+2010 HYPHEN separator used by the localized mirrors (e.g. "pt-BR‐Architecture").
|
||
assert.deepEqual(parseWikiPage("pt-BR‐Architecture"), { locale: "pt-BR", name: "Architecture" });
|
||
assert.deepEqual(parseWikiPage("phi‐API-Reference"), { locale: "phi", name: "API-Reference" });
|
||
});
|
||
|
||
test("NEW_PAGE_EXCLUDE: internal reports/plans never become public wiki pages", () => {
|
||
assert.ok(NEW_PAGE_EXCLUDE.has("DOCUMENTATION_AUDIT_REPORT"));
|
||
assert.ok(NEW_PAGE_EXCLUDE.has("README"));
|
||
assert.ok(!NEW_PAGE_EXCLUDE.has("SUPPLY_CHAIN"));
|
||
});
|