@mittwald/cli 1.0.0-alpha.20 → 1.0.0-alpha.21

package/dist/esm/commands/project/backupschedule/list.js

@@ -8,7 +8,7 @@ export class List extends ListBaseCommand {
         ...projectFlags,
     };
     async getData() {
-        const projectId = await withProjectId(this.apiClient, this.flags, this.args, this.config);
+        const projectId = await withProjectId(this.apiClient, List, this.flags, this.args, this.config);
         return await this.apiClient.backup.listProjectBackupSchedules({
             pathParameters: { projectId },
         });

package/dist/esm/commands/project/create.d.ts

@@ -10,6 +10,7 @@ export default class Create extends ExecRenderBaseCommand<typeof Create, {
         wait: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         "wait-timeout": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         quiet: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        "server-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
     };
     protected exec(): Promise<{
         projectId: string;

package/dist/esm/commands/project/create.js

@@ -10,7 +10,7 @@ import { makeProcessRenderer, processFlags, } from "../../rendering/process/proc
 import { waitFlags, waitUntil } from "../../lib/wait.js";
 import { Context } from "../../lib/context.js";
 export default class Create extends ExecRenderBaseCommand {
-    static description = "Get the details of a project";
+    static description = "Create a new project";
     static flags = {
         ...serverFlags,
         ...processFlags,
@@ -28,7 +28,7 @@ export default class Create extends ExecRenderBaseCommand {
         const { flags } = await this.parse(Create);
         const { description } = flags;
         const process = makeProcessRenderer(flags, "Creating project");
-        const serverId = await withServerId(this.apiClient, flags, {}, this.config);
+        const serverId = await withServerId(this.apiClient, Create, flags, {}, this.config);
         const stepCreating = process.addStep(_jsx(Text, { children: "creating a new project" }));
         const result = await this.apiClient.project.createProject({
             pathParameters: { serverId },

package/dist/esm/commands/project/cronjob/list.d.ts

@@ -10,7 +10,7 @@ export declare class List extends ListBaseCommand<typeof List, ResponseItem, Res
     static description: string;
     static args: {};
     static flags: {
-        [x: string]: import("@oclif/core/lib/interfaces/parser.js").CompletableFlag<any> | import("@oclif/core/lib/interfaces/parser.js").OptionFlag<unknown>;
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
     };
     getData(): Promise<Response>;
     protected mapData(data: SuccessfulResponse<Response, 200>["data"]): ResponseItem[] | Promise<ResponseItem[]>;

package/dist/esm/commands/project/cronjob/list.js

@@ -10,7 +10,7 @@ export class List extends ListBaseCommand {
     };
     async getData() {
         const pathParams = {
-            projectId: await withProjectId(this.apiClient, this.flags, this.args, this.config),
+            projectId: await withProjectId(this.apiClient, List, this.flags, this.args, this.config),
         };
         return await this.apiClient.cronjob.listCronjobs({
             pathParameters: pathParams,

package/dist/esm/commands/project/delete.d.ts

@@ -7,7 +7,7 @@ export default class Delete extends DeleteBaseCommand<typeof Delete> {
         quiet: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     };
     static args: {
-        [x: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
     };
     protected deleteResource(): Promise<void>;
     protected mapResourceId(id: string): Promise<string>;

package/dist/esm/commands/project/delete.js

@@ -8,7 +8,7 @@ export default class Delete extends DeleteBaseCommand {
     static flags = { ...DeleteBaseCommand.baseFlags };
     static args = { ...projectArgs };
     async deleteResource() {
-        const projectId = await withProjectId(this.apiClient, {}, this.args, this.config);
+        const projectId = await withProjectId(this.apiClient, Delete, {}, this.args, this.config);
         const response = await this.apiClient.project.deleteProject({
             pathParameters: { projectId },
         });

package/dist/esm/commands/project/filesystem/usage.d.ts

@@ -8,7 +8,7 @@ export declare class Usage extends RenderBaseCommand<typeof Usage> {
         human: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     };
     static args: {
-        [x: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
     };
     protected render(): ReactNode;
 }

package/dist/esm/commands/project/filesystem/usage.js

@@ -22,7 +22,7 @@ export class Usage extends RenderBaseCommand {
     };
     static args = { ...projectArgs };
     render() {
-        const projectId = usePromise(() => withProjectId(this.apiClient, this.flags, this.args, this.config), []);
+        const projectId = usePromise(() => withProjectId(this.apiClient, Usage, this.flags, this.args, this.config), []);
         const project = usePromise((id) => this.apiClient.project.getProject({ pathParameters: { id } }), [projectId]);
         const projectDiskUsage = usePromise((id) => this.apiClient.projectFileSystem.getDiskUsage({
             pathParameters: { projectId: id },

package/dist/esm/commands/project/get.d.ts

@@ -7,7 +7,7 @@ export declare class Get extends RenderBaseCommand<typeof Get> {
         [x: string]: import("@oclif/core/lib/interfaces/parser.js").CompletableFlag<any>;
     };
     static args: {
-        [x: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
     };
     protected formatter: GetFormatter;
     protected render(): ReactNode;

package/dist/esm/commands/project/get.js

@@ -66,12 +66,12 @@ const GetProject = ({ response }) => {
     return (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: sections }));
 };
 export class Get extends RenderBaseCommand {
-    static description = "Get a Project.";
+    static description = "Get details of a project";
     static flags = { ...GetBaseCommand.baseFlags };
     static args = { ...projectArgs };
     formatter = new GetFormatter(new ComponentPrinter((r) => _jsx(GetProject, { response: r })));
     render() {
-        const projectId = usePromise(() => withProjectId(this.apiClient, this.flags, this.args, this.config), []);
+        const projectId = usePromise(() => withProjectId(this.apiClient, Get, this.flags, this.args, this.config), []);
         const projectResponse = usePromise((id) => this.apiClient.project.getProject({ pathParameters: { id } }), [projectId]);
         assertStatus(projectResponse, 200);
         if (this.flags.output === "json") {

package/dist/esm/commands/project/list.d.ts

@@ -1,11 +1,19 @@
 import { Simplify } from "@mittwald/api-client-commons";
 import { ListColumns } from "../../Formatter.js";
-import { MittwaldAPIV2, MittwaldAPIV2Client as MittwaldAPIClient } from "@mittwald/api-client";
+import { MittwaldAPIV2, MittwaldAPIV2Client, MittwaldAPIV2Client as MittwaldAPIClient } from "@mittwald/api-client";
 import { GeneratedProjectListProjects } from "../../generated/project/listProjects.js";
 import { SuccessfulResponse } from "../../types.js";
+import { ListBaseCommand } from "../../ListBaseCommand.js";
 type ProjectResponse = Awaited<ReturnType<MittwaldAPIClient["project"]["listProjects"]>>;
 type ProjectResponseItem = Simplify<MittwaldAPIV2.Paths.V2Projects.Get.Responses.$200.Content.ApplicationJson[number]>;
-export default class List extends GeneratedProjectListProjects<ProjectResponseItem> {
+type Response = Awaited<ReturnType<MittwaldAPIV2Client["project"]["listProjects"]>>;
+export declare class List extends ListBaseCommand<typeof GeneratedProjectListProjects, ProjectResponseItem, Response> {
+    static description: string;
+    static args: {};
+    static flags: {
+        [x: string]: import("@oclif/core/lib/interfaces/parser.js").CompletableFlag<any>;
+    };
+    getData(): Promise<Response>;
     protected mapData(data: SuccessfulResponse<ProjectResponse, 200>["data"]): ProjectResponseItem[];
     protected getColumns(ignoredData: ProjectResponseItem[]): ListColumns<ProjectResponseItem>;
 }

package/dist/esm/commands/project/list.js

@@ -1,5 +1,13 @@
-import { GeneratedProjectListProjects } from "../../generated/project/listProjects.js";
-export default class List extends GeneratedProjectListProjects {
+import { ListBaseCommand } from "../../ListBaseCommand.js";
+export class List extends ListBaseCommand {
+    static description = "List all projects that you have access to";
+    static args = {};
+    static flags = {
+        ...ListBaseCommand.baseFlags,
+    };
+    async getData() {
+        return await this.apiClient.project.listProjects();
+    }
     mapData(data) {
         return data;
     }

package/dist/esm/commands/project/ssh.d.ts

@@ -2,7 +2,7 @@ import { BaseCommand } from "../../BaseCommand.js";
 export default class Ssh extends BaseCommand {
     static description: string;
     static args: {
-        [x: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
     };
     run(): Promise<void>;
 }

package/dist/esm/commands/project/ssh.js

@@ -7,7 +7,7 @@ export default class Ssh extends BaseCommand {
     static args = { ...projectArgs };
     async run() {
         const { args } = await this.parse(Ssh);
-        const id = await withProjectId(this.apiClient, {}, args, this.config);
+        const id = await withProjectId(this.apiClient, Ssh, {}, args, this.config);
         const projectResponse = await this.apiClient.project.getProject({
             pathParameters: { id },
         });

package/dist/esm/commands/project/update.d.ts

@@ -2,7 +2,7 @@ import { BaseCommand } from "../../BaseCommand.js";
 export default class Update extends BaseCommand {
     static description: string;
     static args: {
-        [x: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
     };
     run(): Promise<void>;
 }

package/dist/esm/commands/project/update.js

@@ -5,7 +5,7 @@ export default class Update extends BaseCommand {
     static args = { ...projectArgs };
     async run() {
         const { args } = await this.parse(Update);
-        const id = await withProjectId(this.apiClient, {}, args, this.config);
+        const id = await withProjectId(this.apiClient, Update, {}, args, this.config);
         console.log("updating project ", id);
         console.log("TODO: Implement me");
     }

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

@@ -25,7 +25,7 @@ export class AppInstaller {
     }
     async exec(apiClient, args, flags, config) {
         const process = makeProcessRenderer(flags, `Installing ${this.appName}`);
-        const projectId = await withProjectId(apiClient, flags, args, config);
+        const projectId = await withProjectId(apiClient, "flag", flags, args, config);
         await autofillFlags(apiClient, process, this.appSupportedFlags, flags, projectId, this.appName);
         const appVersion = await normalizeToAppVersionUuid(apiClient, flags.version, process, this.appId);
         const [appInstallationId, eventId] = await triggerAppInstallation(apiClient, process, projectId, flags, appVersion);

package/dist/esm/lib/context_flags.d.ts

@@ -2,17 +2,28 @@ import { Config } from "@oclif/core";
 import { Arg, ArgOutput, FlagOutput, OptionFlag } from "@oclif/core/lib/interfaces/parser.js";
 import { MittwaldAPIV2Client } from "@mittwald/api-client";
 import { AlphabetLowercase } from "@oclif/core/lib/interfaces/index.js";
-type ContextFlags = {
-    [k: string]: OptionFlag<unknown>;
+type FlagIDType<N extends string> = `${N}-id`;
+type ContextFlags<N extends string, TID extends string = FlagIDType<N>> = {
+    [k in TID]: OptionFlag<string>;
 };
-type ContextArgs = {
-    [k: string]: Arg<unknown>;
+type ContextArgs<N extends string, TID extends string = FlagIDType<N>> = {
+    [k in TID]: Arg<string>;
 };
-export type FlagSet = {
-    flags: ContextFlags;
-    args: ContextArgs;
-    withId: (apiClient: MittwaldAPIV2Client, flags: FlagOutput, args: ArgOutput, cfg: Config) => Promise<string>;
+type CommandType<N extends string, TID extends string = FlagIDType<N>> = {
+    flags: {
+        [k in TID]: OptionFlag<string>;
+    };
+} | {
+    args: {
+        [k in TID]: Arg<string>;
+    };
+};
+export type FlagSet<TName extends string> = {
+    name: TName;
+    flags: ContextFlags<TName>;
+    args: ContextArgs<TName>;
+    withId: (apiClient: MittwaldAPIV2Client, command: CommandType<TName> | "flag" | "arg", flags: FlagOutput, args: ArgOutput, cfg: Config) => Promise<string>;
 };
 export type NormalizeFn = (apiClient: MittwaldAPIV2Client, id: string) => string | Promise<string>;
-export declare function makeFlagSet(name: string, char: AlphabetLowercase, normalize?: NormalizeFn): FlagSet;
+export declare function makeFlagSet<TName extends string>(name: TName, char: AlphabetLowercase, normalize?: NormalizeFn): FlagSet<TName>;
 export {};

package/dist/esm/lib/context_flags.js

@@ -1,5 +1,15 @@
 import { Args, Flags } from "@oclif/core";
 import { Context } from "./context.js";
+class MissingFlagError extends Error {
+    constructor(name, flagName) {
+        super(`No ${name} ID given. Please specify one with --${flagName} or set a default ${name} with 'mittwald context set --${flagName} <${flagName}>'`);
+    }
+}
+class MissingArgError extends Error {
+    constructor(name, flagName) {
+        super(`No ${name} ID given. Please specify one as positional argument or set a default ${name} with 'mittwald context set --${flagName} <${flagName}>'`);
+    }
+}
 export function makeFlagSet(name, char, normalize = (_, id) => id) {
     const flagName = `${name}-id`;
     const flags = {
@@ -24,7 +34,7 @@ export function makeFlagSet(name, char, normalize = (_, id) => id) {
         }
         return undefined;
     };
-    const withId = async (apiClient, flags, args, cfg) => {
+    const withId = async (apiClient, commandType, flags, args, cfg) => {
         const idInput = idFromArgsOrFlag(flags, args);
         if (idInput) {
             return normalize(apiClient, idInput);
@@ -33,9 +43,22 @@ export function makeFlagSet(name, char, normalize = (_, id) => id) {
         if (idFromContext) {
             return idFromContext;
         }
-        throw new Error(`No ${name} ID given. Please specify one with --${flagName} or set a default server with 'mittwald context set --${flagName} <${flagName}>'`);
+        if (commandType === "flag") {
+            throw new MissingFlagError(name, flagName);
+        }
+        if (commandType === "arg") {
+            throw new MissingArgError(name, flagName);
+        }
+        if ("flags" in commandType && flagName in commandType.flags) {
+            throw new MissingFlagError(name, flagName);
+        }
+        if ("args" in commandType && flagName in commandType.args) {
+            throw new MissingArgError(name, flagName);
+        }
+        throw new Error(`No ${name} ID given. Please consult the --help page of this command or set a default ${name} with 'mittwald context set --${flagName} <${flagName}>'`);
     };
     return {
+        name,
         flags,
         args,
         withId,

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

@@ -35,7 +35,7 @@ export async function withMySQLId(apiClient, flags, args, cfg) {
     if (isUuid(candidate)) {
         return candidate;
     }
-    const projectId = await withProjectId(apiClient, flags, args, cfg);
+    const projectId = await withProjectId(apiClient, "flag", flags, args, cfg);
     const databases = await apiClient.database.listMysqlDatabases({
         pathParameters: { projectId },
     });

package/dist/esm/lib/database/redis/flags.js

@@ -22,7 +22,7 @@ export async function withRedisId(apiClient, flags, args, cfg) {
     if (isUuid(candidate)) {
         return candidate;
     }
-    const projectId = await withProjectId(apiClient, flags, args, cfg);
+    const projectId = await withProjectId(apiClient, "flag", flags, args, cfg);
     const databases = await apiClient.database.listRedisDatabases({
         pathParameters: { projectId },
     });

package/dist/esm/lib/handleError.js

@@ -1,6 +1,5 @@
-import oclif from "@oclif/core";
 import { ApiClientError } from "@mittwald/api-client-commons";
-import { CLIError, ExitError } from "@oclif/core/lib/errors/index.js";
+import { ExitError } from "@oclif/core/lib/errors/index.js";
 import { renderError } from "../rendering/react/error.js";
 export const handleError = (error) => {
     if (!isUnexpectedError(error)) {
@@ -11,24 +10,8 @@ export const handleError = (error) => {
         process.exit(error.oclif.exit);
         return;
     }
-    if (error instanceof CLIError) {
-        renderError(error);
-        process.exit(1);
-        return;
-    }
-    if (error instanceof ApiClientError) {
-        const responseJson = JSON.stringify(error.response?.data, undefined, 2);
-        const errorMessage = `\
-${error.message}
-
-Response:
-─────────
-${responseJson}`;
-        error = new Error(errorMessage, {
-            cause: error,
-        });
-    }
-    oclif.Errors.handle(error);
+    renderError(error);
+    process.exit(1);
 };
 export function isUnexpectedError(err) {
     return !isValidationError(err);

package/dist/esm/lib/org/flags.d.ts

@@ -1,5 +1,13 @@
 export declare const orgFlags: {
-    [k: string]: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<unknown>;
+    "org-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
 }, orgArgs: {
-    [k: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
-}, withOrgId: (apiClient: import("@mittwald/api-client").MittwaldAPIV2Client, flags: import("@oclif/core/lib/interfaces/parser.js").FlagOutput, args: import("@oclif/core/lib/interfaces/parser.js").ArgOutput, cfg: import("@oclif/core").Config) => Promise<string>;
+    "org-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+}, withOrgId: (apiClient: import("@mittwald/api-client").MittwaldAPIV2Client, command: "flag" | "arg" | ({
+    flags: {
+        "org-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
+    };
+} | {
+    args: {
+        "org-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+    };
+}), flags: import("@oclif/core/lib/interfaces/parser.js").FlagOutput, args: import("@oclif/core/lib/interfaces/parser.js").ArgOutput, cfg: import("@oclif/core").Config) => Promise<string>;

package/dist/esm/lib/project/flags.d.ts

@@ -1,5 +1,13 @@
 export declare const projectFlags: {
-    [k: string]: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<unknown>;
+    "project-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
 }, projectArgs: {
-    [k: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
-}, withProjectId: (apiClient: import("@mittwald/api-client").MittwaldAPIV2Client, flags: import("@oclif/core/lib/interfaces/parser.js").FlagOutput, args: import("@oclif/core/lib/interfaces/parser.js").ArgOutput, cfg: import("@oclif/core").Config) => Promise<string>;
+    "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+}, withProjectId: (apiClient: import("@mittwald/api-client").MittwaldAPIV2Client, command: "flag" | "arg" | ({
+    flags: {
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
+    };
+} | {
+    args: {
+        "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+    };
+}), flags: import("@oclif/core/lib/interfaces/parser.js").FlagOutput, args: import("@oclif/core/lib/interfaces/parser.js").ArgOutput, cfg: import("@oclif/core").Config) => Promise<string>;

package/dist/esm/lib/server/flags.d.ts

@@ -1,5 +1,13 @@
 export declare const serverFlags: {
-    [k: string]: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<unknown>;
+    "server-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
 }, serverArgs: {
-    [k: string]: import("@oclif/core/lib/interfaces/parser.js").Arg<unknown>;
-}, withServerId: (apiClient: import("@mittwald/api-client").MittwaldAPIV2Client, flags: import("@oclif/core/lib/interfaces/parser.js").FlagOutput, args: import("@oclif/core/lib/interfaces/parser.js").ArgOutput, cfg: import("@oclif/core").Config) => Promise<string>;
+    "server-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+}, withServerId: (apiClient: import("@mittwald/api-client").MittwaldAPIV2Client, command: "flag" | "arg" | ({
+    flags: {
+        "server-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
+    };
+} | {
+    args: {
+        "server-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+    };
+}), flags: import("@oclif/core/lib/interfaces/parser.js").FlagOutput, args: import("@oclif/core/lib/interfaces/parser.js").ArgOutput, cfg: import("@oclif/core").Config) => Promise<string>;

package/dist/esm/rendering/react/ExecRenderBaseCommand.js

@@ -4,12 +4,22 @@ import { render, Text } from "ink";
 import { RenderContextProvider } from "./context.js";
 import { ExtendedBaseCommand } from "../../ExtendedBaseCommand.js";
 const RenderComponent = (p) => (_jsx(_Fragment, { children: p.render() }));
+function wrapRender(fn) {
+    return (result) => {
+        const innerResult = fn(result);
+        if (typeof innerResult === "string") {
+            return _jsx(Text, { children: innerResult });
+        }
+        return innerResult;
+    };
+}
 export class ExecRenderBaseCommand extends ExtendedBaseCommand {
     async run() {
         const result = await this.exec();
+        const wrappedRender = wrapRender(this.render.bind(this));
         render(_jsx(RenderContextProvider, { value: {
                 apiClient: this.apiClient,
                 renderAsJson: false,
-            }, children: _jsx(Suspense, { fallback: _jsx(Text, { children: "Loading..." }), children: _jsx(RenderComponent, { render: () => this.render(result) }) }) }));
+            }, children: _jsx(Suspense, { fallback: _jsx(Text, { children: "Loading..." }), children: _jsx(RenderComponent, { render: () => wrappedRender(result) }) }) }));
     }
 }

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

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Box, Text } from "ink";
 import Link from "ink-link";
 import { FailedFlagValidationError, RequiredArgsError, } from "@oclif/core/lib/parser/errors.js";
+import { ApiClientError, } from "@mittwald/api-client-commons";
 const color = "red";
 const issueURL = "https://github.com/mittwald/cli/issues/new";
 const boxProps = {
@@ -12,8 +13,11 @@ const boxProps = {
     paddingX: 1,
     rowGap: 1,
 };
+const ErrorStack = ({ err }) => {
+    return (_jsxs(Box, { marginX: 2, marginY: 1, flexDirection: "column", rowGap: 1, children: [_jsx(Text, { color: color, dimColor: true, bold: true, children: "ERROR STACK TRACE" }), _jsx(Text, { color: color, dimColor: true, children: "Please provide this when opening a bug report." }), _jsx(Text, { color: color, dimColor: true, children: err.stack })] }));
+};
 const GenericError = ({ err, withStack, }) => {
-    return (_jsxs(_Fragment, { children: [_jsxs(Box, { ...boxProps, borderColor: color, children: [_jsx(Text, { color: color, bold: true, underline: true, children: "ERROR" }), _jsx(Text, { color: color, children: "An error occurred while executing this command:" }), _jsx(Box, { marginX: 2, children: _jsx(Text, { color: color, children: err.toString() }) }), _jsxs(Text, { color: color, children: ["If you believe this to be a bug, please open an issue at", " ", _jsx(Link, { url: issueURL, children: issueURL }), "."] })] }), withStack && "stack" in err ? (_jsxs(Box, { marginX: 2, marginY: 1, flexDirection: "column", rowGap: 1, children: [_jsx(Text, { color: color, dimColor: true, bold: true, children: "ERROR STACK TRACE" }), _jsx(Text, { color: color, dimColor: true, children: "Please provide this when opening a bug report." }), _jsx(Text, { color: color, dimColor: true, children: err.stack })] })) : undefined] }));
+    return (_jsxs(_Fragment, { children: [_jsxs(Box, { ...boxProps, borderColor: color, children: [_jsx(Text, { color: color, bold: true, underline: true, children: "ERROR" }), _jsx(Text, { color: color, children: "An error occurred while executing this command:" }), _jsx(Box, { marginX: 2, children: _jsx(Text, { color: color, children: err.toString() }) }), _jsxs(Text, { color: color, children: ["If you believe this to be a bug, please open an issue at", " ", _jsx(Link, { url: issueURL, children: issueURL }), "."] })] }), withStack && "stack" in err ? _jsx(ErrorStack, { err: err }) : undefined] }));
 };
 const InvalidFlagsError = ({ err }) => {
     const color = "yellow";
@@ -23,6 +27,25 @@ const InvalidArgsError = ({ err }) => {
     const color = "yellow";
     return (_jsxs(Box, { ...boxProps, borderColor: color, children: [_jsx(Text, { color: color, bold: true, underline: true, children: "INVALID COMMAND ARGUMENTS" }), _jsxs(Text, { color: color, children: ["The arguments that you provided for this command were invalid.", " ", err.message] })] }));
 };
+const RequestHeaders = ({ headers }) => {
+    const lines = headers.trim().split("\r\n");
+    const requestLine = lines.shift();
+    const values = lines.map((line) => line.split(": ", 2));
+    const maxKeyLength = Math.max(...values.map(([key]) => key.length));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, children: requestLine }), values.map(([key, value]) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { dimColor: true, children: [key.toLowerCase().padEnd(maxKeyLength, " "), " "] }), _jsx(Text, { bold: true, children: key === "x-access-token" ? "[redacted]" : value })] }, key)))] }));
+};
+const Response = ({ status, statusText, body, headers }) => {
+    const keys = Object.keys(headers);
+    const maxKeyLength = Math.max(...keys.map((key) => key.length));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, underline: true, children: [status, " ", statusText] }, "status"), keys.map((key) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { dimColor: true, children: [key.toLowerCase().padEnd(maxKeyLength, " "), " "] }), _jsx(Text, { bold: true, children: key === "x-access-token" ? "[redacted]" : headers[key] })] }, key))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: JSON.stringify(body, undefined, 2) }) }, "body")] }));
+};
+const HttpMessages = ({ err }) => {
+    const response = err.response ? (_jsx(Response, { status: err.response.status, statusText: err.response.statusText, body: err.response.data, headers: err.response.headers })) : (_jsx(Text, { children: "no response received" }));
+    return (_jsxs(Box, { marginX: 2, marginY: 1, flexDirection: "column", rowGap: 1, children: [_jsx(RequestHeaders, { headers: err.request._header }), response] }));
+};
+const ApiError = ({ err, withStack, withHTTPMessages }) => {
+    return (_jsxs(_Fragment, { children: [_jsxs(Box, { ...boxProps, children: [_jsx(Text, { color: color, bold: true, underline: true, children: "API CLIENT ERROR" }), _jsxs(Text, { color: color, children: ["An error occurred while communicating with the API: ", err.message] }), _jsx(Text, { children: JSON.stringify(err.response?.data, undefined, 2) })] }), withHTTPMessages === "full" ? _jsx(HttpMessages, { err: err }) : undefined, withStack && "stack" in err ? _jsx(ErrorStack, { err: err }) : undefined] }));
+};
 /**
  * Render an error to the terminal.
  *
@@ -37,6 +60,9 @@ export const ErrorBox = ({ err }) => {
     else if (err instanceof RequiredArgsError) {
         return _jsx(InvalidArgsError, { err: err });
     }
+    else if (err instanceof ApiClientError) {
+        return _jsx(ApiError, { err: err, withStack: true, withHTTPMessages: "body" });
+    }
     else if (err instanceof Error) {
         return _jsx(GenericError, { err: err, withStack: true });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/cli",
-  "version": "1.0.0-alpha.20",
+  "version": "1.0.0-alpha.21",
   "description": "Hand-crafted CLI for the mittwald API",
   "license": "MIT",
   "author": {
@@ -118,7 +118,15 @@
     "topicSeparator": " ",
     "topics": {
       "app": {
-        "description": "Manage apps, and app installations in your projects"
+        "description": "Manage apps, and app installations in your projects",
+        "subtopics": {
+          "install": {
+            "description": "Install apps in your projects"
+          },
+          "dependency": {
+            "description": "Manage the system dependencies of your apps"
+          }
+        }
       },
       "article": {
         "description": "Query available hosting articles"
@@ -148,7 +156,33 @@
         "description": "Manage your organizations, and also any kinds of user memberships concerning these organizations."
       },
       "project": {
-        "description": "Manage your projects, and also any kinds of user memberships concerning these projects."
+        "description": "Manage your projects, and also any kinds of user memberships concerning these projects.",
+        "subtopics": {
+          "backup": {
+            "description": "Manage backups of your projects"
+          },
+          "backupschedule": {
+            "description": "Manage backup schedules of your projects"
+          },
+          "cronjob": {
+            "description": "Manage cronjobs of your projects"
+          },
+          "filesystem": {
+            "description": "Interact with the filesystem of your project"
+          },
+          "invite": {
+            "description": "Invite users to your projects and manage their invitations"
+          },
+          "membership": {
+            "description": "Control who gets to work on your projects, and who doesn't"
+          },
+          "sftp-user": {
+            "description": "Manage SFTP users of your projects"
+          },
+          "ssh-user": {
+            "description": "Manage SSH users of your projects"
+          }
+        }
       },
       "server": {
         "description": "Manage your servers"

package/dist/esm/commands/project/list-react.d.ts

@@ -1,11 +0,0 @@
-import React from "react";
-import { RenderBaseCommand } from "../../rendering/react/RenderBaseCommand.js";
-export default class List extends RenderBaseCommand<typeof List> {
-    static flags: {
-        columns: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        extended: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
-        noTruncate: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
-        wait: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<any>;
-    };
-    protected render(): React.ReactNode;
-}

package/dist/esm/commands/project/list-react.js

@@ -1,42 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { assertStatus } from "@mittwald/api-client-commons";
-import { usePromise } from "@mittwald/react-use-promise";
-import { RenderBaseCommand } from "../../rendering/react/RenderBaseCommand.js";
-import { useRenderContext } from "../../rendering/react/context.js";
-import { Table } from "../../rendering/react/components/Table/index.js";
-import { UsePromiseRenderSetup } from "../../rendering/setup/usePromiseSetup.js";
-import { TableRenderSetup } from "../../rendering/setup/TableRenderSetup.js";
-import { ProjectStatus } from "../../rendering/react/components/Project/ProjectStatus.js";
-const usePromiseSetup = new UsePromiseRenderSetup();
-const tableSetupInstance = new TableRenderSetup();
-export default class List extends RenderBaseCommand {
-    static flags = {
-        ...usePromiseSetup.flags,
-        ...tableSetupInstance.flags,
-        ...RenderBaseCommand.buildFlags(),
-    };
-    render() {
-        const { apiClient } = useRenderContext();
-        const tableSetup = tableSetupInstance.getSetup(this.flags);
-        const usePromiseOptions = usePromiseSetup.getSetup(this.flags);
-        const projects = usePromise(apiClient.project.listProjects, [], usePromiseOptions);
-        assertStatus(projects, 200);
-        return (_jsx(Table, { data: projects.data, setup: tableSetup, columns: {
-                id: {
-                    isUuid: true,
-                },
-                shortId: {
-                    minWidth: 8,
-                },
-                customerId: {
-                    isUuid: true,
-                    extended: true,
-                },
-                description: {},
-                status: {
-                    render: (project) => _jsx(ProjectStatus, { project: project }),
-                },
-                createdAt: {},
-            } }));
-    }
-}