@nocobase/cli 2.1.0-alpha.25 → 2.1.0-alpha.27

package/dist/commands/download.js

@@ -6,860 +6,8 @@
  * 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 fsp from 'node:fs/promises';
-import { Command, Flags } from '@oclif/core';
-import * as p from '@clack/prompts';
-import path from 'node:path';
-import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
-import { runPromptCatalog, } from "../lib/prompt-catalog.js";
-import { applyCliLocale, CLI_LOCALE_FLAG_DESCRIPTION, CLI_LOCALE_FLAG_OPTIONS, localeText, resolveCliLocale, translateCli, } from "../lib/cli-locale.js";
-import { run } from "../lib/run-npm.js";
-import { printVerbose, setVerboseMode, startTask, stopTask, updateTask } from '../lib/ui.js';
-const DEFAULT_DOCKER_REGISTRY = 'nocobase/nocobase';
-const DEFAULT_DOCKER_REGISTRY_ZH_CN = 'registry.cn-shanghai.aliyuncs.com/nocobase/nocobase';
-const DEFAULT_DOCKER_PLATFORM = 'auto';
-const DEFAULT_DOWNLOAD_VERSION = 'beta';
-const downloadText = (key, values) => localeText(`commands.download.${key}`, values);
-const downloadTranslatedText = (key, values, fallback) => translateCli(`commands.download.${key}`, values, { fallback });
-function defaultOutputDirForVersion(versionTag) {
-    const safe = versionTag.replace(/[/\\]/g, '-');
-    return `./nocobase-${safe}`;
-}
-async function pathExists(target) {
-    try {
-        await fsp.access(target);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export function defaultDockerRegistryForLang(lang) {
-    return resolveCliLocale(String(lang ?? '').trim() || undefined) === 'zh-CN'
-        ? DEFAULT_DOCKER_REGISTRY_ZH_CN
-        : DEFAULT_DOCKER_REGISTRY;
-}
-function defaultDockerRegistryForPromptValues(_values) {
-    return defaultDockerRegistryForLang(process.env.NB_LOCALE);
-}
-function argvHasToken(argv, tokens) {
-    return tokens.some((t) => argv.includes(t));
-}
-function gitRefForVersion(versionSpec) {
-    const versionToRef = {
-        latest: 'main',
-        beta: 'next',
-        alpha: 'develop',
-    };
-    return versionToRef[versionSpec] || versionSpec;
-}
-/** `build-dts` only applies when `build` is true and source is npm/git. */
-function normalizeBuildDts(source, build, wantDts) {
-    if (source !== 'npm' && source !== 'git') {
-        return false;
-    }
-    return Boolean(build && wantDts);
-}
-function downloadSourceLabel(source) {
-    switch (source) {
-        case 'docker':
-            return 'Docker image';
-        case 'npm':
-            return 'npm package';
-        case 'git':
-            return 'Git repository';
-        default:
-            return source;
-    }
-}
-function normalizeDockerPlatform(value) {
-    const text = String(value ?? '').trim();
-    if (text === 'linux/amd64' || text === 'linux/arm64') {
-        return text;
-    }
-    return DEFAULT_DOCKER_PLATFORM;
-}
-function dockerPlatformArg(value) {
-    const platform = normalizeDockerPlatform(value);
-    if (platform === 'auto') {
-        return undefined;
-    }
-    return platform;
-}
-function formatDownloadStageFailure(stage) {
-    return [
-        downloadTranslatedText(`failures.${stage}.title`),
-        downloadTranslatedText(`failures.${stage}.body`),
-        downloadTranslatedText(`failures.${stage}.hint`),
-    ].join('\n');
-}
-function formatDownloadFailure(message, verbose) {
-    if (verbose) {
-        return message;
-    }
-    const lower = message.toLowerCase();
-    if (lower.includes('yarn install')) {
-        return formatDownloadStageFailure('dependencyInstall');
-    }
-    if (lower.includes('git clone')) {
-        return formatDownloadStageFailure('gitClone');
-    }
-    if (lower.includes('docker pull')) {
-        return formatDownloadStageFailure('dockerPull');
-    }
-    if (lower.includes('docker save')) {
-        return formatDownloadStageFailure('dockerSave');
-    }
-    if (lower.includes('create-nocobase-app') || lower.includes('npx create-nocobase-app')) {
-        return formatDownloadStageFailure('scaffold');
-    }
-    if (lower.includes('nocobase command')) {
-        return formatDownloadStageFailure('build');
-    }
-    if (lower.includes('exited with code') || lower.includes('exited due to signal')) {
-        return formatDownloadStageFailure('generic');
-    }
-    return message;
-}
-const EXTERNAL_COMMAND_LOADING_DELAY_MS = 8_000;
-const EXTERNAL_COMMAND_LOADING_UPDATE_MS = 15_000;
-function normalizeVersionPreset(value) {
-    const text = String(value ?? '').trim();
-    if (text === 'latest' || text === 'beta' || text === 'alpha') {
-        return text;
-    }
-    return 'other';
-}
-function versionPresetForValue(value) {
-    return normalizeVersionPreset(value);
-}
-function otherVersionValue(value) {
-    const text = String(value ?? '').trim();
-    return normalizeVersionPreset(text) === 'other' ? text : '';
-}
-function resolveVersionFromResults(results, fallback) {
-    const preset = normalizeVersionPreset(results.version ?? fallback);
-    if (preset === 'other') {
-        return String(results.otherVersion ?? fallback ?? '').trim();
-    }
-    return preset;
-}
-export default class Download extends Command {
-    _flags;
-    preparationTaskActive = false;
-    static description = 'Scaffold or fetch NocoBase from npm, Docker, or Git. `--version` is the shared version input: package version for npm, image tag for Docker, and git ref for Git.';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> -y --source npm --version alpha',
-        '<%= config.bin %> <%= command.id %> -y --source npm --version alpha --no-build',
-        '<%= config.bin %> <%= command.id %> --source npm --version alpha',
-        '<%= config.bin %> <%= command.id %> --source npm --version alpha --output-dir=./app',
-        '<%= config.bin %> <%= command.id %> --source docker --version alpha --docker-registry=nocobase/nocobase --docker-platform=linux/arm64',
-        '<%= config.bin %> <%= command.id %> -y --source docker --version alpha --docker-save -o ./docker-images',
-        '<%= config.bin %> <%= command.id %> --source git --version alpha --git-url=git@github.com:nocobase/nocobase.git',
-        '<%= config.bin %> <%= command.id %> --source git --version fix/cli-v2',
-        '<%= config.bin %> <%= command.id %> -y --source git --version fix/cli-v2 --no-build',
-        '<%= config.bin %> <%= command.id %> -y --source npm --version alpha --build-dts',
-        '<%= config.bin %> <%= command.id %> -y --source npm --version alpha --npm-registry=https://registry.npmmirror.com',
-    ];
-    static flags = {
-        yes: Flags.boolean({
-            char: 'y',
-            description: 'Use defaults and skip interactive prompts.',
-            default: false,
-        }),
-        verbose: Flags.boolean({
-            description: 'Show detailed command output',
-            default: false,
-        }),
-        locale: Flags.string({
-            description: CLI_LOCALE_FLAG_DESCRIPTION,
-            options: CLI_LOCALE_FLAG_OPTIONS,
-        }),
-        'no-intro': Flags.boolean({
-            hidden: true,
-            description: 'Skip command intro when invoked by another CLI command',
-            default: false,
-        }),
-        source: Flags.string({
-            char: 's',
-            description: 'How to get NocoBase: Docker image, npm package, or Git repository.',
-            options: ['docker', 'npm', 'git'],
-            required: false,
-        }),
-        version: Flags.string({
-            char: 'v',
-            description: 'Shared version input. For npm this is the package version, for Docker the image tag, and for Git a git ref such as a branch name (for example: alpha, beta, latest, fix/cli-v2).',
-        }),
-        replace: Flags.boolean({
-            char: 'r',
-            description: 'Replace the target directory if it already exists.',
-            default: false,
-        }),
-        'dev-dependencies': Flags.boolean({
-            char: 'D',
-            allowNo: true,
-            description: 'Install development dependencies for npm/git source installs.',
-            default: false,
-        }),
-        'output-dir': Flags.string({
-            char: 'o',
-            description: 'Download target directory, or Docker tarball directory when --docker-save is enabled.',
-        }),
-        'git-url': Flags.string({
-            description: 'Git repository URL to clone when --source git is used.',
-        }),
-        'docker-registry': Flags.string({
-            description: 'Docker registry to pull when --source docker is used; combine it with --version as the image tag.',
-        }),
-        'docker-platform': Flags.string({
-            description: 'Docker image platform to pull; use auto to let Docker choose.',
-            options: ['auto', 'linux/amd64', 'linux/arm64'],
-        }),
-        'docker-save': Flags.boolean({
-            allowNo: true,
-            description: 'Also save the pulled Docker image as a tarball.',
-            default: false,
-        }),
-        'npm-registry': Flags.string({
-            description: 'npm registry for npm/git downloads and dependency installation.',
-        }),
-        'build': Flags.boolean({
-            allowNo: true,
-            description: 'Build npm/git source after dependencies are installed.',
-            default: true,
-        }),
-        'build-dts': Flags.boolean({
-            description: 'Generate TypeScript declaration files during the npm/git build.',
-            default: false,
-        }),
-    };
-    static prompts = {
-        source: {
-            type: 'select',
-            variant: 'radio',
-            message: downloadText('prompts.source.message'),
-            options: [
-                {
-                    value: 'docker',
-                    label: downloadText('prompts.source.dockerLabel'),
-                    hint: downloadText('prompts.source.dockerHint'),
-                },
-                {
-                    value: 'npm',
-                    label: downloadText('prompts.source.npmLabel'),
-                    hint: downloadText('prompts.source.npmHint'),
-                },
-                {
-                    value: 'git',
-                    label: downloadText('prompts.source.gitLabel'),
-                    hint: downloadText('prompts.source.gitHint'),
-                },
-            ],
-            yesInitialValue: 'docker',
-            initialValue: 'docker',
-            required: true,
-        },
-        version: {
-            type: 'select',
-            variant: 'radio',
-            message: downloadText('prompts.version.message'),
-            options: [
-                {
-                    value: 'latest',
-                    label: downloadText('prompts.version.latestLabel'),
-                    hint: downloadText('prompts.version.latestHint'),
-                    disabled: true,
-                },
-                {
-                    value: 'beta',
-                    label: downloadText('prompts.version.betaLabel'),
-                    hint: downloadText('prompts.version.betaHint'),
-                },
-                {
-                    value: 'alpha',
-                    label: downloadText('prompts.version.alphaLabel'),
-                    hint: downloadText('prompts.version.alphaHint'),
-                },
-                {
-                    value: 'other',
-                    label: downloadText('prompts.version.otherLabel'),
-                    hint: downloadText('prompts.version.otherHint'),
-                },
-            ],
-            initialValue: DEFAULT_DOWNLOAD_VERSION,
-            yesInitialValue: DEFAULT_DOWNLOAD_VERSION,
-            required: true,
-        },
-        otherVersion: {
-            type: 'text',
-            message: downloadText('prompts.otherVersion.message'),
-            placeholder: downloadText('prompts.otherVersion.placeholder'),
-            required: true,
-            hidden: (values) => normalizeVersionPreset(values.version) !== 'other',
-        },
-        dockerRegistry: {
-            type: 'text',
-            message: downloadText('prompts.dockerRegistry.message'),
-            placeholder: downloadText('prompts.dockerRegistry.placeholder'),
-            initialValue: defaultDockerRegistryForPromptValues,
-            required: true,
-            hidden: (values) => values.source !== 'docker',
-        },
-        dockerPlatform: {
-            type: 'select',
-            message: downloadText('prompts.dockerPlatform.message'),
-            options: [
-                {
-                    value: 'auto',
-                    label: downloadText('prompts.dockerPlatform.autoLabel'),
-                    hint: downloadText('prompts.dockerPlatform.autoHint'),
-                },
-                { value: 'linux/amd64', label: 'linux/amd64' },
-                { value: 'linux/arm64', label: 'linux/arm64' },
-            ],
-            initialValue: DEFAULT_DOCKER_PLATFORM,
-            yesInitialValue: DEFAULT_DOCKER_PLATFORM,
-            required: true,
-            hidden: (values) => values.source !== 'docker',
-        },
-        dockerSave: {
-            type: 'boolean',
-            message: downloadText('prompts.dockerSave.message'),
-            initialValue: false,
-            hidden: (values) => values.source !== 'docker',
-        },
-        gitUrl: {
-            type: 'text',
-            message: downloadText('prompts.gitUrl.message'),
-            placeholder: downloadText('prompts.gitUrl.placeholder'),
-            initialValue: 'https://github.com/nocobase/nocobase.git',
-            yesInitialValue: 'https://github.com/nocobase/nocobase.git',
-            required: true,
-            hidden: (values) => values.source !== 'git',
-        },
-        outputDir: {
-            type: 'text',
-            message: downloadText('prompts.outputDir.message'),
-            placeholder: downloadText('prompts.outputDir.placeholder'),
-            initialValue: (values) => {
-                const version = resolveVersionFromResults(values, DEFAULT_DOWNLOAD_VERSION) || DEFAULT_DOWNLOAD_VERSION;
-                return defaultOutputDirForVersion(version);
-            },
-            required: true,
-            hidden: (values) => {
-                const s = values.source;
-                if (s === 'npm' || s === 'git') {
-                    return false;
-                }
-                if (s === 'docker') {
-                    return !values.dockerSave;
-                }
-                return true;
-            },
-        },
-        npmRegistry: {
-            type: 'text',
-            message: downloadText('prompts.npmRegistry.message'),
-            placeholder: downloadText('prompts.npmRegistry.placeholder'),
-            initialValue: '',
-            hidden: (values) => values.source !== 'npm' && values.source !== 'git',
-        },
-        replace: {
-            type: 'boolean',
-            message: downloadText('prompts.replace.message'),
-            initialValue: false,
-            hidden: (values) => Download.hideOutputDirAndReplaceSteps(values),
-        },
-        devDependencies: {
-            type: 'boolean',
-            message: downloadText('prompts.devDependencies.message'),
-            initialValue: false,
-            hidden: (values) => values.source !== 'npm',
-        },
-        build: {
-            type: 'boolean',
-            message: downloadText('prompts.build.message'),
-            initialValue: true,
-            yesInitialValue: true,
-            hidden: () => true,
-        },
-        buildDts: {
-            type: 'boolean',
-            message: downloadText('prompts.buildDts.message'),
-            initialValue: false,
-            hidden: (values) => values.source !== 'git',
-        },
-    };
-    /** When true, `outputDir` / `replace` prompts are skipped (same condition for both). */
-    static hideOutputDirAndReplaceSteps(values) {
-        const s = values.source;
-        if (s === 'npm' || s === 'git') {
-            return false;
-        }
-        if (s === 'docker') {
-            return !values.dockerSave;
-        }
-        return true;
-    }
-    resolveOutputDir(flags) {
-        const explicit = flags['output-dir'];
-        if (explicit) {
-            return explicit;
-        }
-        return defaultOutputDirForVersion(flags.version || 'latest');
-    }
-    async ensureOutputDirAvailable(outputDir, replace) {
-        const outputAbs = path.resolve(process.cwd(), outputDir);
-        if (replace) {
-            await fsp.rm(outputAbs, { recursive: true, force: true });
-            return outputAbs;
-        }
-        if (await pathExists(outputAbs)) {
-            this.error(`Download target already exists: ${outputDir}. Use --replace to remove it before continuing.`);
-        }
-        return outputAbs;
-    }
-    dockerTarPath(flags, outputAbs) {
-        const image = String(flags['docker-registry'] ?? '').trim() || defaultDockerRegistryForLang(process.env.NB_LOCALE);
-        const tag = flags.version ?? 'latest';
-        const safeBase = `${image.replace(/[/:]/g, '-')}-${tag.replace(/[/\\]/g, '-')}`;
-        return path.join(outputAbs, `${safeBase}.tar`);
-    }
-    /**
-     * Defaults for prompts only. Keys present in **`preset`** are omitted so `runPromptCatalog` uses
-     * **`values`** (preset) alone for those steps — no duplicate prefill for skipped prompts.
-     */
-    buildInitialValuesFromParsed(flags, preset) {
-        const initialValues = {};
-        const localeDefaultDockerRegistry = defaultDockerRegistryForLang(flags.locale ?? process.env.NB_LOCALE);
-        const source = flags.source?.trim();
-        if (source) {
-            initialValues.source = source;
-        }
-        if (flags.version !== undefined) {
-            const version = flags.version.trim() || 'latest';
-            initialValues.version = versionPresetForValue(version);
-            initialValues.otherVersion = otherVersionValue(version);
-        }
-        initialValues.replace = flags.replace;
-        initialValues.devDependencies = flags['dev-dependencies'];
-        initialValues.build = flags.build;
-        initialValues.buildDts = flags['build-dts'];
-        if (flags['output-dir'] !== undefined) {
-            initialValues.outputDir = flags['output-dir']?.trim() ?? '';
-        }
-        if (flags['git-url'] !== undefined) {
-            initialValues.gitUrl = flags['git-url']?.trim() ?? '';
-        }
-        if (flags['docker-registry'] !== undefined) {
-            initialValues.dockerRegistry = String(flags['docker-registry'] ?? '').trim();
-        }
-        else {
-            initialValues.dockerRegistry = localeDefaultDockerRegistry;
-        }
-        initialValues.dockerPlatform = normalizeDockerPlatform(flags['docker-platform']);
-        initialValues.dockerSave = flags['docker-save'];
-        if (flags['npm-registry'] !== undefined) {
-            initialValues.npmRegistry =
-                typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
-        }
-        for (const key of Object.keys(preset)) {
-            if (Object.prototype.hasOwnProperty.call(initialValues, key)) {
-                delete initialValues[key];
-            }
-        }
-        return initialValues;
-    }
-    /**
-     * Preset `values` for `runPromptCatalog`: any key here skips that prompt and fixes the result.
-     * Keys not listed are resolved interactively (TTY) or from catalog defaults / `initialValues` (non-TTY / `-y`).
-     */
-    buildPresetValuesFromFlags(flags) {
-        const preset = {};
-        const argv = process.argv.slice(2);
-        if (flags.source !== undefined && String(flags.source).trim() !== '') {
-            preset.source = String(flags.source).trim();
-        }
-        if (flags.version !== undefined) {
-            const version = String(flags.version).trim() || 'latest';
-            preset.version = versionPresetForValue(version);
-            if (normalizeVersionPreset(version) === 'other') {
-                preset.otherVersion = version;
-            }
-        }
-        if (flags['docker-registry'] !== undefined) {
-            const v = String(flags['docker-registry'] ?? '').trim();
-            if (v) {
-                preset.dockerRegistry = v;
-            }
-        }
-        if (argvHasToken(argv, ['--docker-platform'])) {
-            preset.dockerPlatform = normalizeDockerPlatform(flags['docker-platform']);
-        }
-        if (flags['output-dir'] !== undefined) {
-            const v = flags['output-dir']?.trim();
-            if (v) {
-                preset.outputDir = v;
-            }
-        }
-        if (flags['git-url'] !== undefined) {
-            const v = flags['git-url']?.trim();
-            if (v) {
-                preset.gitUrl = v;
-            }
-        }
-        if (flags['npm-registry'] !== undefined) {
-            preset.npmRegistry = typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
-        }
-        if (argvHasToken(argv, ['--replace', '-r'])) {
-            preset.replace = flags.replace;
-        }
-        if (argvHasToken(argv, ['--dev-dependencies', '--no-dev-dependencies', '-D'])) {
-            preset.devDependencies = flags['dev-dependencies'];
-        }
-        if (argvHasToken(argv, ['--docker-save', '--no-docker-save'])) {
-            preset.dockerSave = flags['docker-save'];
-        }
-        if (argvHasToken(argv, ['--build', '--no-build'])) {
-            preset.build = flags.build;
-        }
-        if (argvHasToken(argv, ['--build-dts', '--no-build-dts'])) {
-            preset.buildDts = flags['build-dts'];
-        }
-        return preset;
-    }
-    resolveEffectiveBuild(source, results, flags) {
-        if (source === 'npm' && !Boolean(results.devDependencies)) {
-            return false;
-        }
-        if (source === 'npm' || source === 'git') {
-            return results.build !== undefined ? Boolean(results.build) : flags.build;
-        }
-        return flags.build;
-    }
-    mapCatalogResultsToResolved(results, flags) {
-        const source = String(results.source);
-        const version = resolveVersionFromResults(results, flags.version) || 'latest';
-        const devDependencies = source === 'npm' ? Boolean(results.devDependencies) : undefined;
-        const effectiveBuild = this.resolveEffectiveBuild(source, results, flags);
-        const buildDtsWant = results.buildDts !== undefined ? Boolean(results.buildDts) : flags['build-dts'];
-        const outputDir = results.outputDir !== undefined
-            ? String(results.outputDir).trim() || undefined
-            : flags['output-dir']?.trim() || undefined;
-        const replace = results.replace !== undefined ? Boolean(results.replace) : flags.replace;
-        const gitUrl = results.gitUrl !== undefined
-            ? String(results.gitUrl).trim() || undefined
-            : flags['git-url']?.trim() || undefined;
-        const dockerRegistry = source === 'docker'
-            ? (results.dockerRegistry !== undefined
-                ? String(results.dockerRegistry).trim() || undefined
-                : flags['docker-registry']?.trim() || defaultDockerRegistryForLang(flags.locale ?? process.env.NB_LOCALE))
-            : undefined;
-        const dockerPlatform = source === 'docker'
-            ? normalizeDockerPlatform(results.dockerPlatform !== undefined
-                ? results.dockerPlatform
-                : flags['docker-platform'])
-            : undefined;
-        const dockerSave = source === 'docker'
-            ? results.dockerSave !== undefined
-                ? Boolean(results.dockerSave)
-                : flags['docker-save']
-            : false;
-        const npmRegistryRaw = results.npmRegistry !== undefined
-            ? String(results.npmRegistry)
-            : flags['npm-registry'] ?? '';
-        const npmRegistry = npmRegistryRaw.trim() || undefined;
-        return {
-            source,
-            version,
-            replace,
-            ...(source === 'npm' ? { 'dev-dependencies': devDependencies } : {}),
-            'build': effectiveBuild,
-            'build-dts': normalizeBuildDts(source, effectiveBuild, buildDtsWant),
-            'output-dir': outputDir,
-            'git-url': gitUrl,
-            'docker-registry': dockerRegistry,
-            ...(source === 'docker' ? { 'docker-platform': dockerPlatform } : {}),
-            ...(source === 'docker' ? { 'docker-save': dockerSave } : {}),
-            ...(npmRegistry ? { 'npm-registry': npmRegistry } : {}),
-        };
-    }
-    async resolveDownloadFlags(flags) {
-        const nonInteractive = !stdinStream.isTTY || !stdoutStream.isTTY || flags.yes;
-        if (nonInteractive && !flags.source?.trim()) {
-            this.error('Download source is required in non-interactive mode. Use --source npm, --source git, or --source docker.');
-        }
-        const presetValues = this.buildPresetValuesFromFlags(flags);
-        const initialValues = this.buildInitialValuesFromParsed(flags, presetValues);
-        const results = await runPromptCatalog(Download.prompts, {
-            initialValues,
-            values: presetValues,
-            yes: flags.yes,
-            command: this,
-            hooks: {
-                onCancel: () => {
-                    p.cancel('Download cancelled.');
-                    this.exit(0);
-                },
-                onMissingNonInteractive: (message) => {
-                    this.error(message);
-                },
-            },
-        });
-        const source = String(results.source ?? '').trim();
-        const version = resolveVersionFromResults(results, flags.version);
-        if (!source || !['docker', 'npm', 'git'].includes(source)) {
-            this.error('Download source is required. Choose npm, git, or docker.');
-        }
-        if (!version) {
-            this.error('Version is required. Choose alpha, beta, latest, or enter another version.');
-        }
-        if (flags['docker-save'] && source !== 'docker') {
-            this.error('--docker-save is only available when --source docker is selected.');
-        }
-        return this.mapCatalogResultsToResolved(results, flags);
-    }
-    npmRegistryUrl(flags) {
-        const url = flags['npm-registry']?.trim();
-        return url || undefined;
-    }
-    npmRegistryEnv(flags) {
-        const url = this.npmRegistryUrl(flags);
-        if (!url) {
-            return undefined;
-        }
-        return { npm_config_registry: url };
-    }
-    isVerbose() {
-        const flags = this._flags;
-        return Boolean(flags?.verbose);
-    }
-    commandStdio() {
-        return this.isVerbose() ? 'inherit' : 'ignore';
-    }
-    formatCommandForLog(name, args, cwd) {
-        const quotedArgs = args.map((arg) => (/\s/.test(arg) ? JSON.stringify(arg) : arg));
-        const commandLine = [name, ...quotedArgs].join(' ');
-        return cwd ? `${commandLine} (cwd: ${cwd})` : commandLine;
-    }
-    async runExternalCommand(name, args, options) {
-        const cwd = options?.cwd;
-        printVerbose(`Running command: ${this.formatCommandForLog(name, args, cwd)}`);
-        let loadingStarted = false;
-        let loadingTimer;
-        let updateTimer;
-        let elapsedSeconds = 0;
-        if (!this.isVerbose() && options?.loadingMessage) {
-            loadingTimer = setTimeout(() => {
-                loadingStarted = true;
-                elapsedSeconds = Math.floor(EXTERNAL_COMMAND_LOADING_DELAY_MS / 1000);
-                startTask(`${options.loadingMessage}. Please wait...`);
-                updateTimer = setInterval(() => {
-                    elapsedSeconds += Math.floor(EXTERNAL_COMMAND_LOADING_UPDATE_MS / 1000);
-                    updateTask(`${options.loadingMessage}. Still working... (${elapsedSeconds}s elapsed)`);
-                }, EXTERNAL_COMMAND_LOADING_UPDATE_MS);
-            }, EXTERNAL_COMMAND_LOADING_DELAY_MS);
-        }
-        try {
-            await run(name, args, {
-                ...options,
-                stdio: this.commandStdio(),
-            });
-        }
-        finally {
-            if (loadingTimer) {
-                clearTimeout(loadingTimer);
-            }
-            if (updateTimer) {
-                clearInterval(updateTimer);
-            }
-            if (loadingStarted) {
-                stopTask();
-            }
-        }
-    }
-    startPreparationTask(message) {
-        if (this.isVerbose()) {
-            p.log.step(message);
-            return;
-        }
-        this.preparationTaskActive = true;
-        startTask(message);
-    }
-    finishPreparationTask() {
-        if (!this.preparationTaskActive) {
-            return;
-        }
-        this.preparationTaskActive = false;
-        stopTask();
-    }
-    runOptionsWithCwd(cwd, registryEnv) {
-        if (registryEnv) {
-            return { cwd, env: registryEnv };
-        }
-        return { cwd };
-    }
-    buildCommandArgv(projectRoot, flags) {
-        const argv = ['--cwd', projectRoot];
-        if (!flags['build-dts']) {
-            argv.push('--no-dts');
-        }
-        return argv;
-    }
-    async downloadFromDocker(flags) {
-        const image = String(flags['docker-registry'] ?? '').trim() || defaultDockerRegistryForLang(process.env.NB_LOCALE);
-        const tag = flags.version ?? 'latest';
-        const imageRef = `${image}:${tag}`;
-        const platform = dockerPlatformArg(flags['docker-platform']);
-        const pullArgs = ['pull'];
-        if (platform) {
-            pullArgs.push('--platform', platform);
-        }
-        pullArgs.push(imageRef);
-        this.finishPreparationTask();
-        p.log.step(`Pulling Docker image ${imageRef}`);
-        await this.runExternalCommand('docker', pullArgs, {
-            errorName: 'docker pull',
-            loadingMessage: 'Pulling the Docker image',
-        });
-        p.log.info(`Docker image is ready: ${imageRef}`);
-        if (!flags['docker-save']) {
-            return;
-        }
-        const outputDir = this.resolveOutputDir(flags);
-        const outAbs = flags.replace
-            ? path.resolve(process.cwd(), outputDir)
-            : await this.ensureOutputDirAvailable(outputDir, false);
-        if (flags.replace) {
-            await fsp.rm(outAbs, { recursive: true, force: true });
-        }
-        await fsp.mkdir(outAbs, { recursive: true });
-        const tarPath = this.dockerTarPath(flags, outAbs);
-        p.log.step(`Saving Docker image tarball to ${tarPath}`);
-        await this.runExternalCommand('docker', ['save', '-o', tarPath, imageRef], {
-            errorName: 'docker save',
-            loadingMessage: 'Saving the Docker image tarball',
-        });
-        p.log.info(`Docker image tarball saved: ${tarPath}`);
-    }
-    async downloadFromNpm(flags) {
-        const versionSpec = flags.version || 'latest';
-        const outputDir = this.resolveOutputDir(flags);
-        const projectRoot = path.resolve(process.cwd(), outputDir);
-        await this.ensureOutputDirAvailable(outputDir, flags.replace);
-        const parentDir = path.dirname(projectRoot);
-        const appName = path.basename(projectRoot);
-        const npxArgs = ['-y', `create-nocobase-app@${versionSpec}`, appName];
-        if (!flags['dev-dependencies']) {
-            npxArgs.push('--skip-dev-dependencies');
-        }
-        await fsp.mkdir(parentDir, { recursive: true });
-        const registryEnv = this.npmRegistryEnv(flags);
-        this.finishPreparationTask();
-        p.log.step(`Creating NocoBase app "${appName}" from npm`);
-        await this.runExternalCommand('npx', npxArgs, {
-            ...this.runOptionsWithCwd(parentDir, registryEnv),
-            errorName: 'npx create-nocobase-app',
-            loadingMessage: 'Creating the app scaffold',
-        });
-        const installArgs = ['install'];
-        if (!flags['dev-dependencies']) {
-            installArgs.push('--production');
-        }
-        p.log.step(`Installing dependencies in ${projectRoot}`);
-        await this.runExternalCommand('yarn', installArgs, {
-            ...this.runOptionsWithCwd(projectRoot, registryEnv),
-            errorName: 'yarn install',
-            loadingMessage: 'Installing dependencies',
-        });
-        if (flags.build && flags['dev-dependencies']) {
-            p.log.step(`Building app in ${projectRoot}`);
-            await this.config.runCommand('build', [
-                ...this.buildCommandArgv(projectRoot, flags),
-                ...(this.isVerbose() ? ['--verbose'] : []),
-            ]);
-        }
-        p.log.info(`NocoBase app is ready at ${projectRoot}`);
-        return projectRoot;
-    }
-    async downloadFromGit(flags) {
-        const repoUrl = flags['git-url'] ?? 'https://github.com/nocobase/nocobase.git';
-        const versionSpec = flags.version || 'latest';
-        const outputDir = this.resolveOutputDir(flags);
-        await this.ensureOutputDirAvailable(outputDir, flags.replace);
-        const branch = gitRefForVersion(versionSpec);
-        const gitArgs = ['clone'];
-        gitArgs.push('--branch', branch);
-        gitArgs.push('--depth', '1', repoUrl, outputDir);
-        this.finishPreparationTask();
-        p.log.step(branch === versionSpec
-            ? `Cloning NocoBase from ${repoUrl} (${branch})`
-            : `Cloning NocoBase from ${repoUrl} (${branch}, resolved from ${versionSpec})`);
-        await this.runExternalCommand('git', gitArgs, {
-            errorName: 'git clone',
-            loadingMessage: 'Cloning the repository',
-        });
-        const projectRoot = path.resolve(process.cwd(), outputDir);
-        const registryEnv = this.npmRegistryEnv(flags);
-        p.log.step(`Installing dependencies in ${projectRoot}`);
-        await this.runExternalCommand('yarn', ['install'], {
-            ...this.runOptionsWithCwd(projectRoot, registryEnv),
-            errorName: 'yarn install',
-            loadingMessage: 'Installing dependencies',
-        });
-        if (flags.build) {
-            p.log.step(`Building app in ${projectRoot}`);
-            await this.config.runCommand('build', [
-                ...this.buildCommandArgv(projectRoot, flags),
-                ...(this.isVerbose() ? ['--verbose'] : []),
-            ]);
-        }
-        p.log.info(`NocoBase app is ready at ${projectRoot}`);
-        return projectRoot;
-    }
-    async download() {
-        const { flags } = await this.parse(Download);
-        this._flags = flags;
-        applyCliLocale(this._flags.locale);
-        setVerboseMode(Boolean(flags.verbose));
-        if (!flags['no-intro']) {
-            p.intro('Get NocoBase');
-        }
-        const resolved = await this.resolveDownloadFlags(flags);
-        const source = resolved.source;
-        this.startPreparationTask(`Preparing download from ${downloadSourceLabel(source)}`);
-        try {
-            switch (source) {
-                case 'npm': {
-                    const projectRoot = await this.downloadFromNpm(resolved);
-                    return { resolved, projectRoot };
-                }
-                case 'docker': {
-                    await this.downloadFromDocker(resolved);
-                    return { resolved, projectRoot: undefined };
-                }
-                case 'git': {
-                    const projectRoot = await this.downloadFromGit(resolved);
-                    return { resolved, projectRoot };
-                }
-                default:
-                    this.error(`Unsupported download source: ${resolved.source}`);
-            }
-        }
-        finally {
-            this.finishPreparationTask();
-        }
-    }
-    async run() {
-        try {
-            const result = await this.download();
-            p.outro(`Download completed via ${downloadSourceLabel(result.resolved.source)}.`);
-            return result;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            this.error(formatDownloadFailure(message, this.isVerbose()));
-        }
-    }
+export { defaultDockerRegistryForLang } from './source/download.js';
+import SourceDownload from './source/download.js';
+export default class Download extends SourceDownload {
+    static hidden = true;
 }