@mittwald/cli 1.5.1 → 1.7.0

package/dist/lib/units/PortMapping.js

@@ -0,0 +1,38 @@
+import { Args } from "@oclif/core";
+/** Represents a mapping between a local port and a remote port. */
+export default class PortMapping {
+    localPort;
+    remotePort;
+    constructor(localPort, remotePort) {
+        this.localPort = localPort;
+        this.remotePort = remotePort;
+    }
+    static validatePort(port) {
+        return !isNaN(port) && port > 0 && port <= 65535;
+    }
+    static arg = Args.custom({
+        parse: async (input) => PortMapping.fromString(input),
+    });
+    /** @param str Port and protocol; example: `8080/tcp` */
+    static fromPortAndProtocol(str) {
+        const [localPort, protocol] = str.split("/");
+        const portNum = parseInt(localPort);
+        if (!PortMapping.validatePort(portNum)) {
+            throw new Error("Invalid port number. Ports must be between 1 and 65535.");
+        }
+        if (protocol.toLowerCase() !== "tcp") {
+            throw new Error("Only TCP protocol is supported.");
+        }
+        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.");
+        }
+        return new PortMapping(localPortNum, remotePortNum);
+    }
+}

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

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

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

@@ -0,0 +1,28 @@
+import { describe, expect, it } from "@jest/globals";
+import PortMapping from "./PortMapping.js";
+describe("PortMapping", () => {
+    // Test: Successfully create PortMapping instance using fromString
+    it("should correctly parse valid port mapping string", () => {
+        const result = PortMapping.fromString("8080:9090");
+        expect(result.localPort).toBe(8080);
+        expect(result.remotePort).toBe(9090);
+    });
+    // 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.");
+    });
+    // Test: Throws an error for invalid remote port
+    it("should throw an error for invalid remote port", () => {
+        expect(() => PortMapping.fromString("8080:70000")).toThrow("Invalid port number. Ports must be between 1 and 65535.");
+    });
+    // Test: Throws an error when input format is incorrect
+    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: Successfully assign local and remote ports via constructor
+    it("should correctly initialize PortMapping with valid ports", () => {
+        const portMapping = new PortMapping(3000, 4000);
+        expect(portMapping.localPort).toBe(3000);
+        expect(portMapping.remotePort).toBe(4000);
+    });
+});

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

@@ -6,6 +6,7 @@ import GenericError from "./Error/GenericError.js";
 import APIError from "./Error/APIError.js";
 import UnexpectedShortIDPassedErrorBox from "./Error/UnexpectedShortIDPassedErrorBox.js";
 import { MissingArgError, MissingFlagError, } from "../../../lib/context/FlagSetBuilder.js";
