@fluid-app/fluid-cli-mist 0.1.51 → 0.1.53

package/dist/index.mjs

@@ -185,7 +185,8 @@ const ENVIRONMENT_STATES = [
 	"ready",
 	"error",
 	"expired",
-	"deleting"
+	"deleting",
+	"deleted"
 ];
 const OPERATION_KINDS = [
 	"ensure_staging",
@@ -239,6 +240,16 @@ async function requestStaging(client, slug, request) {
 	const id = await resolveMistId(client, slug);
 	return parseOperationEnvelope(await client.post(`${base(id)}/branch-environments/staging`, { source_revision: request.sourceRevision }, { "X-Operation-Key": request.operationKey }));
 }
+/**
+* Ask the server to tear down one branch environment. The server only takes
+* it out of service and answers with it deleting (or already deleting or
+* deleted); a worker removes its resources shortly after. Repeating the
+* call is harmless.
+*/
+async function removeBranchEnvironment(client, slug, environmentId) {
+	const id = await resolveMistId(client, slug);
+	return parseEnvironment(record(await client.delete(`${base(id)}/branch-environments/${encodeURIComponent(environmentId)}`), "response")["environment"], "environment");
+}
 /** Read one branch operation of the project. Never advances it. */
 async function fetchBranchOperation(client, slug, operationId) {
 	const id = await resolveMistId(client, slug);
@@ -4368,11 +4379,11 @@ const stagingWaitCommand = new Command("wait").description("Follow a staging ope
 //#endregion
 //#region src/commands/staging/request.ts
 /** `fluid mist staging request` — request staging at a revision. */
-const stagingRequestCommand = new Command("request").description("Request the staging environment at a pushed commit").argument("[slug]", "The mist slug (defaults to .mist file in CWD)").option("--revision <sha>", "Full commit SHA to stage (defaults to this checkout's HEAD when it is clean and on main)").option("--operation-key <key>", "Resume an interrupted request with the key and --revision it printed").option("--wait", "Follow the operation until staging is ready").option("--timeout <minutes>", "How long --wait follows it (default 30)").option("--json", "Emit the operation as JSON").action((slug, opts) => runAction(async () => {
+const stagingRequestCommand = new Command("request").description("Request the staging environment at a pushed commit").argument("[slug]", "The mist slug (defaults to .mist file in CWD)").option("--revision <sha>", "Full commit SHA to stage (defaults to this checkout's HEAD when it is clean and on main)").option("--operation-key <key>", "Resume an interrupted request with the key and --revision it printed").option("--dir <path>", "Checkout to stage from when --revision is omitted (defaults to the current directory)").option("--wait", "Follow the operation until staging is ready").option("--timeout <minutes>", "How long --wait follows it (default 30)").option("--json", "Emit the operation as JSON").action((slug, opts) => runAction(async () => {
 	if (opts.operationKey && !opts.revision) throw new Error("--operation-key needs the --revision it was first sent with. The interrupted request printed both.");
 	const resolved = resolveSlug(slug);
 	const client = createMistClient();
-	const sourceRevision = opts.revision ?? await localRevision(client, resolved);
+	const sourceRevision = opts.revision ?? await localRevision(client, resolved, opts.dir ?? process.cwd());
 	let operation = await requestStagingResumably(client, resolved, {
 		sourceRevision,
 		operationKey: opts.operationKey,
@@ -4386,17 +4397,34 @@ const stagingRequestCommand = new Command("request").description("Request the st
 	if (operation.state === "succeeded") console.log(`✔ Staging is ready. Run \`fluid mist staging status\` for its URL.`);
 	else console.log(`Requested. Follow it with \`fluid mist staging wait --operation ${operation.id}\`.`);
 }));
-/** This checkout's HEAD, once it is clean and already on the remote's main. */
-async function localRevision(client, slug) {
+/** The checkout's HEAD, once it is clean and already on the remote's main. */
+async function localRevision(client, slug, checkout) {
 	const { git_credential: credential } = await createGitCredential(client, slug);
-	const revision = await resolveLocalStagingRevision(process.cwd(), credential.remote_url);
+	const revision = await resolveLocalStagingRevision(checkout, credential.remote_url);
 	process.stderr.write(chalk.dim(`Staging this checkout's HEAD, ${revision.slice(0, 7)}.\n`));
 	return revision;
 }
 //#endregion
+//#region src/commands/staging/teardown.ts
+/** `fluid mist staging teardown` — remove the staging environment. */
+const stagingTeardownCommand = new Command("teardown").description("Tear down the staging environment: its deployment, variables, Git branch and database branch").argument("[slug]", "The mist slug (defaults to .mist file in CWD)").option("--yes", "Confirm the teardown; nothing is removed without it").option("--json", "Emit the environment as JSON").action((slug, opts) => runAction(async () => {
+	const client = createMistClient();
+	const mist = resolveSlug(slug);
+	const { environment } = await readStagingStatus(client, mist);
+	if (!environment || environment.state === "deleted") {
+		if (opts.json) return printJson({ environment: null });
+		console.log(chalk.dim("No staging environment to tear down."));
+		return;
+	}
+	if (!opts.yes) throw new Error("Tearing down staging removes its deployment, variables, Git branch and database branch. Rerun with --yes to confirm.");
+	const removed = await removeBranchEnvironment(client, mist, environment.id);
+	if (opts.json) return printJson({ environment: removed });
+	console.log(removed.state === "deleted" ? "Staging is already torn down." : `Staging is ${chalk.bold(removed.state)}. Its resources are removed within about a minute; check with \`fluid mist staging status\`.`);
+}));
+//#endregion
 //#region src/commands/staging/index.ts
 /** `fluid mist staging` — sub-command aggregator. */
-const stagingCommand = new Command("staging").description("Use a mist's isolated staging environment").addCommand(stagingStatusCommand).addCommand(stagingRequestCommand).addCommand(stagingWaitCommand);
+const stagingCommand = new Command("staging").description("Use a mist's isolated staging environment").addCommand(stagingStatusCommand).addCommand(stagingRequestCommand).addCommand(stagingWaitCommand).addCommand(stagingTeardownCommand);
 //#endregion
 //#region src/index.ts
 /**