@nocobase/cli 2.1.0-beta.9 → 2.1.0-rc.2

package/dist/commands/plugin/import.js

@@ -0,0 +1,108 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Args, Command, Flags } from '@oclif/core';
+import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime } from '../../lib/app-runtime.js';
+import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
+import { importPluginSource } from '../../lib/plugin-import.js';
+import { announceTargetEnv } from '../../lib/ui.js';
+export default class PluginImport extends Command {
+    static hidden = false;
+    static args = {
+        archive: Args.string({
+            required: true,
+            description: 'Plugin source to import. Accepts a local .tgz path, a remote http(s) URL, or an npm package spec.',
+        }),
+    };
+    static summary = 'Import a packaged plugin into storage/plugins for the selected env';
+    static description = 'Download or read a packaged plugin source and extract it into the selected env storage/plugins directory without enabling it.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz',
+        '<%= config.bin %> <%= command.id %> /your/path/plugin-auth-cas-1.4.0.tgz',
+        '<%= config.bin %> <%= command.id %> @nocobase/plugin-acl@beta',
+        '<%= config.bin %> <%= command.id %> @nocobase/plugin-acl@beta --npm-registry=https://registry.npmjs.org',
+        '<%= config.bin %> <%= command.id %> --env app1 ./plugin-auth-cas-1.4.0.tgz',
+        '<%= config.bin %> <%= command.id %> --storage-path ./storage ./plugin-auth-cas-1.4.0.tgz',
+    ];
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name to import the plugin into. Defaults to the current env when omitted',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        'storage-path': Flags.string({
+            description: 'Override the env storage root path. Imported plugins are written into <storage-path>/plugins',
+        }),
+        'npm-registry': Flags.string({
+            description: 'npm registry to use when the import source is an npm package spec.',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PluginImport);
+        const requestedEnv = flags.env?.trim() || undefined;
+        const storagePathOverride = flags['storage-path']?.trim() || undefined;
+        const explicitEnvSelection = Boolean(requestedEnv && hasExplicitEnvSelection(this.argv));
+        if (explicitEnvSelection) {
+            const confirmed = await ensureCrossEnvConfirmed({
+                command: this,
+                requestedEnv,
+                yes: flags.yes,
+            });
+            if (!confirmed) {
+                return;
+            }
+        }
+        const archiveSource = args.archive?.trim();
+        if (!archiveSource) {
+            this.error('Pass a plugin archive path, URL, or npm package spec.');
+        }
+        const shouldResolveTargetEnv = Boolean(requestedEnv || !storagePathOverride);
+        const runtime = await resolveManagedAppRuntime(shouldResolveTargetEnv ? requestedEnv : undefined);
+        if (shouldResolveTargetEnv && !runtime) {
+            this.error(formatMissingManagedAppEnvMessage(requestedEnv));
+        }
+        if (runtime && shouldResolveTargetEnv && runtime.kind === 'http') {
+            this.error([
+                `Can't import plugins for "${runtime.envName}" yet.`,
+                'HTTP envs do not expose a writable storage/plugins path to the CLI.',
+                'Use a local or Docker env for plugin imports right now.',
+            ].join('\n'));
+        }
+        if (runtime && shouldResolveTargetEnv && runtime.kind === 'ssh') {
+            this.error([
+                `Can't import plugins for "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local or Docker env for plugin imports right now.',
+            ].join('\n'));
+        }
+        if (runtime && shouldResolveTargetEnv) {
+            announceTargetEnv(runtime.envName);
+        }
+        const runtimeForDefaults = runtime && runtime.kind !== 'http' && runtime.kind !== 'ssh' ? runtime : undefined;
+        const npmRegistry = flags['npm-registry']?.trim() || String(runtimeForDefaults?.env.config.npmRegistry ?? '').trim() || undefined;
+        const storagePath = storagePathOverride || runtimeForDefaults?.env.storagePath;
+        const result = await importPluginSource(archiveSource, {
+            storagePath,
+            npmRegistry,
+        });
+        const label = result.action === 'updated' ? 'Updated' : 'Imported';
+        const versionSuffix = result.packageVersion ? `@${result.packageVersion}` : '';
+        this.log(`${label} ${result.packageName}${versionSuffix} into ${result.outputDir}`);
+        this.log(`Plugin storage path: ${result.storagePluginsPath}`);
+        if (runtime && shouldResolveTargetEnv) {
+            this.log(`Restart the app before enabling or using the plugin: \`nb app restart --env ${runtime.envName}\`.`);
+        }
+        else {
+            this.log('Restart the app that uses this plugin storage path before enabling or using the plugin.');
+        }
+    }
+}

package/dist/commands/plugin/list.js

