@nocobase/cli 3.0.0-alpha.4 → 3.0.0-alpha.6

package/dist/commands/portal/config.js

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Args, Command, Flags } from '@oclif/core';
-import { getCurrentEnvName, getEnv } from '../../lib/auth-store.js';
+import { getCurrentEnvName, getEnv, setEnvPortalPath } from '../../lib/auth-store.js';
 import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
 import { translateCli } from '../../lib/cli-locale.js';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
@@ -17,6 +17,7 @@ const portalConfigureText = (key, values, fallback) => translateCli(`commands.po
 export default class PortalConfig extends Command {
     static summary = 'Update portal source configuration';
     static examples = [
+        '<%= config.bin %> <%= command.id %> customer --path ./portals/customer',
         '<%= config.bin %> <%= command.id %> customer --source-storage nocobase',
         '<%= config.bin %> <%= command.id %> customer --source-storage git --git-repo git@github.com:nocobase/customer-portal.git',
         '<%= config.bin %> <%= command.id %> customer --git-branch main --git-path portals/customer',
@@ -41,6 +42,9 @@ export default class PortalConfig extends Command {
             description: 'Where portal source code is managed',
             options: ['nocobase', 'git'],
         }),
+        path: Flags.string({
+            description: 'Portal development workspace directory',
+        }),
         'git-repo': Flags.string({
             description: 'Git repository URL used when --source-storage=git',
         }),
@@ -79,10 +83,17 @@ export default class PortalConfig extends Command {
             gitRepo: flags['git-repo'],
             gitBranch: flags['git-branch'],
             gitPath: flags['git-path'],
+            sourcePath: flags.path,
         });
-        printSuccess(portalConfigureText('messages.updated', { portal: result.portal, portalDir: result.portalDir }, `Portal "${result.portal}" configuration updated at ${result.portalDir}/portal.config.json.`));
-        printInfo(result.remoteSynced
-            ? portalConfigureText('messages.remoteSynced', undefined, 'Remote portal record: synced')
-            : portalConfigureText('messages.remoteSkipped', undefined, 'Remote portal record: not found; local config only'));
+        if (flags.path) {
+            await setEnvPortalPath(envName, result.portal, result.portalDir, { scope });
+        }
+        printSuccess(portalConfigureText('messages.updated', { portal: result.portal }, `Portal "${result.portal}" configuration updated.`));
+        if (result.pathUpdated) {
+            printInfo(portalConfigureText('messages.pathUpdated', { portalDir: result.portalDir }, `Development path: ${result.portalDir}`));
+        }
+        if (result.config) {
+            printInfo(portalConfigureText('messages.remoteSynced', undefined, 'Remote portal record: synced'));
+        }
     }
 }

package/dist/commands/portal/create.js

@@ -7,21 +7,21 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Args, Command, Flags } from '@oclif/core';
-import { getEnv } from '../../lib/auth-store.js';
+import { getCurrentEnvName, getEnv, setEnvPortalPath } from '../../lib/auth-store.js';
 import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
 import { translateCli } from '../../lib/cli-locale.js';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
 import { createPortalWorkspace } from '../../lib/portal-create.js';
-import { printInfo, printSuccess } from '../../lib/ui.js';
+import { printInfo, printSuccess, printWarning } from '../../lib/ui.js';
 const DEFAULT_PORTAL_TEMPLATE = '@nocobase/portal-template-default';
 const portalCreateText = (key, values, fallback) => translateCli(`commands.portalCreate.${key}`, values, { fallback });
 export default class PortalCreate extends Command {
     static summary = 'Create a local AI portal from a template';
     static examples = [
         '<%= config.bin %> <%= command.id %> customer',
+        '<%= config.bin %> <%= command.id %> customer --path ./portals/customer',
         '<%= config.bin %> <%= command.id %> customer --template @nocobase/portal-template-default',
         '<%= config.bin %> <%= command.id %> customer --env dev --yes',
-        '<%= config.bin %> <%= command.id %> customer --source-storage git --git-repo git@github.com:nocobase/customer-portal.git',
     ];
     static args = {
         portal: Args.string({
@@ -46,24 +46,13 @@ export default class PortalCreate extends Command {
         title: Flags.string({
             description: 'Portal display title; defaults to a title generated from the portal slug',
         }),
+        path: Flags.string({
+            description: 'Portal workspace directory; defaults to ./<portal>',
+        }),
         force: Flags.boolean({
             description: 'Delete the existing portal and recreate it',
             default: false,
         }),
-        'source-storage': Flags.string({
-            description: 'Where portal source code is managed',
-            options: ['nocobase', 'git'],
-            default: 'nocobase',
-        }),
-        'git-repo': Flags.string({
-            description: 'Git repository URL used when --source-storage=git',
-        }),
-        'git-branch': Flags.string({
-            description: 'Git branch used when --source-storage=git',
-        }),
-        'git-path': Flags.string({
-            description: 'Directory inside the Git repository for this portal; defaults to the repository root',
-        }),
     };
     async run() {
         const { args, flags } = await this.parse(PortalCreate);
@@ -77,10 +66,11 @@ export default class PortalCreate extends Command {
             return;
         }
         const scope = resolveDefaultConfigScope();
-        const env = await getEnv(flags.env, { scope });
+        const envName = requestedEnv ?? (await getCurrentEnvName({ scope }));
+        const env = await getEnv(envName, { scope });
         if (!env) {
-            this.error(flags.env
-                ? portalCreateText('errors.envNotConfigured', { envName: flags.env }, `Env "${flags.env}" is not configured. Run \`nb env add ${flags.env} --api-base-url <url>\` first.`)
+            this.error(requestedEnv
+                ? portalCreateText('errors.envNotConfigured', { envName }, `Env "${envName}" is not configured. Run \`nb env add ${envName} --api-base-url <url>\` first.`)
                 : portalCreateText('errors.noEnvConfigured', undefined, 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.'));
         }
         const result = await createPortalWorkspace({
@@ -88,18 +78,19 @@ export default class PortalCreate extends Command {
             title: flags.title,
             template: flags.template,
             env,
-            envName: flags.env,
+            envName,
             cliVersion: String(this.config.pjson.version ?? '').trim(),
             force: flags.force,
-            sourceStorage: flags['source-storage'],
-            gitRepo: flags['git-repo'],
-            gitBranch: flags['git-branch'],
-            gitPath: flags['git-path'],
+            sourcePath: flags.path,
             onSkipInstall: (message) => printInfo(message),
         });
-        printSuccess(portalCreateText('messages.created', { portal: result.portal, portalDir: result.portalDir }, `Portal "${result.portal}" created at ${result.portalDir}.`));
+        await setEnvPortalPath(envName, result.portal, result.portalDir, { scope });
+        printSuccess(portalCreateText('messages.created', { portal: result.portal, portalDir: result.portalDir }, `Portal "${result.portal}" created at ${result.portalDir}`));
         printInfo(portalCreateText('messages.app', { app: result.app }, `App: ${result.app}`));
         printInfo(portalCreateText('messages.base', { base: result.portalBase }, `Base: ${result.portalBase}`));
         printInfo(portalCreateText('messages.sourceStorage', { sourceStorage: result.sourceStorage }, `Source storage: ${result.sourceStorage}`));
+        if (result.installFailed) {
+            printWarning(portalCreateText('messages.installFailed', { portalDir: result.portalDir }, `Dependency installation did not finish successfully. Run \`pnpm install\` manually in ${result.portalDir}.`));
+        }
     }
 }

