@mittwald/cli 1.11.2 → 1.12.0

package/dist/commands/app/copy.d.ts

@@ -10,6 +10,7 @@ export declare class Copy extends ExecRenderBaseCommand<typeof Copy, Result> {
     };
     static flags: {
         description: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "install-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     protected exec(): Promise<Result>;

package/dist/commands/app/copy.js

@@ -14,16 +14,21 @@ export class Copy extends ExecRenderBaseCommand {
             summary: "set a description for the new app installation",
             required: true,
         }),
+        "install-path": Flags.string({
+            summary: "set the installation path for the new app installation; if omitted, this will default to an autogenerated directory name",
+            required: false,
+        }),
     };
     async exec() {
         const appInstallationId = await this.withAppInstallationId(Copy);
-        const { description } = this.flags;
+        const { description, "install-path": installPath } = this.flags;
         const p = makeProcessRenderer(this.flags, "Copying app installation");
         const result = await p.runStep("requesting app copy", async () => {
             const r = await this.apiClient.app.requestAppinstallationCopy({
                 appInstallationId,
                 data: {
                     description,
+                    installationPath: installPath,
                 },
             });
             assertStatus(r, 201);

package/dist/commands/app/create/node.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const nodeInstaller: AppInstaller<"site-title" | "entrypoint">;
 export default class InstallNode extends ExecRenderBaseCommand<typeof InstallNode, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/create/php-worker.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const phpWorkerInstaller: AppInstaller<"site-title" | "entrypoint">;
 export default class InstallPhpWorker extends ExecRenderBaseCommand<typeof InstallPhpWorker, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/create/php.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const phpInstaller: AppInstaller<"site-title" | "document-root">;
 export default class InstallPhp extends ExecRenderBaseCommand<typeof InstallPhp, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("document-root" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("document-root" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/create/python.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const pythonInstaller: AppInstaller<"site-title" | "entrypoint">;
 export default class InstallPython extends ExecRenderBaseCommand<typeof InstallPython, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/create/static.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const staticInstaller: AppInstaller<"site-title" | "document-root">;
 export default class InstallStatic extends ExecRenderBaseCommand<typeof InstallStatic, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("document-root" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("document-root" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/contao.d.ts

@@ -3,7 +3,7 @@ import React from "react";
 import { AppInstallationResult } from "../../../lib/resources/app/Installer.js";
 export default class InstallContao extends ExecRenderBaseCommand<typeof InstallContao, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/joomla.d.ts

@@ -3,7 +3,7 @@ import React from "react";
 import { AppInstallationResult } from "../../../lib/resources/app/Installer.js";
 export default class InstallJoomla extends ExecRenderBaseCommand<typeof InstallJoomla, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/matomo.d.ts

@@ -3,7 +3,7 @@ import React from "react";
 import { AppInstallationResult } from "../../../lib/resources/app/Installer.js";
 export default class InstallMatomo extends ExecRenderBaseCommand<typeof InstallMatomo, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/nextcloud.d.ts

@@ -3,7 +3,7 @@ import React from "react";
 import { AppInstallationResult } from "../../../lib/resources/app/Installer.js";
 export default class InstallNextcloud extends ExecRenderBaseCommand<typeof InstallNextcloud, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/shopware5.d.ts

@@ -3,7 +3,7 @@ import React from "react";
 import { AppInstallationResult } from "../../../lib/resources/app/Installer.js";
 export default class InstallShopware5 extends ExecRenderBaseCommand<typeof InstallShopware5, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | "shop-email" | "shop-lang" | "shop-currency" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | "shop-email" | "shop-lang" | "shop-currency" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/shopware6.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const shopware6Installer: AppInstaller<"version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | "site-title" | "shop-email" | "shop-lang" | "shop-currency">;
 export default class InstallShopware6 extends ExecRenderBaseCommand<typeof InstallShopware6, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | "shop-email" | "shop-lang" | "shop-currency" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "admin-firstname" | "admin-lastname" | "shop-email" | "shop-lang" | "shop-currency" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/typo3.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const typo3Installer: AppInstaller<"version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "site-title" | "install-mode">;
 export default class InstallTYPO3 extends ExecRenderBaseCommand<typeof InstallTYPO3, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "install-mode" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "install-mode" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/install/wordpress.d.ts

@@ -4,7 +4,7 @@ import { AppInstallationResult, AppInstaller } from "../../../lib/resources/app/
 export declare const wordpressInstaller: AppInstaller<"version" | "host" | "admin-user" | "admin-email" | "admin-pass" | "site-title">;
 export default class InstallWordPress extends ExecRenderBaseCommand<typeof InstallWordPress, AppInstallationResult> {
     static description: string;
-    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | ("wait" | "wait-timeout" | "site-title"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("version" | "host" | "admin-user" | "admin-email" | "admin-pass" | ("wait" | "wait-timeout" | "site-title" | "install-path"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/open.d.ts

@@ -5,5 +5,8 @@ export declare class Open extends ExtendedBaseCommand<typeof Open> {
     static args: {
         "installation-id": import("@oclif/core/interfaces").Arg<string>;
     };
+    static flags: {
+        backend: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
     run(): Promise<void>;
 }

package/dist/commands/app/open.js

@@ -3,27 +3,53 @@ import open from "open";
 import { appInstallationArgs, withAppInstallationId, } from "../../lib/resources/app/flags.js";
 import { ExtendedBaseCommand } from "../../lib/basecommands/ExtendedBaseCommand.js";
 import buildAppURLsFromIngressList from "../../lib/resources/app/buildAppURLsFromIngressList.js";
+import { Flags } from "@oclif/core";
 export class Open extends ExtendedBaseCommand {
     static summary = "Open an app installation in the browser.";
     static description = "This command opens an app installation in the browser. For this to work, there needs to be at least one virtual host linked to the app installation.";
     static args = { ...appInstallationArgs };
+    static flags = {
+        backend: Flags.boolean({
+            summary: "open the backend of the app installation",
+            description: "If this flag is set, the backend of the app installation will be opened instead of the frontend. This flag is only available for some types of apps (like PHP and Node.js).",
+            default: false,
+            required: false,
+        }),
+    };
     async run() {
         const appInstallationId = await withAppInstallationId(this.apiClient, Open, this.flags, this.args, this.config);
         const installation = await this.apiClient.app.getAppinstallation({
             appInstallationId,
         });
         assertStatus(installation, 200);
-        const domains = await this.apiClient.domain.ingressListIngresses({
-            queryParameters: {
-                projectId: installation.data.projectId,
-            },
-        });
-        assertStatus(domains, 200);
-        const urls = buildAppURLsFromIngressList(domains.data, installation.data.id);
+        const [appVersion, domains] = await Promise.all([
+            (async () => {
+                const appVersion = await this.apiClient.app.getAppversion({
+                    appId: installation.data.appId,
+                    appVersionId: installation.data.appVersion.desired,
+                });
+                assertStatus(appVersion, 200);
+                return appVersion.data;
+            })(),
+            (async () => {
+                const domains = await this.apiClient.domain.ingressListIngresses({
+                    queryParameters: {
+                        projectId: installation.data.projectId,
+                    },
+                });
+                assertStatus(domains, 200);
+                return domains.data;
+            })(),
+        ]);
+        const urls = buildAppURLsFromIngressList(domains, installation.data.id);
         if (urls.length === 0) {
             throw new Error("This app installation is not linked to any virtual hosts.");
         }
-        console.log("opening " + urls[0]);
-        await open(urls[0]);
+        let url = urls[0];
+        if (this.flags.backend && appVersion.backendPathTemplate) {
+            url = appVersion.backendPathTemplate.replace("{domain}", url.replace(/\/$/, ""));
+        }
+        console.log("opening " + url);
+        await open(url);
     }
 }

package/dist/commands/container/port-forward.js

@@ -28,8 +28,8 @@ export class PortForward extends ExecRenderBaseCommand {
             required: true,
         }),
         port: PortMapping.arg({
-            summary: "Port mapping in the format 'local-port:container-port'",
-            description: "Specifies the port mapping between your local machine and the container. Format: 'local-port:container-port'. If not specified, available ports will be detected automatically.",
+            summary: "Port mapping in the format 'local-port:container-port' or 'port'",
+            description: "Specifies the port mapping between your local machine and the container. Format: 'local-port:container-port' or just 'port' (in which case the same port is used locally and in the container). If not specified, available ports will be detected automatically.",
             required: false,
         }),
     };

package/dist/commands/container/run.d.ts

@@ -19,6 +19,8 @@ export declare class Run extends ExecRenderBaseCommand<typeof Run, Result> {
         "publish-all": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         volume: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "create-volumes": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        cpus: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        memory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "project-id": import("@oclif/core/interfaces").OptionFlag<string>;
         quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
@@ -46,6 +48,13 @@ export declare class Run extends ExecRenderBaseCommand<typeof Run, Result> {
      *   or undefined if no specific command is set.
      */
     private buildContainerCommand;
+    /**
+     * Builds the deploy.resources structure from command line flags
+     *
+     * @returns The deploy configuration with resource limits, or undefined if no
+     *   limits are specified
+     */
+    private buildDeployResources;
     /**
      * Builds a container service request from command line arguments and image
      * metadata

package/dist/commands/container/run.js

@@ -48,10 +48,10 @@ export class Run extends ExecRenderBaseCommand {
             required: false,
         }),
         publish: Flags.string({
-            summary: "publish a container's port(s) to the host",
-            description: "Map a container's port to a port on the host system. " +
-                "Format: <host-port>:<container-port> or just <container-port> (in which case the host port will be automatically assigned). " +
-                "For example, --publish 8080:80 maps port 80 in the container to port 8080 on the host. " +
+            summary: "publish a container's port(s)",
+            description: "Expose a container's port within the cluster. " +
+                "Format: <cluster-port>:<container-port> or just <port> (in which case the same port is used for both cluster and container). " +
+                "For example, --publish 8080:80 maps port 80 in the container to port 8080 within the cluster, while --publish 8080 exposes port 8080 as port 8080. " +
                 "Use multiple --publish flags to publish multiple ports.\n\n" +
                 "NOTE: Please note that the usual shorthand -p is not supported for this flag, as it would conflict with the --project flag.",
             required: false,
@@ -83,6 +83,19 @@ export class Run extends ExecRenderBaseCommand {
             required: false,
             default: false,
         }),
+        cpus: Flags.string({
+            summary: "set CPU limit for the container",
+            description: "Specify the number of CPUs available to the container (e.g., '0.5', '1', '2'). " +
+                "This is equivalent to the docker run --cpus flag or the deploy.resources.limits.cpus field in docker-compose.",
+            required: false,
+        }),
+        memory: Flags.string({
+            summary: "set memory limit for the container",
+            description: "Specify the maximum amount of memory the container can use (e.g., '512m', '1g', '2g'). " +
+                "This is equivalent to the docker run --memory flag or the deploy.resources.limits.memory field in docker-compose.",
+            required: false,
+            char: "m",
+        }),
     };
     static args = {
         image: Args.string({
@@ -180,6 +193,29 @@ export class Run extends ExecRenderBaseCommand {
         const command = [this.args.command, ...this.argv.slice(firstArg)];
         return command;
     }
+    /**
+     * Builds the deploy.resources structure from command line flags
+     *
+     * @returns The deploy configuration with resource limits, or undefined if no
+     *   limits are specified
+     */
+    buildDeployResources() {
+        if (!this.flags.cpus && !this.flags.memory) {
+            return undefined;
+        }
+        const limits = {};
+        if (this.flags.cpus) {
+            limits.cpus = this.flags.cpus;
+        }
+        if (this.flags.memory) {
+            limits.memory = this.flags.memory;
+        }
+        return {
+            resources: {
+                limits,
+            },
+        };
+    }
     /**
      * Builds a container service request from command line arguments and image
      * metadata
@@ -198,6 +234,7 @@ export class Run extends ExecRenderBaseCommand {
         const environment = await parseEnvironmentVariables(this.flags.env, this.flags["env-file"]);
         const ports = getPortMappings(imageMeta, this.flags["publish-all"], this.flags.publish);
         const volumes = this.flags.volume;
+        const deploy = this.buildDeployResources();
         return {
             image,
             command,
@@ -206,6 +243,7 @@ export class Run extends ExecRenderBaseCommand {
             environment,
             ports,
             volumes,
+            deploy,
         };
     }
     async getImageAndMeta(projectId) {

package/dist/commands/container/update.js

@@ -50,8 +50,8 @@ export class Update extends ExecRenderBaseCommand {
         }),
         publish: Flags.string({
             summary: "update the container's port mappings",
-            description: "Map a container's port to a port on the host system. " +
-                "Format: <host-port>:<container-port> or just <container-port> (in which case the host port will be automatically assigned). " +
+            description: "Expose a container's port within the cluster. " +
+                "Format: <cluster-port>:<container-port> or just <port> (in which case the same port is used for both cluster and container). " +
                 "Use multiple -p flags to publish multiple ports.",
             required: false,
             multiple: true,

package/dist/commands/database/mysql/create.js

@@ -30,7 +30,7 @@ export class Create extends ExecRenderBaseCommand {
             default: "utf8mb4",
         }),
         "user-password": Flags.string({
-            summary: "the password to use for the default user (env: MYSQL_PWD)",
+            summary: "the password to use for the default user",
             env: "MYSQL_PWD",
         }),
         "user-external": Flags.boolean({

package/dist/lib/resources/app/Installer.d.ts

@@ -5,7 +5,7 @@ import { MittwaldAPIV2, MittwaldAPIV2Client } from "@mittwald/api-client";
 import { Config } from "@oclif/core";
 type AppVersion = MittwaldAPIV2.Components.Schemas.AppAppVersion;
 type AppInstallation = MittwaldAPIV2.Components.Schemas.AppAppInstallation;
-type ImplicitDefaultFlag = "wait" | "wait-timeout" | "site-title";
+type ImplicitDefaultFlag = "wait" | "wait-timeout" | "site-title" | "install-path";
 export interface AppInstallationResult {
     appInstallation: AppInstallation;
     appVersion: AppVersion;

package/dist/lib/resources/app/Installer.js

@@ -25,7 +25,13 @@ export class AppInstaller {
         this.description = AppInstaller.makeDescription(appName);
     }
     get flags() {
-        const flags = provideSupportedFlags([...this.appSupportedFlags, "wait", "wait-timeout", "site-title"], this.appName);
+        const flags = provideSupportedFlags([
+            ...this.appSupportedFlags,
+            "wait",
+            "wait-timeout",
+            "site-title",
+            "install-path",
+        ], this.appName);
         if (this.mutateFlags) {
             this.mutateFlags(flags);
         }

package/dist/lib/resources/app/flags.d.ts

@@ -22,6 +22,7 @@ type AvailableFlags = typeof waitFlags & {
     "shop-lang": OptionFlag<string | undefined>;
     "shop-currency": OptionFlag<string | undefined>;
     "install-mode": OptionFlag<string>;
+    "install-path": OptionFlag<string>;
     "document-root": OptionFlag<string>;
     "opensearch-host": OptionFlag<string>;
     "opensearch-port": OptionFlag<string>;

package/dist/lib/resources/app/flags.js

@@ -113,6 +113,12 @@ function buildFlagsWithDescription(appName) {
             options: ["composer", "symlink"],
             default: "composer",
         }),
+        "install-path": Flags.string({
+            required: false,
+            summary: `the installation path of your ${appName} application`,
+            description: "This is the path where your application will be installed. If omitted, this will default to an automatically-generated path.",
+            default: undefined,
+        }),
         "document-root": Flags.string({
             required: true,
             summary: `the document root from which your ${appName} will be served (relative to the installation path)`,

package/dist/lib/resources/app/install.d.ts

@@ -5,6 +5,7 @@ type AppAppVersion = MittwaldAPIV2.Components.Schemas.AppAppVersion;
 export declare function triggerAppInstallation(apiClient: MittwaldAPIV2Client, process: ProcessRenderer, projectId: string, flags: {
     "site-title": string;
     "document-root"?: string;
+    "install-path"?: string;
 } & {
     [k: string]: unknown;
 }, appVersion: AppAppVersion): Promise<AppAppInstallation>;

package/dist/lib/resources/app/install.js

@@ -7,6 +7,7 @@ export async function triggerAppInstallation(apiClient, process, projectId, flag
                 appVersionId: appVersion.id,
                 description: flags["site-title"],
                 updatePolicy: "none",
+                installationPath: flags["install-path"],
                 userInputs: Object.keys(flags).map((k) => ({
                     name: k.replace("-", "_"),
                     value: flags[k],

package/dist/lib/resources/database/mysql/flags.js

@@ -3,7 +3,7 @@ import { assertStatus } from "@mittwald/api-client-commons";
 export const mysqlConnectionFlags = {
     "mysql-password": Flags.string({
         char: "p",
-        summary: "the password to use for the MySQL user (env: MYSQL_PWD)",
+        summary: "the password to use for the MySQL user",
         description: `\
 The password to use for the MySQL user. If not provided, the environment variable MYSQL_PWD will be used. If that is not set either, the command will interactively ask for the password.
 

package/dist/lib/units/PortMapping.d.ts

@@ -4,6 +4,8 @@ export default class PortMapping {
     readonly remotePort: number;
     constructor(localPort: number, remotePort: number);
     private static validatePort;
+    private static isValidPortString;
+    private static parseAndValidatePort;
     static arg: import("@oclif/core/interfaces").ArgDefinition<PortMapping, Record<string, unknown>>;
     /** @param str Port and protocol; example: `8080/tcp` */
     static fromPortAndProtocol(str: string): PortMapping;

package/dist/lib/units/PortMapping.js

@@ -10,6 +10,19 @@ export default class PortMapping {
     static validatePort(port) {
         return !isNaN(port) && port > 0 && port <= 65535;
     }
+    static isValidPortString(str) {
+        return /^\d+$/.test(str);
+    }
+    static parseAndValidatePort(str) {
+        if (!PortMapping.isValidPortString(str)) {
+            throw new Error("Invalid port number. Ports must be between 1 and 65535.");
+        }
+        const portNum = parseInt(str);
+        if (!PortMapping.validatePort(portNum)) {
+            throw new Error("Invalid port number. Ports must be between 1 and 65535.");
+        }
+        return portNum;
+    }
     static arg = Args.custom({
         parse: async (input) => PortMapping.fromString(input),
     });
@@ -26,13 +39,15 @@ export default class PortMapping {
         return new PortMapping(portNum, portNum);
     }
     static fromString(str) {
-        const [localPort, remotePort] = str.split(":");
-        const localPortNum = parseInt(localPort);
-        const remotePortNum = parseInt(remotePort);
-        if (!PortMapping.validatePort(localPortNum) ||
-            !PortMapping.validatePort(remotePortNum)) {
-            throw new Error("Invalid port number. Ports must be between 1 and 65535.");
+        const parts = str.split(":");
+        // If only one part, use it for both local and remote port
+        if (parts.length === 1) {
+            const portNum = PortMapping.parseAndValidatePort(parts[0]);
+            return new PortMapping(portNum, portNum);
         }
+        const [localPort, remotePort] = parts;
+        const localPortNum = PortMapping.parseAndValidatePort(localPort);
+        const remotePortNum = PortMapping.parseAndValidatePort(remotePort);
         return new PortMapping(localPortNum, remotePortNum);
     }
 }

package/dist/lib/units/PortMapping.test.js

@@ -7,6 +7,12 @@ describe("PortMapping", () => {
         expect(result.localPort).toBe(8080);
         expect(result.remotePort).toBe(9090);
     });
+    // Test: Successfully parse single integer as identical local and remote port
+    it("should correctly parse single integer to identical ports", () => {
+        const result = PortMapping.fromString("8080");
+        expect(result.localPort).toBe(8080);
+        expect(result.remotePort).toBe(8080);
+    });
     // Test: Throws an error for invalid local port
     it("should throw an error for invalid local port", () => {
         expect(() => PortMapping.fromString("100000:8080")).toThrow("Invalid port number. Ports must be between 1 and 65535.");
@@ -19,6 +25,10 @@ describe("PortMapping", () => {
     it("should throw an error for invalid string format", () => {
         expect(() => PortMapping.fromString("8080-9090")).toThrow("Invalid port number. Ports must be between 1 and 65535.");
     });
+    // Test: Throws an error for invalid single port
+    it("should throw an error for invalid single port", () => {
+        expect(() => PortMapping.fromString("100000")).toThrow("Invalid port number. Ports must be between 1 and 65535.");
+    });
     // Test: Successfully assign local and remote ports via constructor
     it("should correctly initialize PortMapping with valid ports", () => {
         const portMapping = new PortMapping(3000, 4000);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/cli",
-  "version": "1.11.2",
+  "version": "1.12.0",
   "description": "Hand-crafted CLI for the mittwald API",
   "license": "MIT",
   "author": {