feat(cli): add a webstone deploy web CLI command

.changeset/wild-fireants-doubt.md

@@ -0,0 +1,5 @@
+---
+"@webstone/cli": minor
+---
+
+Add a `webstone deploy web` CLI command.

packages/cli/docs/plugins.md

@@ -44,6 +44,6 @@ This is then accessible in your plugin's commands as `toolbox.bar`.
 
 # Loading a plugin
 
-To load a particular plugin (which has to start with `cli-*`),
-install it to your project using `npm install --save-dev cli-PLUGINNAME`,
+To load a particular plugin (which has to start with `webstone-cli-*`),
+install it to your project using `pnpm install --save-dev webstone-cli-PLUGINNAME`,
 and cli will pick it up automatically.

packages/cli/src/commands/deploy/web.ts

@@ -0,0 +1,34 @@
+import type { WebstoneToolbox } from "../../extensions/web";
+
+import { GluegunCommand } from "gluegun";
+
+const command: GluegunCommand = {
+  // @ts-ignore: WebstoneToolbox extends GluegunToolbox, ignore TS error.
+  run: async (toolbox: WebstoneToolbox) => {
+    const { parameters, print, system, web } = toolbox;
+
+    if (!web.configure.deployment.isAnyAdapterInstalled()) {
+      print.warning(
+        "No deployment adapter configured. Please run `pnpm webstone web configure deployment` to fix this before you deploy the application."
+      );
+      return;
+    }
+
+    const buildSpinner = print.spin(`Building the web service...`);
+    await system.run(`pnpm build --filter ./services/web`);
+    buildSpinner.succeed();
+
+    if (parameters.options.preview) {
+      print.info(`Previewing the web service...`);
+      await system.exec(`pnpm preview --filter ./services/web`, {
+        stdout: "inherit",
+      });
+    } else {
+      print.highlight(
+        `TODO: Link to deployment docs for the ${web.configure.deployment.getInstalledAdapterPackageName()} adapter.`
+      );
+    }
+  },
+};
+
+module.exports = command;

packages/cli/src/commands/web/configure/deployment.ts

@@ -1,7 +1,5 @@
-import type { GluegunCommand, GluegunToolbox } from "gluegun";
-import type { WebToolbox } from "../../../extensions/web/types";
-
-interface WebstoneToolbox extends GluegunToolbox, WebToolbox {}
+import type { GluegunCommand } from "gluegun";
+import type { WebstoneToolbox } from "../../../extensions/web";
 
 const command: GluegunCommand = {
   // @ts-ignore: WebstoneToolbox extends GluegunToolbox, ignore TS error.

packages/cli/src/extensions/web.ts

@@ -3,6 +3,8 @@ import type { WebToolbox } from "./web/types";
 
 import webConfigureDeployment from "./web/configure/deployment";
 
+export interface WebstoneToolbox extends GluegunToolbox, WebToolbox {}
+
 export default (toolbox: GluegunToolbox) => {
   const webToolbox: WebToolbox = {
     web: {