package/dist/commands/portal/destroy.js

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Args, Command, Flags } from '@oclif/core';
-import { getCurrentEnvName, getEnv } from '../../lib/auth-store.js';
+import { getCurrentEnvName, getEnv, unsetEnvPortalPath } from '../../lib/auth-store.js';
 import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
 import { translateCli } from '../../lib/cli-locale.js';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
@@ -15,6 +15,9 @@ import { confirm } from "../../lib/inquirer.js";
 import { destroyPortalWorkspace } from '../../lib/portal-destroy.js';
 import { isInteractiveTerminal, printInfo, printSuccess } from '../../lib/ui.js';
 const portalDestroyText = (key, values, fallback) => translateCli(`commands.portalDestroy.${key}`, values, { fallback });
+function portalDestroyStatus(status) {
+    return portalDestroyText(`statuses.${status}`, undefined, status);
+}
 async function ensureDestroyConfirmed(options) {
     if (options.yes) {
         return true;
@@ -24,7 +27,7 @@ async function ensureDestroyConfirmed(options) {
     }
     try {
         return Boolean(await confirm({
-            message: portalDestroyText('prompts.confirm', { portal: options.portal }, `Destroy portal "${options.portal}" and delete its storage directory?`),
+            message: portalDestroyText('prompts.confirm', { portal: options.portal }, `Destroy portal "${options.portal}" and delete its deployment directory?`),
             default: false,
         }));
     }
@@ -33,9 +36,10 @@ async function ensureDestroyConfirmed(options) {
     }
 }
 export default class PortalDestroy extends Command {
-    static summary = 'Destroy a portal record and local files';
+    static summary = 'Destroy a portal record and deployed files';
     static examples = [
         '<%= config.bin %> <%= command.id %> customer --yes',
+        '<%= config.bin %> <%= command.id %> customer --delete-dev-path --yes',
         '<%= config.bin %> <%= command.id %> customer --env dev --yes',
         '<%= config.bin %> <%= command.id %> customer --force --yes',
     ];
@@ -56,7 +60,12 @@ export default class PortalDestroy extends Command {
             default: false,
         }),
         force: Flags.boolean({
-            description: 'Ignore missing portal records or local files',
+            description: 'Ignore missing portal records or deployment files',
+            default: false,
+        }),
+        'delete-dev-path': Flags.boolean({
+            char: 'D',
+            description: 'Delete the portal development directory in addition to the deployed portal',
             default: false,
         }),
     };
