@mittwald/cli 1.0.0-alpha.10

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

@@ -0,0 +1,15 @@
+import { FancyProcessRenderer } from "./process_fancy.js";
+import { Flags } from "@oclif/core";
+import { SilentProcessRenderer } from "./process_quiet.js";
+export const processFlags = {
+    quiet: Flags.boolean({
+        char: "q",
+        description: "Suppress process output and only display a machine-readable summary.",
+    }),
+};
+export const makeProcessRenderer = (flags, title) => {
+    if (flags.quiet) {
+        return new SilentProcessRenderer();
+    }
+    return new FancyProcessRenderer(title);
+};

package/dist/esm/rendering/react/process_quiet.d.ts

@@ -0,0 +1,12 @@
+import { ReactElement, ReactNode } from "react";
+import { ProcessRenderer, RunnableHandler } from "./process.js";
+export declare class SilentProcessRenderer implements ProcessRenderer {
+    start(): void;
+    addStep(title: ReactElement): RunnableHandler;
+    runStep<TRes>(unusedTitle: ReactNode, fn: () => Promise<TRes>): Promise<TRes>;
+    addInfo(): void;
+    complete(): void;
+    error(err: unknown): void;
+    addConfirmation(): Promise<boolean>;
+    addInput(): Promise<string>;
+}

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

@@ -0,0 +1,29 @@
+import { RunnableHandler } from "./process.js";
+export class SilentProcessRenderer {
+    start() {
+        // 🤐
+    }
+    addStep(title) {
+        return new RunnableHandler({ type: "step", title, phase: "aborted" }, () => {
+            // empty
+        });
+    }
+    runStep(unusedTitle, fn) {
+        return fn();
+    }
+    addInfo() {
+        // 🤐
+    }
+    complete() {
+        // 🤐
+    }
+    error(err) {
+        console.error(err);
+    }
+    addConfirmation() {
+        return Promise.resolve(true);
+    }
+    addInput() {
+        throw new Error("no interactive input available in quiet mode");
+    }
+}

package/dist/esm/rendering/setup/FlagSupportedSetup.d.ts

@@ -0,0 +1,15 @@
+import { FlagInput } from "@oclif/core/lib/interfaces/parser.js";
+import { InferredFlags } from "@oclif/core/lib/interfaces/index.js";
+import { Class } from "type-fest";
+export type InferredOutput<T> = T extends Class<FlagSupportedSetup<FlagInput, any, infer TOut>, // eslint-disable-line
+any> ? TOut : never;
+export declare abstract class FlagSupportedSetup<TFlags extends FlagInput, TSettings, TSetupObject> {
+    flags: TFlags;
+    settings: TSettings;
+    protected constructor(flagsInput: TFlags, settings: TSettings);
+    getSetup(flags: InferredFlags<TFlags>): TSettings & TSetupObject;
+    protected abstract getFlagsOutput(flags: InferredFlags<TFlags>): TSetupObject;
+    static build: <TFlags_1 extends FlagInput<{
+        [flag: string]: any;
+    }>, TSettings_1, TOutput>(flags: TFlags_1, defaultSettings: TSettings_1, buildFlagsOutput: (flags: InferredFlags<TFlags_1>, settings: TSettings_1) => TOutput) => Class<FlagSupportedSetup<TFlags_1, TSettings_1, TOutput>, [] | [Partial<TSettings_1>]>;
+}

package/dist/esm/rendering/setup/FlagSupportedSetup.js

@@ -0,0 +1,22 @@
+import { mergeObjects } from "../../lib/mergeObjects.js";
+export class FlagSupportedSetup {
+    flags;
+    settings;
+    constructor(flagsInput, settings) {
+        this.flags = flagsInput;
+        this.settings = settings;
+    }
+    getSetup(flags) {
+        return mergeObjects(this.settings, this.getFlagsOutput(flags));
+    }
+    static build = (flags, defaultSettings, buildFlagsOutput) => {
+        return class ConcreteRenderSetup extends FlagSupportedSetup {
+            constructor(settings) {
+                super(flags, mergeObjects(defaultSettings, settings ?? {}));
+            }
+            getFlagsOutput(flags) {
+                return buildFlagsOutput(flags, this.settings);
+            }
+        };
+    };
+}

package/dist/esm/rendering/setup/TableRenderSetup.d.ts

@@ -0,0 +1,11 @@
+import { FlagSupportedSetup, InferredOutput } from "./FlagSupportedSetup.js";
+export declare const TableRenderSetup: import("type-fest").Class<FlagSupportedSetup<{
+    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>;
+}, {}, {
+    visibleColumns: string[] | undefined;
+    extended: boolean;
+    noTruncate: boolean;
+}>, [] | [Partial<{}>]>;
+export type TableRenderSetupOutput = InferredOutput<typeof TableRenderSetup>;

