wawesome 0.0.9 → 0.0.11

package/README.md

@@ -200,6 +200,21 @@ Every project directory includes a `wawesome-function.json` file generated durin
 `app` is the App this Function is deployed into, and it is client-facing — every deploy from this
 directory is scoped to it.
 
+### Reserved headers
+
+`x-wawesome-*` belongs to the platform in both directions. It is stripped off the request before your
+handler sees it, and off your response before the caller does — so **do not name a header of your own
+on that prefix**: it is dropped silently rather than rejected, and you will not get an error telling
+you why it vanished.
+
+Three headers arrive or leave on it, and the stripping is what makes them worth trusting:
+
+| Header | Direction | What it means |
+| --- | --- | --- |
+| `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. |
+
 ### Local Development / Gateway Overrides
 
 If you are running a local gateway or self-hosted instance, you can configure your CLI Gateway URL using any of the

package/dist/index.mjs

@@ -161,7 +161,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.9";
+const CLI_VERSION = "0.0.11";
 //#endregion
 //#region src/prompt.ts
 /**
@@ -335,10 +335,6 @@ async function renameTenantSlug(creds, slug) {
 	});
 	return result;
 }
-/** The address a deployed Function answers on, for a workspace and app. */
-function publicInvokeUrl(gatewayUrl, tenantSlug, appSlug, functionName) {
-	return `${gatewayUrl}/v1/s/${encodeURIComponent(tenantSlug)}/apps/${encodeURIComponent(appSlug)}/functions/${encodeURIComponent(functionName)}/invoke`;
-}
 //#endregion
 //#region src/auth.ts
 /**
@@ -548,6 +544,22 @@ async function whoami() {
 	console.log(`  Gateway:   ${creds.gateway_url}\n`);
 }
 //#endregion
+//#region ../shared/public-address.ts
+const INVOCATION_PREFIX = "/x";
+const SUBTREE_NOTE = "Every path beneath this address reaches the Function.";
+function mountBase(origin, tenantSlug) {
+	return `${origin.replace(/\/+$/, "")}${INVOCATION_PREFIX}/${encodeURIComponent(tenantSlug)}`;
+}
+function publicAddress(origin, tenantSlug, appSlug, functionSlug) {
+	const base = `${mountBase(origin, tenantSlug)}/${encodeURIComponent(appSlug)}`;
+	if (functionSlug === "root") return base;
+	return `${base}/${encodeURIComponent(functionSlug)}`;
+}
+/** The same address with the app and function still to be chosen. */
+function publicAddressTemplate(origin, tenantSlug) {
+	return `${mountBase(origin, tenantSlug)}/<app>/<function>`;
+}
+//#endregion
 //#region src/deploy.ts
 /**
 * Deploy a function: build → upload JS to gateway → promote.
@@ -644,10 +656,10 @@ async function deploy(entryInput, options) {
 		}
 		process.exit(1);
 	}
-	let invokeUrl = null;
+	let address = null;
 	try {
 		const { slug } = await resolveWorkspace(creds);
-		invokeUrl = publicInvokeUrl(creds.gateway_url, slug, app, funcName);
+		address = publicAddress(creds.gateway_url, slug, app, funcName);
 	} catch (err) {
 		if (isVerbose) console.log(`[wawesome:verbose] Could not resolve the workspace address: ${err instanceof Error ? err.message : err}`);
 	}
@@ -657,13 +669,16 @@ async function deploy(entryInput, options) {
 	console.log(`\n  App:      ${app}`);
 	console.log(`  Function: ${funcName}`);
 	if (version !== void 0) console.log(`  Version:  ${version}`);
-	if (invokeUrl) console.log(`\n  URL:      \x1b[36m${invokeUrl}\x1b[0m`);
+	if (address) {
+		console.log(`\n  URL:      \x1b[36m${address}\x1b[0m`);
+		console.log(`            ${SUBTREE_NOTE}`);
+	}
 	console.log("======================================================\n");
 	return {
 		app,
 		functionName: funcName,
 		version,
-		invokeUrl
+		address
 	};
 }
 //#endregion
@@ -1014,11 +1029,9 @@ function alignCliDependency(dir, version) {
 	const file = path.join(dir, PACKAGE_FILE);
 	const pkg = readJson(file);
 	const wanted = `^${version}`;
-	for (const field of ["dependencies", "devDependencies"]) {
+	for (const { field, range } of declaredCliRanges(pkg)) {
+		if (range === wanted) continue;
 		const deps = pkg[field];
-		if (!isRecord(deps)) continue;
-		const current = deps[CLI_PACKAGE];
-		if (typeof current !== "string" || current === wanted) continue;
 		writeJson(file, {
 			...pkg,
 			[field]: {
@@ -1027,12 +1040,22 @@ function alignCliDependency(dir, version) {
 			}
 		});
 		return {
-			from: current,
+			from: range,
 			to: wanted
 		};
 	}
 	return null;
 }
+/** Where a template declares the CLI, and at which range. */
+function declaredCliRanges(pkg) {
+	return ["dependencies", "devDependencies"].flatMap((field) => {
+		const deps = pkg[field];
+		return isRecord(deps) && typeof deps[CLI_PACKAGE] === "string" ? [{
+			field,
+			range: deps[CLI_PACKAGE]
+		}] : [];
+	});
+}
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1066,9 +1089,9 @@ function collidingPaths(dir, relativePaths) {
 * not be resolved the message still prints, with the placeholder left visible
 * rather than a confident "undefined".
 */
-function renderPostDeploy(postDeploy, invokeUrl) {
-	if (!invokeUrl) return postDeploy;
-	return postDeploy.split("{{url}}").join(invokeUrl);
+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
@@ -1509,7 +1532,8 @@ const MAX_RENAME_ATTEMPTS = 3;
 /** Show the address the Function will answer on, once it is deployed. */
 function announceUrl(creds, slug, appSlug, functionName) {
 	console.log("\n[wawesome] Your Function will answer on:\n");
-	console.log(`    \x1b[36m${publicInvokeUrl(creds.gateway_url, slug, appSlug, functionName)}\x1b[0m\n`);
+	console.log(`    \x1b[36m${publicAddress(creds.gateway_url, slug, appSlug, functionName)}\x1b[0m`);
+	console.log(`    ${SUBTREE_NOTE}\n`);
 }
 /**
 * Show the URL, and offer to fix the workspace address while it can still be fixed.
@@ -1697,7 +1721,7 @@ async function initFromTemplate(templateName, options) {
 		verbose: options.verbose
 	});
 	if (manifest.post_deploy) {
-		console.log(renderPostDeploy(manifest.post_deploy, result.invokeUrl));
+		console.log(renderPostDeploy(manifest.post_deploy, result.address));
 		console.log("");
 	}
 }
@@ -1714,7 +1738,10 @@ async function init(options) {
 	let functionName;
 	let appSlug;
 	try {
-		functionName = await promptForSlug(session, "Function name", dirName);
+		if (options.root) {
+			functionName = "root";
+			console.log("  Function name? root  (locked by --root)");
+		} else functionName = await promptForSlug(session, "Function name", dirName);
 		console.log("  (an App groups the Functions of one project — its slug is part of the public URL)");
 		appSlug = await promptForSlug(session, "App slug", dirName);
 	} finally {
@@ -1738,7 +1765,26 @@ async function init(options) {
 	if (fs.existsSync(indexPath)) console.log("[wawesome] src/index.ts already exists, skipping.");
 	else {
 		fs.mkdirSync(srcDir, { recursive: true });
-		fs.writeFileSync(indexPath, `/**
+		fs.writeFileSync(indexPath, options.root ? `/**
+ * Root Function Router
+ * Handles all requests that don't match a specific function path.
+ */
+export default {
+  async fetch(request: Request): Promise<Response> {
+    const url = new URL(request.url);
+    
+    // Example router
+    switch (url.pathname) {
+      case "/":
+        return Response.json({ message: "Welcome to the App Root!" });
+      case "/health":
+        return Response.json({ status: "ok" });
+      default:
+        return Response.json({ error: "Not Found" }, { status: 404 });
+    }
+  },
+};
+` : `/**
  * Serverless Function Handler
  * Standard HTTP fetch request handler
  */
@@ -2465,7 +2511,10 @@ async function showWorkspace(options) {
 	console.log(`  Name:     ${tenant.name}`);
 	console.log(`  Address:  ${tenant.tenant_slug}`);
 	console.log(`  Tenant:   ${tenant.id}`);
-	if (options.verbose) console.log(`  Invoke:   ${creds.gateway_url}/v1/s/${tenant.tenant_slug}/apps/<app>/functions/<function>/invoke`);
+	if (options.verbose) {
+		console.log(`  URLs:     ${publicAddressTemplate(creds.gateway_url, tenant.tenant_slug)}`);
+		console.log(`            ${SUBTREE_NOTE}`);
+	}
 	if (tenant.slug_locked) console.log("\n  🔒 The address is fixed — a Function version has been promoted and live URLs carry it.");
 	else {
 		console.log("\n  The address can still be changed: \x1B[36mwawesome workspace rename <name>\x1B[0m");
@@ -2546,7 +2595,7 @@ cli.command("logout", "Clear stored authentication credentials").action(() => lo
 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));
 cli.command("templates [action]", "Browse the template catalog").usage("templates [action]\n\nActions:\n  list (ls)           Show every available template (default)").example("wawesome templates").example("wawesome templates list").option("--api <url>", "API URL (default: https://api.wawesome.io)").option("-v, --verbose", "Enable verbose debug output").action((action, options) => templatesCommand(action, options));
-cli.command("init", "Scaffold a new function project in the current directory").usage("init [options]\n\nWith --template, the project is fetched from the template catalog, wired up\nfrom what the template declares it needs, and deployed. Run 'wawesome templates'\nto see what is available.").example("wawesome init").example("wawesome init --template stripe-webhook").option("-t, --template <name>", "Scaffold from a catalog template and deploy it").option("--api <url>", "API URL (default: https://api.wawesome.io)").option("--no-install", "Skip installing dependencies after scaffolding").option("-v, --verbose", "Enable verbose debug output").action((options) => init(options));
+cli.command("init", "Scaffold a new function project in the current directory").usage("init [options]\n\nWith --template, the project is fetched from the template catalog, wired up\nfrom what the template declares it needs, and deployed. Run 'wawesome templates'\nto see what is available.").example("wawesome init").example("wawesome init --template stripe-webhook").option("-t, --template <name>", "Scaffold from a catalog template and deploy it").option("--api <url>", "API URL (default: https://api.wawesome.io)").option("--no-install", "Skip installing dependencies after scaffolding").option("--root", "Generate a root function router template").option("-v, --verbose", "Enable verbose debug output").action((options) => init(options));
 cli.command("logs [function-name-or-invocation-id]", "View invocation history, fetch log output, or follow live").usage(`logs [target] [options]
 
   The target argument determines what the command does:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wawesome",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "CLI tool for building and deploying serverless functions on wawesome.io platform",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "test": "vitest run",
+    "test:templates": "vitest run --config vitest.live.config.ts",
     "check": "publint --pack npm",
     "changeset": "changeset"
   },