void 0.20.0 → 0.20.2

package/dist/email-r6DHJyAB.mjs

@@ -1,262 +0,0 @@
-import { D as log, F as isCancel, O as note, c as import_picocolors, w as confirm } from "./output-tFQLLj26.mjs";
-import { C as renderAddressMap, S as preflightEmail, a as isWranglerNonInteractiveOrCI, b as createNodeEmailDns, i as discoverRootWranglerConfig, o as loadProvisionModule, r as deriveWorkerName, s as resolveDeployTransport, t as createDeployWranglerRunner, u as runWranglerAuthToken, w as renderEmailChecklist, x as findEmailConfigConflicts, y as applyEmailSetup } from "./deploy-CcDoeBIf.mjs";
-import { n as readProjectPaths } from "./project-paths-SK8nMHPp.mjs";
-import { c as getToken, x as readProjectConfig } from "./auth-W9WII-mN.mjs";
-import { k as writeProvisionedWranglerConfig } from "./wrangler--imS8n0d.mjs";
-import { f as readConfig } from "./config-BQFq7QvD.mjs";
-import { a as scanEmailHandlersSync } from "./email-Ce6SQq-i.mjs";
-import { n as PlatformClient } from "./client-CyCHWSO_.mjs";
-import { parseRootWranglerConfig, readWranglerTopLevelString } from "@void/deploy-cloudflare";
-//#region src/cli/email.ts
-async function runEmailCommand(root, args) {
-	if (args.platform === "cloudflare") return runEmailCloudflareCommand(root, args);
-	if (args.subcommand === "setup") {
-		log.error("email: `void email setup` sets email up on your OWN Cloudflare account — run it with `--platform cloudflare`. The Void platform needs no setup: deploy, and `void email usage` shows your address.");
-		process.exit(1);
-	}
-	if (args.subcommand === "status") {
-		log.error("email: `void email status` is available with `--platform cloudflare` today. On the Void platform use `void email usage` and `void email destinations`.");
-		process.exit(1);
-	}
-	const token = getToken(root);
-	if (!token) {
-		log.error("Not logged in. Run `void auth login` first.");
-		process.exit(1);
-	}
-	const client = new PlatformClient(token, { root });
-	const requestedSlug = args.projectSlug ?? process.env.VOID_PROJECT?.trim();
-	let projectId;
-	if (requestedSlug) {
-		const project = (await client.listProjects()).find((p) => p.slug === requestedSlug);
-		if (!project) {
-			log.error(`project: No project found with slug '${requestedSlug}'.`);
-			process.exit(1);
-		}
-		projectId = project.id;
-	} else {
-		const config = readProjectConfig(root);
-		if (!config) {
-			log.error("No linked project. Run `void project link` or pass --project <name>.");
-			process.exit(1);
-		}
-		projectId = config.projectId;
-	}
-	switch (args.subcommand) {
-		case "usage": return emailUsage(client, projectId);
-		case "logs": return emailLogs(client, projectId, args.limit);
-		case "destinations": return emailDestinations(client, projectId);
-		case "allow": return emailAllow(client, projectId, args.address);
-		case "disallow": return emailDisallow(client, projectId, args.address);
-	}
-}
-async function emailUsage(client, projectId) {
-	const usage = await client.getEmailUsage(projectId);
-	const status = usage.suspended ? import_picocolors.default.red("SUSPENDED") : import_picocolors.default.green("active");
-	const lines = [
-		`Month:       ${usage.month}`,
-		`Status:      ${status}`,
-		`Outbound:    ${usage.sent} / ${usage.limit} (${usage.remaining} remaining)`,
-		`Inbound:     ${usage.received}`
-	];
-	note(lines.join("\n"), "Email Usage");
-}
-async function emailDestinations(client, projectId) {
-	const rows = await client.listEmailDestinations(projectId);
-	if (rows.length === 0) {
-		log.info("No verified destinations. Run `void email allow <address>` to add one — Cloudflare will email the recipient with a verification link.");
-		return;
-	}
-	const lines = rows.map((d) => {
-		const status = d.status === "verified" ? import_picocolors.default.green("verified") : d.status === "pending" ? import_picocolors.default.yellow("pending") : import_picocolors.default.red("failed");
-		return `  ${d.address.padEnd(40)} ${status}`;
-	});
-	note(lines.join("\n"), "Email Destinations");
-}
-/**
-* `void email allow <address>` — exported for the unit test; the command
-* entry (`runEmailCommand`) resolves the client and project first.
-*/
-async function emailAllow(client, projectId, address) {
-	const dest = await client.addEmailDestination(projectId, address);
-	const sent = dest.verificationSent !== false && (dest.created || dest.platformVerificationPending);
-	if (dest.status === "verified") log.success(`${dest.address} is already verified.`);
-	else if (sent) {
-		log.success(`Verification email sent to ${dest.address}.`);
-		log.info("They click the link in their inbox — no Void or Cloudflare account needed. `void email destinations` to poll status.");
-	} else if (dest.created) log.warn(`${dest.address} is on this project's list now, but Cloudflare already had the address pending (added by another project, or by hand), so no new verification email was sent — the link it mailed when the address was first added is the one to click. ${freshLinkHint(dest.address)}`);
-	else log.info(`${dest.address} is still pending — Cloudflare emailed them a verification link when the address was first added, and a repeat add sends nothing new. ${freshLinkHint(dest.address)}`);
-}
-/**
-* Cloudflare has no API to resend its verification mail; the only fresh link
-* is a fresh registration, and the platform deletes the Cloudflare-side
-* address only once no project still lists it.
-*/
-function freshLinkHint(address) {
-	return `For a fresh link, remove the address from every project that lists it (\`void email disallow ${address}\`), then \`void email allow ${address}\` — Cloudflare mails a new link only when it registers the address anew.`;
-}
-/**
-* `void email disallow <address>` — exported for the unit test; the command
-* entry (`runEmailCommand`) resolves the client and project first.
-*
-* No deploy is involved: the api tightens the proxy's `email-allowlist`
-* KV mirror inside the DELETE (and answers 503 if that write fails), and
-* the proxy re-reads the mirror with a 60s `cacheTtl` on both the send
-* path and inbound forward/reply — so the address is refused once that
-* per-colo cache turns over.
-*/
-async function emailDisallow(client, projectId, address) {
-	const dest = (await client.listEmailDestinations(projectId)).find((d) => d.address.toLowerCase() === address.toLowerCase());
-	if (!dest) {
-		log.error(`destination: '${address}' is not in the project's allowlist.`);
-		process.exit(1);
-	}
-	await client.removeEmailDestination(projectId, dest.id);
-	log.success(`Removed ${dest.address}. Sends to it are refused within about a minute.`);
-}
-/**
-* `void email logs` — exported for the unit test; the command entry
-* (`runEmailCommand`) resolves the client and project first.
-*/
-async function emailLogs(client, projectId, limit) {
-	const result = await client.getEmailLogs(projectId, limit);
-	if (result.pending) {
-		log.info(result.note ?? "Persistent log storage is not yet wired up.");
-		log.info("Email activity logs are not available yet. Console output from your email handler appears in `void project logs`.");
-		return;
-	}
-	if (result.logs.length === 0) {
-		log.info("No email activity recorded.");
-		return;
-	}
-	const lines = result.logs.map((entry) => {
-		const ts = new Date(entry.timestamp).toISOString();
-		const dir = entry.direction === "sent" ? "→" : "←";
-		const subject = entry.subject ? ` "${entry.subject}"` : "";
-		return `${ts}  ${dir}  ${entry.from} → ${entry.to}  ${entry.status}${subject}`;
-	});
-	note(lines.join("\n"), "Email Logs");
-}
-/**
-* `void email setup --platform cloudflare` and `void email status --platform cloudflare`.
-*
-* `setup` is the deploy's step 3b-ii on its own: preflight → checklist → the one Enter →
-* apply → write the root wrangler.jsonc. It exists for CI: a non-interactive deploy that
-* finds email not ready prints the checklist and says to run this once, commit
-* wrangler.jsonc, and redeploy. Rules and the catch-all stay wrangler's job — the next
-* `void deploy --platform cloudflare` applies the plan from the written `addresses`. It
-* is also the ONLY place a sending onboarding the committed binding remembers as refused
-* (Workers Free) is retried — on its own prompt, after a Workers Paid upgrade; the deploy
-* reads that row as settled and never retries it.
-*
-* `status` is the preflight alone, printed, exit 1 when not ready.
-*/
-async function runEmailCloudflareCommand(root, args, deps = {}) {
-	const exit = deps.exit ?? ((code) => process.exit(code));
-	const print = deps.print ?? ((block) => log.message(block));
-	const fail = (message) => {
-		log.error(message);
-		return exit(1);
-	};
-	const from = readConfig(root).email?.from;
-	if (!from) return fail("email: no sender configured. Add \"email\": { \"from\": \"you@mail.acme.com\" } to void.json — its host is the domain email is set up on.");
-	const paths = readProjectPaths(root);
-	const handlers = scanEmailHandlersSync(paths.sourceRoot);
-	const configPath = discoverRootWranglerConfig(root);
-	const rootConfig = parseRootWranglerConfig(configPath);
-	await loadProvisionModule();
-	let apiBaseUrl;
-	try {
-		apiBaseUrl = resolveDeployTransport(root, rootConfig);
-	} catch (err) {
-		return fail(`email: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	const accountId = readWranglerTopLevelString(rootConfig, "account_id") ?? (process.env.CLOUDFLARE_ACCOUNT_ID?.trim() || void 0);
-	if (!accountId) return fail([
-		"email: no Cloudflare account is pinned.",
-		"Set `account_id` in your root wrangler.jsonc, or export CLOUDFLARE_ACCOUNT_ID —",
-		"the same pin `void deploy --platform cloudflare` needs."
-	].join("\n"));
-	const workerName = readWranglerTopLevelString(rootConfig, "name") ?? deriveWorkerName(root);
-	const runWrangler = deps.runWrangler ?? createDeployWranglerRunner(root, accountId, apiBaseUrl);
-	const getSessionBearer = deps.getSessionBearer ?? (() => runWranglerAuthToken(runWrangler, configPath));
-	const sendEmail = rootConfig.send_email;
-	const inputs = {
-		handlers,
-		from,
-		workerName,
-		accountId,
-		existingSendEmail: Array.isArray(sendEmail) ? sendEmail : null,
-		existingAddresses: rootConfig.addresses,
-		existingVars: rootConfig.vars && typeof rootConfig.vars === "object" && !Array.isArray(rootConfig.vars) ? rootConfig.vars : null,
-		configConflicts: findEmailConfigConflicts(rootConfig),
-		wranglerArgs: [
-			"-c",
-			configPath,
-			"--env="
-		],
-		apiBaseUrl,
-		runWrangler,
-		getSessionBearer,
-		fetchImpl: deps.fetchImpl ?? fetch,
-		dns: deps.dns ?? await createNodeEmailDns()
-	};
-	let pre;
-	try {
-		pre = await preflightEmail(inputs);
-	} catch (err) {
-		return fail(`email: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	print(renderEmailChecklist(pre));
-	if (args.subcommand === "status") {
-		print(renderAddressMap({
-			from,
-			routes: pre.derived.routes,
-			addresses: pre.rules.mine,
-			sendingReady: pre.sending.state === "ready",
-			pendingLabel: "(no rule yet)"
-		}));
-		if (pre.ready) {
-			log.success(`Email is set up on ${pre.domain}.`);
-			return;
-		}
-		log.warn(`Email is not set up on ${pre.domain} yet — run \`void email setup --platform cloudflare\`.`);
-		return exit(1);
-	}
-	if (pre.blockers.some((b) => b.scope === "all")) return fail("email: nothing was changed — fix the ✘ rows above and rerun.");
-	if (!pre.ready || pre.sendingRetryable) {
-		if (!(deps.isInteractive ?? !isWranglerNonInteractiveOrCI())) return fail("email: `void email setup` changes your Cloudflare account, so it needs an interactive terminal. Run it locally once, commit wrangler.jsonc, then redeploy.");
-		if (!await (deps.confirm ?? (async (message) => {
-			const answer = await confirm({
-				message,
-				initialValue: true
-			});
-			return !isCancel(answer) && answer === true;
-		}))(pre.ready ? `Onboard ${pre.domain} for Email Sending? Inbound already works; onboarding needs Workers Paid.` : `Set up email on ${pre.domain}?`)) {
-			log.info("Nothing changed.");
-			return;
-		}
-	}
-	const out = await applyEmailSetup(pre, inputs);
-	if (out.lines.length > 0) print(out.lines.join("\n"));
-	try {
-		writeProvisionedWranglerConfig(root, out.patch, { configPath });
-	} catch (err) {
-		return fail(`email: could not update ${configPath} — ${err instanceof Error ? err.message : String(err)}`);
-	}
-	print(renderAddressMap({
-		from,
-		routes: pre.derived.routes,
-		addresses: out.patch.addresses ?? [],
-		sendingReady: out.sendingReady,
-		pendingLabel: "(no rule yet)"
-	}));
-	if (!out.inboundReady) {
-		const missing = !out.routingReady ? `Email Routing on ${pre.domain} is not ready` : !out.subaddressingReady ? `subaddressing on ${pre.apex} is still off (support+anything@ would not reach support@)` : "`addresses` was withheld";
-		log.warn(`Email is not set up on ${pre.domain} yet — ${missing}; no routing rule is created until it is. Finish the step above, then rerun \`void email setup --platform cloudflare\`.`);
-		return exit(1);
-	}
-	if ((out.patch.addresses ?? []).length > 0) log.info("Routing rules are created by the next `void deploy --platform cloudflare`, which applies the Email Routing plan from `addresses`.");
-	log.success(`Email set up on ${pre.domain}.`);
-}
-//#endregion
-export { runEmailCommand };