@mittwald/cli 1.12.0 → 1.13.1-beta.6

package/README.md

@@ -42,6 +42,9 @@ using NPM; remember to run `npm upgrade -g @mittwald/cli` occasionally.
 $ npm install -g @mittwald/cli
 ```
 
+Attention! When installing via `-g` flag, make sure you have nodejs >= 20.7.0
+installed, as package definition is ignored for global installations!
+
 #### Any OS, using Docker
 
 There is also the
@@ -101,6 +104,7 @@ USAGE
 ...
 ```
 
+<!-- prettier-ignore-start -->
 <!-- commands -->
 # Command Topics
 
@@ -130,3 +134,4 @@ USAGE
 * [`mw volume`](docs/volume.md) - Manage volumes
 
 <!-- commandsstop -->
+<!-- prettier-ignore-end -->

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" | "install-path"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title" | "install-path" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title" | "install-path" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("document-root" | ("wait" | "wait-timeout" | "site-title" | "install-path" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("entrypoint" | ("wait" | "wait-timeout" | "site-title" | "install-path" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    static flags: import("@oclif/core/interfaces").FlagInput<import("../../../lib/resources/app/flags.js").RelevantFlags<readonly ("document-root" | ("wait" | "wait-timeout" | "site-title" | "install-path" | "update-context"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

package/dist/commands/app/dependency/update.js

@@ -5,7 +5,8 @@ import { makeProcessRenderer, processFlags, } from "../../../rendering/process/p
 import { Flags } from "@oclif/core";
 import { assertStatus } from "@mittwald/api-client-commons";
 import { Success } from "../../../rendering/react/components/Success.js";
-import { Range, SemVer } from "semver";
+import { Range } from "semver";
+import { compareVersionsBy } from "../../../lib/resources/app/versions.js";
 export default class Update extends ExecRenderBaseCommand {
     static summary = "Update the dependencies of an app";
     static args = { ...appInstallationArgs };
@@ -82,7 +83,7 @@ export default class Update extends ExecRenderBaseCommand {
             });
             assertStatus(r, 204);
         });
