@mittwald/cli 1.10.0 → 1.11.0

package/dist/rendering/react/components/Container/ContainerUsageHints.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { Value } from "../Value.js";
+import useDefaultBoxStyles from "../../styles/useDefaultBoxStyles.js";
+import { ContainerManagementCommands } from "./ContainerManagementCommands.js";
+import { NoPortsUsageHints } from "./NoPortsUsageHints.js";
+import { PortConnectionHints } from "./PortConnectionHints.js";
+const infoColor = "blueBright";
+const parsePort = (portString) => {
+    const [port, protocol] = portString.split("/");
+    return { port, protocol };
+};
+/**
+ * ContainerUsageHints displays comprehensive usage instructions for containers,
+ * adapting the content based on whether the container exposes ports or not.
+ */
+const ContainerUsageHints = ({ service }) => {
+    const defaultBoxStyles = useDefaultBoxStyles();
+    const rawPorts = service.deployedState?.ports || [];
+    const ports = rawPorts.map(parsePort);
+    const containerId = service.id;
+    const containerName = service.serviceName;
+    const boxProps = {
+        ...defaultBoxStyles,
+        borderColor: infoColor,
+        marginLeft: 2,
+    };
+    // Handle containers without exposed ports
+    if (ports.length === 0) {
+        return (_jsx(NoPortsUsageHints, { boxProps: boxProps, containerName: containerName }));
+    }
+    // Handle containers with exposed ports
+    return (_jsxs(Box, { ...boxProps, flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, color: infoColor, children: "USAGE HINTS" }), _jsxs(Text, { color: infoColor, children: ["Container ", _jsx(Value, { children: containerName }), " is now running and listening on", " ", ports.length === 1 ? "port" : "ports", ":", " ", ports.map((port, index) => (_jsxs(Value, { children: [port.port, "/", port.protocol, index < ports.length - 1 ? ", " : ""] }, index))), "! \uD83D\uDC33"] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "Connect to your container using one of these methods:" }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(PortConnectionHints, { ports: ports, containerId: containerId, containerName: containerName }), _jsx(ContainerManagementCommands, { containerIdentifier: containerName }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: infoColor, children: ["\uD83D\uDCA1 Tip: Use ", _jsx(Value, { children: "mw container list" }), " to see all your containers and their current status."] }) })] })] }));
+};
+export default ContainerUsageHints;

package/dist/rendering/react/components/Container/DomainConnectionHints.d.ts

@@ -0,0 +1,12 @@
+import { FC } from "react";
+import { ParsedPort } from "./types.js";
+interface DomainConnectionHintsProps {
+    ports: ParsedPort[];
+    containerId: string;
+}
+/**
+ * DomainConnectionHints displays instructions for connecting a domain to
+ * container ports via virtualhost creation.
+ */
+export declare const DomainConnectionHints: FC<DomainConnectionHintsProps>;
+export {};

package/dist/rendering/react/components/Container/DomainConnectionHints.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Text } from "ink";
+import { Value } from "../Value.js";
+import { CommandHint } from "./CommandHint.js";
+const infoColor = "blueBright";
+/**
+ * DomainConnectionHints displays instructions for connecting a domain to
+ * container ports via virtualhost creation.
+ */
+export const DomainConnectionHints = ({ ports, containerId, }) => {
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: infoColor, children: "\uD83C\uDF10 Connect via Domain:" }), ports.map((port) => (_jsx(CommandHint, { command: [
+                    "mw",
+                    "domain",
+                    "virtualhost",
+                    "create",
+                    "--hostname",
+                    "<your-domain.com>",
+                    "--path-to-container",
+                    `/:${containerId}:${port.port}/${port.protocol}`,
+                ], description: _jsxs(_Fragment, { children: ["Connect ", _jsx(Value, { children: "<your-domain.com>" }), " to container port", " ", _jsxs(Value, { children: [port.port, "/", port.protocol] }), ", making it accessible via HTTPS. This works only if the container listens for HTTP connections on this port. Other protocols are not supported."] }) }, `domain-${port.port}`)))] }));
+};

package/dist/rendering/react/components/Container/InternalConnectionHints.d.ts

