@mittwald/cli 1.0.0-alpha.27 → 1.0.0-alpha.28

package/dist/esm/commands/domain/virtualhost/create.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ExecRenderBaseCommand } from "../../../rendering/react/ExecRenderBaseCommand.js";
 import { makeProcessRenderer, processFlags, } from "../../../rendering/process/process_flags.js";
-import { projectFlags, withProjectId } from "../../../lib/project/flags.js";
+import { projectFlags } from "../../../lib/project/flags.js";
 import { assertStatus } from "@mittwald/api-client-commons";
 import { Flags } from "@oclif/core";
 import { Success } from "../../../rendering/react/components/Success.js";
@@ -50,7 +50,7 @@ export default class Create extends ExecRenderBaseCommand {
         }),
     };
     async exec() {
-        const projectId = await withProjectId(this.apiClient, Create, this.flags, this.args, this.config);
+        const projectId = await this.withProjectId(Create);
         const process = makeProcessRenderer(this.flags, "Creating a new ingress");
         const { hostname } = this.flags;
         const paths = [];
@@ -67,7 +67,7 @@ export default class Create extends ExecRenderBaseCommand {
             paths.push({ path, target: { url } });
         }
         const { id: ingressId } = await process.runStep("creating ingress", async () => {
-            const response = await this.apiClient.domain.ingressCreate({
+            const response = await this.apiClient.domain.ingressCreateIngress({
                 data: {
                     projectId,
                     hostname,
@@ -79,7 +79,7 @@ export default class Create extends ExecRenderBaseCommand {
         });
         const [ingress, ownership] = await process.runStep("waiting for ingress to be ready", async () => {
             return await waitUntil(async () => {
-                const response = await this.apiClient.domain.ingressGetSpecific({
+                const response = await this.apiClient.domain.ingressGetIngress({
                     ingressId,
                 });
                 if (response.status !== 200) {

package/dist/esm/commands/domain/virtualhost/delete.js

@@ -13,7 +13,7 @@ export default class Delete extends DeleteBaseCommand {
     };
     async deleteResource() {
         const ingressId = this.args["virtual-host-id"];
-        const response = await this.apiClient.domain.ingressDelete({
+        const response = await this.apiClient.domain.ingressDeleteIngress({
             ingressId,
         });
         assertStatus(response, 204);

package/dist/esm/commands/domain/virtualhost/get.js

@@ -74,7 +74,7 @@ export class Get extends RenderBaseCommand {
     };
     render() {
         const ingressId = this.args["ingress-id"];
-        const ingressResponse = usePromise((id) => this.apiClient.domain.ingressGetSpecific({
+        const ingressResponse = usePromise((id) => this.apiClient.domain.ingressGetIngress({
             ingressId: id,
         }), [ingressId]);
         assertStatus(ingressResponse, 200);

package/dist/esm/commands/domain/virtualhost/list.d.ts

@@ -4,8 +4,7 @@ import { SuccessfulResponse } from "../../../types.js";
 import { ListBaseCommand } from "../../../ListBaseCommand.js";
 import { ListColumns } from "../../../Formatter.js";
 type ResponseItem = Simplify<MittwaldAPIV2.Paths.V2Ingresses.Get.Responses.$200.Content.ApplicationJson[number]>;
-export type PathParams = MittwaldAPIV2.Paths.V2Ingresses.Get.Parameters.Path;
-export type Response = Awaited<ReturnType<MittwaldAPIV2Client["domain"]["ingressListAccessible"]>>;
+type Response = Awaited<ReturnType<MittwaldAPIV2Client["domain"]["ingressListIngresses"]>>;
 export declare class List extends ListBaseCommand<typeof List, ResponseItem, Response> {
     static description: string;
     static args: {};
@@ -14,7 +13,6 @@ export declare class List extends ListBaseCommand<typeof List, ResponseItem, Res
         "project-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
     };
     getData(): Promise<Response>;
-    protected mapParams(input: PathParams): Promise<PathParams> | PathParams;
     protected mapData(data: SuccessfulResponse<Response, 200>["data"]): ResponseItem[] | Promise<ResponseItem[]>;
     protected getColumns(data: ResponseItem[]): ListColumns<ResponseItem>;
 }

package/dist/esm/commands/domain/virtualhost/list.js

@@ -1,6 +1,6 @@
 import { ListBaseCommand } from "../../../ListBaseCommand.js";
 import { Flags } from "@oclif/core";
-import { projectFlags, withProjectId } from "../../../lib/project/flags.js";
+import { projectFlags } from "../../../lib/project/flags.js";
 export class List extends ListBaseCommand {
     static description = "List virtualhosts for a project.";
     static args = {};
@@ -14,16 +14,13 @@ export class List extends ListBaseCommand {
     };
     async getData() {
         if (this.flags.all) {
-            return await this.apiClient.domain.ingressListAccessible({});
+            return await this.apiClient.domain.ingressListIngresses({});
         }
-        const projectId = await withProjectId(this.apiClient, List, this.flags, this.args, this.config);
-        return await this.apiClient.domain.ingressListForProject({
-            projectId,
+        const projectId = await this.withProjectId(List);
+        return await this.apiClient.domain.ingressListIngresses({
+            queryParameters: { projectId },
         });
     }
-    mapParams(input) {
-        return input;
-    }
     mapData(data) {
         return data;
     }

package/dist/esm/commands/mail/address/create.d.ts

@@ -1,6 +1,7 @@
 import { ExecRenderBaseCommand } from "../../../rendering/react/ExecRenderBaseCommand.js";
 import { ReactNode } from "react";
 import { ProcessRenderer } from "../../../rendering/process/process.js";
+import { FlagInput, OutputFlags } from "@oclif/core/lib/interfaces/parser.js";
 type CreateResult = {
     addressId: string;
     generatedPassword: string | null;
@@ -15,6 +16,7 @@ export default class Create extends ExecRenderBaseCommand<typeof Create, CreateR
         quota: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         password: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         "random-password": import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        "forward-to": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         quiet: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         "project-id": import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string>;
     };
@@ -23,6 +25,8 @@ export default class Create extends ExecRenderBaseCommand<typeof Create, CreateR
         command: string;
     }[];
     protected getPassword(process: ProcessRenderer): Promise<[string, boolean]>;
+    protected createForwardAddress(projectId: string, process: ProcessRenderer, flags: OutputFlags<FlagInput<typeof Create.flags>>): Promise<CreateResult>;
+    protected createMailbox(projectId: string, process: ProcessRenderer, flags: OutputFlags<FlagInput<typeof Create.flags>>): Promise<CreateResult>;
     protected exec(): Promise<CreateResult>;
     protected render(executionResult: CreateResult): ReactNode;
 }

package/dist/esm/commands/mail/address/create.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Flags } from "@oclif/core";
 import { assertStatus } from "@mittwald/api-client-commons";
-import { projectFlags, withProjectId } from "../../../lib/project/flags.js";
+import { projectFlags } from "../../../lib/project/flags.js";
 import { ExecRenderBaseCommand } from "../../../rendering/react/ExecRenderBaseCommand.js";
 import { makeProcessRenderer, processFlags, } from "../../../rendering/process/process_flags.js";
 import { Text } from "ink";
@@ -11,6 +11,14 @@ import { Value } from "../../../rendering/react/components/Value.js";
 export default class Create extends ExecRenderBaseCommand {
     static summary = "Create a new mail address";
     static description = `\
+    This command can be used to create a new mail address in a project.
+    
+    A mail address is either associated with a mailbox, or forwards to another address.
+    
+    To create a forwarding address, use the --forward-to flag. This flag can be used multiple times to forward to multiple addresses.
+    
+    When no --forward-to flag is given, the command will create a mailbox for the address. In this case, the --catch-all flag can be used to make the mailbox a catch-all mailbox.
+  
     When running this command with the --quiet flag, the output will contain the ID of the newly created address.
     In addition, when run with --generated-password the output will be the ID of the newly created address, followed by a tab character and the generated password.`;
     static flags = {
@@ -41,6 +49,24 @@ export default class Create extends ExecRenderBaseCommand {
             summary: "generate a random password",
             description: "This flag will cause the command to generate a random 32-character password for the mailbox; when running with --quiet, the address ID and the password will be printed to stdout, separated by a tab character.",
         }),
+        "forward-to": Flags.string({
+            summary: "forward mail to another address",
+            default: undefined,
+            multiple: true,
+            description: "This flag will cause the mailbox to forward all incoming mail to the given address.\n\nNote: This flag is exclusive with --catch-all, --enable-spam-protection, --quota, --password and --random-password.",
+            relationships: [
+                {
+                    type: "none",
+                    flags: [
+                        "catch-all",
+                        "enable-spam-protection",
+                        "quota",
+                        "password",
+                        "random-password",
+                    ],
+                },
+            ],
+        }),
     };
     static examples = [
         {
@@ -51,6 +77,10 @@ export default class Create extends ExecRenderBaseCommand {
             description: "Create non-interactively with random password",
             command: "<%= config.bin %> <%= command.id %> --random-password --address foo@bar.example",
         },
+        {
+            description: "Create a forwarding address",
+            command: "<%= config.bin %> <%= command.id %> --address foo@bar.example --forward-to bar@bar.example --forward-to baz@bar.example",
+        },
     ];
     async getPassword(process) {
         if (this.flags.password) {
@@ -65,10 +95,25 @@ export default class Create extends ExecRenderBaseCommand {
         }
         return [await process.addInput(_jsx(Text, { children: "Mailbox password" }), true), false];
     }
-    async exec() {
-        const { flags } = await this.parse(Create);
-        const projectId = await withProjectId(this.apiClient, Create, flags, {}, this.config);
-        const process = makeProcessRenderer(flags, "Creating a new mail address");
+    async createForwardAddress(projectId, process, flags) {
+        const response = await process.runStep("creating mail address", async () => {
+            const response = await this.apiClient.mail.createMailAddress({
+                projectId,
+                data: {
+                    address: flags.address,
+                    forwardAddresses: flags["forward-to"],
+                },
+            });
+            assertStatus(response, 201);
+            return response;
+        });
+        process.complete(_jsx(Success, { children: "Your mail address was successfully created." }));
+        return {
+            addressId: response.data.id,
+            generatedPassword: null,
+        };
+    }
+    async createMailbox(projectId, process, flags) {
         const [password, passwordGenerated] = await this.getPassword(process);
         const response = await process.runStep("creating mail address", async () => {
             const response = await this.apiClient.mail.createMailAddress({
@@ -92,6 +137,15 @@ export default class Create extends ExecRenderBaseCommand {
             generatedPassword: passwordGenerated ? password : null,
         };
     }
+    async exec() {
+        const { flags } = await this.parse(Create);
+        const projectId = await this.withProjectId(Create);
+        const process = makeProcessRenderer(flags, "Creating a new mail address");
+        if (flags["forward-to"]) {
+            return this.createForwardAddress(projectId, process, flags);
+        }
+        return this.createMailbox(projectId, process, flags);
+    }
     render(executionResult) {
         if (this.flags.quiet) {
             if (executionResult.generatedPassword) {

package/dist/esm/commands/mail/address/list.d.ts

@@ -4,8 +4,8 @@ import { SuccessfulResponse } from "../../../types.js";
 import { ListColumns } from "../../../Formatter.js";
 import { ListBaseCommand } from "../../../ListBaseCommand.js";
 type ResponseItem = Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdMailAddresses.Get.Responses.$200.Content.ApplicationJson[number]>;
-export type PathParams = MittwaldAPIV2.Paths.V2ProjectsProjectIdMailAddresses.Get.Parameters.Path;
-export type Response = Awaited<ReturnType<MittwaldAPIV2Client["mail"]["listMailAddresses"]>>;
+type PathParams = MittwaldAPIV2.Paths.V2ProjectsProjectIdMailAddresses.Get.Parameters.Path;
+type Response = Awaited<ReturnType<MittwaldAPIV2Client["mail"]["listMailAddresses"]>>;
 export declare class List extends ListBaseCommand<typeof List, ResponseItem, Response> {
     static description: string;
     static args: {};

package/dist/esm/commands/mail/address/list.js

@@ -10,10 +10,8 @@ export class List extends ListBaseCommand {
         ...projectFlags,
     };
     async getData() {
-        const pathParams = {
-            projectId: this.flags["project-id"],
-        };
-        return await this.apiClient.mail.listMailAddresses((await this.mapParams(pathParams)));
+        const projectId = await this.withProjectId(List);
+        return await this.apiClient.mail.listMailAddresses({ projectId });
     }
     mapData(data) {
         return data;

package/dist/esm/commands/mail/deliverybox/list.js

@@ -1,6 +1,6 @@
 import { formatRelativeDate } from "../../../lib/viewhelpers/date.js";
 import { ListBaseCommand } from "../../../ListBaseCommand.js";
-import { projectFlags, withProjectId } from "../../../lib/project/flags.js";
+import { projectFlags } from "../../../lib/project/flags.js";
 export class List extends ListBaseCommand {
     static description = "Get all deliveryboxes by project ID";
     static args = {};
@@ -9,7 +9,7 @@ export class List extends ListBaseCommand {
         ...ListBaseCommand.baseFlags,
     };
     async getData() {
-        const projectId = await withProjectId(this.apiClient, List, this.flags, this.args, this.config);
+        const projectId = await this.withProjectId(List);
         return await this.apiClient.mail.listDeliveryBoxes({ projectId });
     }
     mapData(data) {

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

@@ -1,7 +1,7 @@
 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, withServerId } from "../../lib/server/flags.js";
+import { serverFlags } from "../../lib/server/flags.js";
 import { ExecRenderBaseCommand } from "../../rendering/react/ExecRenderBaseCommand.js";
 import { Text } from "ink";
 import { Success } from "../../rendering/react/components/Success.js";
@@ -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, Create, flags, {}, this.config);
+        const serverId = await this.withServerId(Create);
         const stepCreating = process.addStep(_jsx(Text, { children: "creating a new project" }));
         const result = await this.apiClient.project.createProject({
             serverId,

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

@@ -10,5 +10,4 @@ export default class Delete extends DeleteBaseCommand<typeof Delete> {
         "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

@@ -1,20 +1,16 @@
-import { assertStatus } from "@mittwald/api-client-commons";
-import { normalizeProjectIdToUuid } from "../../Helpers.js";
 import { DeleteBaseCommand } from "../../DeleteBaseCommand.js";
-import { projectArgs, withProjectId } from "../../lib/project/flags.js";
+import { projectArgs } from "../../lib/project/flags.js";
+import assertSuccess from "../../lib/assert_success.js";
 export default class Delete extends DeleteBaseCommand {
     static description = "Delete a project";
     static resourceName = "project";
     static flags = { ...DeleteBaseCommand.baseFlags };
     static args = { ...projectArgs };
     async deleteResource() {
-        const projectId = await withProjectId(this.apiClient, Delete, {}, this.args, this.config);
+        const projectId = await this.withProjectId(Delete);
         const response = await this.apiClient.project.deleteProject({
             projectId,
         });
-        assertStatus(response, 200);
-    }
-    mapResourceId(id) {
-        return normalizeProjectIdToUuid(this.apiClient, id);
+        assertSuccess(response);
     }
 }

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

@@ -1,7 +1,7 @@
 import { MittwaldAPIV2 } from "@mittwald/api-client";
 import { RenderBaseCommand } from "../../../rendering/react/RenderBaseCommand.js";
 import { ReactNode } from "react";
-export type PathParams = MittwaldAPIV2.Paths.V2ProjectsProjectIdFilesystemUsagesDisk.Get.Parameters.Path;
+export type PathParams = MittwaldAPIV2.Paths.V2ProjectsProjectIdFilesystemDiskUsage.Get.Parameters.Path;
 export declare class Usage extends RenderBaseCommand<typeof Usage> {
     static description: string;
     static flags: {

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

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { GetBaseCommand } from "../../../GetBaseCommand.js";
-import { projectArgs, withProjectId } from "../../../lib/project/flags.js";
+import { projectArgs } from "../../../lib/project/flags.js";
 import { RenderBaseCommand } from "../../../rendering/react/RenderBaseCommand.js";
 import { usePromise } from "@mittwald/react-use-promise";
 import { SingleResult } from "../../../rendering/react/components/SingleResult.js";
@@ -13,7 +13,7 @@ import { parseBytes } from "../../../lib/bytes.js";
 import { Note, noteColor } from "../../../rendering/react/components/Note.js";
 import { ListItem } from "../../../rendering/react/components/ListItem.js";
 export class Usage extends RenderBaseCommand {
-    static description = "Get a Project directory filesystem usage.";
+    static description = "Get a project directory filesystem usage.";
     static flags = {
         ...GetBaseCommand.baseFlags,
         human: Flags.boolean({
@@ -22,7 +22,7 @@ export class Usage extends RenderBaseCommand {
     };
     static args = { ...projectArgs };
     render() {
-        const projectId = usePromise(() => withProjectId(this.apiClient, Usage, this.flags, this.args, this.config), []);
+        const projectId = this.useProjectId(Usage);
         const project = usePromise((projectId) => this.apiClient.project.getProject({ projectId }), [projectId]);
         const projectDiskUsage = usePromise((id) => this.apiClient.projectFileSystem.getDiskUsage({
             projectId: id,

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

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { GetBaseCommand } from "../../GetBaseCommand.js";
-import { projectArgs, withProjectId } from "../../lib/project/flags.js";
+import { projectArgs } from "../../lib/project/flags.js";
 import { GetFormatter } from "../../Formatter.js";
 import { SingleResult, SingleResultTable, } from "../../rendering/react/components/SingleResult.js";
 import { Box, Text } from "ink";
@@ -25,7 +25,7 @@ const ProjectSpecs = ({ projectId, spec }) => {
         const used = usage.data?.usedBytes ? (_jsxs(Text, { children: [" ", "(", _jsx(Value, { children: _jsx(ByteFormat, { bytes: usage.data?.usedBytes }) }), " ", "used)"] })) : undefined;
         return (_jsx(SingleResult, { title: "Compute resources", rows: {
                 CPUs: _jsx(Value, { children: spec.cpu }),
-                Memory: _jsx(Value, { children: spec.memory }),
+                Memory: _jsx(Value, { children: spec.memory }), // eslint-disable-line
                 Storage: (_jsxs(Text, { children: [_jsx(Value, { children: spec.storage }), used] })),
             } }));
     }
@@ -40,8 +40,8 @@ const ProjectCustomer = ({ customer }) => {
 const GetProject = ({ response }) => {
     const { apiClient } = useRenderContext();
     const customer = usePromise((id) => apiClient.customer.getCustomer({ customerId: id }), [response.customerId]);
-    const vhosts = usePromise((id) => apiClient.domain.ingressListForProject({
-        projectId: id,
+    const vhosts = usePromise((id) => apiClient.domain.ingressListIngresses({
+        queryParameters: { projectId: id },
     }), [response.id]);
     assertStatus(customer, 200);
     assertStatus(vhosts, 200);
@@ -71,7 +71,7 @@ export class Get extends RenderBaseCommand {
     static args = { ...projectArgs };
     formatter = new GetFormatter(new ComponentPrinter((r) => _jsx(GetProject, { response: r })));
     render() {
-        const projectId = usePromise(() => withProjectId(this.apiClient, Get, this.flags, this.args, this.config), []);
+        const projectId = this.useProjectId(Get);
         const projectResponse = usePromise((projectId) => this.apiClient.project.getProject({ projectId }), [projectId]);
         assertStatus(projectResponse, 200);
         if (this.flags.output === "json") {

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

@@ -1,6 +1,6 @@
 import { formatRelativeDate } from "../../../lib/viewhelpers/date.js";
 import { ListBaseCommand } from "../../../ListBaseCommand.js";
-import { projectFlags, withProjectId } from "../../../lib/project/flags.js";
+import { projectFlags } from "../../../lib/project/flags.js";
 export default class List extends ListBaseCommand {
     static description = "List all invites belonging to a project.";
     static args = {};
@@ -9,7 +9,7 @@ export default class List extends ListBaseCommand {
         ...projectFlags,
     };
     async getData() {
-        const projectId = await withProjectId(this.apiClient, List, this.flags, this.args, this.config);
+        const projectId = await this.withProjectId(List);
         return await this.apiClient.project.listInvitesForProject({ projectId });
     }
     mapData(data) {

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

@@ -1,6 +1,6 @@
 import { formatRelativeDate } from "../../../lib/viewhelpers/date.js";
 import { ListBaseCommand } from "../../../ListBaseCommand.js";
-import { projectFlags, withProjectId } from "../../../lib/project/flags.js";
+import { projectFlags } from "../../../lib/project/flags.js";
 export default class List extends ListBaseCommand {
     static description = "List all memberships for a Project.";
     static args = {};
@@ -9,10 +9,10 @@ export default class List extends ListBaseCommand {
         ...projectFlags,
     };
     async getData() {
-        const pathParams = {
-            projectId: await withProjectId(this.apiClient, List, this.flags, this.args, this.config),
-        };
-        return await this.apiClient.project.listMembershipsForProject(pathParams);
+        const projectId = await this.withProjectId(List);
+        return await this.apiClient.project.listMembershipsForProject({
+            projectId,
+        });
     }
     mapData(data) {
         return Promise.all(data.map(async (item) => {

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

@@ -1,5 +1,5 @@
-import { BaseCommand } from "../../BaseCommand.js";
-export default class Ssh extends BaseCommand {
+import { ExtendedBaseCommand } from "../../ExtendedBaseCommand.js";
+export default class Ssh extends ExtendedBaseCommand<typeof Ssh> {
     static description: string;
     static args: {
         "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;

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

@@ -1,13 +1,12 @@
-import { BaseCommand } from "../../BaseCommand.js";
 import { assertStatus } from "@mittwald/api-client-commons";
 import * as child_process from "child_process";
-import { projectArgs, withProjectId } from "../../lib/project/flags.js";
-export default class Ssh extends BaseCommand {
+import { projectArgs } from "../../lib/project/flags.js";
+import { ExtendedBaseCommand } from "../../ExtendedBaseCommand.js";
+export default class Ssh extends ExtendedBaseCommand {
     static description = "Connect to a project via SSH";
     static args = { ...projectArgs };
     async run() {
-        const { args } = await this.parse(Ssh);
-        const projectId = await withProjectId(this.apiClient, Ssh, {}, args, this.config);
+        const projectId = await this.withProjectId(Ssh);
         const projectResponse = await this.apiClient.project.getProject({
             projectId,
         });

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

@@ -1,5 +1,5 @@
-import { BaseCommand } from "../../BaseCommand.js";
-export default class Update extends BaseCommand {
+import { ExtendedBaseCommand } from "../../ExtendedBaseCommand.js";
+export default class Update extends ExtendedBaseCommand<typeof Update> {
     static description: string;
     static args: {
         "project-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;

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

@@ -1,11 +1,10 @@
-import { BaseCommand } from "../../BaseCommand.js";
-import { projectArgs, withProjectId } from "../../lib/project/flags.js";
-export default class Update extends BaseCommand {
+import { projectArgs } from "../../lib/project/flags.js";
+import { ExtendedBaseCommand } from "../../ExtendedBaseCommand.js";
+export default class Update extends ExtendedBaseCommand {
     static description = "Updates a project";
     static args = { ...projectArgs };
     async run() {
-        const { args } = await this.parse(Update);
-        const id = await withProjectId(this.apiClient, Update, {}, args, this.config);
+        const id = await this.withProjectId(Update);
         console.log("updating project ", id);
         console.log("TODO: Implement me");
     }

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

@@ -1,6 +1,5 @@
-import { MittwaldAPIV2, MittwaldAPIV2Client } from "@mittwald/api-client";
+import { MittwaldAPIV2Client } from "@mittwald/api-client";
 import { GetBaseCommand } from "../../GetBaseCommand.js";
-type PathParams = MittwaldAPIV2.Paths.V2ServersServerId.Get.Parameters.Path;
 type APIResponse = Awaited<ReturnType<MittwaldAPIV2Client["project"]["getServer"]>>;
 export default class Get extends GetBaseCommand<typeof Get, APIResponse> {
     static description: string;
@@ -11,6 +10,5 @@ export default class Get extends GetBaseCommand<typeof Get, APIResponse> {
         "server-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
     };
     protected getData(): Promise<APIResponse>;
-    protected mapParams(input: PathParams): Promise<PathParams> | PathParams;
 }
 export {};

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

@@ -1,5 +1,5 @@
 import { GetBaseCommand } from "../../GetBaseCommand.js";
-import { serverArgs, withServerId } from "../../lib/server/flags.js";
+import { serverArgs } from "../../lib/server/flags.js";
 export default class Get extends GetBaseCommand {
     static description = "Get a server.";
     static flags = {
@@ -9,10 +9,7 @@ export default class Get extends GetBaseCommand {
         ...serverArgs,
     };
     async getData() {
-        const serverId = await withServerId(this.apiClient, Get, this.flags, this.args, this.config);
+        const serverId = await this.withServerId(Get);
         return await this.apiClient.project.getServer({ serverId });
     }
-    mapParams(input) {
-        return input;
-    }
 }

package/dist/esm/commands/sftp-user/list.js

@@ -1,5 +1,5 @@
 import { ListBaseCommand } from "../../ListBaseCommand.js";
-import { projectFlags, withProjectId } from "../../lib/project/flags.js";
+import { projectFlags } from "../../lib/project/flags.js";
 export default class List extends ListBaseCommand {
     static description = "List all SFTP users for a project.";
     static args = {};
@@ -10,7 +10,7 @@ export default class List extends ListBaseCommand {
     static aliases = ["project:sftp-user:list"];
     static deprecateAliases = true;
     async getData() {
-        const projectId = await withProjectId(this.apiClient, List, this.flags, this.args, this.config);
+        const projectId = await this.withProjectId(List);
         return await this.apiClient.sshsftpUser.sftpUserListSftpUsers({
             projectId,
         });

package/dist/esm/commands/ssh-user/list.js

@@ -1,5 +1,5 @@
 import { ListBaseCommand } from "../../ListBaseCommand.js";
-import { projectFlags, withProjectId } from "../../lib/project/flags.js";
+import { projectFlags } from "../../lib/project/flags.js";
 export class List extends ListBaseCommand {
     static description = "List all SSH users for a project.";
     static args = {};
@@ -10,7 +10,7 @@ export class List extends ListBaseCommand {
     static aliases = ["project:ssh-user:list"];
     static deprecateAliases = true;
     async getData() {
-        const projectId = await withProjectId(this.apiClient, List, this.flags, this.args, this.config);
+        const projectId = await this.withProjectId(List);
         return await this.apiClient.sshsftpUser.sshUserListSshUsers({ projectId });
     }
     mapData(data) {

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

@@ -3,8 +3,10 @@ import { ProcessRenderer } from "../../rendering/process/process.js";
 import { ProcessFlags } from "../../rendering/process/process_flags.js";
 import { BooleanFlag, FlagInput, OptionFlag, OutputFlags } from "@oclif/core/lib/interfaces/parser.js";
 export declare const appInstallationFlags: {
-    "installation-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
-};
+    "installation-id": OptionFlag<string>;
+}, appInstallationArgs: {
+    "installation-id": import("@oclif/core/lib/interfaces/parser.js").Arg<string>;
+}, withAppInstallationId: (apiClient: MittwaldAPIV2Client, command: "flag" | "arg" | import("../context_flags.js").CommandType<"installation", "installation-id">, 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>;
 export type AvailableFlagName = keyof AvailableFlags;
 interface AvailableFlags {
     version: OptionFlag<string>;

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

@@ -6,14 +6,10 @@ import { Text } from "ink";
 import { assertStatus } from "@mittwald/api-client-commons";
 import { projectFlags } from "../project/flags.js";
 import { processFlags, } from "../../rendering/process/process_flags.js";
-import { Flags, Args } from "@oclif/core";
+import { Flags } from "@oclif/core";
 import { generatePasswordWithSpecialChars } from "../password.js";
-export const appInstallationFlags = {
-    "installation-id": Args.string({
-        description: "ID of the app installation to get",
-        required: true,
-    }),
-};
+import { makeFlagSet } from "../context_flags.js";
+export const { flags: appInstallationFlags, args: appInstallationArgs, withId: withAppInstallationId, } = makeFlagSet("installation", "i", { displayName: "app installation" });
 function buildFlagsWithDescription(appName) {
     return {
         version: Flags.string({

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

@@ -0,0 +1,3 @@
+import { Response } from "@mittwald/api-client-commons";
+export declare function assertSuccess<T extends Response>(response: T): void;
+export default assertSuccess;

package/dist/esm/lib/assert_success.js

@@ -0,0 +1,7 @@
+import { ApiClientError } from "@mittwald/api-client-commons";
+export function assertSuccess(response) {
+    if (response.status >= 300) {
+        throw ApiClientError.fromResponse(`Unexpected response status (expected <300, got: ${response.status})`, response);
+    }
+}
+export default assertSuccess;