@nocobase/cli 2.1.0-alpha.21 → 2.1.0-alpha.23

package/dist/commands/init.js

@@ -14,6 +14,7 @@ import path from 'node:path';
 import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { getEnv, upsertEnv } from "../lib/auth-store.js";
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
+import { applyCliLocale, localeText, translateCli } from "../lib/cli-locale.js";
 import { runPromptCatalogWebUI, } from "../lib/prompt-web-ui.js";
 import { validateApiBaseUrl, validateEnvKey } from "../lib/prompt-validators.js";
 import { run } from "../lib/run-npm.js";
@@ -25,6 +26,7 @@ const DEFAULT_INIT_API_BASE_URL = 'http://localhost:13000/api';
 const DEFAULT_INIT_APP_NAME = 'local';
 const DOWNLOAD_OUTPUT_DIR_PROMPT = Download.prompts.outputDir;
 const CONFIG_SCOPE = 'project';
+const initText = (key, values) => localeText(`commands.init.${key}`, values);
 function withExtraHidden(def, extraHidden) {
     if (def.type === 'run') {
         return def;
@@ -46,6 +48,13 @@ function downloadInNewInstallOnly(def) {
 function argvHasToken(argv, tokens) {
     return tokens.some((token) => argv.includes(token));
 }
+function resolveInitDownloadVersion(results) {
+    const preset = String(results.version ?? '').trim();
+    if (preset === 'other') {
+        return String(results.otherVersion ?? '').trim();
+    }
+    return preset;
+}
 function shouldAllowExistingInitEnv() {
     return argvHasToken(process.argv.slice(2), ['--force', '-f']);
 }
@@ -63,7 +72,7 @@ async function validateInitAppName(value) {
         if (shouldAllowExistingInitEnv()) {
             return undefined;
         }
-        return `Env "${envName}" already exists in this workspace. Choose another app name.`;
+        return translateCli('commands.init.validation.envExists', { envName });
     }
     return undefined;
 }
@@ -71,20 +80,31 @@ function highlightInitValidationMessage(message) {
     return message.replace(/Env "([^"]+)"/, (_match, envName) => `Env ${pc.cyan(pc.bold(`"${envName}"`))}`);
 }
 function formatInitValidationMessage(message) {
-    if (/"appName" is required/.test(message)) {
-        return [
-            'App name is required when prompts are skipped.',
-            'The app name is also the CLI env name. Use `nb init --yes --env <envName>` to continue.',
-        ].join('\n');
-    }
     return message;
 }
 function formatResumeEnvRequiredMessage() {
     return [
-        'Env name is required when resuming setup.',
-        'App name is also the CLI env name. Use `nb init --resume --env <envName>` to continue.',
+        translateCli('commands.init.messages.resumeEnvRequired'),
+        translateCli('commands.init.messages.resumeEnvHelp'),
+    ].join('\n');
+}
+function formatSkippedAppNameRequiredMessage() {
+    return [
+        translateCli('commands.init.messages.appNameRequiredWhenSkipped'),
+        translateCli('commands.init.messages.appNameEnvHelp'),
     ].join('\n');
 }
+function initTitle() {
+    return translateCli('commands.init.messages.title');
+}
+function logInitUiReady(command, url) {
+    p.log.step(translateCli('commands.init.messages.uiReady'));
+    p.log.info(translateCli('commands.init.messages.uiReadyHelp'));
+    command.log(`URL: ${url}`);
+}
+function logInitUiBrowserOpenFallback() {
+    p.log.warn(translateCli('commands.init.messages.uiOpenBrowserFallback'));
+}
 export default class Init extends Command {
     static summary = 'Set up NocoBase so coding agents can connect and work with it';
     static description = `Set up NocoBase for coding agents in the current workspace.
@@ -119,23 +139,23 @@ Prompt modes:
     static prompts = {
         appName: {
             type: 'text',
-            message: 'App name (also used as the CLI env name)',
-            placeholder: DEFAULT_INIT_APP_NAME,
+            message: initText('prompts.appName.message'),
+            placeholder: initText('prompts.appName.placeholder'),
             required: true,
             validate: validateInitAppName,
         },
         hasNocobase: {
             type: 'select',
             variant: 'radio',
-            message: 'Do you already have a NocoBase application?',
+            message: initText('prompts.hasNocobase.message'),
             options: [
                 {
                     value: 'no',
-                    label: "I don't have a NocoBase application yet",
+                    label: initText('prompts.hasNocobase.noLabel'),
                 },
                 {
                     value: 'yes',
-                    label: 'I already have a NocoBase application',
+                    label: initText('prompts.hasNocobase.yesLabel'),
                 },
             ],
             initialValue: 'no',
@@ -144,14 +164,14 @@ Prompt modes:
         },
         installSkills: {
             type: 'boolean',
-            message: 'Install NocoBase AI coding skills (nocobase/skills)?',
+            message: initText('prompts.installSkills.message'),
             initialValue: true,
             yesInitialValue: true,
         },
         apiBaseUrl: existingAppOnly({
             type: 'text',
-            message: 'API base URL',
-            placeholder: DEFAULT_INIT_API_BASE_URL,
+            message: initText('prompts.apiBaseUrl.message'),
+            placeholder: initText('prompts.apiBaseUrl.placeholder'),
             required: true,
             validate: validateApiBaseUrl,
         }),
@@ -164,6 +184,7 @@ Prompt modes:
         fetchSource: newInstallOnly(Install.appPrompts.fetchSource),
         source: downloadInNewInstallOnly(Download.prompts.source),
         version: downloadInNewInstallOnly(Download.prompts.version),
+        otherVersion: downloadInNewInstallOnly(Download.prompts.otherVersion),
         dockerRegistry: downloadInNewInstallOnly(Download.prompts.dockerRegistry),
         dockerPlatform: downloadInNewInstallOnly(Download.prompts.dockerPlatform),
         dockerSave: downloadInNewInstallOnly(Download.prompts.dockerSave),
@@ -194,8 +215,9 @@ Prompt modes:
         devDependencies: downloadInNewInstallOnly(Download.prompts.devDependencies),
         build: downloadInNewInstallOnly(Download.prompts.build),
         buildDts: downloadInNewInstallOnly(Download.prompts.buildDts),
-        builtinDb: newInstallOnly(Install.dbPrompts.builtinDb),
         dbDialect: newInstallOnly(Install.dbPrompts.dbDialect),
+        builtinDb: newInstallOnly(Install.dbPrompts.builtinDb),
+        builtinDbImage: newInstallOnly(Install.dbPrompts.builtinDbImage),
         dbHost: newInstallOnly(Install.dbPrompts.dbHost),
         dbPort: newInstallOnly(Install.dbPrompts.dbPort),
         dbDatabase: newInstallOnly(Install.dbPrompts.dbDatabase),
@@ -209,12 +231,12 @@ Prompt modes:
     static flags = {
         yes: Flags.boolean({
             char: 'y',
-            description: 'Skip prompts and create a new local NocoBase app. Requires an app/env name.',
+            description: 'Skip prompts and create a new local NocoBase app. Requires an env name.',
             default: false,
         }),
         env: Flags.string({
             char: 'e',
-            description: 'App name / CLI env name for this setup. Required with --yes and --resume',
+            description: 'Env name for this setup. Required with --yes and --resume',
         }),
         'install-skills': Flags.boolean({
             description: 'Install NocoBase AI coding skills (`nocobase/skills`) for this workspace',
@@ -224,6 +246,10 @@ Prompt modes:
             description: 'Open the guided setup flow in a local browser form (not valid with --yes)',
             default: false,
         }),
+        verbose: Flags.boolean({
+            description: 'Show detailed command output',
+            default: false,
+        }),
         'ui-host': Flags.string({
             description: 'Host for the local --ui setup server (default: 127.0.0.1)',
         }),
@@ -236,6 +262,7 @@ Prompt modes:
     };
     async run() {
         const parsedResult = await this.parse(Init);
+        applyCliLocale(parsedResult.flags.locale);
         const flags = parsedResult.flags;
         const normalizedFlags = { ...flags };
         if (normalizedFlags.ui && normalizedFlags.yes) {
@@ -254,7 +281,7 @@ Prompt modes:
                 p.log.error(formatResumeEnvRequiredMessage());
                 this.exit(1);
             }
-            p.intro('Set Up NocoBase for Coding Agents');
+            p.intro(initTitle());
             if (Boolean(normalizedFlags['install-skills'])) {
                 try {
                     p.log.step('Installing NocoBase agent skills (npx -y skills add nocobase/skills)');
@@ -282,17 +309,17 @@ Prompt modes:
         const useBrowserUi = Boolean(normalizedFlags.ui);
         let presetValues = this.buildPresetValuesFromFlags(normalizedFlags);
         if (normalizedFlags.yes && !String(presetValues.appName ?? '').trim()) {
-            const formatted = formatInitValidationMessage('Non-interactive: "appName" is required; set initialValues.appName, yesInitialValues.appName, yesInitialValue on the block, or initialValue.');
+            const formatted = formatSkippedAppNameRequiredMessage();
             p.log.error(highlightInitValidationMessage(formatted));
             this.exit(1);
         }
         const appName = String(presetValues.appName ?? '').trim();
         if (useBrowserUi) {
-            p.intro('Set Up NocoBase for Coding Agents');
-            p.log.info('A local setup form will open in your browser. Submit the form there to continue in this terminal.');
+            p.intro(initTitle());
+            p.log.info(translateCli('commands.init.messages.uiOpening'));
         }
         else {
-            p.intro('Set Up NocoBase for Coding Agents');
+            p.intro(initTitle());
             if (normalizedFlags.yes) {
                 p.log.info(`Prompts skipped (--yes). NocoBase will be installed for env "${appName}" using the provided flags and safe defaults.`);
             }
@@ -310,14 +337,14 @@ Prompt modes:
                 },
                 host: normalizedFlags['ui-host']?.trim() || '127.0.0.1',
                 port: normalizedFlags['ui-port'] ?? 0,
-                pageTitle: 'Set Up NocoBase for Coding Agents',
-                documentHeading: 'Set Up NocoBase for Coding Agents',
-                documentHint: 'Connect an existing NocoBase app or install a new one, then save it as an agent-ready CLI environment.',
-                onServerStart: ({ host, port, url }) => {
-                    this.log(`Local setup form ready at ${url} (listening on ${host}:${port}). Submit it in your browser to continue here.`);
+                pageTitle: initText('webUi.pageTitle'),
+                documentHeading: initText('webUi.documentHeading'),
+                documentHint: initText('webUi.documentHint'),
+                onServerStart: ({ url }) => {
+                    logInitUiReady(this, url);
                 },
-                onOpenBrowserError: (url, err) => {
-                    this.log(`Open this URL in your browser to continue setup: ${url} (${err instanceof Error ? err.message : String(err)})`);
+                onOpenBrowserError: (_url, _err) => {
+                    logInitUiBrowserOpenFallback();
                 },
             });
         }
@@ -390,6 +417,7 @@ Prompt modes:
                     'app-root-path': flags['app-root-path'] ?? '',
                     'storage-path': flags['storage-path'] ?? '',
                 },
+                warnOnPortFallback: false,
             });
             if (appInitialValues.appPort !== undefined) {
                 out.appPort = appInitialValues.appPort;
@@ -405,6 +433,7 @@ Prompt modes:
             flags,
             downloadResults: downloadSeed,
             dbPreset: presetValues,
+            warnOnPortFallback: false,
         });
         for (const [key, value] of Object.entries(dbInitial)) {
             if (!Object.prototype.hasOwnProperty.call(presetValues, key)) {
@@ -417,8 +446,8 @@ Prompt modes:
         const c = Init.prompts;
         return [
             {
-                sectionTitle: 'Getting started',
-                sectionDescription: 'Pick your setup path.',
+                sectionTitle: initText('webUi.gettingStarted.title'),
+                sectionDescription: initText('webUi.gettingStarted.description'),
                 catalog: {
                     appName: c.appName,
                     hasNocobase: c.hasNocobase,
@@ -426,8 +455,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Connect an existing app',
-                sectionDescription: 'Add your app connection.',
+                sectionTitle: initText('webUi.connectExistingApp.title'),
+                sectionDescription: initText('webUi.connectExistingApp.description'),
                 catalog: {
                     apiBaseUrl: c.apiBaseUrl,
                     authType: c.authType,
@@ -435,8 +464,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Create a new app',
-                sectionDescription: 'Set project basics.',
+                sectionTitle: initText('webUi.createNewApp.title'),
+                sectionDescription: initText('webUi.createNewApp.description'),
                 catalog: {
                     lang: c.lang,
                     appRootPath: c.appRootPath,
@@ -446,11 +475,12 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Download app files',
-                sectionDescription: 'Choose source and options.',
+                sectionTitle: initText('webUi.downloadAppFiles.title'),
+                sectionDescription: initText('webUi.downloadAppFiles.description'),
                 catalog: {
                     source: c.source,
                     version: c.version,
+                    otherVersion: c.otherVersion,
                     dockerRegistry: c.dockerRegistry,
                     dockerPlatform: c.dockerPlatform,
                     dockerSave: c.dockerSave,
@@ -464,11 +494,12 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Configure the database',
-                sectionDescription: 'Use built-in or custom.',
+                sectionTitle: initText('webUi.configureDatabase.title'),
+                sectionDescription: initText('webUi.configureDatabase.description'),
                 catalog: {
-                    builtinDb: c.builtinDb,
                     dbDialect: c.dbDialect,
+                    builtinDb: c.builtinDb,
+                    builtinDbImage: c.builtinDbImage,
                     dbHost: c.dbHost,
                     dbPort: c.dbPort,
                     dbDatabase: c.dbDatabase,
@@ -477,8 +508,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Create an admin account',
-                sectionDescription: 'Set up the first admin.',
+                sectionTitle: initText('webUi.createAdminAccount.title'),
+                sectionDescription: initText('webUi.createAdminAccount.description'),
                 catalog: {
                     rootUsername: c.rootUsername,
                     rootEmail: c.rootEmail,
@@ -521,6 +552,9 @@ Prompt modes:
         if (flags['db-dialect'] !== undefined && String(flags['db-dialect']).trim() !== '') {
             preset.dbDialect = String(flags['db-dialect']).trim();
         }
+        if (flags['builtin-db-image'] !== undefined && String(flags['builtin-db-image']).trim() !== '') {
+            preset.builtinDbImage = String(flags['builtin-db-image']).trim();
+        }
         if (flags['db-host'] !== undefined && String(flags['db-host']).trim() !== '') {
             preset.dbHost = String(flags['db-host']).trim();
         }
@@ -593,7 +627,7 @@ Prompt modes:
         const envName = String(results.appName ?? DEFAULT_INIT_APP_NAME).trim() || DEFAULT_INIT_APP_NAME;
         const appPort = String(results.appPort ?? '').trim();
         const source = String(results.source ?? '').trim();
-        const version = String(results.version ?? '').trim();
+        const version = resolveInitDownloadVersion(results);
         const dockerRegistry = String(results.dockerRegistry ?? '').trim();
         const dockerPlatform = String(results.dockerPlatform ?? '').trim();
         const gitUrl = String(results.gitUrl ?? '').trim();
@@ -601,6 +635,7 @@ Prompt modes:
         const appRootPath = String(results.appRootPath ?? '').trim();
         const storagePath = String(results.storagePath ?? '').trim();
         const dbDialect = String(results.dbDialect ?? '').trim();
+        const builtinDbImage = String(results.builtinDbImage ?? '').trim();
         const dbHost = String(results.dbHost ?? '').trim();
         const dbPort = String(results.dbPort ?? '').trim();
         const dbDatabase = String(results.dbDatabase ?? '').trim();
@@ -622,6 +657,7 @@ Prompt modes:
             ...(results.buildDts !== undefined ? { buildDts: Boolean(results.buildDts) } : {}),
             ...(results.builtinDb !== undefined ? { builtinDb: Boolean(results.builtinDb) } : {}),
             ...(dbDialect ? { dbDialect } : {}),
+            ...(builtinDbImage || results.builtinDb === false ? { builtinDbImage: builtinDbImage || undefined } : {}),
             ...(dbHost ? { dbHost } : {}),
             ...(dbPort ? { dbPort } : {}),
             ...(dbDatabase ? { dbDatabase } : {}),
@@ -652,6 +688,9 @@ Prompt modes:
         if (options?.resume) {
             argv.push('--resume');
         }
+        if (Boolean(flags.verbose)) {
+            argv.push('--verbose');
+        }
         const lang = String(results.lang ?? '').trim();
         if (lang) {
             argv.push('--lang', lang);
@@ -676,7 +715,7 @@ Prompt modes:
             if (source) {
                 argv.push('--source', source);
             }
-            const version = String(results.version ?? '').trim();
+            const version = resolveInitDownloadVersion(results);
             if (version) {
                 argv.push('--version', version);
             }
@@ -727,6 +766,10 @@ Prompt modes:
         if (dbDialect) {
             argv.push('--db-dialect', dbDialect);
         }
+        const builtinDbImage = String(results.builtinDbImage ?? '').trim();
+        if (builtinDb && builtinDbImage) {
+            argv.push('--builtin-db-image', builtinDbImage);
+        }
         const dbHost = String(results.dbHost ?? '').trim();
         if (dbHost) {
             argv.push('--db-host', dbHost);