wawesome 0.18.0 → 0.19.0

package/dist/{guest-parity-Df4rlLDW.mjs → guest-parity-B5GLO6LA.mjs}

@@ -1,4 +1,4 @@
-import { a as unsupportedGlobals, i as shimmedGlobals, n as methodRemedy, r as polyfilledGlobals, t as declaredMethods } from "./guest-surface-CXON0L5V.mjs";
+import { a as unsupportedGlobals, i as shimmedGlobals, n as methodRemedy, r as polyfilledGlobals, t as declaredMethods } from "./guest-surface-4bHyTMIy.mjs";
 //#region ../../server/guest-surface/message-channel.js
 const ENTANGLED = Symbol("entangled");
 const QUEUE = Symbol("queue");

package/dist/guest-parity.mjs

@@ -1,2 +1,2 @@
-import { t as applyGuestParity } from "./guest-parity-Df4rlLDW.mjs";
+import { t as applyGuestParity } from "./guest-parity-B5GLO6LA.mjs";
 export { applyGuestParity };

package/dist/{guest-surface-CXON0L5V.mjs → guest-surface-4bHyTMIy.mjs}

@@ -27,6 +27,17 @@ var globals = [
 			"intl-locales-supported",
 			"intl-segmenter-polyfill"
 		]
+	},
+	{
+		"name": "URLPattern",
+		"status": "unsupported",
+		"remedy": "bundle a URLPattern polyfill, for example urlpattern-polyfill",
+		"providedBy": ["urlpattern-polyfill"]
+	},
+	{
+		"name": "WebSocket",
+		"status": "unsupported",
+		"remedy": "the sandbox has no sockets, so nothing can supply this one; open the connection from the browser instead, or reach a realtime service over HTTPS"
 	}
 ];
 var methods = [

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as unsupportedGlobals, n as methodRemedy, r as polyfilledGlobals, t as declaredMethods } from "./guest-surface-CXON0L5V.mjs";
+import { a as unsupportedGlobals, n as methodRemedy, r as polyfilledGlobals, t as declaredMethods } from "./guest-surface-4bHyTMIy.mjs";
 import cac from "cac";
 import fs from "node:fs";
 import path from "node:path";
