@mittwald/cli 1.0.0-alpha.39 → 1.0.0-alpha.40

package/README.md

@@ -1010,7 +1010,7 @@ FLAG DESCRIPTIONS
 
 ## `mw app install nextcloud`
 
-Creates new Shopware 6 installation.
+Creates new Nextcloud installation.
 
 ```
 USAGE
@@ -1021,17 +1021,17 @@ FLAGS
   -p, --project-id=<value>   ID or short ID of a project; this flag is optional if a default project is set in the
                              context
   -q, --quiet                suppress process output and only display a machine-readable summary.
-  -w, --wait                 wait for your Shopware 6 to be ready.
+  -w, --wait                 wait for your Nextcloud to be ready.
       --admin-email=<value>  email address of your administrator user.
       --admin-pass=<value>   password of your administrator user.
       --admin-user=<value>   Username for your administrator user.
-      --host=<value>         host to initially configure your Shopware 6 installation with; needs to be created
+      --host=<value>         host to initially configure your Nextcloud installation with; needs to be created
                              separately.
-      --site-title=<value>   site title for your Shopware 6 installation.
-      --version=<value>      (required) [default: latest] version of Shopware 6 to be installed.
+      --site-title=<value>   site title for your Nextcloud installation.
+      --version=<value>      (required) [default: latest] version of Nextcloud to be installed.
 
 DESCRIPTION
-  Creates new Shopware 6 installation.
+  Creates new Nextcloud installation.
 
 FLAG DESCRIPTIONS
   -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
@@ -1046,40 +1046,40 @@ FLAG DESCRIPTIONS
 
   --admin-email=<value>  email address of your administrator user.
 
-    email address that will be used for the first administrator user that is created during the Shopware 6 installation.
+    email address that will be used for the first administrator user that is created during the Nextcloud installation.
     If unspecified, email address of your mStudio account will be used. This email address can be changed after the
     installation is finished.
 
   --admin-pass=<value>  password of your administrator user.
 
-    The password that will be used for the first administrator user that is created during the Shopware 6 installation.
+    The password that will be used for the first administrator user that is created during the Nextcloud installation.
     If unspecified, a random secure password will be generated and printed to stdout. This password can be changed after
     the installation is finished
 
   --admin-user=<value>  Username for your administrator user.
 
-    Username of the first administrator user which will be created during the Shopware 6 installation.
+    Username of the first administrator user which will be created during the Nextcloud installation.
     If unspecified, an adequate username will be generated.
     After the installation is finished, the username can be changed and additional administrator users can be created.
 
-  --host=<value>  host to initially configure your Shopware 6 installation with; needs to be created separately.
+  --host=<value>  host to initially configure your Nextcloud installation with; needs to be created separately.
 
-    Specify a host which will be used during the installation and as an initial host for the Shopware 6 configuration.
+    Specify a host which will be used during the installation and as an initial host for the Nextcloud configuration.
     If unspecified, the default host for the given project will be used.
-    This does not change the target of the used host and can be changed later by configuring the host and your Shopware
-    6 installation.
+    This does not change the target of the used host and can be changed later by configuring the host and your Nextcloud
+    installation.
 
-  --site-title=<value>  site title for your Shopware 6 installation.
+  --site-title=<value>  site title for your Nextcloud installation.
 
-    The site title for this Shopware 6 installation. It is also the title shown in the app overview in the mStudio and
+    The site title for this Nextcloud installation. It is also the title shown in the app overview in the mStudio and
     the CLI.
     If unspecified, the application name and the given project ID will be used. The title can be changed after the
     installation is finished
 
-  --version=<value>  version of Shopware 6 to be installed.
+  --version=<value>  version of Nextcloud to be installed.
 
-    Specify the version in which your Shopware 6 will be installed.
-    If unspecified, the Shopware 6 will be installed in the latest available version.
+    Specify the version in which your Nextcloud will be installed.
+    If unspecified, the Nextcloud will be installed in the latest available version.
 ```
 
 ## `mw app install shopware5`
@@ -1588,7 +1588,7 @@ EXAMPLES
   $ mw autocomplete --refresh-cache
 ```
 
-_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.0.11/src/commands/autocomplete/index.ts)_
+_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.0.13/src/commands/autocomplete/index.ts)_
 
 ## `mw backup create`
 
@@ -2727,8 +2727,8 @@ Initialize a new ddev project in the current directory.
 
 ```
 USAGE
-  $ mw ddev init [INSTALLATION-ID] [-q] [--override-type <value>] [--project-name <value>]
-    [--override-mittwald-plugin <value>]
+  $ mw ddev init [INSTALLATION-ID] [-q] [--override-type <value>] [--without-database | --database-id <value>]
+    [--project-name <value>] [--override-mittwald-plugin <value>]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -2736,8 +2736,10 @@ ARGUMENTS
 
 FLAGS
   -q, --quiet                  suppress process output and only display a machine-readable summary.
+      --database-id=<value>    ID of the application database
       --override-type=<value>  [default: auto] Override the type of the generated DDEV configuration
       --project-name=<value>   DDEV project name
+      --without-database       Create a DDEV project without a database
 
 DEVELOPMENT FLAGS
   --override-mittwald-plugin=<value>  [default: mittwald/ddev] override the mittwald plugin
@@ -2764,6 +2766,14 @@ FLAG DESCRIPTIONS
     This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
     scripts), you can use this flag to easily get the IDs of created resources for further processing.
 
+  --database-id=<value>  ID of the application database
+
+    The ID of the database to use for the DDEV project; if set to 'auto', the command will use the database linked to
+    the app installation.
+
+    Setting a database ID (either automatically or manually) is required. To create a DDEV project without a database,
+    set the --without-database flag.
+
   --override-mittwald-plugin=<value>  override the mittwald plugin
 
     This flag allows you to override the mittwald plugin that should be installed by default; this is useful for testing
@@ -2779,6 +2789,11 @@ FLAG DESCRIPTIONS
   --project-name=<value>  DDEV project name
 
     The name of the DDEV project
+
+  --without-database  Create a DDEV project without a database
+
+    Use this flag to create a DDEV project without a database; this is useful for projects that do not require a
+    database.
 ```
 
 ## `mw ddev render-config [INSTALLATION-ID]`
@@ -2787,14 +2802,16 @@ Generate a DDEV configuration YAML file for the current app.
 
 ```
 USAGE
-  $ mw ddev render-config [INSTALLATION-ID] [--override-type <value>]
+  $ mw ddev render-config [INSTALLATION-ID] [--override-type <value>] [--without-database | --database-id <value>]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
                    in the context
 
 FLAGS
+  --database-id=<value>    ID of the application database
   --override-type=<value>  [default: auto] Override the type of the generated DDEV configuration
+  --without-database       Create a DDEV project without a database
 
 DESCRIPTION
   Generate a DDEV configuration YAML file for the current app.