@@ -0,0 +1,12 @@
+import { FC } from "react";
+import { ParsedPort } from "./types.js";
+interface InternalConnectionHintsProps {
+    ports: ParsedPort[];
+    containerName: string;
+}
+/**
+ * InternalConnectionHints displays instructions for connecting to the container
+ * from within the hosting environment using the service name as hostname.
+ */
+export declare const InternalConnectionHints: FC<InternalConnectionHintsProps>;
+export {};

package/dist/rendering/react/components/Container/InternalConnectionHints.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment } from "react";
+import { Box, Text } from "ink";
+import { Value } from "../Value.js";
+const infoColor = "blueBright";
+/**
+ * InternalConnectionHints displays instructions for connecting to the container
+ * from within the hosting environment using the service name as hostname.
+ */
+export const InternalConnectionHints = ({ ports, containerName, }) => {
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: infoColor, children: "\uD83C\uDFE0 Connect from within hosting environment:" }), _jsx(Box, { marginLeft: 2, marginBottom: 1, children: _jsxs(Text, { wrap: "wrap", children: ["Access container from other services using", " ", ports.map((port, idx) => (_jsxs(Fragment, { children: [_jsxs(Value, { children: [containerName, ":", port.port] }), idx === ports.length - 1 ? " " : " or "] }, `internal-${idx}`))), "as the hostname and port"] }) })] }));
+};

package/dist/rendering/react/components/Container/NoPortsUsageHints.d.ts

@@ -0,0 +1,12 @@
+import { FC } from "react";
+import { BoxProps } from "ink";
+interface NoPortsUsageHintsProps {
+    containerName: string;
+    boxProps: BoxProps;
+}
+/**
+ * NoPortsUsageHints displays usage instructions for containers that don't
+ * expose any ports. It shows management commands for SSH, logs, and exec.
+ */
+export declare const NoPortsUsageHints: FC<NoPortsUsageHintsProps>;
+export {};

package/dist/rendering/react/components/Container/NoPortsUsageHints.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { Value } from "../Value.js";
+import { ContainerManagementCommands } from "./ContainerManagementCommands.js";
+const infoColor = "blueBright";
+/**
+ * NoPortsUsageHints displays usage instructions for containers that don't
+ * expose any ports. It shows management commands for SSH, logs, and exec.
+ */
+export const NoPortsUsageHints = ({ containerName, boxProps, }) => {
+    return (_jsxs(Box, { ...boxProps, flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, color: infoColor, children: "USAGE HINTS" }), _jsxs(Text, { color: infoColor, children: ["Container ", _jsx(Value, { children: containerName }), " is now running! \uD83D\uDC33"] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "Your container doesn't expose any ports, but you can still interact with it:" }) }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(ContainerManagementCommands, { containerIdentifier: containerName }) })] }));
+};

package/dist/rendering/react/components/Container/PortConnectionHints.d.ts

@@ -0,0 +1,13 @@
+import { FC } from "react";
+import { ParsedPort } from "./types.js";
+interface PortConnectionHintsProps {
+    ports: ParsedPort[];
+    containerId: string;
+    containerName: string;
+}
+/**
+ * PortConnectionHints orchestrates the display of internal, domain connection,
+ * and port forwarding options for containers with exposed ports.
+ */
+export declare const PortConnectionHints: FC<PortConnectionHintsProps>;
+export {};

package/dist/rendering/react/components/Container/PortConnectionHints.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { InternalConnectionHints } from "./InternalConnectionHints.js";
+import { DomainConnectionHints } from "./DomainConnectionHints.js";
+import { PortForwardingHints } from "./PortForwardingHints.js";
+/**
+ * PortConnectionHints orchestrates the display of internal, domain connection,
+ * and port forwarding options for containers with exposed ports.
+ */
+export const PortConnectionHints = ({ ports, containerId, containerName, }) => {
+    return (_jsxs(_Fragment, { children: [_jsx(InternalConnectionHints, { ports: ports, containerName: containerName }), _jsx(DomainConnectionHints, { ports: ports, containerId: containerId }), _jsx(PortForwardingHints, { ports: ports, containerName: containerName })] }));
+};

package/dist/rendering/react/components/Container/PortForwardingHints.d.ts