@@ -0,0 +1,82 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, Flags } from '@oclif/core';
+import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runDockerNocoBaseCommand, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
+import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
+export default class PluginList extends Command {
+    static hidden = false;
+    static args = {};
+    static summary = 'List plugins for the selected env';
+    static description = 'List installed plugins in the selected env (npm/git runs locally, Docker runs inside the saved app container, HTTP envs fall back to the API)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> -e local',
+        '<%= config.bin %> <%= command.id %> -e local-docker',
+    ];
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name to inspect plugins for. Defaults to the current env when omitted',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PluginList);
+        const requestedEnv = flags.env?.trim() || undefined;
+        const explicitEnvSelection = Boolean(requestedEnv && hasExplicitEnvSelection(this.argv));
+        if (explicitEnvSelection) {
+            const confirmed = await ensureCrossEnvConfirmed({
+                command: this,
+                requestedEnv,
+                yes: flags.yes,
+            });
+            if (!confirmed) {
+                return;
+            }
+        }
+        const runtime = await resolveManagedAppRuntime(requestedEnv);
+        if (!runtime) {
+            this.error(formatMissingManagedAppEnvMessage(requestedEnv));
+        }
+        if (runtime.kind === 'local') {
+            try {
+                await runLocalNocoBaseCommand(runtime, ['pm', 'list']);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.error(message);
+            }
+            return;
+        }
+        if (runtime.kind === 'docker') {
+            try {
+                await runDockerNocoBaseCommand(runtime.containerName, ['pm', 'list']);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.error(message);
+            }
+            return;
+        }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't list plugins for "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local, Docker, or HTTP env for plugin inspection right now.',
+            ].join('\n'));
+        }
+        await this.config.runCommand('api:pm:list', explicitEnvSelection
+            ? ['--mode=summary', '--env', runtime.envName, '--yes']
+            : ['--mode=summary']);
+    }
+}

package/dist/commands/pm/disable.js

@@ -0,0 +1,12 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import PluginDisable from '../plugin/disable.js';
+export default class PmDisable extends PluginDisable {
+    static hidden = true;
+}

package/dist/commands/pm/enable.js

@@ -0,0 +1,12 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import PluginEnable from '../plugin/enable.js';
+export default class PmEnable extends PluginEnable {
+    static hidden = true;
+}

package/dist/commands/pm/list.js

@@ -0,0 +1,12 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import PluginList from '../plugin/list.js';
+export default class PmList extends PluginList {
+    static hidden = true;
+}

package/dist/commands/proxy/caddy/current.js

@@ -0,0 +1,17 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getCaddyProxyDriver } from '../../../lib/proxy-caddy.js';
+export default class ProxyCaddyCurrent extends Command {
+    static summary = 'Print the current caddy runtime driver';
+    async run() {
+        await this.parse(ProxyCaddyCurrent);
+        this.log(await getCaddyProxyDriver());
+    }
+}

package/dist/commands/proxy/caddy/generate.js

