@nocobase/cli 2.3.0-beta.5 → 2.4.0-alpha.1

package/dist/commands/portal/list.js

@@ -0,0 +1,98 @@
+/**
+ * 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 { getCurrentEnvName, getEnv } 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 { listPortalWorkspaces, toPortalOutputItem } from '../../lib/portal-list.js';
+import { printInfo, renderTable } from '../../lib/ui.js';
+const portalListText = (key, values, fallback) => translateCli(`commands.portalList.${key}`, values, { fallback });
+function formatBoolean(value) {
+    if (value === null) {
+        return '';
+    }
+    return value ? 'yes' : 'no';
+}
+export default class PortalList extends Command {
+    static summary = 'List portal records and development paths';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --env dev --yes',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name; omitted uses the current env',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        'json-output': Flags.boolean({
+            char: 'j',
+            aliases: ['json'],
+            description: 'Print portal records as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PortalList);
+        const requestedEnv = hasExplicitEnvSelection(this.argv) ? flags.env : undefined;
+        const confirmed = await ensureCrossEnvConfirmed({
+            command: this,
+            requestedEnv,
+            yes: flags.yes,
+        });
+        if (!confirmed) {
+            return;
+        }
+        const scope = resolveDefaultConfigScope();
+        const envName = requestedEnv ?? (await getCurrentEnvName({ scope }));
+        const env = await getEnv(envName, { scope });
+        if (!env) {
+            this.error(portalListText(requestedEnv ? 'errors.envNotConfigured' : 'errors.noEnvConfigured', { envName }, requestedEnv
+                ? `Env "${envName}" is not configured. Run \`nb env add ${envName} --api-base-url <url>\` first.`
+                : 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.'));
+        }
+        const result = await listPortalWorkspaces({
+            env,
+            envName,
+            cliVersion: String(this.config.pjson.version ?? '').trim(),
+        });
+        const outputItems = result.items.map(toPortalOutputItem);
+        if (flags['json-output']) {
+            this.log(JSON.stringify(outputItems, null, 2));
+            return;
+        }
+        if (!outputItems.length) {
+            printInfo(portalListText('messages.empty', undefined, 'No portal records found.'));
+            return;
+        }
+        this.log(renderTable([
+            portalListText('table.name', undefined, 'Name'),
+            portalListText('table.url', undefined, 'URL'),
+            portalListText('table.portalType', undefined, 'Portal type'),
+            portalListText('table.sourceStorage', undefined, 'Source storage'),
+            portalListText('table.path', undefined, 'Development path'),
+            portalListText('table.enabled', undefined, 'Enabled'),
+            portalListText('table.default', undefined, 'Default'),
+        ], outputItems.map((item) => [
+            item.name,
+            item.url,
+            item.portalType,
+            item.sourceStorage,
+            item.developmentPath,
+            formatBoolean(item.enabled),
+            formatBoolean(item.isDefault),
+        ])));
+    }
+}

package/dist/commands/portal/pull.js

@@ -0,0 +1,113 @@
+/**
+ * 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 { 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, 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',
+    ];
+    static args = {
+        portal: Args.string({
+            required: true,
+            description: 'Portal name',
+        }),
+    };
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name; omitted uses the current env',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        force: Flags.boolean({
+            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,
+            allowNo: true,
+        }),
+    };
+    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,
+            requestedEnv,
+            yes: flags.yes,
+        });
+        if (!confirmed) {
+            return;
+        }
+        const scope = resolveDefaultConfigScope();
+        const envName = requestedEnv ?? (await getCurrentEnvName({ scope }));
+        const env = await getEnv(envName, { scope });
+        if (!env) {
+            this.error(portalPullText(requestedEnv ? 'errors.envNotConfigured' : 'errors.noEnvConfigured', { envName }, requestedEnv
+                ? `Env "${envName}" is not configured. Run \`nb env add ${envName} --api-base-url <url>\` first.`
+                : 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.'));
+        }
+        const result = await pullPortalSource({
+            portal: args.portal,
+            env,
+            envName,
+            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;
+        }
+        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/commands/portal/push.js

@@ -0,0 +1,79 @@
+/**
+ * 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 { getCurrentEnvName, getEnv } 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 { pushPortalSource } from '../../lib/portal-source.js';
+import { printInfo, printSuccess } from '../../lib/ui.js';
+const portalPushText = (key, values, fallback) => translateCli(`commands.portalPush.${key}`, values, { fallback });
+export default class PortalPush extends Command {
+    static summary = 'Push local portal source changes to source storage';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> customer',
+        '<%= config.bin %> <%= command.id %> customer --env prod --yes',
+        '<%= config.bin %> <%= command.id %> customer --message "Update customer portal"',
+    ];
+    static args = {
+        portal: Args.string({
+            required: true,
+            description: 'Portal name',
+        }),
+    };
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name; omitted uses the current env',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        message: Flags.string({
+            char: 'm',
+            description: 'Source update message; used as the Git commit message for Git-managed source',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PortalPush);
+        const requestedEnv = hasExplicitEnvSelection(this.argv) ? flags.env : undefined;
+        const confirmed = await ensureCrossEnvConfirmed({
+            command: this,
+            requestedEnv,
+            yes: flags.yes,
+        });
+        if (!confirmed) {
+            return;
+        }
+        const scope = resolveDefaultConfigScope();
+        const envName = requestedEnv ?? (await getCurrentEnvName({ scope }));
+        const env = await getEnv(envName, { scope });
+        if (!env) {
+            this.error(portalPushText(requestedEnv ? 'errors.envNotConfigured' : 'errors.noEnvConfigured', { envName }, requestedEnv
+                ? `Env "${envName}" is not configured. Run \`nb env add ${envName} --api-base-url <url>\` first.`
+                : 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.'));
+        }
+        const result = await pushPortalSource({
+            portal: args.portal,
+            env,
+            envName,
+            cliVersion: String(this.config.pjson.version ?? '').trim(),
+            message: flags.message,
+        });
+        if (!result.changed) {
+            printInfo(result.noopReason ?? portalPushText('messages.noop', undefined, 'No push is needed.'));
+            return;
+        }
+        printSuccess(portalPushText('messages.pushed', { portal: result.portal, sourceRevision: result.sourceRevision ?? '' }, result.sourceRevision
+            ? `Pushed portal source "${result.portal}" (${result.sourceRevision}).`
+            : `Pushed portal source "${result.portal}".`));
+    }
+}

package/dist/commands/source/dev.js

@@ -140,7 +140,7 @@ export default class SourceDev extends Command {
                     : `Run \`nb app stop --env ${runtime.envName}\` before starting dev mode, or choose another dev port with --port.`,
             ].join('\n'));
         }
-        const npmArgs = ['dev', '--rsbuild'];
+        const npmArgs = ['dev', '--rsbuild', '--quickstart'];
         if (flags['db-sync']) {
             npmArgs.push('--db-sync');
         }

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/app-client-entry-mode.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.
+ */
+export const APP_CLIENT_ENTRY_MODES = [
+    'legacy-default',
+    'modern-default',
+    'modern-only',
+    'settings-default',
+];
+export const PUBLIC_APP_CLIENT_ENTRY_MODES = ['legacy-default', 'modern-default', 'modern-only'];
+export function normalizeAppClientEntryMode(value) {
+    const text = String(value ?? '').trim();
+    return APP_CLIENT_ENTRY_MODES.includes(text) ? text : undefined;
+}
+export function normalizePublicAppClientEntryMode(value) {
+    const text = String(value ?? '').trim();
+    return PUBLIC_APP_CLIENT_ENTRY_MODES.includes(text)
+        ? text
+        : undefined;
+}
+export function defaultAppClientEntryModeForDownloadVersion(version) {
+    return String(version ?? '').trim() === 'latest' ? 'legacy-default' : 'modern-only';
+}