@@ -93,12 +102,25 @@ export default class PortalDestroy extends Command {
             envName,
             cliVersion: String(this.config.pjson.version ?? '').trim(),
             force: flags.force,
+            deleteDevPath: flags['delete-dev-path'],
         });
+        await unsetEnvPortalPath(envName, result.portal, { scope });
         printSuccess(portalDestroyText('messages.destroyed', { portal: result.portal }, `Portal "${result.portal}" destroyed.`));
         printInfo(portalDestroyText('messages.mode', { mode: result.mode }, `Mode: ${result.mode}`));
         printInfo(portalDestroyText('messages.app', { app: result.app }, `App: ${result.app}`));
         printInfo(portalDestroyText('messages.base', { base: result.portalBase }, `Base: ${result.portalBase}`));
-        printInfo(portalDestroyText('messages.record', { status: result.recordDeleted ? 'deleted' : 'missing' }, `Record: ${result.recordDeleted ? 'deleted' : 'missing'}`));
-        printInfo(portalDestroyText('messages.workspace', { dir: result.portalDir, status: result.workspaceDeleted ? 'deleted' : 'missing' }, `Portal files: ${result.workspaceDeleted ? 'deleted' : 'missing'} (${result.portalDir})`));
+        printInfo(portalDestroyText('messages.record', { status: portalDestroyStatus(result.recordDeleted ? 'deleted' : 'missing') }, `Record: ${result.recordDeleted ? 'deleted' : 'missing'}`));
+        const deploymentPathStatus = result.deploymentPathDeleted ? 'deleted' : 'missing';
+        printInfo(portalDestroyText('messages.deploymentPath', { dir: result.deploymentPath, status: portalDestroyStatus(deploymentPathStatus) }, `Deployment path: ${deploymentPathStatus} (${result.deploymentPath})`));
+        let developmentPathStatus = 'missing';
+        if (result.developmentPath) {
+            developmentPathStatus = result.developmentPathDeleted ? 'deleted' : 'retained';
+        }
+        printInfo(portalDestroyText(result.developmentPath ? 'messages.developmentPath' : 'messages.developmentPathMissing', {
+            dir: result.developmentPath,
+            status: portalDestroyStatus(developmentPathStatus),
+        }, result.developmentPath
+            ? `Development path: ${developmentPathStatus} (${result.developmentPath})`
+            : 'Development path: missing'));
     }
 }

package/dist/commands/portal/dev.js