package/dist/esm/rendering/setup/TableRenderSetup.js

@@ -0,0 +1,24 @@
+import { Flags } from "@oclif/core";
+import { FlagSupportedSetup } from "./FlagSupportedSetup.js";
+export const TableRenderSetup = FlagSupportedSetup.build({
+    columns: Flags.string({
+        exclusive: ["additional"],
+        description: "only show provided columns (comma-seperated)",
+    }),
+    extended: Flags.boolean({
+        description: "show extra columns",
+    }),
+    noTruncate: Flags.boolean({
+        default: false,
+        description: "do not truncate output to fit screen",
+    }),
+}, {}, (flags) => {
+    const visibleColumns = flags.columns
+        ?.split(",")
+        .map((colName) => colName.trim());
+    return {
+        visibleColumns,
+        extended: flags.extended,
+        noTruncate: flags.noTruncate,
+    };
+});

package/dist/esm/rendering/setup/usePromiseSetup.d.ts

@@ -0,0 +1,12 @@
+import { FlagSupportedSetup } from "./FlagSupportedSetup.js";
+import { usePromise } from "@mittwald/react-use-promise";
+import { Simplify } from "@mittwald/api-client-commons";
+type UsePromiseOptions = Simplify<Parameters<typeof usePromise>[2]>;
+export declare const UsePromiseRenderSetup: import("type-fest").Class<FlagSupportedSetup<{
+    wait: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<any>;
+}, {
+    refreshIntervalSeconds: number;
+}, UsePromiseOptions>, [] | [Partial<{
+    refreshIntervalSeconds: number;
+}>]>;
+export {};

package/dist/esm/rendering/setup/usePromiseSetup.js

@@ -0,0 +1,11 @@
+import { FlagSupportedSetup } from "./FlagSupportedSetup.js";
+import { Flags } from "@oclif/core";
+export const UsePromiseRenderSetup = FlagSupportedSetup.build({
+    wait: Flags.boolean(),
+}, { refreshIntervalSeconds: 5 }, (flags, settings) => ({
+    autoRefresh: flags.wait
+        ? {
+            seconds: settings.refreshIntervalSeconds,
+        }
+        : undefined,
+}));

package/dist/esm/types.d.ts

@@ -0,0 +1,8 @@
+import { Response } from "@mittwald/api-client-commons";
+import { BaseCommand } from "./BaseCommand.js";
+import { Interfaces } from "@oclif/core";
+export type SuccessfulResponse<T extends Response, S extends T["status"]> = T & {
+    status: S;
+};
+export type CommandFlags<T extends typeof BaseCommand> = Interfaces.InferredFlags<T["flags"]>;
+export type CommandArgs<T extends typeof BaseCommand> = Interfaces.InferredArgs<T["args"]>;

package/dist/esm/types.js

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

package/package.json