package/dist/lib/app-managed-resources.js

@@ -186,6 +186,7 @@ export async function buildSavedDockerRunArgs(runtime, options) {
     const dbTablePrefix = trimValue(config.dbTablePrefix);
     const dbUnderscored = typeof config.dbUnderscored === 'boolean' ? config.dbUnderscored : undefined;
     const extractClientAssets = resolveDockerClientAssetsExtractEnabled(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
+    const appClientEntryMode = trimValue(config.appClientEntryMode);
     const dockerRegistry = trimValue(config.dockerRegistry) || DEFAULT_DOCKER_REGISTRY;
     const version = trimValue(config.downloadVersion) || DEFAULT_DOCKER_VERSION;
     const imageRef = resolveDockerImageRef(dockerRegistry, version, {
@@ -245,6 +246,7 @@ export async function buildSavedDockerRunArgs(runtime, options) {
     const lifecycleEnvVars = managedAppLifecycleEnvVars();
     args.push('-e', `APP_ENV=${lifecycleEnvVars.APP_ENV}`, '-e', `NODE_ENV=${lifecycleEnvVars.NODE_ENV}`, '-e', `APP_KEY=${appKey}`, '-e', `DB_DIALECT=${dbDialect}`, '-e', `DB_HOST=${dbHost}`, '-e', `DB_PORT=${dbPort}`, '-e', `DB_DATABASE=${dbDatabase}`, '-e', `DB_USER=${dbUser}`, '-e', `DB_PASSWORD=${dbPassword}`, '-e', `TZ=${timeZone}`, '-v', `${storagePath}:${DOCKER_APP_STORAGE_DESTINATION}`);
     pushOptionalEnvArg(args, 'APP_PUBLIC_PATH', appPublicPath ? resolveAppPublicPath(appPublicPath) : undefined);
+    pushOptionalEnvArg(args, 'APP_CLIENT_ENTRY_MODE', appClientEntryMode);
     pushOptionalEnvArg(args, 'DB_SCHEMA', dbSchema || undefined);
     pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix || undefined);
     pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);

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) {
@@ -97,6 +100,7 @@ function normalizeAuthConfig(config) {
     const locale = normalizeOptionalCliLocale(settings.locale);
     const defaultUiHost = normalizeOptionalString(settings.init?.defaultUiHost);
     const defaultApiHost = normalizeOptionalString(settings.init?.defaultApiHost);
+    const defaultPortalTemplate = normalizeOptionalString(settings.init?.defaultPortalTemplate);
     const updatePolicy = normalizeOptionalCliUpdatePolicy(settings.update?.policy);
     const logRetentionDays = typeof settings.log?.retentionDays === 'number' && Number.isInteger(settings.log.retentionDays)
         ? settings.log.retentionDays
@@ -117,11 +121,12 @@ function normalizeAuthConfig(config) {
         name: config.name || config.dockerResourcePrefix,
         settings: {
             ...(locale ? { locale } : {}),
-            ...(defaultUiHost || defaultApiHost
+            ...(defaultUiHost || defaultApiHost || defaultPortalTemplate
                 ? {
                     init: {
                         ...(defaultUiHost ? { defaultUiHost } : {}),
                         ...(defaultApiHost ? { defaultApiHost } : {}),
+                        ...(defaultPortalTemplate ? { defaultPortalTemplate } : {}),
                     },
                 }
                 : {}),
@@ -330,6 +335,7 @@ export class Env {
         put('APP_PORT', this.appPort);
         put('APP_PUBLIC_PATH', this.config.appPublicPath ? resolveAppPublicPath(this.config.appPublicPath) : undefined);
         put('CDN_BASE_URL', this.config.cdnBaseUrl);
+        put('APP_CLIENT_ENTRY_MODE', this.config.appClientEntryMode);
         put('APP_KEY', this.config.appKey);
         put('TZ', this.config.timezone);
         put('DB_DIALECT', this.config.dbDialect);
@@ -519,6 +525,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/bootstrap.js

@@ -72,7 +72,9 @@ function hasVersionFlag(argv) {
 function isBuiltinCommand(argv) {
     const commandTokens = argv.filter((token) => token && !token.startsWith('-'));
     const [topic, subtopic] = commandTokens;
-    return topic === 'env' || topic === 'resource' || (topic === 'api' && subtopic === 'resource');
+    return (topic === 'env' ||
+        topic === 'resource' ||
+        (topic === 'api' && (subtopic === 'resource' || subtopic === 'swagger')));
 }
 export function shouldSkipRuntimeBootstrap(argv) {
     return hasVersionFlag(argv) || isBuiltinCommand(argv);

package/dist/lib/cli-config.js

@@ -34,6 +34,7 @@ export const SUPPORTED_CLI_CONFIG_KEYS = [
     'locale',
     'default-ui-host',
     'default-api-host',
+    'default-portal-template',
     'update.policy',
     'license.pkg-url',
     'docker.network',
@@ -120,7 +121,10 @@ function pruneSettings(config) {
         delete config.settings.locale;
     }
     const init = config.settings?.init;
-    if (init && !trimValue(init.defaultUiHost) && !trimValue(init.defaultApiHost)) {
+    if (init &&
+        !trimValue(init.defaultUiHost) &&
+        !trimValue(init.defaultApiHost) &&
+        !trimValue(init.defaultPortalTemplate)) {
         delete config.settings?.init;
     }
     const update = config.settings?.update;
@@ -181,6 +185,8 @@ export function getExplicitCliConfigValue(config, key) {
             return trimValue(config.settings?.init?.defaultUiHost);
         case 'default-api-host':
             return trimValue(config.settings?.init?.defaultApiHost);
+        case 'default-portal-template':
+            return trimValue(config.settings?.init?.defaultPortalTemplate);
         case 'update.policy':
             return normalizeCliUpdatePolicy(config.settings?.update?.policy);
         case 'license.pkg-url':
@@ -233,6 +239,8 @@ export function getEffectiveCliConfigValue(config, key) {
             return '127.0.0.1';
         case 'default-api-host':
             return '127.0.0.1';
+        case 'default-portal-template':
+            return explicit ?? '';
         case 'update.policy':
             return explicit ?? DEFAULT_UPDATE_POLICY;
         case 'license.pkg-url':
@@ -377,6 +385,12 @@ export async function setCliConfigValue(key, value, options = {}) {
                 defaultApiHost: normalized,
             };
             break;
+        case 'default-portal-template':
+            config.settings.init = {
+                ...(config.settings.init ?? {}),
+                defaultPortalTemplate: normalized,
+            };
+            break;
         case 'update.policy':
             config.settings.update = {
                 ...(config.settings.update ?? {}),
@@ -512,6 +526,11 @@ export async function deleteCliConfigValue(key, options = {}) {
                 delete config.settings.init.defaultApiHost;
             }
             break;
+        case 'default-portal-template':
+            if (config.settings.init) {
+                delete config.settings.init.defaultPortalTemplate;
+            }
+            break;
         case 'update.policy':
             if (config.settings.update) {
                 delete config.settings.update.policy;