@@ -59,6 +59,8 @@ export default class PortalDev extends Command {
         await devPortalWorkspace({
             portal: args.portal,
             env,
+            envName,
+            cliVersion: String(this.config?.pjson?.version ?? '').trim(),
             onStart: (result) => {
                 printInfo(portalDevText('messages.starting', { portal: result.portal }, `Starting portal "${result.portal}"...`));
                 printInfo(portalDevText('messages.mode', { mode: result.mode }, `Mode: ${result.mode}`));

package/dist/commands/portal/list.js

@@ -21,7 +21,7 @@ function formatBoolean(value) {
     return value ? 'yes' : 'no';
 }
 export default class PortalList extends Command {
-    static summary = 'List portal records and local sync status';
+    static summary = 'List portal records and development paths';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --env dev --yes',
@@ -82,17 +82,17 @@ export default class PortalList extends Command {
             portalListText('table.url', undefined, 'URL'),
             portalListText('table.portalType', undefined, 'Portal type'),
             portalListText('table.sourceStorage', undefined, 'Source storage'),
-            portalListText('table.path', undefined, 'Local path'),
+            portalListText('table.path', undefined, 'Development path'),
             portalListText('table.enabled', undefined, 'Enabled'),
-            portalListText('table.localSynced', undefined, 'Local synced'),
+            portalListText('table.default', undefined, 'Default'),
         ], outputItems.map((item) => [
             item.name,
             item.url,
             item.portalType,
             item.sourceStorage,
-            item.localPath,
+            item.developmentPath,
             formatBoolean(item.enabled),
-            formatBoolean(item.localSynced),
+            formatBoolean(item.isDefault),
         ])));
     }
 }

package/dist/commands/portal/pull.js

@@ -7,18 +7,20 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Args, Command, Flags } from '@oclif/core';
-import { getCurrentEnvName, getEnv } from '../../lib/auth-store.js';
+import { getCurrentEnvName, getEnv, setEnvPortalPath } from '../../lib/auth-store.js';
 import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
 import { translateCli } from '../../lib/cli-locale.js';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
 import { pullPortalSource } from '../../lib/portal-source.js';
-import { printInfo, printSuccess } from '../../lib/ui.js';
+import { printInfo, printSuccess, printWarning } from '../../lib/ui.js';
 const portalPullText = (key, values, fallback) => translateCli(`commands.portalPull.${key}`, values, { fallback });
 export default class PortalPull extends Command {
     static summary = 'Pull portal source into local files';
     static examples = [
         '<%= config.bin %> <%= command.id %> customer',
         '<%= config.bin %> <%= command.id %> customer --env prod --yes',
+        '<%= config.bin %> <%= command.id %> customer --path ./portals/customer',
+        '<%= config.bin %> <%= command.id %> customer --git-repo git@github.com:nocobase/customer.git',
         '<%= config.bin %> <%= command.id %> customer --force',
         '<%= config.bin %> <%= command.id %> customer --no-install',
     ];
@@ -42,6 +44,18 @@ export default class PortalPull extends Command {
             description: 'Delete the existing local files and pull them again',
             default: false,
         }),