@@ -2802,12 +2819,25 @@ DESCRIPTION
   This command initializes a new ddev configuration in the current directory.
 
 FLAG DESCRIPTIONS
+  --database-id=<value>  ID of the application database
+
+    The ID of the database to use for the DDEV project; if set to 'auto', the command will use the database linked to
+    the app installation.
+
+    Setting a database ID (either automatically or manually) is required. To create a DDEV project without a database,
+    set the --without-database flag.
+
   --override-type=<value>  Override the type of the generated DDEV configuration
 
     The type of the generated DDEV configuration; this can be any of the documented DDEV project types, or 'auto' (which
     is also the default) for automatic discovery.
 
     See https://ddev.readthedocs.io/en/latest/users/configuration/config/#type for more information
+
+  --without-database  Create a DDEV project without a database
+
+    Use this flag to create a DDEV project without a database; this is useful for projects that do not require a
+    database.
 ```
 
 ## `mw domain dnszone get DNSZONE-ID`
@@ -3112,10 +3142,10 @@ Display help for mw.
 
 ```
 USAGE
-  $ mw help [COMMAND] [-n]
+  $ mw help [COMMAND...] [-n]
 
 ARGUMENTS
-  COMMAND  Command to show help for.
+  COMMAND...  Command to show help for.
 
 FLAGS
   -n, --nested-commands  Include all nested commands in the output.
@@ -3124,7 +3154,7 @@ DESCRIPTION
   Display help for mw.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.16/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.18/src/commands/help.ts)_
 
 ## `mw login reset`
 