-        process.complete(_jsx(Success, { children: "The dependencies of this app were successfully updated!" }));
+        await process.complete(_jsx(Success, { children: "The dependencies of this app were successfully updated!" }));
     }
     async getVersions(p, systemSoftware, versionRange) {
         const versions = await p.runStep(`fetching versions for ${systemSoftware.name}`, async () => {
@@ -95,10 +96,7 @@ export default class Update extends ExecRenderBaseCommand {
             assertStatus(r, 200);
             return r.data;
         });
-        versions.sort((a, b) => {
-            return (new SemVer(a.externalVersion).compare(new SemVer(b.externalVersion)) *
-                -1);
-        });
+        versions.sort(compareVersionsBy("internal"));
         return versions;
     }
     render() {

package/dist/commands/app/dependency/versions.js

@@ -1,7 +1,7 @@
 import { assertStatus } from "@mittwald/api-client-commons";
 import { ListBaseCommand, } from "../../../lib/basecommands/ListBaseCommand.js";
-import { SemVer } from "semver";
 import { Args } from "@oclif/core";
+import { compareVersionsBy } from "../../../lib/resources/app/versions.js";
 export class Versions extends ListBaseCommand {
     static description = "Get all available versions of a particular dependency";
     static args = {
@@ -13,7 +13,7 @@ export class Versions extends ListBaseCommand {
     static flags = {
         ...ListBaseCommand.baseFlags,
     };
-    sorter = (a, b) => new SemVer(a.externalVersion).compare(b.externalVersion);
+    sorter = compareVersionsBy("internal");
     async getData() {
         const systemSoftwareName = this.args["systemsoftware"];
         const systemSoftwares = await this.apiClient.app.listSystemsoftwares({});
@@ -22,7 +22,7 @@ export class Versions extends ListBaseCommand {
         if (!systemSoftware) {
             throw new Error(`system software ${systemSoftwareName} not found`);
         }
-        return await this.apiClient.app.listSystemsoftwareversions({
+        return this.apiClient.app.listSystemsoftwareversions({
             systemSoftwareId: systemSoftware.id,
         });
     }

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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     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" | "install-path"))[]>>;
+    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" | "update-context"))[]>>;
     protected exec(): Promise<AppInstallationResult>;
     protected render(result: AppInstallationResult): React.ReactNode;
 }

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

@@ -5,6 +5,7 @@ export declare class Logs extends BaseCommand {
     static aliases: string[];
     static flags: {
         "no-pager": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        tail: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "project-id": import("@oclif/core/interfaces").OptionFlag<string>;
         token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/container/logs.js

@@ -17,6 +17,11 @@ export class Logs extends BaseCommand {
         "no-pager": Flags.boolean({
             description: "Disable pager for output.",
         }),
+        tail: Flags.integer({
+            char: "t",
+            description: "Number of lines to show from the end of the logs (minimum: 1).",
+            min: 1,
+        }),
     };
     static args = {
         "container-id": Args.string({
@@ -31,6 +36,9 @@ export class Logs extends BaseCommand {
         const logsResp = await this.apiClient.container.getServiceLogs({
             stackId,
             serviceId,
+            queryParameters: {
+                ...(flags.tail && { tail: flags.tail }),
+            },
         });
         assertStatus(logsResp, 200);
         // This is to work around a bug which causes the response to

package/dist/commands/context/get.js

@@ -42,6 +42,7 @@ const GetContext = ({ ctx }) => {
         "server-id",
         "org-id",
         "installation-id",
+        "stack-id",
     ]) {
         const value = usePromise(ctx.getContextValue.bind(ctx), [key]);
         if (value) {

package/dist/commands/database/mysql/create.d.ts

@@ -13,7 +13,7 @@ export declare class Create extends ExecRenderBaseCommand<typeof Create, Result>
         "character-set": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "user-password": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "user-external": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "user-access-level": import("@oclif/core/interfaces").OptionFlag<"full" | "readonly", import("@oclif/core/interfaces").CustomOptions>;
+        "user-access-level": import("@oclif/core/interfaces").OptionFlag<"full", import("@oclif/core/interfaces").CustomOptions>;
         quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "project-id": import("@oclif/core/interfaces").OptionFlag<string>;
     };

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

@@ -39,7 +39,8 @@ export class Create extends ExecRenderBaseCommand {
         }),
         "user-access-level": Flags.custom({
             summary: "the access level preset for the default user",
-            options: ["full", "readonly"],
+            deprecated: true,
+            options: ["full"],
             default: "full",
         })(),
     };

package/dist/commands/ddev/init.js

@@ -46,7 +46,7 @@ export class Init extends ExecRenderBaseCommand {
             summary: "override the mittwald plugin",
             helpGroup: "Development",
             description: "This flag allows you to override the mittwald plugin that should be installed by default; this is useful for testing purposes",
-            default: "mittwald/ddev",
+            default: "mittwald/ddev-mittwald",
         }),
     };
     static args = {
@@ -89,6 +89,7 @@ export class Init extends ExecRenderBaseCommand {
     async installMittwaldPlugin(r) {
         const { "override-mittwald-plugin": mittwaldPlugin } = this.flags;
         await spawnInProcess(r, "installing mittwald plugin", "ddev", [
+            "add-on",
             "get",
             mittwaldPlugin,
         ]);

package/dist/commands/org/invite/list-own.d.ts

@@ -33,6 +33,7 @@ export declare class List extends ListBaseCommand<typeof List, ResponseItem, Res
             creationDate: string;
             customerId: string;
             customerNumber: string;
+            deletionProhibitedBy?: ("hasOpenInvoices" | "hasActiveContracts" | "hasActiveExtensionSubscriptions" | "isActiveContributor")[] | undefined;
             executingUserRoles?: import("node_modules/@mittwald/api-client/dist/types/generated/v2/types.js").MittwaldAPIV2.Components.Schemas.CustomerRole[] | undefined;
             flags?: import("node_modules/@mittwald/api-client/dist/types/generated/v2/types.js").MittwaldAPIV2.Components.Schemas.CustomerCustomerFlag[] | undefined;
             isAllowedToPlaceOrders?: boolean | undefined;

package/dist/commands/org/membership/list-own.d.ts

@@ -33,6 +33,7 @@ export declare class ListOwn extends ListBaseCommand<typeof ListOwn, ResponseIte
             creationDate: string;
             customerId: string;
             customerNumber: string;
+            deletionProhibitedBy?: ("hasOpenInvoices" | "hasActiveContracts" | "hasActiveExtensionSubscriptions" | "isActiveContributor")[] | undefined;
             executingUserRoles?: import("node_modules/@mittwald/api-client/dist/types/generated/v2/types.js").MittwaldAPIV2.Components.Schemas.CustomerRole[] | undefined;
             flags?: import("node_modules/@mittwald/api-client/dist/types/generated/v2/types.js").MittwaldAPIV2.Components.Schemas.CustomerCustomerFlag[] | undefined;
             isAllowedToPlaceOrders?: boolean | undefined;

package/dist/commands/project/create.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Flags } from "@oclif/core";
 import { assertStatus } from "@mittwald/api-client-commons";
 import { serverFlags } from "../../lib/resources/server/flags.js";
@@ -7,6 +7,7 @@ import { Success } from "../../rendering/react/components/Success.js";
 import { makeProcessRenderer, processFlags, } from "../../rendering/process/process_flags.js";
 import { waitFlags, waitUntil } from "../../lib/wait.js";
 import Context from "../../lib/context/Context.js";
+import { Value } from "../../rendering/react/components/Value.js";
 export default class Create extends ExecRenderBaseCommand {
     static description = "Create a new project";
     static flags = {
@@ -19,7 +20,8 @@ export default class Create extends ExecRenderBaseCommand {
             description: "A description for the project.",
         }),
         "update-context": Flags.boolean({
-            description: "Update the CLI context to use the newly created project",
+            description: "update the CLI context to use the newly created project",
+            char: "c",
         }),
     };
     async exec() {
@@ -48,12 +50,16 @@ export default class Create extends ExecRenderBaseCommand {
             }, this.flags["wait-timeout"]);
             stepWaiting.complete();
         }
+        const projectResult = await this.apiClient.project.getProject({
+            projectId: result.data.id,
+        });
+        assertStatus(projectResult, 200);
         if (flags["update-context"]) {
             await process.runStep("updating CLI context", async () => {
                 await new Context(this.apiClient, this.config).setProjectId(result.data.id);
             });
         }
-        process.complete(_jsx(Success, { children: "Your new project was successfully created! \uD83D\uDE80" }));
+        await process.complete(_jsx(ProjectCreationSuccess, { shortId: projectResult.data.shortId }));
         return { projectId: result.data.id };
     }
     render({ projectId }) {
@@ -62,3 +68,6 @@ export default class Create extends ExecRenderBaseCommand {
         }
     }
 }
+function ProjectCreationSuccess({ shortId }) {
+    return (_jsxs(Success, { children: ["Your new project ", _jsx(Value, { children: shortId }), " was successfully created! \uD83D\uDE80"] }));
+}

package/dist/commands/stack/deploy.d.ts

@@ -8,10 +8,12 @@ export declare class Deploy extends ExecRenderBaseCommand<typeof Deploy, DeployR
     static aliases: string[];
     static flags: {
         "compose-file": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "from-template": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "env-file": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "stack-id": import("@oclif/core/interfaces").OptionFlag<string>;
     };
+    private loadStackDefinition;
     protected exec(): Promise<DeployResult>;
     protected render({ restartedServices }: DeployResult): ReactNode;
 }

package/dist/commands/stack/deploy.js

@@ -3,14 +3,16 @@ import { ExecRenderBaseCommand } from "../../lib/basecommands/ExecRenderBaseComm
 import { stackFlags, withStackId } from "../../lib/resources/stack/flags.js";
 import { Flags } from "@oclif/core";
 import { makeProcessRenderer, processFlags, } from "../../rendering/process/process_flags.js";
-import { loadStackFromFile } from "../../lib/resources/stack/loader.js";
+import { loadStackFromFile, loadStackFromStr, } from "../../lib/resources/stack/loader.js";
 import { assertStatus } from "@mittwald/api-client";
 import assertSuccess from "../../lib/apiutil/assert_success.js";
-import { collectEnvironment } from "../../lib/resources/stack/env.js";
+import { collectEnvironment, fillMissingEnvironmentVariables, } from "../../lib/resources/stack/env.js";
 import { sanitizeStackDefinition } from "../../lib/resources/stack/sanitize.js";
 import { enrichStackDefinition } from "../../lib/resources/stack/enrich.js";
 import { Success } from "../../rendering/react/components/Success.js";
 import { Value } from "../../rendering/react/components/Value.js";
+import { loadStackFromTemplate } from "../../lib/resources/stack/template-loader.js";
+import { parse } from "envfile";
 export class Deploy extends ExecRenderBaseCommand {
     static description = "Deploys a docker-compose compatible file to a mittwald container stack";
     static aliases = ["stack:up"];
@@ -21,22 +23,63 @@ export class Deploy extends ExecRenderBaseCommand {
             summary: 'path to a compose file, or "-" to read from stdin',
             default: "./docker-compose.yml",
             char: "c",
+            exclusive: ["from-template"],
+        }),
+        "from-template": Flags.string({
+            summary: "deploy from a GitHub template (e.g., mittwald/n8n)",
+            description: `\
+Fetch and deploy a stack from a GitHub template repository. Template names are automatically converted to repository names by prefixing "stack-template-" to the name part.
+
+For example, "mittwald/n8n" resolves to the repository "mittwald/stack-template-n8n". The command fetches both docker-compose.yml and .env files from the main branch.
+
+Environment variable precedence (from lowest to highest):
+1. Template .env file (if present in the repository)
+2. System environment variables (process.env)
+3. Local --env-file (if specified)
+
+This flag is mutually exclusive with --compose-file.`,
+            exclusive: ["compose-file"],
         }),
         "env-file": Flags.file({
             summary: "alternative path to file with environment variables",
             default: "./.env",
         }),
     };
+    async loadStackDefinition(source, envFile, existing, renderer) {
+        // Build environment: start with process.env, then template .env, then local --env-file
+        let env = { ...process.env };
+        if ("template" in source) {
+            const hasServices = existing.services?.length ?? 0 > 0;
+            if (hasServices) {
+                throw new Error("Re-applying templates to existing stacks is currently not supported.");
+            }
+            // Load from GitHub template
+            const { composeYaml, envContent } = await renderer.runStep("fetching template from GitHub", () => loadStackFromTemplate(source.template));
+            if (envContent) {
+                const templateEnv = parse(envContent);
+                env = { ...env, ...templateEnv };
+            }
+            env = await collectEnvironment(env, envFile);
+            env = await fillMissingEnvironmentVariables(env, renderer);
+            return loadStackFromStr(composeYaml, env);
+        }
+        // Load from local file
+        env = await collectEnvironment(env, envFile);
+        return loadStackFromFile(source.composeFile, env);
+    }
     async exec() {
         const stackId = await withStackId(this.apiClient, Deploy, this.flags, this.args, this.config);
-        const { "compose-file": composeFile, "env-file": envFile } = this.flags;
+        const { "compose-file": composeFile, "from-template": fromTemplate, "env-file": envFile, } = this.flags;
         const r = makeProcessRenderer(this.flags, "Deploying container stack");
+        const existingStack = await r.runStep("retrieving current stack state", async () => {
+            const resp = await this.apiClient.container.getStack({ stackId });
+            assertStatus(resp, 200);
+            return resp.data;
+        });
         const result = { restartedServices: [] };
-        const env = await collectEnvironment(process.env, envFile);
-        let stackDefinition = await loadStackFromFile(composeFile, env);
+        let stackDefinition = await this.loadStackDefinition(fromTemplate ? { template: fromTemplate } : { composeFile }, envFile, existingStack, r);
         stackDefinition = sanitizeStackDefinition(stackDefinition);
         stackDefinition = await r.runStep("getting image configurations", () => enrichStackDefinition(stackDefinition));
-        this.debug("complete stack definition: %O", stackDefinition);
         const declaredStack = await r.runStep("deploying stack", async () => {
             const resp = await this.apiClient.container.declareStack({
                 stackId,

package/dist/lib/context/FlagSetBuilder.d.ts

@@ -27,6 +27,7 @@ export type FlagSetOptions = {
     normalize: NormalizeFn;
     displayName: string;
     retrieveFromContext: boolean;
+    retrieveFunction: (client: MittwaldAPIV2Client, ctx: Context) => Promise<string | null>;
     expectedShortIDFormat: {
         pattern: RegExp;
         display: string;

package/dist/lib/context/FlagSetBuilder.js

@@ -119,7 +119,7 @@ export default class FlagSetBuilder {
     buildIDGetter() {
         const idInputSanityCheck = this.buildSanityCheck();
         const idFromArgsOrFlag = this.buildIDFromArgsOrFlag();
-        const { normalize = (_, id) => id, retrieveFromContext = true } = this.opts;
+        const { normalize = (_, id) => id, retrieveFromContext = true, retrieveFunction, } = this.opts;
         return async (apiClient, commandType, flags, args, cfg) => {
             const context = new Context(apiClient, cfg);
             const idInput = idFromArgsOrFlag(flags, args);
@@ -133,6 +133,12 @@ export default class FlagSetBuilder {
                     return idFromContext.value;
                 }
             }
+            if (retrieveFunction) {
+                const idFromFunction = await retrieveFunction(apiClient, context);
+                if (idFromFunction) {
+                    return idFromFunction;
+                }
+            }
             throw makeMissingContextInputError(commandType, this.name, this.flagName);
         };
     }

package/dist/lib/intellij/config.test.js

@@ -7,7 +7,10 @@ import { generateIntellijConfigs } from "./config.js";
 describe("IntelliJ Config Generator", () => {
     let tempDir;
     let testData;
-    const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "@_" });
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: "@_",
+    });
     beforeEach(() => {
         tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "intellij-test-"));
         testData = {
@@ -74,7 +77,11 @@ describe("IntelliJ Config Generator", () => {
         });
         test("should add multiple SSH configs for different hosts", () => {
             generateIntellijConfigs(testData, tempDir);
-            const differentHostData = { ...testData, host: "ssh.other.example.com", appShortId: "app456" };
+            const differentHostData = {
+                ...testData,
+                host: "ssh.other.example.com",
+                appShortId: "app456",
+            };
             generateIntellijConfigs(differentHostData, tempDir);
             const configPath = path.join(tempDir, ".idea", "sshConfigs.xml");
             const content = fs.readFileSync(configPath, "utf8");

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" | "install-path";
+type ImplicitDefaultFlag = "wait" | "wait-timeout" | "site-title" | "install-path" | "update-context";
 export interface AppInstallationResult {
     appInstallation: AppInstallation;
     appVersion: AppVersion;

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

@@ -7,6 +7,7 @@ import { triggerAppInstallation } from "./install.js";
 import { waitUntilAppStateHasNormalized } from "./wait.js";
 import { Success } from "../../../rendering/react/components/Success.js";
 import AppUsageHints from "../../../rendering/react/components/AppInstallation/AppUsageHints.js";
+import Context from "../../context/Context.js";
 export class AppInstaller {
     appId;
     appName;
@@ -31,6 +32,7 @@ export class AppInstaller {
             "wait-timeout",
             "site-title",
             "install-path",
+            "update-context",
         ], this.appName);
         if (this.mutateFlags) {
             this.mutateFlags(flags);
@@ -51,6 +53,11 @@ export class AppInstaller {
         else {
             successText = `Your ${this.appName} installation has started. Have fun when it's ready! 🎉`;
         }
+        if (flags["update-context"]) {
+            const context = new Context(apiClient, config);
+            await context.setProjectId(appInstallation.projectId);
+            await context.setAppInstallationId(appInstallation.id);
+        }
         await process.complete(_jsx(Success, { children: successText }));
         return {
             appInstallation,

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

@@ -1,7 +1,7 @@
 import { MittwaldAPIV2Client } from "@mittwald/api-client";
 import { ProcessRenderer } from "../../../rendering/process/process.js";
 import { ProcessFlags } from "../../../rendering/process/process_flags.js";
-import { FlagInput, OptionFlag, OutputFlags } from "@oclif/core/interfaces";
+import { BooleanFlag, FlagInput, OptionFlag, OutputFlags } from "@oclif/core/interfaces";
 import { waitFlags } from "../../wait.js";
 export declare const appInstallationFlags: import("../../context/FlagSetBuilder.js").ContextFlags<"installation">, appInstallationArgs: import("../../context/FlagSetBuilder.js").ContextArgs<"installation">, withAppInstallationId: (apiClient: MittwaldAPIV2Client, command: "flag" | "arg" | import("../../context/FlagSetBuilder.js").CommandType<"installation">, flags: {
     [k: string]: unknown;
@@ -27,6 +27,7 @@ type AvailableFlags = typeof waitFlags & {
     "opensearch-host": OptionFlag<string>;
     "opensearch-port": OptionFlag<string>;
     entrypoint: OptionFlag<string | undefined>;
+    "update-context": BooleanFlag<boolean>;
 };
 export type RelevantFlags<TFlags extends readonly AvailableFlagName[]> = ProcessFlags & Pick<AvailableFlags, TFlags[number]>;
 export type RelevantFlagInput<TFlags extends readonly AvailableFlagName[]> = FlagInput<RelevantFlags<TFlags>>;

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

@@ -143,6 +143,12 @@ function buildFlagsWithDescription(appName) {
             required: false,
             default: undefined,
         }),
+        "update-context": Flags.boolean({
+            description: "update the CLI context to use the newly created app installation",
+            char: "c",
+            required: false,
+            default: false,
+        }),
         ...waitFlags,
     };
 }

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

@@ -1,11 +1,17 @@
 import { MittwaldAPIV2, MittwaldAPIV2Client } from "@mittwald/api-client";
 import { ProcessRenderer } from "../../../rendering/process/process.js";
 type AppVersion = MittwaldAPIV2.Components.Schemas.AppAppVersion;
+type ObjectWithVersions = {
+    internalVersion: string;
+    externalVersion: string;
+};
 export declare function normalizeToAppVersionUuid(apiClient: MittwaldAPIV2Client, version: string, process: ProcessRenderer, appUuid: string): Promise<MittwaldAPIV2.Components.Schemas.AppAppVersion>;
 export declare function getLatestAvailableAppVersionForApp(apiClient: MittwaldAPIV2Client, appId: string): Promise<AppVersion | undefined>;
 export declare function getAllUpgradeCandidatesFromAppInstallationId(apiClient: MittwaldAPIV2Client, appInstallationId: string): Promise<AppVersion[]>;
 export declare function getLatestAvailableTargetAppVersionForAppVersionUpgradeCandidates(apiClient: MittwaldAPIV2Client, appId: string, baseAppVersionId: string): Promise<AppVersion | undefined>;
 export declare function getAvailableTargetAppVersionFromExternalVersion(apiClient: MittwaldAPIV2Client, appId: string, baseAppVersionId: string, targetExternalVersion: string): Promise<AppVersion | undefined>;
 export declare function getAppVersionUuidFromAppVersion(apiClient: MittwaldAPIV2Client, appId: string, appVersion: string | undefined): Promise<AppVersion | undefined>;
-export declare function sortArrayByExternalVersion(versions: AppVersion[]): AppVersion[];
+export declare function sortArrayByExternalVersion<T extends ObjectWithVersions>(versions: T[]): T[];
+export declare function sortArrayByInternalVersion<T extends ObjectWithVersions>(versions: T[]): T[];
+export declare function compareVersionsBy<T extends ObjectWithVersions>(field: "internal" | "external"): (a: T, b: T) => -1 | 0 | 1;
 export {};

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

@@ -1,5 +1,5 @@
 import { assertStatus } from "@mittwald/api-client-commons";
-import { gt } from "semver";
+import { coerce, gt } from "semver";
 import { getAppInstallationFromUuid, getAppNameFromUuid } from "./uuid.js";
 import { compare } from "semver";
 export async function normalizeToAppVersionUuid(apiClient, version, process, appUuid) {
@@ -78,5 +78,38 @@ export async function getAppVersionUuidFromAppVersion(apiClient, appId, appVersi
         item.externalVersion === appVersion);
 }
 export function sortArrayByExternalVersion(versions) {
-    return versions.sort((a, b) => compare(b.externalVersion, a.externalVersion));
+    return versions.sort(compareVersionsBy("external"));
+}
+export function sortArrayByInternalVersion(versions) {
+    return versions.sort(compareVersionsBy("internal"));
+}
+export function compareVersionsBy(field) {
+    const fullField = `${field}Version`;
+    return (a, b) => {
+        const aCoerced = coerce(a[fullField]);
+        const bCoerced = coerce(b[fullField]);
+        if (!aCoerced || !bCoerced) {
+            return naiveVersionCompare(a.internalVersion, b.internalVersion);
+        }
+        return compare(aCoerced, bCoerced);
+    };
+}
+/**
+ * A naive version comparison function that compares version strings in the
+ * format "x.y.z". This function does not handle pre-release or build metadata.
+ */
+function naiveVersionCompare(a, b) {
+    const aParts = a.split(".").map((part) => parseInt(part, 10));
+    const bParts = b.split(".").map((part) => parseInt(part, 10));
+    for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+        const aPart = aParts[i] || 0;
+        const bPart = bParts[i] || 0;
+        if (aPart > bPart) {
+            return 1;
+        }
+        if (aPart < bPart) {
+            return -1;
+        }
+    }
+    return 0;
 }

package/dist/lib/resources/container/containerconfig.js

@@ -40,7 +40,13 @@ export async function parseEnvironmentVariablesFromFile(envFiles = []) {
  * @returns An object containing environment variable key-value pairs
  */
 export function parseEnvironmentVariablesFromEnvFlags(envFlags = []) {
-    const splitIntoKeyAndValue = (e) => e.split("=", 2);
+    const splitIntoKeyAndValue = (e) => {
+        const index = e.indexOf("=");
+        if (index < 0) {
+            throw new Error(`Invalid environment variable format: ${e}`);
+        }
+        return [e.slice(0, index), e.slice(index + 1)];
+    };
     return Object.fromEntries(envFlags.map(splitIntoKeyAndValue));
 }
 /**

package/dist/lib/resources/container/containerconfig.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/resources/container/containerconfig.test.js

@@ -0,0 +1,25 @@
+import { describe, expect, test } from "@jest/globals";
+import { parseEnvironmentVariablesFromEnvFlags } from "./containerconfig.js";
+describe("Containerconfig handling", () => {
+    describe("Config parsing", () => {
+        test("call parser with simple flags", () => {
+            const args = ["foo=bar", "ham=eggs"];
+            const res = parseEnvironmentVariablesFromEnvFlags(args);
+            expect(res).toStrictEqual({
+                foo: "bar",
+                ham: "eggs",
+            });
+        });
+        test("call parser with flag containing another '='", () => {
+            const args = ["extra_args=first=1 second=2 third=littlebitoflove"];
+            const res = parseEnvironmentVariablesFromEnvFlags(args);
+            expect(res).toStrictEqual({
+                extra_args: "first=1 second=2 third=littlebitoflove",
+            });
+        });
+        test("throw error for invalid flag format", () => {
+            const args = ["invalidFlagWithoutEqualsSign"];
+            expect(() => parseEnvironmentVariablesFromEnvFlags(args)).toThrow("Invalid environment variable format: invalidFlagWithoutEqualsSign");
+        });
+    });
+});

package/dist/lib/resources/stack/env.d.ts

@@ -1 +1,11 @@
+import { ProcessRenderer } from "../../../rendering/process/process.js";
 export declare function collectEnvironment(base: NodeJS.ProcessEnv, envFile: string): Promise<Record<string, string | undefined>>;
+/**
+ * Fills in missing environment variables in the base environment.
+ *
+ * This is done by checking for special placeholder values:
+ *
+ * - `__PROMPT__`: prompts the user to input a value.
+ * - `__GENERATE__`: generates a random base64-encoded string.
+ */
+export declare function fillMissingEnvironmentVariables(base: NodeJS.ProcessEnv, renderer: ProcessRenderer): Promise<Record<string, string | undefined>>;

package/dist/lib/resources/stack/env.js

@@ -1,6 +1,7 @@
 import * as fs from "fs/promises";
 import { parse } from "envfile";
 import { pathExists } from "../../util/fs/pathExists.js";
+import { getRandomValues } from "node:crypto";
 export async function collectEnvironment(base, envFile) {
     if (!(await pathExists(envFile))) {
         return base;
@@ -9,3 +10,24 @@ export async function collectEnvironment(base, envFile) {
     const parsed = parse(defs);
     return { ...base, ...parsed };
 }
+/**
+ * Fills in missing environment variables in the base environment.
+ *
+ * This is done by checking for special placeholder values:
+ *
+ * - `__PROMPT__`: prompts the user to input a value.
+ * - `__GENERATE__`: generates a random base64-encoded string.
+ */
+export async function fillMissingEnvironmentVariables(base, renderer) {
+    const output = { ...base };
+    for (const [key, value] of Object.entries(base)) {
+        if (value === "__PROMPT__") {
+            output[key] = await renderer.addInput(`enter value for environment variable ${key}`, false);
+        }
+        if (value === "__GENERATE__") {
+            renderer.addInfo(`generating random value for environment variable ${key}`);
+            output[key] = Buffer.from(getRandomValues(new Uint8Array(32))).toString("base64");
+        }
+    }
+    return output;
+}

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

@@ -1,2 +1,17 @@
 import FlagSetBuilder from "../../context/FlagSetBuilder.js";
-export const { flags: stackFlags, args: stackArgs, withId: withStackId, } = new FlagSetBuilder("stack", "s").build();
+import { assertStatus } from "@mittwald/api-client";
+export const { flags: stackFlags, args: stackArgs, withId: withStackId, } = new FlagSetBuilder("stack", "s", {
+    retrieveFunction: async (client, context) => {
+        const projectContext = await context.projectId();
+        if (!projectContext) {
+            return null;
+        }
+        const projectId = projectContext.value;
+        const stacks = await client.container.listStacks({ projectId });
+        assertStatus(stacks, 200);
+        if (stacks.data.length === 1) {
+            return stacks.data[0].id;
+        }
+        return null;
+    },
+}).build();

package/dist/lib/resources/stack/template-loader.d.ts

@@ -0,0 +1,18 @@
+export interface TemplateContent {
+    composeYaml: string;
+    envContent: string | null;
+}
+export declare class TemplateFileNotFoundError extends Error {
+    constructor(url: string);
+}
+export declare class GitHubRateLimitError extends Error {
+    constructor();
+}
+export declare class TemplateNetworkError extends Error {
+    constructor(message: string);
+}
+export declare function validateTemplateName(name: string): void;
+export declare function templateNameToRepoName(templateName: string): string;
+export declare function buildGitHubRawUrl(templateName: string, filename: string): string;
+export declare function fetchTemplateFile(url: string): Promise<string>;
+export declare function loadStackFromTemplate(templateName: string): Promise<TemplateContent>;

package/dist/lib/resources/stack/template-loader.js

@@ -0,0 +1,94 @@
+import axios from "axios";
+export class TemplateFileNotFoundError extends Error {
+    constructor(url) {
+        super(`File not found at ${url}`);
+        this.name = "TemplateFileNotFoundError";
+    }
+}
+export class GitHubRateLimitError extends Error {
+    constructor() {
+        super("GitHub API rate limit exceeded. Please try again later.");
+        this.name = "GitHubRateLimitError";
+    }
+}
+export class TemplateNetworkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TemplateNetworkError";
+    }
+}
+export function validateTemplateName(name) {
+    const validFormat = /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_-]+$/;
+    if (!validFormat.test(name)) {
+        throw new Error(`Invalid template name format: '${name}'. Expected format: 'owner/name' (e.g., 'mittwald/n8n')`);
+    }
+}
+export function templateNameToRepoName(templateName) {
+    const [owner, name] = templateName.split("/");
+    return `${owner}/stack-template-${name}`;
+}
+export function buildGitHubRawUrl(templateName, filename) {
+    const repoName = templateNameToRepoName(templateName);
+    return `https://raw.githubusercontent.com/${repoName}/main/${filename}`;
+}
+function convertAxiosError(error, url) {
+    if (!axios.isAxiosError(error)) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+    const axiosError = error;
+    if (axiosError.response?.status === 404) {
+        return new TemplateFileNotFoundError(url);
+    }
+    if (axiosError.response?.status === 403) {
+        return new GitHubRateLimitError();
+    }
+    if (axiosError.code === "ETIMEDOUT") {
+        return new TemplateNetworkError("Request timed out while fetching template from GitHub");
+    }
+    if (axiosError.code === "ECONNREFUSED" || axiosError.code === "ENOTFOUND") {
+        return new TemplateNetworkError("Network error: Unable to connect to GitHub. Please check your internet connection.");
+    }
+    return error;
+}
+export async function fetchTemplateFile(url) {
+    try {
+        const response = await axios.get(url, {
+            responseType: "text",
+            timeout: 10000,
+        });
+        return response.data;
+    }
+    catch (error) {
+        throw convertAxiosError(error, url);
+    }
+}
+export async function loadStackFromTemplate(templateName) {
+    validateTemplateName(templateName);
+    const composeUrl = buildGitHubRawUrl(templateName, "docker-compose.yml");
+    const envUrl = buildGitHubRawUrl(templateName, ".env");
+    let composeYaml;
+    try {
+        composeYaml = await fetchTemplateFile(composeUrl);
+    }
+    catch (error) {
+        if (error instanceof TemplateFileNotFoundError) {
+            const repoName = templateNameToRepoName(templateName);
+            throw new Error(`Template '${templateName}' not found. Repository '${repoName}' does not exist or does not contain a docker-compose.yml file.`);
+        }
+        throw error;
+    }
+    let envContent = null;
+    try {
+        envContent = await fetchTemplateFile(envUrl);
+    }
+    catch (error) {
+        if (error instanceof TemplateFileNotFoundError) {
+            // .env file is optional, so we ignore 404 errors
+            envContent = null;
+        }
+        else {
+            throw error;
+        }
+    }
+    return { composeYaml, envContent };
+}

package/dist/lib/resources/stack/template-loader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/resources/stack/template-loader.test.js

@@ -0,0 +1,125 @@
+import { afterEach, beforeEach, describe, expect, it, jest, } from "@jest/globals";
+import { validateTemplateName, templateNameToRepoName, buildGitHubRawUrl, fetchTemplateFile, loadStackFromTemplate, TemplateFileNotFoundError, GitHubRateLimitError, TemplateNetworkError, } from "./template-loader.js";
+import axios from "axios";
+describe("validateTemplateName", () => {
+    it("should accept valid template names", () => {
+        expect(() => validateTemplateName("mittwald/n8n")).not.toThrow();
+        expect(() => validateTemplateName("owner/name")).not.toThrow();
+        expect(() => validateTemplateName("my-org/my-app")).not.toThrow();
+        expect(() => validateTemplateName("org_name/app_name")).not.toThrow();
+    });
+    it("should reject invalid template names", () => {
+        expect(() => validateTemplateName("")).toThrow(/Invalid template name/);
+        expect(() => validateTemplateName("noSlash")).toThrow(/Invalid template name/);
+        expect(() => validateTemplateName("too/many/slashes")).toThrow(/Invalid template name/);
+        expect(() => validateTemplateName("/missingOwner")).toThrow(/Invalid template name/);
+        expect(() => validateTemplateName("missingName/")).toThrow(/Invalid template name/);
+    });
+});
+describe("templateNameToRepoName", () => {
+    it("should convert template name to repository name", () => {
+        expect(templateNameToRepoName("mittwald/n8n")).toBe("mittwald/stack-template-n8n");
+        expect(templateNameToRepoName("owner/app")).toBe("owner/stack-template-app");
+    });
+});
+describe("buildGitHubRawUrl", () => {
+    it("should build correct GitHub raw URL", () => {
+        expect(buildGitHubRawUrl("mittwald/n8n", "docker-compose.yml")).toBe("https://raw.githubusercontent.com/mittwald/stack-template-n8n/main/docker-compose.yml");
+        expect(buildGitHubRawUrl("owner/app", ".env")).toBe("https://raw.githubusercontent.com/owner/stack-template-app/main/.env");
+    });
+});
+describe("fetchTemplateFile", () => {
+    let axiosGetSpy;
+    let axiosIsAxiosErrorSpy;
+    beforeEach(() => {
+        axiosGetSpy = jest.spyOn(axios, "get");
+        axiosIsAxiosErrorSpy = jest.spyOn(axios, "isAxiosError");
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    it("should fetch file successfully", async () => {
+        const mockData = "file content";
+        axiosGetSpy.mockResolvedValue({ data: mockData });
+        const result = await fetchTemplateFile("https://raw.githubusercontent.com/mittwald/stack-template-n8n/main/docker-compose.yml");
+        expect(result).toBe(mockData);
+        expect(axiosGetSpy).toHaveBeenCalledWith("https://raw.githubusercontent.com/mittwald/stack-template-n8n/main/docker-compose.yml", { responseType: "text", timeout: 10000 });
+    });
+    it("should handle 404 errors", async () => {
+        axiosGetSpy.mockRejectedValue({
+            isAxiosError: true,
+            response: { status: 404 },
+        });
+        axiosIsAxiosErrorSpy.mockReturnValue(true);
+        await expect(fetchTemplateFile("https://example.com/missing.yml")).rejects.toThrow(TemplateFileNotFoundError);
+    });
+    it("should handle 403 rate limit errors", async () => {
+        axiosGetSpy.mockRejectedValue({
+            isAxiosError: true,
+            response: { status: 403 },
+        });
+        axiosIsAxiosErrorSpy.mockReturnValue(true);
+        await expect(fetchTemplateFile("https://example.com/file.yml")).rejects.toThrow(GitHubRateLimitError);
+    });
+    it("should handle timeout errors", async () => {
+        axiosGetSpy.mockRejectedValue({
+            isAxiosError: true,
+            code: "ETIMEDOUT",
+        });
+        axiosIsAxiosErrorSpy.mockReturnValue(true);
+        await expect(fetchTemplateFile("https://example.com/file.yml")).rejects.toThrow(TemplateNetworkError);
+    });
+    it("should handle network errors", async () => {
+        axiosGetSpy.mockRejectedValue({
+            isAxiosError: true,
+            code: "ECONNREFUSED",
+        });
+        axiosIsAxiosErrorSpy.mockReturnValue(true);
+        await expect(fetchTemplateFile("https://example.com/file.yml")).rejects.toThrow(TemplateNetworkError);
+    });
+});
+describe("loadStackFromTemplate", () => {
+    let axiosGetSpy;
+    let axiosIsAxiosErrorSpy;
+    beforeEach(() => {
+        axiosGetSpy = jest.spyOn(axios, "get");
+        axiosIsAxiosErrorSpy = jest.spyOn(axios, "isAxiosError");
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    it("should load both docker-compose.yml and .env", async () => {
+        const composeContent = "version: '3'\nservices:\n  app:\n    image: nginx";
+        const envContent = "FOO=bar\nBAZ=qux";
+        axiosGetSpy
+            .mockResolvedValueOnce({ data: composeContent })
+            .mockResolvedValueOnce({ data: envContent });
+        const result = await loadStackFromTemplate("mittwald/n8n");
+        expect(result.composeYaml).toBe(composeContent);
+        expect(result.envContent).toBe(envContent);
+    });
+    it("should handle missing .env file gracefully", async () => {
+        const composeContent = "version: '3'\nservices:\n  app:\n    image: nginx";
+        axiosGetSpy.mockResolvedValueOnce({ data: composeContent });
+        axiosGetSpy.mockRejectedValueOnce({
+            isAxiosError: true,
+            response: { status: 404 },
+        });
+        axiosIsAxiosErrorSpy.mockReturnValue(true);
+        const result = await loadStackFromTemplate("mittwald/n8n");
+        expect(result.composeYaml).toBe(composeContent);
+        expect(result.envContent).toBeNull();
+    });
+    it("should throw error if docker-compose.yml is missing", async () => {
+        axiosGetSpy.mockRejectedValue({
+            isAxiosError: true,
+            response: { status: 404 },
+        });
+        axiosIsAxiosErrorSpy.mockReturnValue(true);
+        await expect(loadStackFromTemplate("mittwald/n8n")).rejects.toThrow(/Template 'mittwald\/n8n' not found/);
+    });
+    it("should validate template name before fetching", async () => {
+        await expect(loadStackFromTemplate("invalid")).rejects.toThrow(/Invalid template name/);
+        expect(axiosGetSpy).not.toHaveBeenCalled();
+    });
+});

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@mittwald/cli",
-  "version": "1.12.0",
+  "version": "1.13.1-beta.6",
   "description": "Hand-crafted CLI for the mittwald API",
   "license": "MIT",
+  "repository": {
+    "url": "https://github.com/mittwald/cli"
+  },
   "author": {
     "name": "Mittwald CM Service GmbH & Co. KG",
     "email": "opensource@mittwald.de"
@@ -16,12 +19,13 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.7.0"
   },
   "scripts": {
     "clean": "(rimraf --glob dist tsconfig.*.tsbuildinfo) | true",
     "compile": "tsc --build tsconfig.json",
-    "format": "prettier --write $@ '**/*.{ts,tsx,yaml,yml,json,md,mdx}'",
+    "format": "yarn format:prettier --write",
+    "format:prettier": "prettier $@ '**/*.{ts,tsx,yaml,yml,json,md,mdx}'",
     "generate:readme": "oclif readme --multi --output-dir=docs < /dev/null",
     "license-check": "yarn pnpify license-checker-rseidelsohn ",
     "lint": "eslint . --cache",
@@ -31,7 +35,7 @@
     "package:windows": "oclif pack win --targets=win32-x64,win32-x86",
     "post:generate": "yarn run -T compile && yarn run -T compile:cjs",
     "test": "yarn test:format && yarn test:licenses && yarn test:unit",
-    "test:format": "yarn lint && yarn format --check",
+    "test:format": "yarn lint && yarn format:prettier --check",
     "test:licenses": "yarn license-check --summary --unknown --failOn 'UNLICENSED;UNKNOWN'",
     "test:readme": "yarn generate:readme && git diff --exit-code README.md docs/*.md",
     "test:unit": "NODE_NO_WARNINGS=1 yarn node --experimental-vm-modules $(yarn bin jest) ./src"
@@ -61,7 +65,7 @@
     "js-yaml": "^4.1.0",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
-    "open": "^10.0.3",
+    "open": "^11.0.0",
     "parse-duration": "^2.0.1",
     "pretty-bytes": "^7.0.0",
     "react": "^19.1.1",
@@ -70,14 +74,14 @@
     "shell-escape": "^0.2.0",
     "slice-ansi": "^7.1.0",
     "string-width": "^8.0.0",
-    "tempfile": "^5.0.0",
+    "tempfile": "^6.0.1",
     "uuid": "^13.0.0"
   },
   "devDependencies": {
     "@jest/globals": "^30.0.4",
     "@oclif/test": "^4.0.4",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.0.10",
+    "@types/node": "^25.0.3",
     "@types/react": "^19",
     "@types/semver": "^7.5.0",
     "@types/shell-escape": "^0.2.3",
@@ -88,7 +92,7 @@
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-json": "^4.0.1",
     "eslint-plugin-prettier": "^5.5.1",
-    "globals": "^16.0.0",
+    "globals": "^17.0.0",
     "jest": "^30.0.4",
     "license-checker-rseidelsohn": "^4.2.6",
     "nock": "^14.0.0",
@@ -288,4 +292,4 @@
     }
   },
   "packageManager": "yarn@3.6.1"
-}
+}

package/dist/commands/cronjob/execution/abort.d.ts

@@ -1,18 +0,0 @@
-import { ExecRenderBaseCommand } from "../../../lib/basecommands/ExecRenderBaseCommand.js";
-import { ReactNode } from "react";
-type Result = {
-    executionId: string;
-};
-export declare class Abort extends ExecRenderBaseCommand<typeof Abort, Result> {
-    static summary: string;
-    static flags: {
-        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    static args: {
-        "cronjob-id": import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        "execution-id": import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    protected exec(): Promise<Result>;
-    protected render({ executionId }: Result): ReactNode;
-}
-export {};

package/dist/commands/cronjob/execution/abort.js

@@ -1,41 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { ExecRenderBaseCommand } from "../../../lib/basecommands/ExecRenderBaseCommand.js";
-import { makeProcessRenderer, processFlags, } from "../../../rendering/process/process_flags.js";
-import { Args } from "@oclif/core";
-import { Success } from "../../../rendering/react/components/Success.js";
-import { Value } from "../../../rendering/react/components/Value.js";
-import assertSuccess from "../../../lib/apiutil/assert_success.js";
-export class Abort extends ExecRenderBaseCommand {
-    static summary = "Abort a running cron job execution.";
-    static flags = {
-        ...processFlags,
-    };
-    static args = {
-        "cronjob-id": Args.string({
-            description: "ID of the cronjob the execution belongs to",
-            required: true,
-        }),
-        "execution-id": Args.string({
-            required: true,
-            description: "ID of the cron job execution to abort",
-        }),
-    };
-    async exec() {
-        const p = makeProcessRenderer(this.flags, "Aborting a cron job execution");
-        const { "cronjob-id": cronjobId, "execution-id": executionId } = this.args;
-        await p.runStep("aborting cron job execution", async () => {
-            const r = await this.apiClient.cronjob.abortExecution({
-                cronjobId,
-                executionId,
-            });
-            assertSuccess(r);
-        });
-        p.complete(_jsxs(Success, { children: ["Execution ", _jsx(Value, { children: executionId }), " was successfully aborted."] }));
-        return { executionId };
-    }
-    render({ executionId }) {
-        if (this.flags.quiet) {
-            return executionId;
-        }
-    }
-}