@@ -0,0 +1,159 @@
+{
+  "name": "@mittwald/cli",
+  "version": "1.0.0-alpha.10",
+  "description": "Hand-crafted CLI for the mittwald API",
+  "license": "MIT",
+  "author": {
+    "name": "Mittwald CM Service GmbH & Co. KG",
+    "email": "opensource@mittwald.de"
+  },
+  "homepage": "https://developer.mittwald.de",
+  "bugs": {
+    "url": "https://github.com/mittwald/api-client-js/issues"
+  },
+  "type": "module",
+  "scripts": {
+    "clean": "(rimraf --glob dist tsconfig.*.tsbuildinfo) | true",
+    "compile": "tsc --build tsconfig.esm.json",
+    "compile:all": "yarn clean && yarn compile:cjs && yarn compile:esm",
+    "compile:cjs": "tsc --build tsconfig.cjs.json",
+    "compile:esm": "tsc --build tsconfig.esm.json",
+    "format": "prettier --write $@ '**/*.{ts,tsx,yaml,yml,json,md,mdx}'",
+    "generate:commands": "yarn generate:commands:v2",
+    "generate:commands-dev": "yarn generate:commands-dev:v2",
+    "generate:commands-dev:v2": "curl --silent https://api-public.dev.mittwald.systems/openapi | ./transform-openapi.sh | yarn acg generate --name MittwaldAPIV2 --outputFormat=oclifCommands - src --optionalHeader x-access-token",
+    "generate:commands:v2": "curl --silent https://api.mittwald.de/openapi | ./transform-openapi.sh | yarn acg generate --name MittwaldAPIV2 --outputFormat=oclifCommands - src --optionalHeader x-access-token",
+    "license-check": "yarn pnpify license-checker-rseidelsohn ",
+    "lint": "eslint . --cache",
+    "package": "yarn package:tarballs && yarn package:windows && yarn package:macos",
+    "package:macos": "oclif pack macos",
+    "package:tarballs": "oclif pack tarballs --targets=linux-x64,linux-arm64,darwin-x64,darwin-arm64 --no-xz",
+    "package:windows": "oclif pack win",
+    "post:generate": "yarn run -T compile && yarn run -T compile:cjs",
+    "test": "yarn lint && yarn format --check && yarn test:licenses",
+    "test:licenses": "yarn license-check --summary --unknown && yarn license-check --unknown --failOn 'UNLICENSED;UNKNOWN'"
+  },
+  "files": [
+    ".deps",
+    "{dist,dist-cjs}/**/*.{js,d.ts}",
+    "bin"
+  ],
+  "bin": {
+    "mw": "bin/run.js"
+  },
+  "dependencies": {
+    "@mittwald/api-client": "^2.0.5",
+    "@mittwald/api-client-commons": "^3.0.3",
+    "@mittwald/react-use-promise": "^1.2.2",
+    "@oclif/core": "^2.8.5",
+    "@oclif/plugin-help": "^5.2.9",
+    "chalk": "^5.3.0",
+    "date-fns": "^2.30.0",
+    "humanize-string": "^3.0.0",
+    "ink": "^4.2.0",
+    "ink-link": "^3.0.0",
+    "ink-text-input": "^5.0.1",
+    "js-yaml": "^4.1.0",
+    "marked": "^5.1.0",
+    "marked-terminal": "^5.2.0",
+    "node-notifier": "^8.0.2",
+    "parse-duration": "^1.1.0",
+    "pretty-bytes": "^6.1.0",
+    "react": "^18.2.0",
+    "semver": "^7.5.4",
+    "tempfile": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/chalk": "^2.2.0",
+    "@types/copyfiles": "^2.4.1",
+    "@types/js-yaml": "^4.0.5",
+    "@types/marked": "^5.0.0",
+    "@types/marked-terminal": "^3.1.3",
+    "@types/node": "^20.3.3",
+    "@types/node-notifier": "^8.0.2",
+    "@types/parse-duration": "^0.3.0",
+    "@types/pretty-bytes": "^5.2.0",
+    "@types/react": "^18",
+    "@types/semver": "^7.5.0",
+    "@typescript-eslint/eslint-plugin": "^5.61.0",
+    "@typescript-eslint/parser": "^5.61.0",
+    "@yarnpkg/pnpify": "^4.0.0-rc.48",
+    "copyfiles": "^2.4.1",
+    "eslint": "^8.44.0",
+    "eslint-config-prettier": "^8.8.0",
+    "eslint-plugin-json": "^3.1.0",
+    "eslint-plugin-prettier": "^4.2.1",
+    "license-checker-rseidelsohn": "^4.2.6",
+    "oclif": "^3.9.1",
+    "pkg": "^5.8.1",
+    "prettier": "^2.8.8",
+    "prettier-plugin-jsdoc": "^0.4.2",
+    "prettier-plugin-package": "^1.3.1",
+    "prettier-plugin-sort-json": "^1.0.0",
+    "rimraf": "^5.0.1",
+    "type-fest": "^3.12.0",
+    "typescript": "^5.1.6"
+  },
+  "oclif": {
+    "bin": "mw",
+    "dirname": "mw",
+    "commands": "./dist/esm/commands",
+    "macos": {
+      "identifier": "de.mittwald.cli"
+    },
+    "additionalHelpFlags": [
+      "-h"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "app": {
+        "description": "Manage apps, and app installations in your projects"
+      },
+      "article": {
+        "description": "Query available hosting articles"
+      },
+      "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"
+      },
+      "database": {
+        "description": "Manage databases (like MySQL and Redis) in your projects"
+      },
+      "domain": {
+        "description": "Manage domains, virtual hosts and DNS settings in your projects"
+      },
+      "login": {
+        "description": "Manage your client authentication"
+      },
+      "mail": {
+        "description": "Manage mailboxes and mail addresses in your projects"
+      },
+      "org": {
+        "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."
+      },
+      "server": {
+        "description": "Manage your servers"
+      },
+      "user": {
+        "description": "Manage your own user account",
+        "subtopics": {
+          "ssh-key": {
+            "description": "Manage your SSH keys"
+          }
+        }
+      }
+    },
+    "plugins": [
+      "@oclif/plugin-help"
+    ]
+  },
+  "packageManager": "yarn@3.6.1"
+}