@@ -0,0 +1,12 @@
+import { FC } from "react";
+import { ParsedPort } from "./types.js";
+interface PortForwardingHintsProps {
+    ports: ParsedPort[];
+    containerName: string;
+}
+/**
+ * PortForwardingHints displays instructions for forwarding container ports to
+ * local ports for development purposes.
+ */
+export declare const PortForwardingHints: FC<PortForwardingHintsProps>;
+export {};

package/dist/rendering/react/components/Container/PortForwardingHints.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Text } from "ink";
+import { Value } from "../Value.js";
+import { CommandHint } from "./CommandHint.js";
+const infoColor = "blueBright";
+/**
+ * PortForwardingHints displays instructions for forwarding container ports to
+ * local ports for development purposes.
+ */
+export const PortForwardingHints = ({ ports, containerName, }) => {
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: infoColor, children: "\uD83D\uDD17 Port Forward for Local Development:" }), ports.map((port) => (_jsx(CommandHint, { command: [
+                    "mw",
+                    "container",
+                    "port-forward",
+                    containerName,
+                    `<local-port>:${port.port}`,
+                ], description: _jsxs(_Fragment, { children: ["Forward container port ", _jsx(Value, { children: port.port }), " to a local port (e.g.,", " ", _jsxs(Value, { children: [port.port, ":", port.port] }), " ", "makes it accessible at ", _jsxs(Value, { children: ["http://localhost:", port.port] }), "). This works for all TCP-based protocols."] }) }, `forward-${port.port}`)))] }));
+};

package/dist/rendering/react/components/Container/types.d.ts

@@ -0,0 +1,4 @@
+export interface ParsedPort {
+    port: string;
+    protocol: string;
+}

package/dist/rendering/react/components/Container/types.js

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

package/dist/rendering/react/components/Error/ErrorBox.d.ts

@@ -1,4 +1,4 @@
 import { BoxProps } from "ink";
 import { PropsWithChildren } from "react";
 /** A pre-styled box for displaying errors. */
-export default function ErrorBox(props: PropsWithChildren<BoxProps>): import("react/jsx-runtime").JSX.Element;
+export default function ErrorBox(props: PropsWithChildren<Omit<BoxProps, "width">>): import("react/jsx-runtime").JSX.Element;

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

@@ -1,14 +1,13 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Box } from "ink";
+import useDefaultBoxStyles from "../../styles/useDefaultBoxStyles.js";
 const defaultErrorBoxProps = {
-    width: 80,
     flexDirection: "column",
     borderColor: "red",
-    borderStyle: "round",
-    paddingX: 1,
     rowGap: 1,
 };
 /** A pre-styled box for displaying errors. */
 export default function ErrorBox(props) {
-    return (_jsx(Box, { ...defaultErrorBoxProps, ...props, children: props.children }));
+    const defaultBoxStyles = useDefaultBoxStyles();
+    return (_jsx(Box, { ...defaultBoxStyles, ...defaultErrorBoxProps, ...props, children: props.children }));
 }

package/dist/rendering/react/components/Error/GenericError.js

@@ -9,5 +9,5 @@ const issueURL = "https://github.com/mittwald/cli/issues/new";
  * have a specific rendering function.
  */
 export default function GenericError({ err, withStack, withIssue = true, title = "Error", }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(ErrorBox, { children: [_jsx(ErrorText, { bold: true, underline: true, children: title.toUpperCase() }), _jsx(ErrorText, { children: "An error occurred while executing this command:" }), _jsx(Box, { marginX: 2, children: _jsx(ErrorText, { children: err.toString() }) }), withIssue ? (_jsxs(ErrorText, { children: ["If you believe this to be a bug, please open an issue at ", issueURL, "."] })) : undefined] }), withStack && "stack" in err ? _jsx(ErrorStack, { err: err }) : undefined] }));
+    return (_jsxs(Box, { flexDirection: "column", width: Infinity, children: [_jsxs(ErrorBox, { children: [_jsx(ErrorText, { bold: true, underline: true, children: title.toUpperCase() }), _jsx(ErrorText, { children: "An error occurred while executing this command:" }), _jsx(Box, { marginX: 2, children: _jsx(ErrorText, { children: err.toString() }) }), withIssue ? (_jsxs(ErrorText, { children: ["If you believe this to be a bug, please open an issue at ", issueURL, "."] })) : undefined] }), withStack && "stack" in err ? _jsx(ErrorStack, { err: err }) : undefined] }));
 }