+        path: Flags.string({
+            description: 'Portal workspace directory; defaults to the saved path, then ./<portal>',
+        }),
+        'git-repo': Flags.string({
+            description: 'Temporarily pull source from this Git repository without updating the portal source configuration',
+        }),
+        'git-branch': Flags.string({
+            description: 'Git branch for the temporary --git-repo pull; defaults to main',
+        }),
+        'git-path': Flags.string({
+            description: 'Directory inside the temporary Git repository; defaults to the repository root',
+        }),
         install: Flags.boolean({
             description: 'Run pnpm install after pulling the portal source',
             default: true,
@@ -50,6 +64,12 @@ export default class PortalPull extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(PortalPull);
+        if ((flags['git-branch'] || flags['git-path']) && !flags['git-repo']) {
+            this.error(portalPullText('errors.gitRepoRequiredForTemporaryPull', undefined, [
+                '--git-branch and --git-path require --git-repo for a temporary Git pull.',
+                'To update the portal configuration, use `nb portal config`.',
+            ].join(' ')));
+        }
         const requestedEnv = hasExplicitEnvSelection(this.argv) ? flags.env : undefined;
         const confirmed = await ensureCrossEnvConfirmed({
             command: this,
@@ -74,11 +94,20 @@ export default class PortalPull extends Command {
             cliVersion: String(this.config.pjson.version ?? '').trim(),
             force: flags.force,
             installDependencies: flags.install,
+            sourcePath: flags.path,
+            defaultSourcePath: true,
+            gitRepo: flags['git-repo'],
+            gitBranch: flags['git-branch'],
+            gitPath: flags['git-path'],
         });
         if (!result.changed) {
             printInfo(result.noopReason ?? portalPullText('messages.noop', undefined, 'No pull is needed.'));
             return;
         }
-        printSuccess(portalPullText('messages.pulled', { portal: result.portal, portalDir: result.portalDir }, `Pulled portal source "${result.portal}" into ${result.portalDir}.`));
+        await setEnvPortalPath(envName, result.portal, result.portalDir, { scope });
+        printSuccess(portalPullText('messages.pulled', { portal: result.portal, portalDir: result.portalDir }, `Pulled portal source "${result.portal}" into ${result.portalDir}`));
+        if (result.installFailed) {
+            printWarning(portalPullText('messages.installFailed', { portalDir: result.portalDir }, `Dependency installation did not finish successfully. Run \`pnpm install\` manually in ${result.portalDir}.`));
+        }
     }
 }

package/dist/lib/api-client.js

@@ -19,6 +19,7 @@ import { promises as fs } from 'node:fs';
 import { basename, dirname } from 'node:path';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
+import { translateCli } from './cli-locale.js';
 import { resolveServerRequestTarget } from './env-auth.js';
 import { fetchWithPreservedAuthRedirect } from './http-request.js';
 const CLI_REQUEST_SOURCE_HEADER = 'x-request-source';
@@ -40,7 +41,32 @@ function parseJsonInput(raw, flagName) {
 function normalizeBaseUrl(baseUrl) {
     return baseUrl.replace(/\/+$/, '');
 }
-async function parseResponse(response) {
+function buildAuthFailureCommand(envName) {
+    const normalizedEnvName = String(envName ?? '').trim();
+    return normalizedEnvName ? `nb env auth ${normalizedEnvName}` : 'nb env auth';
+}
+function decorateAuthFailureResponse(data, status, envName) {
+    if (status !== 401) {
+        return data;
+    }
+    const cliCommand = buildAuthFailureCommand(envName);
+    const cliHint = translateCli('apiClient.authRequiredHint', { command: cliCommand }, {
+        fallback: 'Authentication failed or the saved session has expired. Run `{{command}}` to sign in again.',
+    });
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return {
+            ...data,
+            cliHint,
+            cliCommand,
+        };
+    }
+    return {
+        error: data,
+        cliHint,
+        cliCommand,
+    };
+}
+async function parseResponse(response, envName) {
     const text = await response.text();
     let data = text;
     if (text) {
@@ -54,10 +80,10 @@ async function parseResponse(response) {
     return {
         ok: response.ok,
         status: response.status,
-        data,
+        data: decorateAuthFailureResponse(data, response.status, envName),
     };
 }
-async function parseBinaryResponse(response, outputPath) {
+async function parseBinaryResponse(response, outputPath, envName) {
     if (response.ok && response.body) {
         await fs.mkdir(dirname(outputPath), { recursive: true }).catch(() => undefined);
         await pipeline(Readable.fromWeb(response.body), createWriteStream(outputPath));
@@ -69,7 +95,7 @@ async function parseBinaryResponse(response, outputPath) {
             },
         };
     }
-    return parseResponse(response);
+    return parseResponse(response, envName);
 }
 function parseScalarValue(value, type) {
     if (value === undefined) {
@@ -215,7 +241,7 @@ async function createMultipartBody(flags, operation) {
     return hasValues ? formData : undefined;
 }
 export async function executeApiRequest(options) {
-    const { baseUrl, token } = await resolveServerRequestTarget(options);
+    const { baseUrl, token, envName } = await resolveServerRequestTarget(options);
     const headers = new Headers();
     headers.set(CLI_REQUEST_SOURCE_HEADER, CLI_REQUEST_SOURCE_VALUE);
     headers.set(CLI_VERSION_HEADER, options.cliVersion);
@@ -283,12 +309,12 @@ export async function executeApiRequest(options) {
         if (!outputPath) {
             throw new Error('Missing required output path --output');
         }
-        return parseBinaryResponse(response, outputPath);
+        return parseBinaryResponse(response, outputPath, envName);
     }
-    return parseResponse(response);
+    return parseResponse(response, envName);
 }
 export async function executeRawApiRequest(options) {
-    const { baseUrl, token } = await resolveServerRequestTarget(options);
+    const { baseUrl, token, envName } = await resolveServerRequestTarget(options);
     const headers = new Headers();
     headers.set(CLI_REQUEST_SOURCE_HEADER, CLI_REQUEST_SOURCE_VALUE);
     if (token) {
@@ -332,7 +358,7 @@ export async function executeRawApiRequest(options) {
             body: options.body === undefined ? undefined : JSON.stringify(options.body),
             signal: controller?.signal,
         });
-        return parseResponse(response);
+        return parseResponse(response, envName);
     }
     finally {
         if (timeout) {

package/dist/lib/auth-store.js

@@ -14,6 +14,7 @@ import { normalizeCliLocale } from './cli-locale.js';
 import { normalizeEnvProxyConfig, normalizeEnvProxyProviderConfig, } from './env-proxy-config.js';
 import { inferConfiguredAppPathFromLegacyConfig, resolveConfiguredAppPath, resolveConfiguredSourcePath, resolveConfiguredStoragePath, } from './env-paths.js';
 import { ENV_CONFIG_SCHEMA_VERSION, normalizeEnvConfigSchemaVersion } from './env-config.js';
+import { normalizeEnvPortalsConfig, } from './env-portal-config.js';
 import { cleanupCurrentSessionAfterEnvRemoval, resolveEffectiveCurrentEnv, setSessionCurrentEnv, } from './session-store.js';
 function normalizeStoredEnvKind(value) {
     const kind = String(value ?? '').trim();
@@ -78,11 +79,12 @@ function normalizeEnvConfigEntry(entry) {
     if (!entry) {
         return entry;
     }
-    const { kind: _kind, apiBaseUrl: _apiBaseUrl, baseUrl: _baseUrl, apibaseUrl: _legacyApiBaseUrl, schemaVersion: _schemaVersion, ...rest } = entry;
+    const { kind: _kind, apiBaseUrl: _apiBaseUrl, baseUrl: _baseUrl, apibaseUrl: _legacyApiBaseUrl, schemaVersion: _schemaVersion, portals: _portals, ...rest } = entry;
     const normalizedKind = resolveEnvKind(entry);
     const apiBaseUrl = readEnvApiBaseUrl(entry);
     const schemaVersion = normalizeEnvConfigSchemaVersion(entry.schemaVersion);
     const proxy = normalizeEnvProxyConfig(entry.proxy);
+    const portals = normalizeEnvPortalsConfig(entry.portals);
     return {
         ...rest,
         ...(schemaVersion ? { schemaVersion } : {}),
@@ -90,6 +92,7 @@ function normalizeEnvConfigEntry(entry) {
         ...(apiBaseUrl !== undefined ? { apiBaseUrl } : {}),
         ...(normalizeOptionalString(entry.appPublicPath) ? { appPublicPath: resolveAppPublicPath(entry.appPublicPath) } : {}),
         ...(proxy ? { proxy } : {}),
+        ...(portals ? { portals } : {}),
     };
 }
 function normalizeAuthConfig(config) {
@@ -521,6 +524,53 @@ export async function setEnvRuntime(envName, runtime, options = {}) {
     };
     await saveAuthConfig(config, options);
 }
+export function resolveEnvPortalPath(config, portal) {
+    const portalName = normalizeOptionalString(portal);
+    if (!portalName) {
+        return undefined;
+    }
+    return normalizeOptionalString(config?.portals?.[portalName]?.path);
+}
+export async function setEnvPortalPath(envName, portal, portalPath, options = {}) {
+    const portalName = normalizeOptionalString(portal);
+    const normalizedPath = normalizeOptionalString(portalPath);
+    if (!portalName || !normalizedPath) {
+        return;
+    }
+    await writeEnv(envName, (previous) => {
+        if (!previous) {
+            throw new Error(`Env "${envName}" is not configured`);
+        }
+        const portals = normalizeEnvPortalsConfig(previous.portals) ?? {};
+        return {
+            ...previous,
+            portals: {
+                ...portals,
+                [portalName]: {
+                    ...(portals[portalName] ?? {}),
+                    path: normalizedPath,
+                },
+            },
+        };
+    }, options);
+}
+export async function unsetEnvPortalPath(envName, portal, options = {}) {
+    const portalName = normalizeOptionalString(portal);
+    if (!portalName) {
+        return;
+    }
+    await writeEnv(envName, (previous) => {
+        if (!previous) {
+            throw new Error(`Env "${envName}" is not configured`);
+        }
+        const portals = normalizeEnvPortalsConfig(previous.portals) ?? {};
+        delete portals[portalName];
+        return {
+            ...previous,
+            ...(Object.keys(portals).length > 0 ? { portals } : { portals: undefined }),
+        };
+    }, options);
+}
 export function resolveEnvProxyEntry(config, provider) {
     const proxy = normalizeEnvProxyConfig(config?.proxy);
     const resolved = {

package/dist/lib/env-auth.js

@@ -973,7 +973,7 @@ export async function resolveServerRequestTarget(options) {
                 : `Use --api-base-url or run \`nb init --ui --env ${envName}\` first.`,
         ].join('\n'));
     }
-    return { baseUrl, token };
+    return { baseUrl, token, envName };
 }
 export async function authenticateEnvWithBasic(options) {
     const envName = options.envName ?? (await getCurrentEnvName({ scope: options.scope }));

package/dist/lib/env-config.js

@@ -8,6 +8,7 @@
  */
 import { normalizeEnvProxyConfig } from './env-proxy-config.js';
 import { resolveAppPublicPath } from './app-public-path.js';
+import { normalizeEnvPortalsConfig } from './env-portal-config.js';
 const STRING_ENV_CONFIG_KEYS = [
     'source',
     'downloadVersion',
@@ -118,5 +119,9 @@ export function buildStoredEnvConfig(input) {
     if (proxy) {
         envConfig.proxy = proxy;
     }
+    const portals = normalizeEnvPortalsConfig(input.portals);
+    if (portals) {
+        envConfig.portals = portals;
+    }
     return envConfig;
 }

package/dist/lib/env-portal-config.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.
+ */
+function trimValue(value) {
+    return String(value ?? '').trim();
+}
+function readRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+export function normalizeEnvPortalsConfig(value) {
+    const input = readRecord(value);
+    const portals = {};
+    for (const [portal, rawEntry] of Object.entries(input)) {
+        const portalName = trimValue(portal);
+        if (!portalName) {
+            continue;
+        }
+        const entry = readRecord(rawEntry);
+        const portalPath = trimValue(entry.path);
+        if (portalPath) {
+            portals[portalName] = { path: portalPath };
+        }
+    }
+    return Object.keys(portals).length > 0 ? portals : undefined;
+}

package/dist/lib/portal-build-html.js

@@ -0,0 +1,27 @@
+/**
+ * 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 { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+const BUILD_HTML_SCRIPT_PATH = path.join('scripts', 'build-html.mjs');
+const BUILD_HTML_ENV_FILES_PATTERN = /return\s+\[\s*["']\.env["']\s*,\s*["']\.env\.local["']\s*,\s*`\.env\.\$\{mode\}`\s*,\s*`\.env\.\$\{mode\}\.local`\s*\]\.map\(\s*\(?file\)?\s*=>\s*path\.join\(rootDir,\s*file\)\s*\);/m;
+const BUILD_HTML_ENV_ONLY_REPLACEMENT = 'return [".env"].map((file) => path.join(rootDir, file));';
+export async function ensurePortalBuildHtmlReadsEnvOnly(portalDir) {
+    const scriptPath = path.join(portalDir, BUILD_HTML_SCRIPT_PATH);
+    let content;
+    try {
+        content = await readFile(scriptPath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    const nextContent = content.replace(BUILD_HTML_ENV_FILES_PATTERN, BUILD_HTML_ENV_ONLY_REPLACEMENT);
+    if (nextContent !== content) {
+        await writeFile(scriptPath, nextContent, 'utf-8');
+    }
+}