@wervt/cli 0.2.18 → 0.2.19

package/dist/index.mjs

@@ -420,6 +420,13 @@ function resolveAppDir(arg = ".") {
 	if (existsSync(join("apps", arg, "package.json"))) return resolve("apps", arg);
 	throw new Error(`No app found at ${arg}`);
 }
+const PREVIEW_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** `todos--pr-12` for `--preview pr-12`: the preview's own app name (control's previews.ts). */
+function previewName(app, preview) {
+	if (preview === void 0) return app;
+	if (!PREVIEW_RE.test(preview)) throw new Error(`--preview must be lowercase letters, digits and dashes, like pr-12`);
+	return `${app}--${preview}`;
+}
 async function appName(dir, name) {
 	if (!name) {
 		const pkg = JSON.parse(await readFile(join(dir, "package.json"), "utf8"));
@@ -444,6 +451,10 @@ const deploy = defineCommand({
 			type: "string",
 			description: "App name (default: package.json name)"
 		},
+		preview: {
+			type: "string",
+			description: "Deploy a preview of the app instead, at <app>--<preview> (like pr-12): own empty database, the app's access and env plus its preview env"
+		},
 		build: {
 			type: "boolean",
 			default: true,
@@ -466,7 +477,7 @@ const deploy = defineCommand({
 	},
 	async run({ args }) {
 		const dir = resolveAppDir(args.dir);
-		const name = await appName(dir, args.name);
+		const name = previewName(await appName(dir, args.name), args.preview);
 		p.intro(`wervt deploy ${name}`);
 		if (args.build) {
 			const pm = (await detectPackageManager(dir))?.name ?? "npm";
@@ -912,6 +923,10 @@ const env = defineCommand({
 			type: "string",
 			description: "KEY (comma separated)"
 		},
+		preview: {
+			type: "boolean",
+			description: "The app's preview env instead: set on top of its env in every preview, from their next deploy"
+		},
 		...connection
 	},
 	async run({ args, rawArgs }) {
@@ -922,17 +937,18 @@ const env = defineCommand({
 			return [pair.slice(0, i), pair.slice(i + 1)];
 		}));
 		const unset = toList(args.unset);
-		const { keys, warnings = [] } = await (Object.keys(set).length || unset.length ? await api(`/v1/apps/${args.app}/env`, args, {
+		const path = `/v1/apps/${args.app}/${args.preview ? "preview-env" : "env"}`;
+		const { keys, warnings = [] } = await (Object.keys(set).length || unset.length ? await api(path, args, {
 			method: "PATCH",
 			headers: { "content-type": "application/json" },
 			body: JSON.stringify({
 				set,
 				unset
 			})
-		}) : await api(`/v1/apps/${args.app}/env`, args)).json();
+		}) : await api(path, args)).json();
 		console.log(keys.length ? keys.join("\n") : "No variables set.");
 		for (const warning of warnings) console.error(styleText("yellow", `Warning: ${warning}`));
-		if (Object.keys(set).length || unset.length) console.log("Applies from the next request.");
+		if (Object.keys(set).length || unset.length) console.log(args.preview ? "Previews get it with their next deploy." : "Applies from the next request.");
 	}
 });
 const SIZE_FLAGS = [
@@ -1074,7 +1090,7 @@ const tokens = defineCommand({
 			})).json();
 			console.error(`Deploy token "${token.name}" for ${args.app} (shown once):`);
 			console.log(token.token);
-			console.error(styleText("dim", "It can deploy this app and nothing else. Store it as the WERVT_TOKEN secret."));
+			console.error(styleText("dim", "It can deploy this app and its previews, nothing else. Store it as the WERVT_TOKEN secret."));
 			return;
 		}
 		if (args.revoke) {
@@ -1377,13 +1393,17 @@ const tasks = defineCommand({
 const remove = defineCommand({
 	meta: {
 		name: "delete",
-		description: "Delete an app (releases, access, env)"
+		description: "Delete an app (releases, access, env) or one of its previews"
 	},
 	args: {
 		app: {
 			type: "positional",
-			required: true,
-			description: "App name"
+			required: false,
+			description: "App name (default: package.json name in the current directory)"
+		},
+		preview: {
+			type: "string",
+			description: "Delete the preview <app>--<preview> (like pr-12) and its data instead"
 		},
 		"drop-database": {
 			type: "boolean",
@@ -1396,16 +1416,18 @@ const remove = defineCommand({
 		...connection
 	},
 	async run({ args }) {
-		const dropDb = Boolean(args["drop-database"]);
+		const app = previewName(args.app ?? await appName(resolveAppDir()), args.preview);
+		const dropDb = Boolean(args["drop-database"]) || app.includes("--");
 		if (!args.yes) {
 			const ok = await p.confirm({
-				message: `Delete ${args.app}${dropDb ? " and ALL its data" : " (data is kept, the name stays yours)"}?`,
+				message: `Delete ${app}${dropDb ? " and ALL its data" : " (data is kept, the name stays yours)"}${app.includes("--") ? "" : ", and all its previews"}?`,
 				initialValue: false
 			});
 			if (p.isCancel(ok) || !ok) return p.cancel("Cancelled");
 		}
-		await api(`/v1/apps/${args.app}?dropDatabase=${dropDb}`, args, { method: "DELETE" });
-		console.log(`Deleted ${args.app}${dropDb ? " and its database" : ""}`);
+		const { previews = [] } = await (await api(`/v1/apps/${app}?dropDatabase=${dropDb}`, args, { method: "DELETE" })).json();
+		console.log(`Deleted ${app}${dropDb ? " and its database" : ""}`);
+		if (previews.length) console.log(`Also deleted its previews: ${previews.join(", ")}`);
 	}
 });
 const LEVEL_COLORS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wervt/cli",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "description": "Deploy and manage apps on wervt.",
   "keywords": [
     "agents",

package/skill/SKILL.md

@@ -123,7 +123,9 @@ git push -u origin main
 ```
 
 The pipe hands the deploy token straight to GitHub; it never appears in the output. A deploy token
-can only deploy that one app. Set the secret and variable **before** the first push, or the first
+can only deploy that one app and its previews: `.github/workflows/preview.yml` deploys every pull
+request to `<name>--pr-<number>` (own empty database, the app's access and env plus its preview
+env, `wervt env <name> --preview --set …`) and deletes it when the pull request closes. Set the secret and variable **before** the first push, or the first
 workflow run fails. Then `gh run watch` and check `pnpm exec wervt releases <name>`: the new
 release lists the commit.