@@ -0,0 +1,69 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, Flags } from '@oclif/core';
+import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, } from '../../../lib/app-runtime.js';
+import { getCaddyProxyDriver, writeCaddyProxyBundle, resolveCaddyProxyRuntimeContext, } from '../../../lib/proxy-caddy.js';
+import { normalizeProxyListenPort } from '../../../lib/proxy-nginx.js';
+import { announceTargetEnv, failTask, startTask, succeedTask } from '../../../lib/ui.js';
+export default class ProxyCaddyGenerate extends Command {
+    static summary = 'Generate caddy proxy files for one managed env';
+    static examples = [
+        '<%= config.bin %> proxy caddy generate --env app1 --host app1.example.com',
+        '<%= config.bin %> proxy caddy generate --env app1 --host app1.example.com --port 8080',
+    ];
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name to generate proxy files for',
+            required: true,
+        }),
+        host: Flags.string({
+            description: 'Host exposed by the caddy site block, such as example.com or localhost',
+        }),
+        port: Flags.string({
+            description: 'Port exposed by the caddy site block, not the upstream NocoBase app port',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProxyCaddyGenerate);
+        const requestedEnv = flags.env?.trim() || undefined;
+        const requestedPort = flags.port?.trim() || undefined;
+        const normalizedPort = normalizeProxyListenPort(requestedPort);
+        if (requestedPort && !normalizedPort) {
+            this.error(`Invalid proxy entry port "${requestedPort}". Use an integer between 1 and 65535.`);
+        }
+        const runtime = await resolveManagedAppRuntime(requestedEnv);
+        if (!runtime) {
+            this.error(formatMissingManagedAppEnvMessage(requestedEnv));
+        }
+        if (runtime.kind === 'http') {
+            this.error(`Can't generate a caddy proxy config for "${runtime.envName}" from this machine because the env only has an API connection.`);
+        }
+        if (runtime.kind === 'ssh') {
+            this.error(`Can't generate a caddy proxy config for "${runtime.envName}" yet because SSH envs are not implemented.`);
+        }
+        const driver = await getCaddyProxyDriver();
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        announceTargetEnv(runtime.envName);
+        startTask(`Generating caddy proxy config for env "${runtime.envName}" with the ${driver} driver...`);
+        try {
+            const { bundle, status } = await writeCaddyProxyBundle(runtime, {
+                host: flags.host?.trim() || undefined,
+                port: normalizedPort,
+            }, runtimeContext);
+            succeedTask(status === 'created'
+                ? `Saved caddy proxy files for env "${runtime.envName}" under ${bundle.entryDir}, and created app.caddy at ${bundle.appConfigPath}.`
+                : `Saved caddy proxy files for env "${runtime.envName}" under ${bundle.entryDir}, and refreshed app.caddy at ${bundle.appConfigPath}.`);
+        }
+        catch (error) {
+            failTask(`Failed to generate caddy proxy config for env "${runtime.envName}".`);
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

package/dist/commands/proxy/caddy/index.js

@@ -0,0 +1,28 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, loadHelpClass } from '@oclif/core';
+export default class ProxyCaddy extends Command {
+    static summary = 'Manage caddy proxy generation and runtime selection';
+    static examples = [
+        '<%= config.bin %> proxy caddy current',
+        '<%= config.bin %> proxy caddy use local',
+        '<%= config.bin %> proxy caddy generate --env app1 --host app1.example.com',
+        '<%= config.bin %> proxy caddy start',
+        '<%= config.bin %> proxy caddy status',
+        '<%= config.bin %> proxy caddy info',
+    ];
+    async run() {
+        await this.parse(ProxyCaddy);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'proxy caddy',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/proxy/caddy/info.js

@@ -0,0 +1,31 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getCliConfigValue } from '../../../lib/cli-config.js';
+import { mapProxyPathFromCliRoot, resolveEnvProxyMainOutputPath } from '../../../lib/env-proxy.js';
+import { formatCaddyProxyInfoLines, resolveCaddyProxyContainerName, resolveCaddyProxyImage, resolveCaddyProxyRuntimeContext, } from '../../../lib/proxy-caddy.js';
+export default class ProxyCaddyInfo extends Command {
+    static summary = 'Show current caddy proxy driver and generated path info';
+    async run() {
+        await this.parse(ProxyCaddyInfo);
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        const lines = formatCaddyProxyInfoLines({
+            driver: runtimeContext.driver,
+            configFile: await mapProxyPathFromCliRoot(resolveEnvProxyMainOutputPath({ provider: 'caddy' }), {
+                runtimeCliRoot: runtimeContext.runtimeCliRoot,
+            }),
+            upstreamHost: runtimeContext.upstreamHost,
+            caddyBinary: await getCliConfigValue('bin.caddy'),
+            runtimeRoot: runtimeContext.runtimeCliRoot,
+            containerName: await resolveCaddyProxyContainerName(),
+            image: resolveCaddyProxyImage(),
+        });
+        this.log(lines.join('\n'));
+    }
+}

package/dist/commands/proxy/caddy/reload.js

@@ -0,0 +1,30 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getCaddyProxyDriver, reloadCaddyProxy, resolveCaddyProxyRuntimeContext } from '../../../lib/proxy-caddy.js';
+import { failTask, startTask, succeedTask } from '../../../lib/ui.js';
+export default class ProxyCaddyReload extends Command {
+    static summary = 'Reload the managed caddy proxy';
+    async run() {
+        await this.parse(ProxyCaddyReload);
+        const driver = await getCaddyProxyDriver();
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        startTask(`Reloading caddy proxy with the ${driver} driver...`);
+        try {
+            const result = await reloadCaddyProxy(runtimeContext);
+            succeedTask(result === 'started'
+                ? `Caddy proxy started with the ${driver} driver using the latest config.`
+                : `Caddy proxy reloaded with the ${driver} driver.`);
+        }
+        catch (error) {
+            failTask(`Failed to reload caddy proxy with the ${driver} driver.`);
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

package/dist/commands/proxy/caddy/restart.js

@@ -0,0 +1,28 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getCaddyProxyDriver, resolveCaddyProxyRuntimeContext, restartCaddyProxy } from '../../../lib/proxy-caddy.js';
+import { failTask, startTask, succeedTask } from '../../../lib/ui.js';
+export default class ProxyCaddyRestart extends Command {
+    static summary = 'Restart the managed caddy proxy';
+    async run() {
+        await this.parse(ProxyCaddyRestart);
+        const driver = await getCaddyProxyDriver();
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        startTask(`Restarting caddy proxy with the ${driver} driver...`);
+        try {
+            await restartCaddyProxy(runtimeContext);
+            succeedTask(`Caddy proxy restarted with the ${driver} driver.`);
+        }
+        catch (error) {
+            failTask(`Failed to restart caddy proxy with the ${driver} driver.`);
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

package/dist/commands/proxy/caddy/start.js

@@ -0,0 +1,30 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getCaddyProxyDriver, resolveCaddyProxyRuntimeContext, startCaddyProxy } from '../../../lib/proxy-caddy.js';
+import { failTask, startTask, succeedTask } from '../../../lib/ui.js';
+export default class ProxyCaddyStart extends Command {
+    static summary = 'Start the managed caddy proxy';
+    async run() {
+        await this.parse(ProxyCaddyStart);
+        const driver = await getCaddyProxyDriver();
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        startTask(`Starting caddy proxy with the ${driver} driver...`);
+        try {
+            const result = await startCaddyProxy(runtimeContext);
+            succeedTask(result === 'already-running'
+                ? `Caddy proxy is already running with the ${driver} driver.`
+                : `Caddy proxy started with the ${driver} driver.`);
+        }
+        catch (error) {
+            failTask(`Failed to start caddy proxy with the ${driver} driver.`);
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

package/dist/commands/proxy/caddy/status.js

@@ -0,0 +1,19 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { formatCaddyProxyStatusLines, getCaddyProxyStatus, resolveCaddyProxyRuntimeContext, } from '../../../lib/proxy-caddy.js';
+export default class ProxyCaddyStatus extends Command {
+    static summary = 'Show the current caddy proxy runtime status';
+    async run() {
+        await this.parse(ProxyCaddyStatus);
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        const status = await getCaddyProxyStatus(runtimeContext);
+        this.log(formatCaddyProxyStatusLines(status).join('\n'));
+    }
+}

package/dist/commands/proxy/caddy/stop.js

@@ -0,0 +1,30 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getCaddyProxyDriver, resolveCaddyProxyRuntimeContext, stopCaddyProxy } from '../../../lib/proxy-caddy.js';
+import { failTask, startTask, succeedTask } from '../../../lib/ui.js';
+export default class ProxyCaddyStop extends Command {
+    static summary = 'Stop the managed caddy proxy';
+    async run() {
+        await this.parse(ProxyCaddyStop);
+        const driver = await getCaddyProxyDriver();
+        const runtimeContext = await resolveCaddyProxyRuntimeContext();
+        startTask(`Stopping caddy proxy with the ${driver} driver...`);
+        try {
+            const result = await stopCaddyProxy(runtimeContext);
+            succeedTask(result === 'already-stopped'
+                ? `Caddy proxy is already stopped with the ${driver} driver.`
+                : `Caddy proxy stopped with the ${driver} driver.`);
+        }
+        catch (error) {
+            failTask(`Failed to stop caddy proxy with the ${driver} driver.`);
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

package/dist/commands/proxy/caddy/use.js

@@ -0,0 +1,26 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Args, Command } from '@oclif/core';
+import { CADDY_PROXY_DRIVER_OPTIONS } from '../../../lib/cli-config.js';
+import { setCaddyProxyDriver } from '../../../lib/proxy-caddy.js';
+export default class ProxyCaddyUse extends Command {
+    static summary = 'Select the caddy runtime driver';
+    static args = {
+        driver: Args.string({
+            description: 'caddy runtime driver',
+            options: [...CADDY_PROXY_DRIVER_OPTIONS],
+            required: true,
+        }),
+    };
+    async run() {
+        const { args } = await this.parse(ProxyCaddyUse);
+        const driver = await setCaddyProxyDriver(args.driver);
+        this.log(driver);
+    }
+}

package/dist/commands/proxy/index.js

@@ -0,0 +1,28 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, loadHelpClass } from '@oclif/core';
+export default class Proxy extends Command {
+    static summary = 'Manage reverse proxy providers for CLI-managed apps';
+    static description = 'Use `nb proxy nginx` or `nb proxy caddy` to manage reverse proxy workflows.';
+    static examples = [
+        '<%= config.bin %> proxy nginx current',
+        '<%= config.bin %> proxy nginx use docker',
+        '<%= config.bin %> proxy nginx generate --env app1 --host app1.example.com',
+        '<%= config.bin %> proxy caddy current',
+        '<%= config.bin %> proxy caddy use docker',
+    ];
+    async run() {
+        await this.parse(Proxy);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'proxy',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/proxy/nginx/current.js

@@ -0,0 +1,18 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command } from '@oclif/core';
+import { getNginxProxyDriver } from '../../../lib/proxy-nginx.js';
+export default class ProxyNginxCurrent extends Command {
+    static summary = 'Print the current nginx runtime driver';
+    async run() {
+        await this.parse(ProxyNginxCurrent);
+        const driver = await getNginxProxyDriver();
+        this.log(driver);
+    }
+}