wawesome 0.0.12 → 0.0.13

package/README.md

@@ -213,7 +213,7 @@ Three headers arrive or leave on it, and the stripping is what makes them worth
 | --- | --- | --- |
 | `x-wawesome-forwarded-prefix` | inbound | The mount that was stripped from the path. Join it to the path you observe to rebuild the caller's URL. |
 | `x-wawesome-invocation-id` | outbound | The id of this run — the key to fetch its logs with `npx wawesome logs --invocation <id>`. |
-| `x-wawesome-error` | outbound | Present only when the platform failed, never when your Function did. Its *absence* means the status on the wire is yours. |
+| `x-wawesome-error` | outbound | Present only when the platform failed, never when your Function did. Its *absence* means the status on the wire is yours — up to the moment your response is committed, and no further. |
 
 ### Local Development / Gateway Overrides
 

package/dist/index.mjs

@@ -166,7 +166,7 @@ async function buildJs(entryInput, 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.0.12";
+const CLI_VERSION = "0.0.13";
 //#endregion
 //#region src/prompt.ts
 /**
@@ -549,6 +549,148 @@ async function whoami() {
 	console.log(`  Gateway:   ${creds.gateway_url}\n`);
 }
 //#endregion
+//#region src/usage.ts
+const USAGE_TIMEOUT_MS = 2e3;
+/**
+* Bounded by its own timeout: every caller treats this as an aside to something
+* that already succeeded, so a management API that hangs must not be able to
+* hold that something open.
+*/
+async function fetchTenantUsage(creds, timeoutMs = USAGE_TIMEOUT_MS) {
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const res = await fetch(`${creds.gateway_url}/v1/tenant/usage`, {
+			headers: { Authorization: `Bearer ${creds.tenant_jwt}` },
+			signal: controller.signal
+		});
+		if (!res.ok) throw await asGatewayError(res, `Failed to read usage (HTTP ${res.status}).`);
+		return asTenantUsage(await res.json());
+	} finally {
+		clearTimeout(timer);
+	}
+}
+/**
+* A payload that is missing any of this is one the plan could not be resolved
+* for, and is refused here rather than rendered as half a block.
+*/
+function asTenantUsage(value) {
+	const usage = value;
+	if (!(!!usage && typeof usage.plan?.name === "string" && typeof usage.plan?.limits?.app_slots === "number" && typeof usage.occupied_app_slots === "number" && !!usage.allowances && typeof usage.allowances === "object" && isInstant(usage.period?.start) && isInstant(usage.period?.end))) throw new Error("Usage payload does not carry a resolved plan.");
+	return usage;
+}
+function isInstant(value) {
+	return typeof value === "string" && !isNaN(new Date(value).getTime());
+}
+//#endregion
+//#region src/headroom.ts
+const KNOWN_LABELS = {
+	invocations: "Invocations",
+	caller_facing_bytes: "Caller-facing bytes"
+};
+const COUNT_UNITS = [
+	{
+		threshold: 1e9,
+		suffix: "B"
+	},
+	{
+		threshold: 1e6,
+		suffix: "M"
+	},
+	{
+		threshold: 1e3,
+		suffix: "k"
+	}
+];
+const BYTE_UNITS = [
+	"B",
+	"KiB",
+	"MiB",
+	"GiB",
+	"TiB"
+];
+const MONTHS = [
+	"January",
+	"February",
+	"March",
+	"April",
+	"May",
+	"June",
+	"July",
+	"August",
+	"September",
+	"October",
+	"November",
+	"December"
+];
+/** Indented to sit inside the receipt the deploy already prints. */
+function headroomLines(usage) {
+	const lines = [
+		`  Plan:     ${usage.plan.name} — this deploy does not change your bill.`,
+		`  Apps:     ${usage.occupied_app_slots} / ${usage.plan.limits.app_slots} slots`,
+		`  Usage:    ${periodLabel(usage.period.start, usage.period.end)}`
+	];
+	const entries = Object.entries(usage.allowances);
+	const labelWidth = widest(entries.map(([key]) => allowanceLabel(key)));
+	const amountWidth = widest(entries.map(([key, allowance]) => amount(key, allowance.used, allowance.limit)));
+	for (const [key, allowance] of entries) {
+		const percent = allowance.consumed_percent === null ? "" : `  (${allowance.consumed_percent}%)`;
+		const line = `            ${allowanceLabel(key).padEnd(labelWidth)}  ${amount(key, allowance.used, allowance.limit).padEnd(amountWidth)}${percent}`;
+		lines.push(line.trimEnd());
+	}
+	return lines;
+}
+function allowanceLabel(key) {
+	if (KNOWN_LABELS[key]) return KNOWN_LABELS[key];
+	const words = key.replace(/[_-]+/g, " ").trim();
+	return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function formatCount(value) {
+	for (let i = 0; i < COUNT_UNITS.length; i++) {
+		const { threshold, suffix } = COUNT_UNITS[i];
+		if (value < threshold) continue;
+		const scaled = round(value / threshold, 1);
+		if (scaled >= 1e3 && i > 0) {
+			const bigger = COUNT_UNITS[i - 1];
+			return `${round(value / bigger.threshold, 1)}${bigger.suffix}`;
+		}
+		return `${scaled}${suffix}`;
+	}
+	return String(Math.round(value));
+}
+function formatBytes(value) {
+	let scaled = value;
+	let unit = 0;
+	while (scaled >= 1024 && unit < BYTE_UNITS.length - 1) {
+		scaled /= 1024;
+		unit++;
+	}
+	return `${unit === 0 ? Math.round(scaled) : round(scaled, 2)} ${BYTE_UNITS[unit]}`;
+}
+/**
+* Name the period rather than print its bounds. The end is exclusive, so a
+* partial period names the last day inside it and not the instant after it.
+*/
+function periodLabel(start, end) {
+	const from = new Date(start);
+	const to = new Date(end);
+	if (from.getTime() === Date.UTC(from.getUTCFullYear(), from.getUTCMonth(), 1) && to.getTime() === Date.UTC(from.getUTCFullYear(), from.getUTCMonth() + 1, 1)) return `${MONTHS[from.getUTCMonth()]} ${from.getUTCFullYear()} (UTC)`;
+	return `${dayLabel(from)} – ${dayLabel(/* @__PURE__ */ new Date(to.getTime() - 1))} (UTC)`;
+}
+function dayLabel(date) {
+	return `${date.getUTCDate()} ${MONTHS[date.getUTCMonth()].slice(0, 3)} ${date.getUTCFullYear()}`;
+}
+function amount(key, used, limit) {
+	const format = key.includes("bytes") ? formatBytes : formatCount;
+	return `${format(used)} / ${format(limit)}`;
+}
+function round(value, places) {
+	return Number(value.toFixed(places));
+}
+function widest(values) {
+	return values.reduce((longest, value) => Math.max(longest, value.length), 0);
+}
+//#endregion
 //#region ../shared/public-address.ts
 const INVOCATION_PREFIX = "/x";
 const SUBTREE_NOTE = "Every path beneath this address reaches the Function.";
@@ -668,6 +810,12 @@ async function deploy(entryInput, options) {
 	} catch (err) {
 		if (isVerbose) console.log(`[wawesome:verbose] Could not resolve the workspace address: ${err instanceof Error ? err.message : err}`);
 	}
+	let headroom = null;
+	try {
+		headroom = headroomLines(await fetchTenantUsage(creds));
+	} catch (err) {
+		if (isVerbose) console.log(`[wawesome:verbose] Could not read the plan's usage: ${errorText(err)}`);
+	}
 	console.log("\n======================================================");
 	console.log("🚀 \x1B[32mDEPLOYED SUCCESSFULLY!\x1B[0m");
 	console.log("======================================================");
@@ -678,6 +826,10 @@ async function deploy(entryInput, options) {
 		console.log(`\n  URL:      \x1b[36m${address}\x1b[0m`);
 		console.log(`            ${SUBTREE_NOTE}`);
 	}
+	if (headroom) {
+		console.log("");
+		for (const line of headroom) console.log(line);
+	}
 	console.log("======================================================\n");
 	return {
 		app,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wawesome",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "CLI tool for building and deploying serverless functions on wawesome.io platform",
   "type": "module",
   "bin": {