+import NoTokenFoundError from "../../../lib/error/NoTokenFoundError.js";
 /**
  * Render an error to the terminal.
  *
@@ -27,6 +28,9 @@ export const ErrorBox = ({ err }) => {
         err instanceof MissingFlagError) {
         return (_jsx(GenericError, { err: err, withStack: false, withIssue: false, title: "Input required" }));
     }
+    else if (err instanceof NoTokenFoundError) {
+        return (_jsx(GenericError, { err: err, withStack: false, withIssue: false, title: "Login required" }));
+    }
     else if (err instanceof UnexpectedShortIDPassedError) {
         return _jsx(UnexpectedShortIDPassedErrorBox, { err: err });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/cli",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "description": "Hand-crafted CLI for the mittwald API",
   "license": "MIT",
   "author": {
@@ -16,7 +16,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "scripts": {
     "clean": "(rimraf --glob dist tsconfig.*.tsbuildinfo) | true",
@@ -62,7 +62,7 @@
     "marked-terminal": "^7.3.0",
     "open": "^10.0.3",
     "parse-duration": "^2.0.1",
-    "pretty-bytes": "^6.1.0",
+    "pretty-bytes": "^7.0.0",
     "react": "^18.2.0",
     "semver": "^7.5.4",
     "semver-parser": "^4.1.6",
@@ -73,10 +73,10 @@
     "uuid": "^11.0.3"
   },
   "devDependencies": {
-    "@jest/globals": "^29.7.0",
+    "@jest/globals": "^30.0.4",
     "@oclif/test": "^4.0.4",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.7.5",
+    "@types/node": "^24.0.10",
     "@types/react": "^18",
     "@types/semver": "^7.5.0",
     "@types/shell-escape": "^0.2.3",
@@ -88,11 +88,11 @@
     "eslint-plugin-json": "^4.0.1",
     "eslint-plugin-prettier": "^5.5.1",
     "globals": "^16.0.0",
-    "jest": "^29.7.0",
+    "jest": "^30.0.4",
     "license-checker-rseidelsohn": "^4.2.6",
     "nock": "^14.0.0",
     "oclif": "^4.14.31",
-    "prettier": "~3.5.3",
+    "prettier": "~3.6.2",
     "prettier-plugin-jsdoc": "^1.3.2",
     "prettier-plugin-package": "^1.4.0",
     "prettier-plugin-sort-json": "^4.1.1",
@@ -117,6 +117,9 @@
       "app": {
         "description": "Manage apps, and app installations in your projects",
         "subtopics": {
+          "create": {
+            "description": "Create new self-managed apps in your projects"
+          },
           "install": {
             "description": "Install apps in your projects"
           },
@@ -128,9 +131,6 @@
       "registry": {
         "description": "Manage container registries"
       },
-      "article": {
-        "description": "Query available hosting articles"
-      },
       "backup": {
         "description": "Manage backups of your projects",
         "subtopics": {
@@ -139,12 +139,12 @@
           }
         }
       },
+      "container": {
+        "description": "Manage containers"
+      },
       "context": {
         "description": "Save certain environment parameters for later use"
       },
-      "contract": {
-        "description": "Manage your hosting contracts, and order new ones"
-      },
       "conversation": {
         "description": "Manage your support cases"
       },
@@ -157,16 +157,42 @@
         }
       },
       "cronjob": {
-        "description": "Manage cronjobs of your projects"
+        "description": "Manage cronjobs of your projects",
+        "subtopics": {
+          "execution": {
+            "description": "Manage individual cronjob executions"
+          }
+        }
       },
       "database": {
-        "description": "Manage databases (like MySQL and Redis) in your projects"
+        "description": "Manage databases (like MySQL and Redis) in your projects",
+        "subtopics": {
+          "mysql": {
+            "description": "Manage MySQL databases in your projects",
+            "subtopics": {
+              "user": {
+                "description": "Manage MySQL database users"
+              }
+            }
+          },
+          "redis": {
+            "description": "Manage Redis databases in your projects"
+          }
+        }
       },
       "ddev": {
         "description": "Integrate your mittwald projects with DDEV"
       },
       "domain": {
-        "description": "Manage domains, virtual hosts and DNS settings in your projects"
+        "description": "Manage domains, virtual hosts and DNS settings in your projects",
+        "subtopics": {
+          "dnszone": {
+            "description": "Manage DNS zones for your domains"
+          },
+          "virtualhost": {
+            "description": "Manage virtual hosts for your domains"
+          }
+        }
       },
       "extension": {
         "description": "Install and manage extensions in your organisations and projects"
@@ -175,10 +201,26 @@
         "description": "Manage your client authentication"
       },
       "mail": {
-        "description": "Manage mailboxes and mail addresses in your projects"
+        "description": "Manage mailboxes and mail addresses in your projects",
+        "subtopics": {
+          "address": {
+            "description": "Manage mail addresses in your projects"
+          },
+          "deliverybox": {
+            "description": "Manage mail delivery boxes in your projects"
+          }
+        }
       },
       "org": {
-        "description": "Manage your organizations, and also any kinds of user memberships concerning these organizations."
+        "description": "Manage your organizations, and also any kinds of user memberships concerning these organizations.",
+        "subtopics": {
+          "invite": {
+            "description": "Invite users to your organizations and manage their invitations"
+          },
+          "membership": {
+            "description": "Control who gets to work in your organizations, and who doesn't"
+          }
+        }
       },
       "project": {
         "description": "Manage your projects, and also any kinds of user memberships concerning these projects.",
@@ -209,6 +251,12 @@
       "user": {
         "description": "Manage your own user account",
         "subtopics": {
+          "api-token": {
+            "description": "Manage your API tokens"
+          },
+          "session": {
+            "description": "Manage your active sessions"
+          },
           "ssh-key": {
             "description": "Manage your SSH keys"
           }
@@ -223,7 +271,7 @@
     ],
     "update": {
       "node": {
-        "version": "18.20.4"
+        "version": "20.19.3"
       },
       "s3": {
         "xz": true,