@theholocron/cli 5.0.0-alpha.190 → 5.0.0-alpha.192

package/dist/cli.mjs

@@ -2898,11 +2898,6 @@ async function runNotificationsChannelAdd(input) {
 */
 /** Features not built yet, in the order of the table in holocron#1098. Move an entry into a real check when it lands. */
 const PLANNED_CHECKS = [
-	{
-		step: 10,
-		id: "server-settings",
-		title: "server verification, notifications and system channels set"
-	},
 	{
 		step: 11,
 		id: "welcome",
@@ -2939,6 +2934,7 @@ const same = (a, b) => a.toLowerCase() === b.toLowerCase();
 const accessKey = (v) => v === "everyone" ? "everyone" : JSON.stringify([...new Set(v.map((r) => r.toLowerCase()))].sort());
 const accessText = (v) => v === "everyone" ? "everyone" : v.length === 0 ? "nobody (bots and webhooks only)" : v.join(", ");
 const shown = (s) => sanitizeDetail(s);
+const SERVER_TITLE = "server verification, notifications and community set";
 const ACCESS_TITLE = "channel and category access set";
 const ROLE_APPEARANCE_TITLE = "role colour, hoist and permissions set";
 const SECRETS_TITLE = "webhook URLs and role id stored as secrets";
@@ -3058,7 +3054,8 @@ async function runDoctorNotifications(input) {
 			["webhooks", "webhooks on their channels"],
 			["roles", "roles exist and are mentionable"],
 			["role-appearance", ROLE_APPEARANCE_TITLE],
-			["access", ACCESS_TITLE]
+			["access", ACCESS_TITLE],
+			["server-settings", SERVER_TITLE]
 		]) failed(id, title, "not checked: could not read the server");
 	} else {
 		const inspected = found;
@@ -3162,6 +3159,33 @@ async function runDoctorNotifications(input) {
 			}
 		}
 		add("access", ACCESS_TITLE, inspected.rolesError && accessDeclared > 0 ? ["not checked: could not read the roles"] : accessProblems, accessDeclared === 0 ? "none declared" : `${accessDeclared} of ${accessDeclared} as declared`);
+		const wantServer = layout.server;
+		const serverProblems = [];
+		if (wantServer) {
+			if (inspected.serverError) serverProblems.push(`not checked: could not read the server settings (${shown(inspected.serverError)})`);
+			else if (!inspected.server) serverProblems.push("the provider did not report the server's settings");
+			else {
+				const have = inspected.server;
+				for (const field of [
+					"verification",
+					"defaultNotifications",
+					"contentFilter",
+					"systemChannel",
+					"rulesChannel",
+					"updatesChannel",
+					"community",
+					"description",
+					"locale"
+				]) {
+					const want = wantServer[field];
+					if (want === void 0) continue;
+					const actual = have[field];
+					if (!((field === "systemChannel" || field === "rulesChannel" || field === "updatesChannel") && typeof want === "string" && typeof actual === "string" ? same(want, actual) : want === actual)) serverProblems.push(`${field} is ${shown(String(actual ?? "not set"))} but the layout says ${shown(String(want))}`);
+				}
+			}
+		}
+		const serverFields = wantServer ? Object.values(wantServer).filter((v) => v !== void 0).length : 0;
+		add("server-settings", SERVER_TITLE, serverProblems, serverFields === 0 ? "none declared" : `${serverFields} of ${serverFields} as declared`);
 	}
 	const wanted = [...declaredChannels.filter(({ channel }) => channel.webhook).map(({ channel }) => channel.webhook !== true && channel.webhook && channel.webhook.secret ? channel.webhook.secret : defaultSecretName(channel.name)), ...(layout.roles ?? []).flatMap((r) => r.secret ? [r.secret] : [])];
 	if (wanted.length === 0) checks.push({
@@ -3860,6 +3884,25 @@ function accessRoleProblem(layout) {
 		}
 	}
 }
+/** The first problem with the layout's `server` section that needs no knowledge of the provider, or undefined. */
+function serverLayoutProblem(layout) {
+	const server = layout.server;
+	if (!server) return void 0;
+	const counts = /* @__PURE__ */ new Map();
+	for (const name of (layout.categories ?? []).flatMap((c) => (c.channels ?? []).map((ch) => ch.name.toLowerCase()))) counts.set(name, (counts.get(name) ?? 0) + 1);
+	for (const field of [
+		"systemChannel",
+		"rulesChannel",
+		"updatesChannel"
+	]) {
+		const name = server[field];
+		if (name === void 0) continue;
+		const count = counts.get(name.toLowerCase()) ?? 0;
+		if (count === 0) return `server: \`${field}\` names the channel \`${name}\`, which is not in the layout's channels`;
+		if (count > 1) return `server: \`${field}\` names \`${name}\`, but more than one channel in the layout has that name`;
+	}
+	if (server.community === true && (!server.rulesChannel || !server.updatesChannel)) return "server: `community: true` needs both `rulesChannel` and `updatesChannel`";
+}
 async function runNotificationsSetup(input) {
 	const print = input.print ?? ((line) => console.log(line));
 	const logger = input.logger ?? getLogger();
@@ -3915,10 +3958,18 @@ async function runNotificationsSetup(input) {
 	if (secretProblem) return refuse(secretProblem);
 	const accessProblem = accessRoleProblem(layout);
 	if (accessProblem) return refuse(accessProblem);
+	const serverProblem = serverLayoutProblem(layout);
+	if (serverProblem) return refuse(serverProblem);
+	if (layout.server && !notifications.ensureServer) return refuse(`the layout declares \`server\` settings, but the \`${notifications.providerName}\` provider cannot manage them`);
 	const needsCategories = (layout.categories ?? []).find((c) => c.access);
 	if (needsCategories && !notifications.ensureCategory) return refuse(`category \`${needsCategories.name}\` declares \`access\`, but the \`${notifications.providerName}\` provider cannot manage categories`);
 	const providerProblem = notifications.validateLayout?.(layout);
 	if (providerProblem) return refuse(providerProblem);
+	if (!dryRun && notifications.preflight) try {
+		await notifications.preflight(layout);
+	} catch (err) {
+		return refuse(describeProviderError(err), logReason(err));
+	}
 	const tally = {
 		ok: 0,
 		skip: 0
@@ -4022,6 +4073,20 @@ async function runNotificationsSetup(input) {
 			});
 		});
 	}
+	if (layout.server) {
+		print(`\n${style.header("Server")}`);
+		await attempt("server settings", async () => {
+			if (dryRun) {
+				print(`  ${style.skip("would ensure server settings")}`);
+				tally.skip++;
+				return;
+			}
+			const result = await notifications.ensureServer(layout.server);
+			const changed = result.updated.length > 0;
+			print(`  ${(changed ? style.success : style.skip)(`${changed ? "updated" : "exists "} server settings${changed ? `: ${result.updated.join(", ")}` : ""}`)}`);
+			made(changed);
+		});
+	}
 	if (report.failures.length > 0) report.status = "fail";
 	else if (dryRun) report.status = "dry-run";
 	print("");