package/dist/rendering/react/components/ErrorBoundary.d.ts

@@ -15,6 +15,6 @@ export default class ErrorBoundary extends Component<PropsWithChildren<ErrorBoun
     constructor(props: PropsWithChildren<ErrorBoundaryProps>);
     static getDerivedStateFromError(error: unknown): ErrorBoundaryState;
     componentDidCatch(error: Error): void;
-    render(): string | number | boolean | Iterable<import("react").ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+    render(): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
 }
 export {};

package/dist/rendering/react/components/Success.d.ts

@@ -2,7 +2,6 @@ import { FC, PropsWithChildren } from "react";
 interface Props {
     title?: string;
     color?: string;
-    width?: number;
     innerText?: boolean;
 }
 export declare const defaultSuccessColor = "#00B785";

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

@@ -1,8 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
+import useDefaultBoxStyles from "../styles/useDefaultBoxStyles.js";
 export const defaultSuccessColor = "#00B785";
 export const Success = (props) => {
-    const { title = "Success", color = defaultSuccessColor, width = 80, innerText = true, } = props;
+    const { title = "Success", color = defaultSuccessColor, innerText = true, } = props;
     const inner = innerText ? (_jsx(Text, { wrap: "wrap", color: color, children: props.children })) : (props.children);
-    return (_jsxs(Box, { width: width, borderStyle: "round", borderColor: color, flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, underline: true, color: color, children: title.toUpperCase() }), inner] }));
+    const defaultBoxStyles = useDefaultBoxStyles();
+    return (_jsxs(Box, { ...defaultBoxStyles, borderColor: color, flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, color: color, children: title.toUpperCase() }), inner] }));
 };

package/dist/rendering/react/styles/useDefaultBoxStyles.d.ts

@@ -0,0 +1,11 @@
+import { BoxProps } from "ink";
+/**
+ * Provides default box styles based on the terminal output environment. If the
+ * terminal supports TTY (Text Terminal), default styles such as border style
+ * and horizontal padding are applied.
+ *
+ * @returns The default styles for a box. Returns an object containing styles
+ *   like `borderStyle` and `paddingX` when the terminal is TTY, otherwise
+ *   returns an empty object.
+ */
+export default function useDefaultBoxStyles(): Partial<BoxProps>;

package/dist/rendering/react/styles/useDefaultBoxStyles.js

@@ -0,0 +1,23 @@
+import { useStdout } from "ink";
+/**
+ * Provides default box styles based on the terminal output environment. If the
+ * terminal supports TTY (Text Terminal), default styles such as border style
+ * and horizontal padding are applied.
+ *
+ * @returns The default styles for a box. Returns an object containing styles
+ *   like `borderStyle` and `paddingX` when the terminal is TTY, otherwise
+ *   returns an empty object.
+ */
+export default function useDefaultBoxStyles() {
+    const { stdout } = useStdout();
+    if (stdout.isTTY) {
+        return {
+            borderStyle: "single",
+            paddingX: 2,
+            width: 80,
+        };
+    }
+    return {
+        width: 99999,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/cli",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Hand-crafted CLI for the mittwald API",
   "license": "MIT",
   "author": {
@@ -54,7 +54,8 @@
     "date-fns": "^4.0.0",
     "docker-names": "^1.2.1",
     "envfile": "^7.1.0",
-    "ink": "^5.0.1",
+    "fast-xml-parser": "^5.2.5",
+    "ink": "^6.2.3",
     "ink-link": "^4.0.0",
     "ink-text-input": "^6.0.0",
     "js-yaml": "^4.1.0",
@@ -63,21 +64,21 @@
     "open": "^10.0.3",
     "parse-duration": "^2.0.1",
     "pretty-bytes": "^7.0.0",
-    "react": "^18.2.0",
+    "react": "^19.1.1",
     "semver": "^7.5.4",
     "semver-parser": "^4.1.6",
     "shell-escape": "^0.2.0",
     "slice-ansi": "^7.1.0",
     "string-width": "^8.0.0",
     "tempfile": "^5.0.0",
-    "uuid": "^11.0.3"
+    "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/react": "^18",
+    "@types/react": "^19",
     "@types/semver": "^7.5.0",
     "@types/shell-escape": "^0.2.3",
     "@typescript-eslint/eslint-plugin": "^8.35.0",