@@ -4518,7 +4548,7 @@ EXAMPLES
     $ mw update --available
 ```
 
-_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.1.16/src/commands/update.ts)_
+_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.2.0/src/commands/update.ts)_
 
 ## `mw user api-token create`
 

package/dist/BaseCommand.d.ts

@@ -4,8 +4,4 @@ export declare abstract class BaseCommand extends Command {
     protected authenticationRequired: boolean;
     protected apiClient: MittwaldAPIV2Client;
     init(): Promise<void>;
-    protected getTokenFilename(): string;
-    private readApiToken;
-    private readApiTokenFromEnvironment;
-    private readApiTokenFromConfig;
 }

package/dist/BaseCommand.js

@@ -1,18 +1,17 @@
 import { Command } from "@oclif/core";
-import * as fs from "fs/promises";
-import * as path from "path";
 import { MittwaldAPIV2Client } from "@mittwald/api-client";
 import { configureAxiosRetry } from "./lib/api_retry.js";
 import { configureConsistencyHandling } from "./lib/api_consistency.js";
+import { getTokenFilename, readApiToken } from "./lib/auth/token.js";
 export class BaseCommand extends Command {
     authenticationRequired = true;
     apiClient = MittwaldAPIV2Client.newUnauthenticated();
     async init() {
         await super.init();
         if (this.authenticationRequired) {
-            const token = await this.readApiToken();
+            const token = await readApiToken(this.config);
             if (token === undefined) {
-                throw new Error(`Could not get token from either config file (${this.getTokenFilename()}) or environment`);
+                throw new Error(`Could not get token from either config file (${getTokenFilename(this.config)}) or environment`);
             }
             this.apiClient = MittwaldAPIV2Client.newWithToken(token);
             this.apiClient.axios.defaults.headers["User-Agent"] =
@@ -21,30 +20,4 @@ export class BaseCommand extends Command {
             configureConsistencyHandling(this.apiClient.axios);
         }
     }
-    getTokenFilename() {
-        return path.join(this.config.configDir, "token");
-    }
-    async readApiToken() {
-        return (this.readApiTokenFromEnvironment() ??
-            (await this.readApiTokenFromConfig()));
-    }
-    readApiTokenFromEnvironment() {
-        const token = process.env.MITTWALD_API_TOKEN;
-        if (token === undefined) {
-            return undefined;
-        }
-        return token.trim();
-    }
-    async readApiTokenFromConfig() {
-        try {
-            const tokenFileContents = await fs.readFile(this.getTokenFilename(), "utf-8");
-            return tokenFileContents.trim();
-        }
-        catch (err) {
-            if (err instanceof Error && "code" in err && err.code === "ENOENT") {
-                return undefined;
-            }
-            throw err;
-        }
-    }
 }

package/dist/commands/app/install/nextcloud.js

@@ -1,6 +1,6 @@
 import { ExecRenderBaseCommand } from "../../../rendering/react/ExecRenderBaseCommand.js";
 import { AppInstaller, } from "../../../lib/app/Installer.js";
-const installer = new AppInstaller("0b97d59f-ee13-4f18-a1f6-53e1beaf2e70", "Shopware 6", [
+const installer = new AppInstaller("0b97d59f-ee13-4f18-a1f6-53e1beaf2e70", "Nextcloud", [
     "version",
     "host",
     "admin-user",

package/dist/commands/ddev/init.d.ts

@@ -6,6 +6,8 @@ export declare class Init extends ExecRenderBaseCommand<typeof Init, void> {
     static flags: {
         "project-name": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         "override-mittwald-plugin": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        "database-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        "without-database": import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         "override-type": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         quiet: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     };
@@ -15,9 +17,18 @@ export declare class Init extends ExecRenderBaseCommand<typeof Init, void> {
     protected exec(): Promise<void>;
     protected render(): React.ReactNode;
     private addSSHCredentials;
-    private determineDDEVVersion;
+    private getAppInstallation;
     private installMittwaldPlugin;
     private initializeDDEVProject;
     private determineProjectName;
+    /**
+     * This steps writes the users API token to the local DDEV configuration file.
+     * This is necessary to authenticate the DDEV project with the mittwald API.
+     *
+     * The token is written to the `web_environment` section of the
+     * `config.local.yaml`, which _should_ be safe to store credentials in, as it
+     * is in DDEV's default `.gitignore` file.
+     */
+    private writeAuthConfiguration;
     private writeMittwaldConfiguration;
 }

package/dist/commands/ddev/init.js

@@ -2,22 +2,24 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { ExecRenderBaseCommand } from "../../rendering/react/ExecRenderBaseCommand.js";
 import { appInstallationArgs } from "../../lib/app/flags.js";
 import { makeProcessRenderer, processFlags, } from "../../rendering/process/process_flags.js";
-import { mkdir, writeFile } from "fs/promises";
+import { mkdir, readFile, writeFile } from "fs/promises";
 import path from "path";
 import { DDEVConfigBuilder } from "../../lib/ddev/config_builder.js";
 import { spawnInProcess } from "../../rendering/process/process_exec.js";
 import { Flags } from "@oclif/core";
 import { DDEVInitSuccess } from "../../rendering/react/components/DDEV/DDEVInitSuccess.js";
 import { ddevConfigToFlags } from "../../lib/ddev/config.js";
-import { hasBinary } from "../../lib/hasbin.js";
 import { renderDDEVConfig } from "../../lib/ddev/config_render.js";
 import { loadDDEVConfig } from "../../lib/ddev/config_loader.js";
 import { Value } from "../../rendering/react/components/Value.js";
 import { ddevFlags } from "../../lib/ddev/flags.js";
-import { exec } from "child_process";
-import { promisify } from "util";
 import { compareSemVer } from "semver-parser";
-const execAsync = promisify(exec);
+import { assertStatus } from "@mittwald/api-client";
+import { readApiToken } from "../../lib/auth/token.js";
+import { isNotFound } from "../../lib/fsutil.js";
+import { dump, load } from "js-yaml";
+import { determineDDEVDatabaseId } from "../../lib/ddev/init_database.js";
+import { assertDDEVIsInstalled, determineDDEVVersion, } from "../../lib/ddev/init_assert.js";
 export class Init extends ExecRenderBaseCommand {
     static summary = "Initialize a new ddev project in the current directory.";
     static description = "This command initializes a new ddev configuration for an existing app installation in the current directory.\n" +
@@ -54,8 +56,11 @@ export class Init extends ExecRenderBaseCommand {
         const appInstallationId = await this.withAppInstallationId(Init);
         const r = makeProcessRenderer(this.flags, "Initializing DDEV project");
         await assertDDEVIsInstalled(r);
-        const ddevVersion = await this.determineDDEVVersion(r);
-        const config = await this.writeMittwaldConfiguration(r, appInstallationId);
+        const ddevVersion = await determineDDEVVersion(r);
+        const appInstallation = await this.getAppInstallation(r, appInstallationId);
+        const databaseId = await determineDDEVDatabaseId(r, this.apiClient, this.flags, appInstallation);
+        await this.writeAuthConfiguration(r);
+        const config = await this.writeMittwaldConfiguration(r, appInstallationId, databaseId);
         const projectName = await this.determineProjectName(r);
         await this.initializeDDEVProject(r, config, projectName, ddevVersion);
         await this.installMittwaldPlugin(r);
@@ -71,11 +76,14 @@ export class Init extends ExecRenderBaseCommand {
             "ssh",
         ]);
     }
-    async determineDDEVVersion(r) {
-        const { stdout } = await execAsync("ddev --version");
-        const version = stdout.trim().replace(/^ddev version +/, "");
-        r.addInfo(_jsx(InfoDDEVVersion, { version: version }));
-        return version;
+    async getAppInstallation(r, appInstallationId) {
+        return r.runStep("fetching app installation", async () => {
+            const r = await this.apiClient.app.getAppinstallation({
+                appInstallationId,
+            });
+            assertStatus(r, 200);
+            return r.data;
+        });
     }
     async installMittwaldPlugin(r) {
         const { "override-mittwald-plugin": mittwaldPlugin } = this.flags;
@@ -94,6 +102,7 @@ export class Init extends ExecRenderBaseCommand {
         if (compareSemVer(ddevVersion, "1.22.7") < 0) {
             ddevFlags.push("--create-docroot");
         }
+        this.debug("running %o %o", "ddev", ddevFlags);
         await spawnInProcess(r, "initializing DDEV project", "ddev", ddevFlags);
     }
     async determineProjectName(r) {
@@ -108,23 +117,56 @@ export class Init extends ExecRenderBaseCommand {
         }
         return await r.addInput("Enter the project name", false);
     }
-    async writeMittwaldConfiguration(r, appInstallationId) {
+    /**
+     * This steps writes the users API token to the local DDEV configuration file.
+     * This is necessary to authenticate the DDEV project with the mittwald API.
+     *
+     * The token is written to the `web_environment` section of the
+     * `config.local.yaml`, which _should_ be safe to store credentials in, as it
+     * is in DDEV's default `.gitignore` file.
+     */
+    async writeAuthConfiguration(r) {
+        // NOTE that config.local.yaml is in DDEV's default .gitignore file, so
+        // it *should* be safe to store credentials in there.
+        const configFile = path.join(".ddev", "config.local.yaml");
+        const token = await readApiToken(this.config);
+        await r.runStep("writing local-only DDEV configuration", async () => {
+            try {
+                const existing = await readFile(configFile, { encoding: "utf-8" });
+                const parsed = load(existing);
+                const alreadyContainsAPIToken = (parsed.web_environment ?? []).some((e) => e.startsWith("MITTWALD_API_TOKEN="));
+                if (!alreadyContainsAPIToken) {
+                    parsed.web_environment = [
+                        ...(parsed.web_environment ?? []),
+                        `MITTWALD_API_TOKEN=${token}`,
+                    ];
+                    await writeContentsToFile(configFile, dump(parsed));
+                }
+            }
+            catch (err) {
+                if (isNotFound(err)) {
+                    const config = {
+                        web_environment: [`MITTWALD_API_TOKEN=${token}`],
+                    };
+                    await writeContentsToFile(configFile, dump(config));
+                    return;
+                }
+                else {
+                    throw err;
+                }
+            }
+        });
+    }
+    async writeMittwaldConfiguration(r, appInstallationId, databaseId) {
+        const builder = new DDEVConfigBuilder(this.apiClient);
         return await r.runStep("creating mittwald-specific DDEV configuration", async () => {
-            const builder = new DDEVConfigBuilder(this.apiClient);
-            const config = await builder.build(appInstallationId, this.flags["override-type"]);
+            const config = await builder.build(appInstallationId, databaseId, this.flags["override-type"]);
             const configFile = path.join(".ddev", "config.mittwald.yaml");
             await writeContentsToFile(configFile, renderDDEVConfig(appInstallationId, config));
             return config;
         });
     }
 }
-async function assertDDEVIsInstalled(r) {
-    await r.runStep("check if DDEV is installed", async () => {
-        if (!(await hasBinary("ddev"))) {
-            throw new Error("this command requires DDEV to be installed");
-        }
-    });
-}
 async function writeContentsToFile(filename, data) {
     const dirname = path.dirname(filename);
     await mkdir(dirname, { recursive: true });
@@ -133,6 +175,3 @@ async function writeContentsToFile(filename, data) {
 function InfoUsingExistingName({ name }) {
     return (_jsxs(_Fragment, { children: ["using existing project name: ", _jsx(Value, { children: name })] }));
 }
-function InfoDDEVVersion({ version }) {
-    return (_jsxs(_Fragment, { children: ["detected DDEV version: ", _jsx(Value, { children: version })] }));
-}

package/dist/commands/ddev/render-config.d.ts

@@ -3,6 +3,8 @@ export declare class RenderConfig extends ExtendedBaseCommand<typeof RenderConfi
     static summary: string;
     static description: string;
     static flags: {
+        "database-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        "without-database": import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         "override-type": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };
     static args: {

package/dist/commands/ddev/render-config.js

@@ -15,8 +15,11 @@ export class RenderConfig extends ExtendedBaseCommand {
     async run() {
         const appInstallationId = await this.withAppInstallationId(RenderConfig);
         const projectType = this.flags["override-type"];
+        const databaseId = this.flags["without-database"]
+            ? "none"
+            : this.flags["database-id"];
         const ddevConfigBuilder = new DDEVConfigBuilder(this.apiClient);
-        const ddevConfig = await ddevConfigBuilder.build(appInstallationId, projectType);
+        const ddevConfig = await ddevConfigBuilder.build(appInstallationId, databaseId, projectType);
         this.log(renderDDEVConfig(appInstallationId, ddevConfig));
     }
 }

package/dist/commands/login/reset.js

@@ -5,32 +5,35 @@ import { Box, Text } from "ink";
 import { Note } from "../../rendering/react/components/Note.js";
 import { FancyProcessRenderer } from "../../rendering/process/process_fancy.js";
 import { Filename } from "../../rendering/react/components/Filename.js";
+import { getTokenFilename } from "../../lib/auth/token.js";
+import { isNotFound } from "../../lib/fsutil.js";
 export default class Reset extends ExecRenderBaseCommand {
     static description = "Reset your local authentication state";
     authenticationRequired = false;
     async exec() {
         const process = new FancyProcessRenderer("Resetting authentication state");
+        const tokenFilename = getTokenFilename(this.config);
         process.start();
-        if (await this.tokenFileExists()) {
-            const step = process.addStep(_jsxs(Text, { children: ["Deleting token file ", _jsx(Filename, { filename: this.getTokenFilename() })] }));
-            await fs.rm(this.getTokenFilename(), { force: true });
+        if (await this.tokenFileExists(tokenFilename)) {
+            const step = process.addStep(_jsxs(Text, { children: ["Deleting token file ", _jsx(Filename, { filename: tokenFilename })] }));
+            await fs.rm(tokenFilename, { force: true });
             step.complete();
-            process.complete(_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Authentication state successfully reset" }), _jsx(Note, { children: "Please keep in mind that this does not invalidate the token on the server. Invalidate your API token using the mStudio web interface, or using the 'mw user api-token revoke' command." })] }));
+            await process.complete(_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Authentication state successfully reset" }), _jsx(Note, { children: "Please keep in mind that this does not invalidate the token on the server. Invalidate your API token using the mStudio web interface, or using the 'mw user api-token revoke' command." })] }));
             return { deleted: true };
         }
-        process.complete(_jsx(Text, { children: "No token file found, nothing to do" }));
+        await process.complete(_jsx(Text, { children: "No token file found, nothing to do" }));
         return { deleted: false };
     }
     render() {
         return null;
     }
-    async tokenFileExists() {
+    async tokenFileExists(tokenFilename) {
         try {
-            await fs.access(this.getTokenFilename());
+            await fs.access(tokenFilename);
             return true;
         }
         catch (err) {
-            if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+            if (isNotFound(err)) {
                 return false;
             }
             throw err;

package/dist/commands/login/token.js

@@ -1,6 +1,8 @@
 import { Flags, ux } from "@oclif/core";
 import { BaseCommand } from "../../BaseCommand.js";
 import * as fs from "fs/promises";
+import { getTokenFilename } from "../../lib/auth/token.js";
+import { isNotFound } from "../../lib/fsutil.js";
 export default class Token extends BaseCommand {
     static description = "Authenticate using an API token";
     static flags = {
@@ -21,17 +23,18 @@ export default class Token extends BaseCommand {
         const token = await ux.prompt("Enter your mStudio API token", {
             type: "mask",
         });
+        const tokenFilename = getTokenFilename(this.config);
         await fs.mkdir(this.config.configDir, { recursive: true });
-        await fs.writeFile(this.getTokenFilename(), token, "utf-8");
-        this.log("token saved to %o", this.getTokenFilename());
+        await fs.writeFile(tokenFilename, token, "utf-8");
+        this.log("token saved to %o", tokenFilename);
     }
     async tokenFileExists() {
         try {
-            await fs.access(this.getTokenFilename());
+            await fs.access(getTokenFilename(this.config));
             return true;
         }
         catch (err) {
-            if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+            if (isNotFound(err)) {
                 return false;
             }
             throw err;

package/dist/lib/api_consistency.js

@@ -2,8 +2,10 @@ import debug from "debug";
 const d = debug("mw:api-consistency");
 export function configureConsistencyHandling(axios) {
     let lastEventId = undefined;
+    let mutatedPaths = undefined;
     axios.interceptors.request.use((config) => {
-        if (lastEventId !== undefined) {
+        if (lastEventId !== undefined &&
+            mutatedPaths?.some((path) => config.url?.startsWith(path))) {
             d("setting if-event-reached to %o", lastEventId);
             config.headers["if-event-reached"] = lastEventId;
         }
@@ -13,8 +15,12 @@ export function configureConsistencyHandling(axios) {
         const isMutatingRequest = ["post", "put", "delete", "patch"].indexOf(response.config?.method?.toLowerCase() ?? "") >= 0;
         const headers = response.headers;
         if (headers.has("etag") && isMutatingRequest) {
-            d("setting last event id to %o after mutating request", headers.get("etag"));
             lastEventId = headers.get("etag");
+            const mutatedPath = response.config?.url;
+            if (mutatedPath !== undefined) {
+                mutatedPaths = [mutatedPath];
+            }
+            d("setting last event id to %o after mutating request for path %o", headers["etag"], mutatedPath);
         }
         return response;
     });

package/dist/lib/api_retry.js

@@ -2,16 +2,26 @@ import debug from "debug";
 import axiosRetry from "axios-retry";
 const d = debug("mw:api-retry");
 export function configureAxiosRetry(axios) {
+    let shouldRetryAccessDenied = false;
     axios.interceptors.request.use((config) => {
         return {
             ...config,
             validateStatus: (status) => status < 300,
         };
     });
+    axios.interceptors.request.use((config) => {
+        if (config.method?.toLowerCase() === "post") {
+            shouldRetryAccessDenied = true;
+        }
+        return config;
+    });
     axiosRetry(axios, {
         retries: 10,
         retryDelay: axiosRetry.exponentialDelay,
-        onRetry(count, error) {
+        onRetry(count, error, config) {
+            if (error.response?.status === 412 && config.headers !== undefined) {
+                delete config.headers["if-event-reached"];
+            }
             d("retrying request after %d attempts; error: %o", count, error.message);
         },
         retryCondition(error) {
@@ -22,8 +32,12 @@ export function configureAxiosRetry(axios) {
                 return true;
             }
             const isSafeRequest = error.config?.method?.toLowerCase() === "get";
+            const isPreconditionFailed = error.response?.status === 412;
             const isAccessDenied = error.response?.status === 403;
-            return isSafeRequest && isAccessDenied;
+            if (isPreconditionFailed) {
+                return true;
+            }
+            return isSafeRequest && isAccessDenied && shouldRetryAccessDenied;
         },
     });
 }

package/dist/lib/auth/token.d.ts

@@ -0,0 +1,13 @@
+import { Config } from "@oclif/core";
+/**
+ * Gets the filename in which the CLI should store the API token.
+ *
+ * @param config The CLI configuration object.
+ */
+export declare function getTokenFilename(config: Config): string;
+/**
+ * Reads the API token from the environment or the configuration file.
+ *
+ * @param config The CLI configuration object.
+ */
+export declare function readApiToken(config: Config): Promise<string | undefined>;

package/dist/lib/auth/token.js

@@ -0,0 +1,44 @@
+import path from "path";
+import fs from "fs/promises";
+import { isNotFound } from "../fsutil.js";
+/**
+ * Gets the filename in which the CLI should store the API token.
+ *
+ * @param config The CLI configuration object.
+ */
+export function getTokenFilename(config) {
+    return path.join(config.configDir, "token");
+}
+/**
+ * Reads the API token from the environment or the configuration file.
+ *
+ * @param config The CLI configuration object.
+ */
+export async function readApiToken(config) {
+    return (readApiTokenFromEnvironment() ?? (await readApiTokenFromConfig(config)));
+}
+/** Reads the API token from the MITTWALD_API_TOKEN environment variable. */
+function readApiTokenFromEnvironment() {
+    const token = process.env.MITTWALD_API_TOKEN;
+    if (token === undefined) {
+        return undefined;
+    }
+    return token.trim();
+}
+/**
+ * Reads the API token from the configuration file.
+ *
+ * @param config The CLI configuration object.
+ */
+async function readApiTokenFromConfig(config) {
+    try {
+        const tokenFileContents = await fs.readFile(getTokenFilename(config), "utf-8");
+        return tokenFileContents.trim();
+    }
+    catch (err) {
+        if (isNotFound(err)) {
+            return undefined;
+        }
+        throw err;
+    }
+}

package/dist/lib/ddev/config_builder.d.ts

@@ -3,11 +3,13 @@ import { DDEVConfig } from "./config.js";
 export declare class DDEVConfigBuilder {
     private apiClient;
     constructor(apiClient: MittwaldAPIV2Client);
-    build(appInstallationId: string, type: string): Promise<Partial<DDEVConfig>>;
+    build(appInstallationId: string, databaseId: string | undefined, type: string): Promise<Partial<DDEVConfig>>;
     private buildHooks;
     private determineDocumentRoot;
     private determineProjectType;
     private determineDatabaseVersion;
+    private determineMySQLDatabaseVersion;
+    private determineDatabaseVersionFromInstallation;
     private determinePHPVersion;
     private buildSystemSoftwareVersionMap;
     private getSystemSoftware;

package/dist/lib/ddev/config_builder.js

@@ -8,19 +8,19 @@ export class DDEVConfigBuilder {
     constructor(apiClient) {
         this.apiClient = apiClient;
     }
-    async build(appInstallationId, type) {
+    async build(appInstallationId, databaseId, type) {
         const appInstallation = await this.getAppInstallation(appInstallationId);
         const systemSoftwares = await this.buildSystemSoftwareVersionMap(appInstallation);
         type = await this.determineProjectType(appInstallation, type);
         return {
-            override_config: true,
             type,
             webserver_type: "apache-fpm",
             php_version: this.determinePHPVersion(systemSoftwares),
-            database: await this.determineDatabaseVersion(appInstallation),
+            database: await this.determineDatabaseVersion(databaseId),
             docroot: await this.determineDocumentRoot(appInstallation),
             web_environment: [
                 `MITTWALD_APP_INSTALLATION_ID=${appInstallation.shortId}`,
+                `MITTWALD_DATABASE_ID=${databaseId ?? ""}`,
             ],
             hooks: this.buildHooks(type),
         };
@@ -70,18 +70,33 @@ export class DDEVConfigBuilder {
                 throw new Error("Automatic project type detection failed. Please specify the project type manually by setting the `--override-type` flag.");
         }
     }
-    async determineDatabaseVersion(inst) {
+    async determineDatabaseVersion(databaseId) {
+        if (!databaseId) {
+            return undefined;
+        }
+        const mysqlDatabase = await this.determineMySQLDatabaseVersion(databaseId);
+        if (mysqlDatabase) {
+            return mysqlDatabase;
+        }
+        return undefined;
+    }
+    async determineMySQLDatabaseVersion(mysqlDatabaseId) {
+        const r = await this.apiClient.database.getMysqlDatabase({
+            mysqlDatabaseId,
+        });
+        if (r.status !== 200) {
+            return undefined;
+        }
+        return {
+            type: "mysql",
+            version: r.data.version,
+        };
+    }
+    async determineDatabaseVersionFromInstallation(inst) {
         const isPrimary = (db) => db.purpose === "primary";
         const primary = (inst.linkedDatabases || []).find(isPrimary);
         if (primary?.kind === "mysql") {
-            const r = await this.apiClient.database.getMysqlDatabase({
-                mysqlDatabaseId: primary.databaseId,
-            });
-            assertStatus(r, 200);
-            return {
-                type: "mysql",
-                version: r.data.version,
-            };
+            return this.determineMySQLDatabaseVersion(primary.databaseId);
         }
         return undefined;
     }

package/dist/lib/ddev/flags.d.ts

@@ -1,3 +1,12 @@
+import { InferredFlags } from "@oclif/core/lib/interfaces/index.js";
+declare const ddevDatabaseFlags: {
+    "database-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    "without-database": import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+};
 export declare const ddevFlags: {
+    "database-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    "without-database": import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     "override-type": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
 };
+export type DDEVDatabaseFlags = InferredFlags<typeof ddevDatabaseFlags>;
+export {};

package/dist/lib/ddev/flags.js

@@ -1,4 +1,20 @@
 import { Flags } from "@oclif/core";
+const ddevDatabaseFlags = {
+    "database-id": Flags.string({
+        summary: "ID of the application database",
+        description: "The ID of the database to use for the DDEV project; if set to 'auto', the command will use the database linked to the app installation.\n" +
+            "\n" +
+            "Setting a database ID (either automatically or manually) is required. To create a DDEV project without a database, set the --without-database flag.",
+        required: false,
+        default: undefined,
+    }),
+    "without-database": Flags.boolean({
+        summary: "Create a DDEV project without a database",
+        description: "Use this flag to create a DDEV project without a database; this is useful for projects that do not require a database.",
+        default: false,
+        exclusive: ["database-id"],
+    }),
+};
 export const ddevFlags = {
     "override-type": Flags.string({
         summary: "Override the type of the generated DDEV configuration",
@@ -7,4 +23,5 @@ export const ddevFlags = {
             "\n\n" +
             "See https://ddev.readthedocs.io/en/latest/users/configuration/config/#type for more information",
     }),
+    ...ddevDatabaseFlags,
 };

package/dist/lib/ddev/init_assert.d.ts

@@ -0,0 +1,3 @@
+import { ProcessRenderer } from "../../rendering/process/process.js";
+export declare function assertDDEVIsInstalled(r: ProcessRenderer): Promise<void>;
+export declare function determineDDEVVersion(r: ProcessRenderer): Promise<string>;

package/dist/lib/ddev/init_assert.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { hasBinary } from "../hasbin.js";
+import { promisify } from "util";
+import { exec } from "child_process";
+import { Value } from "../../rendering/react/components/Value.js";
+const execAsync = promisify(exec);
+export async function assertDDEVIsInstalled(r) {
+    await r.runStep("check if DDEV is installed", async () => {
+        if (!(await hasBinary("ddev"))) {
+            throw new Error("this command requires DDEV to be installed");
+        }
+    });
+}
+export async function determineDDEVVersion(r) {
+    const { stdout } = await execAsync("ddev --version");
+    const version = stdout.trim().replace(/^ddev version +/, "");
+    r.addInfo(_jsx(InfoDDEVVersion, { version: version }));
+    return version;
+}
+function InfoDDEVVersion({ version }) {
+    return (_jsxs(_Fragment, { children: ["detected DDEV version: ", _jsx(Value, { children: version })] }));
+}

package/dist/lib/ddev/init_database.d.ts

@@ -0,0 +1,19 @@
+import { ProcessRenderer } from "../../rendering/process/process.js";
+import { DDEVDatabaseFlags } from "./flags.js";
+import { type MittwaldAPIV2, type MittwaldAPIV2Client } from "@mittwald/api-client";
+type AppInstallation = MittwaldAPIV2.Components.Schemas.AppAppInstallation;
+/**
+ * Determines the database ID to use for the DDEV project.
+ *
+ * This is done according to the following rules (in order of precedence):
+ *
+ * 1. If the `--without-database` flag is set, do not use a database.
+ * 2. If the `--database-id` flag is set, use the database with the given ID.
+ * 3. If the app installation has a linked database with the purpose "primary", use
+ *    that database.
+ * 4. Otherwise, prompt the user to select a database from the list of databases
+ *    present in the project.
+ * 5. If interactive input is not available, terminate with an error.
+ */
+export declare function determineDDEVDatabaseId(r: ProcessRenderer, apiClient: MittwaldAPIV2Client, flags: DDEVDatabaseFlags, appInstallation: AppInstallation): Promise<string | undefined>;
+export {};

package/dist/lib/ddev/init_database.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { assertStatus, } from "@mittwald/api-client";
+import { Value } from "../../rendering/react/components/Value.js";
+import { Text } from "ink";
+/**
+ * Determines the database ID to use for the DDEV project.
+ *
+ * This is done according to the following rules (in order of precedence):
+ *
+ * 1. If the `--without-database` flag is set, do not use a database.
+ * 2. If the `--database-id` flag is set, use the database with the given ID.
+ * 3. If the app installation has a linked database with the purpose "primary", use
+ *    that database.
+ * 4. Otherwise, prompt the user to select a database from the list of databases
+ *    present in the project.
+ * 5. If interactive input is not available, terminate with an error.
+ */
+export async function determineDDEVDatabaseId(r, apiClient, flags, appInstallation) {
+    let databaseId = flags["database-id"];
+    const withoutDatabase = flags["without-database"];
+    if (withoutDatabase) {
+        return undefined;
+    }
+    if (databaseId === undefined) {
+        databaseId = (appInstallation.linkedDatabases ?? []).find((db) => db.purpose === "primary")?.databaseId;
+    }
+    if (databaseId !== undefined) {
+        const mysqlDatabaseResponse = await apiClient.database.getMysqlDatabase({
+            mysqlDatabaseId: databaseId,
+        });
+        assertStatus(mysqlDatabaseResponse, 200);
+        r.addInfo(_jsx(InfoDatabase, { name: mysqlDatabaseResponse.data.name }));
+        return mysqlDatabaseResponse.data.name;
+    }
+    return await promptDatabaseFromUser(r, apiClient, appInstallation);
+}
+async function promptDatabaseFromUser(r, apiClient, appInstallation) {
+    const { projectId } = appInstallation;
+    if (!projectId) {
+        throw new Error("app installation has no project ID");
+    }
+    const mysqlDatabaseResponse = await apiClient.database.listMysqlDatabases({
+        projectId,
+    });
+    assertStatus(mysqlDatabaseResponse, 200);
+    return await r.addSelect("select the database to use", [
+        ...mysqlDatabaseResponse.data.map((db) => ({
+            value: db.name,
+            label: `${db.name} (${db.description})`,
+        })),
+        {
+            value: undefined,
+            label: "no database",
+        },
+    ]);
+}
+function InfoDatabase({ name }) {
+    return (_jsxs(Text, { children: ["using database: ", _jsx(Value, { children: name })] }));
+}

package/dist/lib/error/InteractiveInputRequiredError.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error thrown when a command requires interactive input, but the current
+ * terminal environment does not support it.
+ */
+export default class InteractiveInputRequiredError extends Error {
+    constructor();
+}

package/dist/lib/error/InteractiveInputRequiredError.js

@@ -0,0 +1,11 @@
+/**
+ * Error thrown when a command requires interactive input, but the current
+ * terminal environment does not support it.
+ */
+export default class InteractiveInputRequiredError extends Error {
+    constructor() {
+        super("This command requires an interactive input, but the current environment " +
+            "does not support it. Please have a look at this command's --help page " +
+            "to learn how to pass the required input non-interactively.");
+    }
+}

package/dist/rendering/process/components/InteractiveInputDisabled.d.ts

@@ -0,0 +1 @@
+export declare const InteractiveInputDisabled: () => import("react/jsx-runtime").JSX.Element;

package/dist/rendering/process/components/InteractiveInputDisabled.js

@@ -0,0 +1,3 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from "ink";
+export const InteractiveInputDisabled = () => (_jsx(Text, { color: "red", children: "interactive input required; inspect this command's --help page to learn how to pass the required input non-interactively." }));

package/dist/rendering/process/components/ProcessInput.js

@@ -4,7 +4,7 @@ import { ProcessStateIcon } from "./ProcessStateIcon.js";
 import { ProcessState } from "./ProcessState.js";
 import { Box, Text, useStdin } from "ink";
 import TextInput from "ink-text-input";
-const InteractiveInputDisabled = () => (_jsx(Text, { color: "red", children: "interactive input required; inspect this command's --help page to learn how to pass the required input non-interactively." }));
+import { InteractiveInputDisabled } from "./InteractiveInputDisabled.js";
 export const ProcessInput = ({ step, onSubmit }) => {
     const [value, setValue] = useState("");
     if (!step.value) {

package/dist/rendering/process/components/ProcessSelect.d.ts

@@ -0,0 +1,6 @@
+import { ProcessStepSelect } from "../process.js";
+export declare function ProcessSelect<TVal>({ step, onSubmit, onError, }: {
+    step: ProcessStepSelect<TVal>;
+    onSubmit: (_: TVal) => void;
+    onError?: (err: unknown) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/rendering/process/components/ProcessSelect.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { ProcessStateIcon } from "./ProcessStateIcon.js";
+import { ProcessState } from "./ProcessState.js";
+import { Box, Text, useInput, useStdin } from "ink";
+import { InteractiveInputDisabled } from "./InteractiveInputDisabled.js";
+import InteractiveInputRequiredError from "../../../lib/error/InteractiveInputRequiredError.js";
+function useSelectControls(initial, length, onSelect) {
+    const { isRawModeSupported } = useStdin();
+    const [value, setValue] = useState(initial);
+    const [extraUsageHint, setExtraUsageHint] = useState(false);
+    if (!isRawModeSupported) {
+        return {
+            value: undefined,
+            extraUsageHint: false,
+        };
+    }
+    useInput((_, key) => {
+        if (key.return) {
+            if (value !== undefined) {
+                setValue(value);
+                onSelect(value);
+            }
+            else {
+                setExtraUsageHint(true);
+            }
+        }
+        else if (key.downArrow) {
+            setExtraUsageHint(false);
+            setValue((prev) => prev === undefined ? 0 : Math.min(length - 1, prev + 1));
+        }
+        else if (key.upArrow) {
+            setExtraUsageHint(false);
+            setValue((prev) => (prev === undefined ? 0 : Math.max(prev - 1, 0)));
+        }
+    });
+    return {
+        value,
+        extraUsageHint,
+    };
+}
+export function ProcessSelect({ step, onSubmit, onError, }) {
+    const { value, extraUsageHint } = useSelectControls(Math.max(step.options.findIndex((o) => o.value === step.selected), 0), step.options.length, (idx) => onSubmit(step.options[idx].value));
+    const { isRawModeSupported } = useStdin();
+    if (step.selected === undefined) {
+        if (!isRawModeSupported) {
+            useEffect(() => {
+                onError && onError(new InteractiveInputRequiredError());
+            });
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginX: 2, children: [_jsx(ProcessStateIcon, { step: step }), _jsxs(Text, { children: [step.title, ": "] })] }), _jsx(Box, { marginX: 8, children: _jsx(InteractiveInputDisabled, {}) })] }));
+        }
+        return (_jsxs(_Fragment, { children: [_jsxs(Box, { marginX: 2, children: [_jsx(ProcessStateIcon, { step: step }), _jsxs(Text, { children: [step.title, ": "] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(SelectUsageHint, { extraHint: extraUsageHint }), step.options.map((option, index) => (_jsx(SelectOption, { selected: index === value, label: option.label }, index)))] })] }));
+    }
+    return _jsx(ProcessState, { step: step });
+}
+function SelectUsageHint({ extraHint }) {
+    return (_jsx(Box, { marginLeft: 4, children: _jsx(Text, { color: extraHint ? "red" : "gray", bold: extraHint, children: "(use the up and down keys to select an option)" }) }));
+}
+function SelectOption({ selected, label, }) {
+    return (_jsx(Box, { marginLeft: 4, children: _jsxs(Text, { color: "blue", children: [selected ? "👉︎ " : "   ", label] }) }));
+}

package/dist/rendering/process/components/ProcessSelectStateSummary.d.ts

@@ -0,0 +1,4 @@
+import { ProcessStepSelect } from "../process.js";
+export declare function ProcessSelectStateSummary<TVal>({ step, }: {
+    step: ProcessStepSelect<TVal>;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/rendering/process/components/ProcessSelectStateSummary.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text } from "ink";
+export function ProcessSelectStateSummary({ step, }) {
+    if (step.selected) {
+        return (_jsxs(_Fragment, { children: [_jsx(Text, { children: ": " }), _jsx(Text, { color: "green", children: step.options.find((o) => o.value === step.selected)?.label })] }));
+    }
+    else {
+        return _jsx(Text, { children: ": " });
+    }
+}

package/dist/rendering/process/components/ProcessStateIcon.js

@@ -4,7 +4,9 @@ export const ProcessStateIcon = ({ step }) => {
     if (step.type === "info") {
         return _jsx(Text, { children: "\uD83D\uDCA1 " });
     }
-    else if (step.type === "confirm" || step.type === "input") {
+    else if (step.type === "confirm" ||
+        step.type === "input" ||
+        step.type === "select") {
         return _jsx(Text, { children: "\u2753" });
     }
     else if (step.phase === "completed") {

package/dist/rendering/process/components/ProcessStateSummary.js

@@ -2,6 +2,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { ProcessConfirmationStateSummary } from "./ProcessConfirmationStateSummary.js";
 import { ProcessInputStateSummary } from "./ProcessInputStateSummary.js";
 import { Text } from "ink";
+import { ProcessSelectStateSummary } from "./ProcessSelectStateSummary.js";
 export const ProcessStateSummary = ({ step, }) => {
     if (step.type === "info") {
         return _jsx(_Fragment, {});
@@ -12,6 +13,9 @@ export const ProcessStateSummary = ({ step, }) => {
     else if (step.type === "input") {
         return _jsx(ProcessInputStateSummary, { step: step });
     }
+    else if (step.type === "select") {
+        return _jsx(ProcessSelectStateSummary, { step: step });
+    }
     else if (step.phase === "completed") {
         return (_jsxs(_Fragment, { children: [_jsx(Text, { children: ". " }), _jsx(Text, { color: "green", children: "done" })] }));
     }

package/dist/rendering/process/process.d.ts

@@ -22,7 +22,16 @@ export type ProcessStepInput = {
     mask?: boolean;
     value?: string;
 };
-export type ProcessStep = ProcessStepInfo | ProcessStepRunnable | ProcessStepConfirm | ProcessStepInput;
+export type ProcessStepSelect<TVal> = {
+    type: "select";
+    title: ReactNode;
+    options: {
+        value: TVal;
+        label: ReactNode;
+    }[];
+    selected?: TVal;
+};
+export type ProcessStep = ProcessStepInfo | ProcessStepRunnable | ProcessStepConfirm | ProcessStepInput | ProcessStepSelect<unknown>;
 export type CleanupFunction = {
     title: ReactNode;
     fn: () => Promise<unknown>;
@@ -49,6 +58,10 @@ export interface ProcessRenderer {
     addInfo(title: ReactElement): void;
     addConfirmation(question: ReactElement): Promise<boolean>;
     addInput(question: ReactNode, mask?: boolean): Promise<string>;
+    addSelect<TVal>(question: ReactNode, options: {
+        value: TVal;
+        label: ReactNode;
+    }[]): Promise<TVal>;
     addCleanup(title: ReactNode, fn: () => Promise<unknown>): void;
     complete(summary: ReactElement): Promise<void>;
     error(err: unknown): Promise<void>;

package/dist/rendering/process/process_fancy.d.ts

@@ -11,6 +11,10 @@ export declare class FancyProcessRenderer implements ProcessRenderer {
     runStep<TRes>(title: ReactNode, fn: () => Promise<TRes>): Promise<TRes>;
     addInfo(title: ReactElement): void;
     addInput(question: React.ReactElement, mask?: boolean): Promise<string>;
+    addSelect<TVal>(question: React.ReactNode, options: {
+        value: TVal;
+        label: React.ReactNode;
+    }[]): Promise<TVal>;
     addConfirmation(question: ReactElement): Promise<boolean>;
     complete(summary: ReactElement): Promise<void>;
     error(err: unknown): Promise<void>;

package/dist/rendering/process/process_fancy.js

@@ -5,6 +5,7 @@ import { Box, render, Text } from "ink";
 import { ProcessState } from "./components/ProcessState.js";
 import { ProcessConfirmation } from "./components/ProcessConfirmation.js";
 import { ProcessInput } from "./components/ProcessInput.js";
+import { ProcessSelect } from "./components/ProcessSelect.js";
 export class FancyProcessRenderer {
     title;
     started = false;
@@ -78,6 +79,35 @@ export class FancyProcessRenderer {
             const renderHandle = render(_jsx(ProcessInput, { step: state, onSubmit: onInput }));
         });
     }
+    addSelect(question, options) {
+        this.start();
+        if (this.currentHandler !== null) {
+            this.currentHandler.complete();
+        }
+        const state = {
+            type: "select",
+            title: question,
+            options,
+            selected: undefined,
+        };
+        return new Promise((res, rej) => {
+            const onSelect = (selected) => {
+                res(selected);
+                state.selected = selected;
+                if (renderHandle) {
+                    renderHandle.rerender(_jsx(ProcessSelect, { step: state, onSubmit: onSelect }));
+                    renderHandle.unmount();
+                }
+            };
+            const onError = (err) => {
+                if (renderHandle) {
+                    renderHandle.unmount();
+                }
+                rej(err);
+            };
+            const renderHandle = render(_jsx(ProcessSelect, { step: state, onSubmit: onSelect, onError: onError }));
+        });
+    }
     addConfirmation(question) {
         this.start();
         if (this.currentHandler !== null) {

package/dist/rendering/process/process_quiet.d.ts

@@ -10,6 +10,7 @@ export declare class SilentProcessRenderer implements ProcessRenderer {
     error(err: unknown): Promise<void>;
     addConfirmation(): Promise<boolean>;
     addInput(): Promise<string>;
+    addSelect<TVal>(): Promise<TVal>;
     addCleanup(_: ReactNode, fn: () => Promise<unknown>): void;
     private cleanup;
 }

package/dist/rendering/process/process_quiet.js

@@ -29,6 +29,9 @@ export class SilentProcessRenderer {
     addInput() {
         throw new Error("no interactive input available in quiet mode");
     }
+    addSelect() {
+        throw new Error("no interactive input available in quiet mode");
+    }
     addCleanup(_, fn) {
         this.cleanupFns.push(fn);
     }

package/dist/rendering/react/components/ErrorBox.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from "ink";
-import Link from "ink-link";
 import { FailedFlagValidationError, RequiredArgsError, } from "@oclif/core/lib/parser/errors.js";
 import { ApiClientError, } from "@mittwald/api-client-commons";
+import InteractiveInputRequiredError from "../../../lib/error/InteractiveInputRequiredError.js";
 const color = "red";
 const issueURL = "https://github.com/mittwald/cli/issues/new";
 const boxProps = {
@@ -16,8 +16,8 @@ const boxProps = {
 const ErrorStack = ({ err }) => {
     return (_jsxs(Box, { marginX: 2, marginY: 1, flexDirection: "column", rowGap: 1, children: [_jsx(Text, { color: color, dimColor: true, bold: true, children: "ERROR STACK TRACE" }), _jsx(Text, { color: color, dimColor: true, children: "Please provide this when opening a bug report." }), _jsx(Text, { color: color, dimColor: true, children: err.stack })] }));
 };
-const GenericError = ({ err, withStack, }) => {
-    return (_jsxs(_Fragment, { children: [_jsxs(Box, { ...boxProps, borderColor: color, children: [_jsx(Text, { color: color, bold: true, underline: true, children: "ERROR" }), _jsx(Text, { color: color, children: "An error occurred while executing this command:" }), _jsx(Box, { marginX: 2, children: _jsx(Text, { color: color, children: err.toString() }) }), _jsxs(Text, { color: color, children: ["If you believe this to be a bug, please open an issue at", " ", _jsx(Link, { url: issueURL, children: issueURL }), "."] })] }), withStack && "stack" in err ? _jsx(ErrorStack, { err: err }) : undefined] }));
+const GenericError = ({ err, withStack, withIssue = true, title = "Error" }) => {
+    return (_jsxs(_Fragment, { children: [_jsxs(Box, { ...boxProps, borderColor: color, children: [_jsx(Text, { color: color, bold: true, underline: true, children: title.toUpperCase() }), _jsx(Text, { color: color, children: "An error occurred while executing this command:" }), _jsx(Box, { marginX: 2, children: _jsx(Text, { color: color, children: err.toString() }) }), withIssue ? (_jsxs(Text, { color: color, children: ["If you believe this to be a bug, please open an issue at ", issueURL, "."] })) : undefined] }), withStack && "stack" in err ? _jsx(ErrorStack, { err: err }) : undefined] }));
 };
 const InvalidFlagsError = ({ err }) => {
     const color = "yellow";
@@ -63,6 +63,9 @@ export const ErrorBox = ({ err }) => {
     else if (err instanceof ApiClientError) {
         return _jsx(ApiError, { err: err, withStack: true, withHTTPMessages: "body" });
     }
+    else if (err instanceof InteractiveInputRequiredError) {
+        return (_jsx(GenericError, { err: err, withStack: false, withIssue: false, title: "Input required" }));
+    }
     else if (err instanceof Error) {
         return _jsx(GenericError, { err: err, withStack: true });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/cli",
-  "version": "1.0.0-alpha.39",
+  "version": "1.0.0-alpha.40",
   "description": "Hand-crafted CLI for the mittwald API",
   "license": "MIT",
   "author": {