@nocobase/cli 2.3.0-alpha.1 → 3.0.0-alpha.2

package/dist/commands/portal/destroy.js

@@ -0,0 +1,104 @@
+/**
+ * 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 { 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 });
+async function ensureDestroyConfirmed(options) {
+    if (options.yes) {
+        return true;
+    }
+    if (!isInteractiveTerminal()) {
+        options.command.error(portalDestroyText('errors.confirmationRequired', undefined, 'Refusing to destroy a portal in non-interactive mode without --yes.'));
+    }
+    try {
+        return Boolean(await confirm({
+            message: portalDestroyText('prompts.confirm', { portal: options.portal }, `Destroy portal "${options.portal}" and delete its storage directory?`),
+            default: false,
+        }));
+    }
+    catch {
+        return false;
+    }
+}
+export default class PortalDestroy extends Command {
+    static summary = 'Destroy a portal record and local files';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> customer --yes',
+        '<%= config.bin %> <%= command.id %> customer --env dev --yes',
+        '<%= config.bin %> <%= command.id %> customer --force --yes',
+    ];
+    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: 'Skip confirmation prompts',
+            default: false,
+        }),
+        force: Flags.boolean({
+            description: 'Ignore missing portal records or local files',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PortalDestroy);
+        const requestedEnv = hasExplicitEnvSelection(this.argv) ? flags.env : undefined;
+        const crossEnvConfirmed = await ensureCrossEnvConfirmed({
+            command: this,
+            requestedEnv,
+            yes: flags.yes,
+        });
+        if (!crossEnvConfirmed) {
+            return;
+        }
+        const destroyConfirmed = await ensureDestroyConfirmed({
+            command: this,
+            portal: args.portal,
+            yes: flags.yes,
+        });
+        if (!destroyConfirmed) {
+            return;
+        }
+        const scope = resolveDefaultConfigScope();
+        const envName = requestedEnv ?? (await getCurrentEnvName({ scope }));
+        const env = await getEnv(envName, { scope });
+        if (!env) {
+            this.error(portalDestroyText(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 destroyPortalWorkspace({
+            portal: args.portal,
+            env,
+            envName,
+            cliVersion: String(this.config.pjson.version ?? '').trim(),
+            force: flags.force,
+        });
+        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})`));
+    }
+}

package/dist/commands/portal/dev.js

@@ -0,0 +1,71 @@
+/**
+ * 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 { devPortalWorkspace } from '../../lib/portal-dev.js';
+import { printInfo } from '../../lib/ui.js';
+const portalDevText = (key, values, fallback) => translateCli(`commands.portalDev.${key}`, values, { fallback });
+export default class PortalDev extends Command {
+    static summary = 'Start a portal in development mode';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> customer',
+        '<%= config.bin %> <%= command.id %> customer --env dev --yes',
+    ];
+    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,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PortalDev);
+        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(portalDevText(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.'));
+        }
+        await devPortalWorkspace({
+            portal: args.portal,
+            env,
+            onStart: (result) => {
+                printInfo(portalDevText('messages.starting', { portal: result.portal }, `Starting portal "${result.portal}"...`));
+                printInfo(portalDevText('messages.mode', { mode: result.mode }, `Mode: ${result.mode}`));
+                printInfo(portalDevText('messages.app', { app: result.app }, `App: ${result.app}`));
+                printInfo(portalDevText('messages.base', { base: result.portalBase }, `Base: ${result.portalBase}`));
+                printInfo(portalDevText('messages.dir', { dir: result.portalDir }, `Dir: ${result.portalDir}`));
+            },
+        });
+    }
+}

package/dist/commands/portal/index.js

@@ -0,0 +1,20 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, loadHelpClass } from '@oclif/core';
+export default class Portal extends Command {
+    static summary = 'Manage portals';
+    async run() {
+        await this.parse(Portal);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'portal',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/portal/info.js

@@ -0,0 +1,82 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { 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 { findPortalListItem, formatPortalInfo } from '../../lib/portal-info.js';
+import { listPortalWorkspaces, toPortalOutputItem } from '../../lib/portal-list.js';
+const portalInfoText = (key, values, fallback) => translateCli(`commands.portalInfo.${key}`, values, { fallback });
+export default class PortalInfo extends Command {
+    static summary = 'Show portal record and local file details';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> customer',
+        '<%= config.bin %> <%= command.id %> customer --env dev --yes',
+        '<%= config.bin %> <%= command.id %> customer --json',
+    ];
+    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,
+        }),
+        'json-output': Flags.boolean({
+            char: 'j',
+            aliases: ['json'],
+            description: 'Print portal details as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PortalInfo);
+        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(portalInfoText(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 portal = findPortalListItem(result.items, args.portal);
+        if (!portal) {
+            this.error(portalInfoText('errors.notFound', { portal: args.portal }, `Portal "${args.portal}" was not found.`));
+        }
+        const outputItem = toPortalOutputItem(portal);
+        if (flags['json-output']) {
+            this.log(JSON.stringify(outputItem, null, 2));
+            return;
+        }
+        this.log(formatPortalInfo(portal));
+    }
+}

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 local sync status';
+    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, 'Local path'),
+            portalListText('table.enabled', undefined, 'Enabled'),
+            portalListText('table.localSynced', undefined, 'Local synced'),
+        ], outputItems.map((item) => [
+            item.name,
+            item.url,
+            item.portalType,
+            item.sourceStorage,
+            item.localPath,
+            formatBoolean(item.enabled),
+            formatBoolean(item.localSynced),
+        ])));
+    }
+}

package/dist/commands/portal/pull.js

@@ -0,0 +1,84 @@
+/**
+ * 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 { pullPortalSource } from '../../lib/portal-source.js';
+import { printInfo, printSuccess } 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 --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,
+        }),
+        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);
+        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,
+        });
+        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}.`));
+    }
+}

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

@@ -199,6 +199,13 @@ async function createMultipartBody(flags, operation) {
         if (value === undefined) {
             continue;
         }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                formData.append(parameter.name, typeof item === 'object' ? JSON.stringify(item) : String(item));
+            }
+            hasValues = hasValues || value.length > 0;
+            continue;
+        }
         formData.append(parameter.name, typeof value === 'object' ? JSON.stringify(value) : String(value));
         hasValues = true;
     }

package/dist/lib/auth-store.js

@@ -97,6 +97,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 +118,12 @@ function normalizeAuthConfig(config) {
         name: config.name || config.dockerResourcePrefix,
         settings: {
             ...(locale ? { locale } : {}),
-            ...(defaultUiHost || defaultApiHost
+            ...(defaultUiHost || defaultApiHost || defaultPortalTemplate
                 ? {
                     init: {
                         ...(defaultUiHost ? { defaultUiHost } : {}),
                         ...(defaultApiHost ? { defaultApiHost } : {}),
+                        ...(defaultPortalTemplate ? { defaultPortalTemplate } : {}),
                     },
                 }
                 : {}),

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;

package/dist/lib/env-auth.js

@@ -32,12 +32,12 @@ function buildDeviceVerificationPathFromApiBaseUrl(apiBaseUrl) {
     const subappMatch = url.pathname.match(/^(.*)\/api\/__app\/([^/]+)\/?$/);
     if (subappMatch) {
         const publicPath = (subappMatch[1] || '').replace(/\/+$/, '');
-        return `${publicPath}/apps/${subappMatch[2]}/idpOAuth/device`;
+        return `${publicPath}/settings/apps/${subappMatch[2]}/idpOAuth/device`;
     }
     const appMatch = url.pathname.match(/^(.*)\/api\/?$/);
     if (appMatch) {
         const publicPath = (appMatch[1] || '').replace(/\/+$/, '');
-        return `${publicPath}/idpOAuth/device`;
+        return `${publicPath}/settings/idpOAuth/device`;
     }
     return undefined;
 }