@@ -905,7 +905,7 @@ async function buildHandler(entryInput, config, options) {
 * that has to name this version — `--version`, the dependency a scaffolded
 * project pins — reads it here, so a release bumps one file.
 */
-const CLI_VERSION = "0.18.0";
+const CLI_VERSION = "0.19.0";
 //#endregion
 //#region src/prompt.ts
 /**
@@ -962,6 +962,144 @@ function isInteractive() {
 	return Boolean(process.stdin.isTTY);
 }
 //#endregion
+//#region ../shared/public-address.ts
+const INVOCATION_PREFIX = "/x";
+const SLUG_SEPARATOR = "--";
+const SURFACE_ROUTE = "/v1/invocation-surface";
+const SUBTREE_NOTE = "Every path beneath this address reaches the Function.";
+const ROOT_FUNCTION_SLUG = "root";
+/**
+* A gateway that serves no form of the address — and the value a client uses for
+* one that did not answer at all, deliberately the same: both name no address,
+* and there is nothing else either could honestly do.
+*/
+const NO_INVOCATION_SURFACE = {
+	contentOrigin: null,
+	pathFormOrigin: null
+};
+async function fetchInvocationSurface(gatewayUrl) {
+	const origin = trimTrailingSlashes(gatewayUrl);
+	const res = await fetch(`${origin}${SURFACE_ROUTE}`);
+	if (!res.ok) throw new Error(`Failed to read the gateway's address forms (HTTP ${res.status}).`);
+	const body = await res.json();
+	return {
+		contentOrigin: body.content_origin ?? null,
+		pathFormOrigin: body.path_form ? origin : null
+	};
+}
+/** The one address the Function answers at, `null` where it has none. */
+function publicAddress(surface, tenantSlug, appSlug, functionSlug) {
+	const base = appBase(surface, tenantSlug, appSlug);
+	if (base === null) return null;
+	if (functionSlug === "root") return base;
+	return `${base}/${encodeURIComponent(functionSlug)}`;
+}
+/**
+* Where one of a Function's static files answers, `null` where none of them do.
+*
+* A **Static asset** is served on the App's own hostname and on no other
+* address, so a gateway serving only the path form has no address to give for
+* one — see **Static route** in `CONTEXT.md`.
+*/
+function assetAddress(surface, tenantSlug, appSlug, functionSlug, assetPath) {
+	if (!surface.contentOrigin) return null;
+	const mount = publicAddress(surface, tenantSlug, appSlug, functionSlug);
+	if (mount === null) return null;
+	return `${mount}/${assetPath.split("/").map(encodeURIComponent).join("/")}`;
+}
+/** The same address with the app and function still to be chosen. */
+function publicAddressTemplate(surface, tenantSlug) {
+	if (surface.contentOrigin) {
+		if (!isLegalDnsLabel(tenantSlug)) return null;
+		const hostname = appHostname(surface.contentOrigin, `${tenantSlug}${SLUG_SEPARATOR}<app>`);
+		return hostname === null ? null : `${hostname}/<function>`;
+	}
+	if (surface.pathFormOrigin) return `${pathFormBase(surface.pathFormOrigin, tenantSlug)}/<app>/<function>`;
+	return null;
+}
+function appBase(surface, tenantSlug, appSlug) {
+	if (surface.contentOrigin) {
+		if (!isLegalDnsLabel(tenantSlug) || !isLegalDnsLabel(appSlug)) return null;
+		return appHostname(surface.contentOrigin, `${tenantSlug}${SLUG_SEPARATOR}${appSlug}`);
+	}
+	if (surface.pathFormOrigin) return `${pathFormBase(surface.pathFormOrigin, tenantSlug)}/${encodeURIComponent(appSlug)}`;
+	return null;
+}
+/**
+* The App's own hostname, built the way the gateway rebuilds it from its own
+* configuration: the label one level beneath the content domain. Callers check
+* the slugs the label is made of, since a slug the gateway would refuse to read
+* a `Host` for names no App there.
+*/
+function appHostname(contentOrigin, label) {
+	let origin;
+	try {
+		origin = new URL(contentOrigin);
+	} catch {
+		return null;
+	}
+	return `${origin.protocol}//${label}.${origin.host}`;
+}
+/** The surface, or none where the gateway did not answer. */
+async function invocationSurfaceOrNone(gatewayUrl) {
+	try {
+		return await fetchInvocationSurface(gatewayUrl);
+	} catch {
+		return NO_INVOCATION_SURFACE;
+	}
+}
+function pathFormBase(origin, tenantSlug) {
+	return `${trimTrailingSlashes(origin)}${INVOCATION_PREFIX}/${encodeURIComponent(tenantSlug)}`;
+}
+/**
+* The legal DNS label closest to what somebody typed, empty where nothing legal
+* survives. What a workspace name suggests as an address, and what the CLI
+* offers as a default — never applied to a typed address, which is refused
+* rather than rewritten into a name nobody chose.
+*/
+function slugifyLabel(raw) {
+	let label = "";
+	for (const c of raw.trim().toLowerCase()) if (c >= "a" && c <= "z" || c >= "0" && c <= "9") label += c;
+	else if (label.length > 0 && !label.endsWith("-")) label += "-";
+	label = label.slice(0, 63);
+	while (label.endsWith("-")) label = label.slice(0, -1);
+	return label;
+}
+/** Must match `dns_label::is_legal` in `server/crates/core/src/value_objects.rs`. */
+function isLegalDnsLabel(candidate) {
+	return candidate.length > 0 && candidate.length <= 63 && !candidate.startsWith("-") && !candidate.endsWith("-") && !candidate.includes("--") && /^[a-z0-9-]+$/.test(candidate);
+}
+function trimTrailingSlashes(origin) {
+	return origin.replace(/\/+$/, "");
+}
+//#endregion
+//#region src/slug.ts
+/**
+* The character rules every slug on the platform obeys, mirrored from the
+* `dns_label` module in `server/crates/core/src/value_objects.rs`.
+*
+* A typed name is checked while the user is still standing there, rather than
+* accepted, sent, and rewritten by the gateway into something else that ends up
+* in a client's dashboard. The rules live beside the address they build, so the
+* CLI and the dashboard cannot come to disagree about what a legal name is.
+*/
+/** Maximum length of a single DNS label (RFC 1035 §2.3.4). */
+const MAX_SLUG_LENGTH = 63;
+/**
+* Normalise arbitrary input into a legal DNS label, returning an empty string
+* when nothing legal survives — callers decide whether that is an error.
+*/
+function sanitizeSlug(raw) {
+	return slugifyLabel(raw);
+}
+/**
+* Whether `candidate` is already a legal DNS label — i.e. whether
+* {@link sanitizeSlug} would leave it untouched.
+*/
+function isLegalSlug(candidate) {
+	return candidate.length > 0 && candidate.length <= MAX_SLUG_LENGTH && !candidate.startsWith("-") && !candidate.endsWith("-") && !candidate.includes("--") && /^[a-z0-9-]+$/.test(candidate);
+}
+//#endregion
 //#region src/session.ts
 /**
 * A gateway request, retried once against a renewed session if it comes back 401.
@@ -1170,24 +1308,36 @@ async function renameTenantSlug(creds, slug) {
 //#endregion
 //#region src/auth.ts
 /**
-* Ask what to call the workspace being created.
+* Ask what to call the workspace being created, and what it should answer at.
 *
-* There is no default worth offering: a name nobody typed is exactly what this
-* replaced. A non-interactive login has nobody to ask, so it says what flag to
-* pass rather than inventing one and minting a workspace under it.
-*/
-async function promptForWorkspaceName(options) {
+* There is no default name worth offering: a name nobody typed is exactly what
+* this replaced. The address has one — the name, slugified — because it is a
+* DNS label and typing it a second time is work the name already did. A
+* non-interactive login has nobody to ask, so it says what flag to pass rather
+* than inventing a name and minting a workspace under it; an address it is not
+* given is still minted, which is what a pipeline that says nothing gets.
+*/
+async function promptForWorkspace(options) {
 	const supplied = options.workspace?.trim();
-	if (supplied) return supplied;
+	if (supplied) return {
+		name: supplied,
+		address: options.address?.trim() || ""
+	};
 	if (!isInteractive()) throw new Error("No workspace found, and no name to create one with. Re-run with --workspace <name>.");
 	console.log("\n[wawesome] You don't have a workspace yet. Let's create one.");
-	console.log("  (this is the name you'll see in the dashboard; its public address is set separately)");
+	console.log("  (the name is what you'll see in the dashboard; the address is the first half of every URL you deploy)");
 	const session = openPromptSession();
 	try {
 		for (let attempt = 0; attempt < 3; attempt++) {
-			const answer = await session.ask("  Workspace name?", "");
-			if (answer.trim()) return answer.trim();
-			console.log("[wawesome] A workspace needs a name.");
+			const name = (await session.ask("  Workspace name?", "")).trim();
+			if (!name) {
+				console.log("[wawesome] A workspace needs a name.");
+				continue;
+			}
+			return {
+				name,
+				address: (await session.ask("  Public address?", options.address?.trim() || sanitizeSlug(name))).trim()
+			};
 		}
 	} finally {
 		session.close();
@@ -1235,9 +1385,9 @@ async function completeLogin({ gatewayUrl, dashboardUrl, accessToken, refreshTok
 	let workspaceName;
 	let workspaceSlug;
 	if (tenants.length === 0) {
-		const chosenName = await promptForWorkspaceName(options);
+		const chosen = await promptForWorkspace(options);
 		await confirmTermsAccepted(options);
-		console.log(`[wawesome] Creating workspace "${chosenName}"...`);
+		console.log(`[wawesome] Creating workspace "${chosen.name}"...`);
 		const initRes = await fetch(`${gatewayUrl}/api/v1/onboarding/init`, {
 			method: "POST",
 			headers: {
@@ -1245,7 +1395,8 @@ async function completeLogin({ gatewayUrl, dashboardUrl, accessToken, refreshTok
 				"Content-Type": "application/json"
 			},
 			body: JSON.stringify({
-				tenant_name: chosenName,
+				tenant_name: chosen.name,
+				tenant_slug: chosen.address || void 0,
 				accepted_terms: true
 			})
 		});
@@ -1253,7 +1404,7 @@ async function completeLogin({ gatewayUrl, dashboardUrl, accessToken, refreshTok
 		const initData = await initRes.json();
 		primaryTenantId = initData.tenant_id;
 		workspaceSlug = initData.tenant_slug;
-		workspaceName = initData.tenant_name || chosenName;
+		workspaceName = initData.tenant_name || chosen.name;
 	} else primaryTenantId = tenants[0].tenant_id;
 	if (isVerbose) console.log(`[wawesome:verbose] Using tenant: ${primaryTenantId}`);
 	console.log("[wawesome] Exchanging for tenant-scoped credentials...");
@@ -1544,6 +1695,17 @@ function wrapped(said) {
 function indented(said) {
 	return wrapped(said).map((line) => `${VALUE_COLUMN}${line}`);
 }
+/**
+* What fits in `room` characters, with an ellipsis where it does not. Cut
+* rather than wrapped: a row that took two lines would push the row above it
+* out of sight. A room too small for even that shows nothing, so nothing ever
+* runs past the width it was given.
+*/
+function truncate(said, room) {
+	if (said.length <= room) return said;
+	if (room <= 1) return "";
+	return `${said.slice(0, room - 1)}…`;
+}
 //#endregion
 //#region src/domains.ts
 /**
@@ -1883,6 +2045,7 @@ function domainsUrl(creds, app) {
 function whereItGotTo(domain) {
 	const { state } = domain;
 	if (state.serving) return "serving";
+	if (domain.proxied_in_public_dns) return "the CNAME is in at Cloudflare with the proxy on, so set that record to DNS only";
 	if (state.certificate_active) return "certificate issued, so point the CNAME here to cut over";
 	if (state.ownership_verified) return domain.certificate_record_pending ? "name verified, and the certificate record is not ready" : "name verified, so add the certificate CNAME below";
 	if (domain.ownership_record_pending) return "not verified yet, and the TXT record is not ready";
@@ -2280,103 +2443,6 @@ function manifestOf(assets) {
 	}));
 }
 //#endregion
-//#region ../shared/public-address.ts
-const INVOCATION_PREFIX = "/x";
-const SLUG_SEPARATOR = "--";
-const SURFACE_ROUTE = "/v1/invocation-surface";
-const SUBTREE_NOTE = "Every path beneath this address reaches the Function.";
-const ROOT_FUNCTION_SLUG = "root";
-/**
-* A gateway that serves no form of the address — and the value a client uses for
-* one that did not answer at all, deliberately the same: both name no address,
-* and there is nothing else either could honestly do.
-*/
-const NO_INVOCATION_SURFACE = {
-	contentOrigin: null,
-	pathFormOrigin: null
-};
-async function fetchInvocationSurface(gatewayUrl) {
-	const origin = trimTrailingSlashes(gatewayUrl);
-	const res = await fetch(`${origin}${SURFACE_ROUTE}`);
-	if (!res.ok) throw new Error(`Failed to read the gateway's address forms (HTTP ${res.status}).`);
-	const body = await res.json();
-	return {
-		contentOrigin: body.content_origin ?? null,
-		pathFormOrigin: body.path_form ? origin : null
-	};
-}
-/** The one address the Function answers at, `null` where it has none. */
-function publicAddress(surface, tenantSlug, appSlug, functionSlug) {
-	const base = appBase(surface, tenantSlug, appSlug);
-	if (base === null) return null;
-	if (functionSlug === "root") return base;
-	return `${base}/${encodeURIComponent(functionSlug)}`;
-}
-/**
-* Where one of a Function's static files answers, `null` where none of them do.
-*
-* A **Static asset** is served on the App's own hostname and on no other
-* address, so a gateway serving only the path form has no address to give for
-* one — see **Static route** in `CONTEXT.md`.
-*/
-function assetAddress(surface, tenantSlug, appSlug, functionSlug, assetPath) {
-	if (!surface.contentOrigin) return null;
-	const mount = publicAddress(surface, tenantSlug, appSlug, functionSlug);
-	if (mount === null) return null;
-	return `${mount}/${assetPath.split("/").map(encodeURIComponent).join("/")}`;
-}
-/** The same address with the app and function still to be chosen. */
-function publicAddressTemplate(surface, tenantSlug) {
-	if (surface.contentOrigin) {
-		if (!isLegalDnsLabel(tenantSlug)) return null;
-		const hostname = appHostname(surface.contentOrigin, `${tenantSlug}${SLUG_SEPARATOR}<app>`);
-		return hostname === null ? null : `${hostname}/<function>`;
-	}
-	if (surface.pathFormOrigin) return `${pathFormBase(surface.pathFormOrigin, tenantSlug)}/<app>/<function>`;
-	return null;
-}
-function appBase(surface, tenantSlug, appSlug) {
-	if (surface.contentOrigin) {
-		if (!isLegalDnsLabel(tenantSlug) || !isLegalDnsLabel(appSlug)) return null;
-		return appHostname(surface.contentOrigin, `${tenantSlug}${SLUG_SEPARATOR}${appSlug}`);
-	}
-	if (surface.pathFormOrigin) return `${pathFormBase(surface.pathFormOrigin, tenantSlug)}/${encodeURIComponent(appSlug)}`;
-	return null;
-}
-/**
-* The App's own hostname, built the way the gateway rebuilds it from its own
-* configuration: the label one level beneath the content domain. Callers check
-* the slugs the label is made of, since a slug the gateway would refuse to read
-* a `Host` for names no App there.
-*/
-function appHostname(contentOrigin, label) {
-	let origin;
-	try {
-		origin = new URL(contentOrigin);
-	} catch {
-		return null;
-	}
-	return `${origin.protocol}//${label}.${origin.host}`;
-}
-/** The surface, or none where the gateway did not answer. */
-async function invocationSurfaceOrNone(gatewayUrl) {
-	try {
-		return await fetchInvocationSurface(gatewayUrl);
-	} catch {
-		return NO_INVOCATION_SURFACE;
-	}
-}
-function pathFormBase(origin, tenantSlug) {
-	return `${trimTrailingSlashes(origin)}${INVOCATION_PREFIX}/${encodeURIComponent(tenantSlug)}`;
-}
-/** Must match `dns_label::is_legal` in `server/crates/core/src/value_objects.rs`. */
-function isLegalDnsLabel(candidate) {
-	return candidate.length > 0 && candidate.length <= 63 && !candidate.startsWith("-") && !candidate.endsWith("-") && !candidate.includes("--") && /^[a-z0-9-]+$/.test(candidate);
-}
-function trimTrailingSlashes(origin) {
-	return origin.replace(/\/+$/, "");
-}
-//#endregion
 //#region src/deploy-target.ts
 const RECORD_PATH = path.join(".wawesome", "last-deploy.json");
 function readLastDeployTarget(projectDir = process.cwd()) {
@@ -2909,7 +2975,8 @@ async function cronCommand(action, target, subtarget, options = {}) {
 * The address a **Document** answers at, relative to its Function's mount: a
 * request path whose last segment carries no extension resolves to that path,
 * to it with `.html` appended and to it with `/index.html` appended, so both
-* `about.html` and `about/index.html` are the address `about`.
+* `about.html` and `about/index.html` are the address `about`. A last segment
+* spelled `index` skips the middle one, which is what this strips first.
 */
 function documentAddressPath(assetPath) {
 	return assetPath.replace(/(^|\/)index\.html$/, "").replace(/\.html$/, "");
@@ -3036,6 +3103,17 @@ function declaredFields(declared) {
 	};
 }
 /**
+* What this deploy says it carries.
+*
+* Trimmed here so that a flag whose value came out of a shell variable nobody
+* set is a deploy that said nothing rather than one the gateway turns down. How
+* long a message may be and whether it is one line are the platform's rule, and
+* holding them here as well is two places for them to drift.
+*/
+function declaredMessage(stated) {
+	return typeof stated === "string" ? stated.trim() || void 0 : void 0;
+}
+/**
 * The fallback this project declares.
 *
 * A declaration missing either half is refused here rather than at the gateway,
@@ -3106,7 +3184,8 @@ async function deploy(entryInput, options) {
 		visibility: declaredVisibility(config.visibility),
 		confirmPublish: Boolean(options.publish),
 		confirmAssetDrop: Boolean(options.dropAssets),
-		fallback: declaredFallback(config.fallback)
+		fallback: declaredFallback(config.fallback),
+		message: declaredMessage(options.message)
 	};
 	const domainName = declaredDomain(config.domain);
 	if (isVerbose) {
@@ -3165,7 +3244,10 @@ async function deploy(entryInput, options) {
 	console.log(`[wawesome] Uploading code for ${app}/${funcName}...`);
 	const uploadUrl = `${creds.gateway_url}/v1/apps/${encodeURIComponent(app)}/functions/${encodeURIComponent(funcName)}/code`;
 	if (isVerbose) console.log(`[wawesome:verbose] POST ${uploadUrl}`);
-	const declaredOnTheWire = declaredFields(declared);
+	const declaredOnTheWire = {
+		...declaredFields(declared),
+		...declared.message ? { message: declared.message } : {}
+	};
 	const uploadRes = assets.length > 0 || declaresSchedules || declaresFallback || Object.keys(declaredOnTheWire).length > 0 || jsCode === null ? await authorizedFetch(uploadUrl, {
 		method: "POST",
 		headers: {
@@ -3189,7 +3271,7 @@ async function deploy(entryInput, options) {
 	});
 	if (!uploadRes.ok) {
 		const errorBody = await uploadRes.text();
-		const refusal = rejectionOf(errorBody, uploadRes.status, "Version with this code bundle already exists.");
+		const refusal = rejectionOf(errorBody, uploadRes.status, uploadRes.status === 409 ? "Version with this code bundle already exists." : `Code upload failed (HTTP ${uploadRes.status}).`);
 		if (uploadRes.status === 401 || uploadRes.status === 403) console.error(`[wawesome] Error: ${unauthorizedMessage(uploadRes.status, errorBody)}`);
 		else if (refusal.reason === "paid-plan-required") {
 			console.error(`\n[wawesome] \x1b[31mError: ${refusal.message}\x1b[0m`);
@@ -3211,7 +3293,7 @@ async function deploy(entryInput, options) {
 				console.error("[wawesome] To switch active version, run: \x1B[36mwawesome version switch\x1B[0m\n");
 			}
 		} else {
-			console.error(`[wawesome] Error: Code upload failed (HTTP ${uploadRes.status}).`);
+			console.error(`\n[wawesome] \x1b[31mError: ${refusal.message}\x1b[0m\n`);
 			if (isVerbose) console.error(`[wawesome:verbose] Response: ${errorBody}`);
 		}
 		process.exit(1);
@@ -3482,11 +3564,6 @@ async function setEnvVar(key, value, options) {
 		console.log("");
 	} else console.log(`[wawesome] ✅ Set variable '${key}' on app '${app}'.`);
 }
-function truncate(str, maxLen) {
-	if (str.length <= maxLen) return str;
-	if (maxLen <= 3) return str.slice(0, maxLen);
-	return str.slice(0, maxLen - 1) + "…";
-}
 /**
 * List environment variables on the current app.
 */
@@ -3807,26 +3884,6 @@ function renderPostDeploy(postDeploy, address) {
 	if (!address) return postDeploy;
 	return postDeploy.split("{{url}}").join(address);
 }
-/**
-* Normalise arbitrary input into a legal DNS label, returning an empty string
-* when nothing legal survives — callers decide whether that is an error.
-*/
-function sanitizeSlug(raw) {
-	let label = "";
-	for (const c of raw.trim().toLowerCase()) if (c >= "a" && c <= "z") label += c;
-	else if (c >= "0" && c <= "9") label += c;
-	else if (label.length > 0 && !label.endsWith("-")) label += "-";
-	label = label.slice(0, 63);
-	while (label.endsWith("-")) label = label.slice(0, -1);
-	return label;
-}
-/**
-* Whether `candidate` is already a legal DNS label — i.e. whether
-* {@link sanitizeSlug} would leave it untouched.
-*/
-function isLegalSlug(candidate) {
-	return candidate.length > 0 && candidate.length <= 63 && !candidate.startsWith("-") && !candidate.endsWith("-") && !candidate.includes("--") && /^[a-z0-9-]+$/.test(candidate);
-}
 //#endregion
 //#region src/tarball.ts
 /**
@@ -4576,6 +4633,24 @@ export default {
 //#region src/version.ts
 /** How both surfaces name a version nobody can switch to. */
 const RECLAIMED = "⚠ [assets reclaimed]";
+/** Where the message sits, under the row rather than in a column of its own. */
+const MESSAGE_INDENT = " ".repeat(10);
+const ASSUMED_WIDTH = 80;
+function terminalWidth() {
+	const columns = process.stdout.columns;
+	return columns && columns > 40 ? columns : ASSUMED_WIDTH;
+}
+/**
+* The lines one version takes in the listing: its row, and the words its deploy
+* stated beneath it where it stated any.
+*/
+function versionLines(v, activeNumber, width) {
+	const isActive = v.version_number === activeNumber;
+	const row = `${`#${v.version_number}`.padEnd(7)} | ${v.cwasm_hash.slice(0, 8).padEnd(8)} | ${new Date(v.created_at).toISOString().replace("T", " ").slice(0, 19).padEnd(20)} | ${v.status.padEnd(9)} | ${isActive ? "\x1B[32m★ [active]\x1B[0m" : v.rollbackable === false ? `\x1b[33m${RECLAIMED}\x1b[0m` : ""}`;
+	const message = v.message?.trim();
+	if (!message) return [row];
+	return [row, `${MESSAGE_INDENT}\x1b[2m${truncate(message, width - MESSAGE_INDENT.length)}\x1b[0m`];
+}
 async function fetchVersions(gatewayUrl, tenantJwt, app, funcName, env, isVerbose) {
 	const url = `${gatewayUrl}/v1/apps/${encodeURIComponent(app)}/functions/${encodeURIComponent(funcName)}/versions?environment=${encodeURIComponent(env)}`;
 	if (isVerbose) console.log(`[wawesome:verbose] GET ${url}`);
@@ -4619,15 +4694,8 @@ async function listVersions(options) {
 	console.log(`\n📦 \x1b[1mVersions for '${app}/${funcName}' (environment: ${env})\x1b[0m\n`);
 	console.log("VERSION | HASH     | CREATED AT           | STATUS    | ACTIVE");
 	console.log("--------|----------|----------------------|-----------|-------");
-	for (const v of data.versions) {
-		const isActive = v.version_number === data.active_version_number;
-		const verStr = `#${v.version_number}`.padEnd(7);
-		const hashStr = v.cwasm_hash.slice(0, 8).padEnd(8);
-		const dateStr = new Date(v.created_at).toISOString().replace("T", " ").slice(0, 19).padEnd(20);
-		const statusStr = v.status.padEnd(9);
-		const badge = isActive ? "\x1B[32m★ [active]\x1B[0m" : v.rollbackable === false ? `\x1b[33m${RECLAIMED}\x1b[0m` : "";
-		console.log(`${verStr} | ${hashStr} | ${dateStr} | ${statusStr} | ${badge}`);
-	}
+	const width = terminalWidth();
+	for (const v of data.versions) for (const line of versionLines(v, data.active_version_number, width)) console.log(line);
 	console.log("");
 }
 /**
@@ -4675,8 +4743,11 @@ async function switchVersion(targetInput, options) {
 			const hashShort = v.cwasm_hash.slice(0, 8);
 			const dateStr = new Date(v.created_at).toISOString().replace("T", " ").slice(0, 19);
 			const badge = isActive ? " ★ [active]" : v.rollbackable === false ? ` ${RECLAIMED}` : "";
+			const said = v.message?.trim();
+			const row = `v${v.version_number} (${hashShort}) • ${dateStr}${badge}`;
+			const room = terminalWidth() - row.length - 3 - 2;
 			return {
-				name: `v${v.version_number} (${hashShort}) • ${dateStr}${badge}`,
+				name: said ? `${row} • ${truncate(said, room)}` : row,
 				value: v.version_number
 			};
 		});
@@ -4716,6 +4787,8 @@ async function switchVersion(targetInput, options) {
 	console.log(`  Function:    ${funcName}`);
 	console.log(`  Environment: ${env}`);
 	console.log(`  Active Ver:  v${selectedVersionNum}`);
+	const restored = data.versions.find((v) => v.version_number === selectedVersionNum)?.message?.trim();
+	if (restored) console.log(`  Message:     ${truncate(restored, terminalWidth() - 15)}`);
 	console.log(`======================================================\n`);
 }
 //#endregion
@@ -6039,7 +6112,7 @@ async function credentialsCommand(action, target, options) {
 //#region src/index.ts
 const cli = cac("wawesome");
 cli.command("build [entry]", "Bundle a serverless function to an optimized JS file").option("-o, --out <path>", "Output JS bundle path", { default: "dist/index.js" }).option("-v, --verbose", "Enable verbose debug output").action((entry, options) => buildJs(entry, options));
-cli.command("deploy [entry]", "Build, upload, and promote a serverless function").option("-o, --out <path>", "Output JS bundle path", { default: "dist/index.js" }).option("-v, --verbose", "Enable verbose debug output").option("--skip-build", "Skip the build step, deploy an already-built bundle").option("--publish", "Confirm putting a private function back on its public address").option("--drop-assets", "Confirm a deploy carrying no static files where the live version serves some").action((entry, options) => deploy(entry, options));
+cli.command("deploy [entry]", "Build, upload, and promote a serverless function").option("-o, --out <path>", "Output JS bundle path", { default: "dist/index.js" }).option("-v, --verbose", "Enable verbose debug output").option("--skip-build", "Skip the build step, deploy an already-built bundle").option("--publish", "Confirm putting a private function back on its public address").option("--drop-assets", "Confirm a deploy carrying no static files where the live version serves some").option("-m, --message <text>", "One line about what this deploy carries, kept on the version it makes").action((entry, options) => deploy(entry, options));
 cli.command("version [action] [target]", "Manage versions (e.g. 'version list', 'version switch [version]')").option("-e, --env <environment>", "Target environment (default: production)").option("-v, --verbose", "Enable verbose debug output").action((action, target, options) => {
 	if (!action || action === "list" || action === "ls") return listVersions(options);
 	if (action === "switch" || action === "use" || action === "select") return switchVersion(target, options);
@@ -6054,7 +6127,7 @@ cli.command("env rm <key>", "Delete an environment variable from the current app
 cli.command("domains [action] [hostname]", "Show the custom domain on the current app, its state and its DNS records").usage("domains [action] [hostname]\n\nWith no action, prints the app's domain, every half of it, where each got to, when the platform last checked, and the records to add.\n\nActions:\n  adopt               Write the attached domain into wawesome-function.json\n  detach <hostname>   Stop serving the app at a domain you attached\n\nA domain is attached by declaring it in wawesome-function.json and deploying, from the dashboard, or by an agent.").example("wawesome domains").example("wawesome domains adopt").example("wawesome domains detach shop.client.com").option("-a, --app <slug>", "App to act on (default: the app in wawesome-function.json)").action((action, hostname, options) => domainsCommand(action, hostname, options));
 cli.command("domains adopt", "Write the domain the current app answers at into wawesome-function.json").option("-a, --app <slug>", "App to act on (default: the app in wawesome-function.json)").action((options) => adoptDomainCommand(void 0, options));
 cli.command("domains detach <hostname>", "Stop serving the current app at a domain you attached").option("-a, --app <slug>", "App to act on (default: the app in wawesome-function.json)").action((hostname, options) => detachDomainCommand(hostname, options));
-cli.command("login", "Authenticate with the wawesome.io platform").option("--api <url>", "API URL (default: https://api.wawesome.io)").option("--gateway <url>", "Alias for --api <url>").option("--dashboard <url>", "Dashboard URL (default: https://dashboard.wawesome.io)").option("--provider <name>", "OAuth provider (default: github)").option("--workspace <name>", "Name for the workspace, when signing up without a terminal to prompt").option("--accept-terms", "Accept the terms of service and privacy policy, when signing up without a terminal to prompt").option("-v, --verbose", "Enable verbose debug output").action((options) => login(options));
+cli.command("login", "Authenticate with the wawesome.io platform").option("--api <url>", "API URL (default: https://api.wawesome.io)").option("--gateway <url>", "Alias for --api <url>").option("--dashboard <url>", "Dashboard URL (default: https://dashboard.wawesome.io)").option("--provider <name>", "OAuth provider (default: github)").option("--workspace <name>", "Name for the workspace, when signing up without a terminal to prompt").option("--address <name>", "Public address for the workspace being created (default: one is minted)").option("--accept-terms", "Accept the terms of service and privacy policy, when signing up without a terminal to prompt").option("-v, --verbose", "Enable verbose debug output").action((options) => login(options));
 cli.command("logout", "Clear stored authentication credentials").action(() => logout());
 cli.command("whoami", "Show current login session info").action(() => whoami());
 cli.command("workspace [action] [name]", "Show the workspace, or rename its public address").usage("workspace <action> [name]\n\nActions:\n  show                Show the workspace name, address, and whether it can still change\n  rename <name>       Change the public address, while nothing live depends on it").example("wawesome workspace").example("wawesome workspace rename northwind").option("-v, --verbose", "Enable verbose debug output").action((action, name, options) => workspaceCommand(action, name, options));

package/dist/vite.mjs

@@ -1,4 +1,4 @@
-import { a as unsupportedGlobals, n as methodRemedy, r as polyfilledGlobals, t as declaredMethods } from "./guest-surface-CXON0L5V.mjs";
+import { a as unsupportedGlobals, n as methodRemedy, r as polyfilledGlobals, t as declaredMethods } from "./guest-surface-4bHyTMIy.mjs";
 import fs from "node:fs";
 import path from "node:path";
 //#region src/vite.ts

package/dist/vitest-setup.mjs

@@ -1,4 +1,4 @@
-import { t as applyGuestParity } from "./guest-parity-Df4rlLDW.mjs";
+import { t as applyGuestParity } from "./guest-parity-B5GLO6LA.mjs";
 //#region src/vitest-setup.ts
 applyGuestParity();
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wawesome",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "CLI tool for building and deploying serverless functions on wawesome.io platform",
   "type": "module",
   "bin": {
@@ -35,6 +35,9 @@
     "dist",
     "vite-env.d.ts"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",