@nocobase/cli 2.1.0-beta.34 → 2.1.0-beta.36

package/dist/commands/source/dev.js

@@ -8,8 +8,9 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
+import { ensureLocalPostinstall } from '../../lib/app-managed-resources.js';
 import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
-import { announceTargetEnv, printInfo } from '../../lib/ui.js';
+import { announceTargetEnv, failTask, printInfo, startTask, succeedTask } from '../../lib/ui.js';
 function formatUnsupportedRuntimeMessage(kind, envName) {
     if (kind === 'docker') {
         return [
@@ -159,6 +160,12 @@ export default class SourceDev extends Command {
         }
         printInfo(`Starting NocoBase dev mode for "${runtime.envName}" from ${runtime.projectRoot}. Press Ctrl+C to stop.`);
         try {
+            await ensureLocalPostinstall(runtime, {
+                onStartTask: startTask,
+                onSucceedTask: succeedTask,
+                onFailTask: failTask,
+                verbose: true,
+            });
             await runLocalNocoBaseCommand(runtime, npmArgs, {
                 stdio: 'inherit',
             });

package/dist/commands/source/publish.js

@@ -0,0 +1,109 @@
+/**
+ * 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 { buildSuggestedInitCommand, publishSourceSnapshot } from '../../lib/source-publish.js';
+import { failTask, printInfo, startTask, succeedTask } from '../../lib/ui.js';
+function formatPublishFailure(message) {
+    if (message.includes('The specified --cwd does not exist:')
+        || message.includes('The specified --cwd is not a directory:')
+        || message.includes('Couldn\'t find a NocoBase source project from --cwd:')) {
+        return message;
+    }
+    return [
+        'Couldn\'t publish a source snapshot.',
+        'Check that Docker is running, the target npm registry is reachable, and the current directory is a NocoBase source repo.',
+        `Details: ${message}`,
+    ].join('\n');
+}
+export default class SourcePublish extends Command {
+    static description = 'Publish the current NocoBase source repo as a snapshot version to an npm registry for install testing.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --snapshot',
+        '<%= config.bin %> <%= command.id %> --snapshot --no-build',
+        '<%= config.bin %> <%= command.id %> --snapshot --build-dts',
+        '<%= config.bin %> <%= command.id %> --snapshot --cwd /path/to/nocobase/source',
+        '<%= config.bin %> <%= command.id %> --snapshot --npm-registry=http://127.0.0.1:4873',
+        '<%= config.bin %> <%= command.id %> --snapshot --json',
+    ];
+    static flags = {
+        snapshot: Flags.boolean({
+            description: 'Publish the current source repo as a unique snapshot version',
+            required: true,
+            default: false,
+        }),
+        'npm-registry': Flags.string({
+            description: 'npm registry URL to publish to. Defaults to the running local source registry when available',
+            required: false,
+        }),
+        cwd: Flags.string({
+            description: 'Source repository path. Defaults to the nearest detected NocoBase source root from the current working directory',
+            required: false,
+        }),
+        'no-build': Flags.boolean({
+            description: 'Skip building the source repo before snapshot versioning and publish',
+            default: false,
+        }),
+        'build-dts': Flags.boolean({
+            description: 'Generate TypeScript declaration files during the source build',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Print the publish result as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            description: 'Show detailed command output while versioning and publishing the snapshot',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SourcePublish);
+        if (!flags.snapshot) {
+            this.error('`nb source publish` currently requires `--snapshot`.');
+        }
+        if (!flags.json) {
+            startTask('Publishing a source snapshot...');
+        }
+        try {
+            const result = await publishSourceSnapshot({
+                cwd: flags.cwd,
+                npmRegistry: flags['npm-registry'],
+                build: !flags['no-build'],
+                buildDts: flags['build-dts'],
+                verbose: flags.verbose,
+            });
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    version: result.version,
+                    npmRegistry: result.npmRegistry,
+                    gitSha: result.gitSha,
+                    projectRoot: result.projectRoot,
+                    suggestedInitCommand: buildSuggestedInitCommand(result),
+                }, null, 2));
+                return;
+            }
+            succeedTask(`Published source snapshot ${result.version} to ${result.npmRegistry}.`);
+            printInfo(`Source root: ${result.projectRoot}`);
+            printInfo(`Snapshot version: ${result.version}`);
+            printInfo(`npm registry: ${result.npmRegistry}`);
+            printInfo(`Next: ${buildSuggestedInitCommand(result)}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (flags.json) {
+                this.logToStderr(JSON.stringify({
+                    error: formatPublishFailure(message),
+                }, null, 2));
+                this.exit(1);
+            }
+            failTask('Failed to publish the source snapshot.');
+            this.error(formatPublishFailure(message));
+        }
+    }
+}

package/dist/commands/source/registry/logs.js

@@ -0,0 +1,70 @@
+/**
+ * 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 { run } from '../../../lib/run-npm.js';
+import { printInfo } from '../../../lib/ui.js';
+import { getSourceRegistryInfo } from '../../../lib/source-registry.js';
+function formatLogsFailure(message) {
+    if (/does not exist/i.test(message)) {
+        return [
+            'Can\'t show source registry logs yet.',
+            'The saved source registry container could not be found on this machine.',
+            'Start the registry first with `nb source registry start`.',
+            `Details: ${message}`,
+        ].join('\n');
+    }
+    return [
+        'Couldn\'t show source registry logs.',
+        'Check that Docker is installed and the source registry container still exists, then try again.',
+        `Details: ${message}`,
+    ].join('\n');
+}
+export default class SourceRegistryLogs extends Command {
+    static description = 'Show logs for the local Docker-based npm registry used for source tests.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --tail 200',
+        '<%= config.bin %> <%= command.id %> --follow',
+    ];
+    static flags = {
+        tail: Flags.integer({
+            description: 'Number of recent log lines to show before following',
+            default: 100,
+            min: 0,
+        }),
+        follow: Flags.boolean({
+            char: 'f',
+            description: 'Keep streaming new log lines',
+            default: false,
+            allowNo: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SourceRegistryLogs);
+        const info = getSourceRegistryInfo();
+        printInfo(flags.follow
+            ? `Showing source registry logs from "${info.containerName}" (press Ctrl+C to stop).`
+            : `Showing recent source registry logs from "${info.containerName}".`);
+        const dockerArgs = ['logs', '--tail', String(flags.tail ?? 100)];
+        if (flags.follow) {
+            dockerArgs.push('--follow');
+        }
+        dockerArgs.push(info.containerName);
+        try {
+            await run('docker', dockerArgs, {
+                errorName: 'docker logs',
+                stdio: 'inherit',
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(formatLogsFailure(message));
+        }
+    }
+}

package/dist/commands/source/registry/start.js

@@ -0,0 +1,57 @@
+/**
+ * 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 { failTask, startTask, succeedTask } from '../../../lib/ui.js';
+import { getSourceRegistryInfo, startSourceRegistry } from '../../../lib/source-registry.js';
+function formatStartFailure(message) {
+    if (/port is already allocated|address already in use/i.test(message)) {
+        return [
+            'Can\'t start the source registry.',
+            'Port 4873 is already in use on this machine.',
+            'Stop the conflicting process, or free the port before trying again.',
+            `Details: ${message}`,
+        ].join('\n');
+    }
+    return [
+        'Couldn\'t start the source registry.',
+        'Check that Docker is installed and running, then try again.',
+        `Details: ${message}`,
+    ].join('\n');
+}
+export default class SourceRegistryStart extends Command {
+    static description = 'Start the local Docker-based npm registry used for source snapshot publish and install tests.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --verbose',
+    ];
+    static flags = {
+        verbose: Flags.boolean({
+            description: 'Show raw Docker output while starting the registry container',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SourceRegistryStart);
+        const info = getSourceRegistryInfo();
+        startTask(`Starting the source registry at ${info.url}...`);
+        try {
+            const state = await startSourceRegistry({
+                stdio: flags.verbose ? 'inherit' : 'ignore',
+            });
+            succeedTask(state === 'already-running'
+                ? `The source registry is already running at ${info.url}.`
+                : `The source registry is running at ${info.url}.`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            failTask('Failed to start the source registry.');
+            this.error(formatStartFailure(message));
+        }
+    }
+}

package/dist/commands/source/registry/status.js

@@ -0,0 +1,33 @@
+/**
+ * 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 { renderTable } from '../../../lib/ui.js';
+import { resolveSourceRegistryInfo } from '../../../lib/source-registry.js';
+export default class SourceRegistryStatus extends Command {
+    static description = 'Show the status of the local Docker-based npm registry used for source tests.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            description: 'Print the source registry status as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SourceRegistryStatus);
+        const info = await resolveSourceRegistryInfo();
+        if (flags.json) {
+            this.log(JSON.stringify(info, null, 2));
+            return;
+        }
+        this.log(renderTable(['Container', 'Status', 'URL', 'Storage'], [[info.containerName, info.status, info.url, info.storageDir]]));
+    }
+}

package/dist/commands/source/registry/stop.js

@@ -0,0 +1,48 @@
+/**
+ * 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 { failTask, startTask, succeedTask } from '../../../lib/ui.js';
+import { stopSourceRegistry } from '../../../lib/source-registry.js';
+function formatStopFailure(message) {
+    return [
+        'Couldn\'t stop the source registry.',
+        'Check that Docker is installed and the saved registry container still exists, then try again.',
+        `Details: ${message}`,
+    ].join('\n');
+}
+export default class SourceRegistryStop extends Command {
+    static description = 'Stop the local Docker-based npm registry used for source snapshot tests.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --verbose',
+    ];
+    static flags = {
+        verbose: Flags.boolean({
+            description: 'Show raw Docker output while stopping the registry container',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SourceRegistryStop);
+        startTask('Stopping the source registry...');
+        try {
+            const state = await stopSourceRegistry({
+                stdio: flags.verbose ? 'inherit' : 'ignore',
+            });
+            succeedTask(state === 'already-stopped'
+                ? 'The source registry is already stopped.'
+                : 'The source registry has stopped.');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            failTask('Failed to stop the source registry.');
+            this.error(formatStopFailure(message));
+        }
+    }
+}

package/dist/commands/v1.js

@@ -0,0 +1,210 @@
+/**
+ * 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 } from '@oclif/core';
+import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runDockerNocoBaseCommand, runLocalNocoBaseCommand, } from '../lib/app-runtime.js';
+import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../lib/env-guard.js';
+import { announceTargetEnv } from '../lib/ui.js';
+const SILENT_LIKE_PASSTHROUGH_FLAGS = new Set(['--help', '-h', '--silent']);
+const SILENT_RUNTIME_ENV_VARS = {
+    LOGGER_SILENT: 'true',
+    NODE_NO_WARNINGS: '1',
+};
+const SILENT_STDERR_FILTERS = [
+    /^\(node:\d+\) \[DEP0040\] DeprecationWarning: The `punycode` module is deprecated\..*$/,
+    /^\(Use `node --trace-deprecation .*$/,
+    /^About to overwrite ArrayBuffer\.prototype properties /,
+];
+function parseBridgeArgv(argv) {
+    let requestedEnv;
+    let yes = false;
+    const passthroughArgs = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === '--') {
+            passthroughArgs.push(...argv.slice(index + 1));
+            break;
+        }
+        if (token === '--env') {
+            const value = argv[index + 1];
+            if (!value || value === '--') {
+                throw new Error('Missing value for `--env`.');
+            }
+            requestedEnv = value.trim() || undefined;
+            index += 1;
+            continue;
+        }
+        if (token.startsWith('--env=')) {
+            requestedEnv = token.slice('--env='.length).trim() || undefined;
+            continue;
+        }
+        if (token === '-e') {
+            const value = argv[index + 1];
+            if (!value || value === '--') {
+                throw new Error('Missing value for `-e`.');
+            }
+            requestedEnv = value.trim() || undefined;
+            index += 1;
+            continue;
+        }
+        if (token.startsWith('-e') && token.length > 2) {
+            requestedEnv = token.slice(2).trim() || undefined;
+            continue;
+        }
+        if (token === '--yes') {
+            yes = true;
+            continue;
+        }
+        passthroughArgs.push(...argv.slice(index));
+        break;
+    }
+    return {
+        requestedEnv,
+        yes,
+        passthroughArgs,
+    };
+}
+function formatHttpEnvError(envName) {
+    return [
+        `Can't run \`nb v1\` for "${envName}" yet.`,
+        'This env only has an API connection, so the v1 bridge is not available here.',
+        'Use a local or Docker env instead.',
+    ].join('\n');
+}
+function formatSshEnvError(envName) {
+    return [
+        `Can't run \`nb v1\` for "${envName}" yet.`,
+        'SSH env support is reserved but not implemented yet.',
+        'Use a local or Docker env right now.',
+    ].join('\n');
+}
+function hasSilentLikePassthrough(args) {
+    return args.some((arg) => SILENT_LIKE_PASSTHROUGH_FLAGS.has(arg));
+}
+function shouldFilterSilentStderrLine(line) {
+    const normalized = line.replace(/\r$/, '');
+    return SILENT_STDERR_FILTERS.some((pattern) => pattern.test(normalized));
+}
+function createSilentBridgeOptions() {
+    let pendingStderr = '';
+    const flushBufferedStderr = (force) => {
+        while (true) {
+            const newlineIndex = pendingStderr.indexOf('\n');
+            if (newlineIndex === -1) {
+                break;
+            }
+            const line = pendingStderr.slice(0, newlineIndex);
+            pendingStderr = pendingStderr.slice(newlineIndex + 1);
+            if (!shouldFilterSilentStderrLine(line)) {
+                process.stderr.write(`${line}\n`);
+            }
+        }
+        if (force && pendingStderr) {
+            if (!shouldFilterSilentStderrLine(pendingStderr)) {
+                process.stderr.write(pendingStderr);
+            }
+            pendingStderr = '';
+        }
+    };
+    return {
+        commandOptions: {
+            stdio: 'pipe',
+            env: {
+                ...SILENT_RUNTIME_ENV_VARS,
+            },
+            onStdout: (chunk) => {
+                process.stdout.write(chunk);
+            },
+            onStderr: (chunk) => {
+                pendingStderr += chunk;
+                flushBufferedStderr(false);
+            },
+        },
+        flush: () => {
+            flushBufferedStderr(true);
+        },
+    };
+}
+export default class V1 extends Command {
+    static hidden = true;
+    static strict = false;
+    static summary = 'Forward commands to the selected env through the v1 bridge';
+    static description = 'Forward v1-compatible commands to the selected env. Defaults to the current env when `--env` is omitted. Local envs run `nocobase-v1`, and Docker envs run inside the saved app container. Bridge flags (`--env`, `--yes`) must appear before the forwarded command. Use `--` when the forwarded command needs the same flag names.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> build',
+        '<%= config.bin %> <%= command.id %> --env local pm list',
+        '<%= config.bin %> <%= command.id %> --env docker-local -- pm enable @nocobase/plugin-sample --yes',
+    ];
+    async run() {
+        const originalArgv = [...this.argv];
+        await this.parse({ strict: false, flags: {}, args: {} }, []);
+        this.argv = originalArgv;
+        let parsed;
+        try {
+            parsed = parseBridgeArgv(this.argv);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(message);
+        }
+        const { requestedEnv, yes, passthroughArgs } = parsed;
+        if (passthroughArgs.length === 0) {
+            this.error('Pass at least one v1 command to forward.');
+        }
+        const explicitEnvSelection = Boolean(requestedEnv && hasExplicitEnvSelection(this.argv));
+        if (explicitEnvSelection) {
+            const confirmed = await ensureCrossEnvConfirmed({
+                command: this,
+                requestedEnv,
+                yes,
+            });
+            if (!confirmed) {
+                return;
+            }
+        }
+        const runtime = await resolveManagedAppRuntime(requestedEnv);
+        if (!runtime) {
+            this.error(formatMissingManagedAppEnvMessage(requestedEnv));
+        }
+        const silentLike = hasSilentLikePassthrough(passthroughArgs);
+        const silentBridge = silentLike ? createSilentBridgeOptions() : undefined;
+        if (!silentLike) {
+            announceTargetEnv(runtime.envName);
+        }
+        if (runtime.kind === 'local') {
+            try {
+                await runLocalNocoBaseCommand(runtime, passthroughArgs, silentBridge?.commandOptions);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.error(message);
+            }
+            finally {
+                silentBridge?.flush();
+            }
+            return;
+        }
+        if (runtime.kind === 'docker') {
+            try {
+                await runDockerNocoBaseCommand(runtime.containerName, passthroughArgs, silentBridge?.commandOptions);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.error(message);
+            }
+            finally {
+                silentBridge?.flush();
+            }
+            return;
+        }
+        if (runtime.kind === 'http') {
+            this.error(formatHttpEnvError(runtime.envName));
+        }
+        this.error(formatSshEnvError(runtime.envName));
+    }
+}

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

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { mkdir, readdir } from 'node:fs/promises';
-import { dockerContainerExists, startDockerContainer } from './app-runtime.js';
+import { dockerContainerExists, runLocalNocoBaseCommand, startDockerContainer } from './app-runtime.js';
 import { deriveBuiltinDbConnection, resolveBuiltinDbConnection } from './builtin-db.js';
 import { resolveConfiguredEnvPath } from './cli-home.js';
 import { resolveDockerEnvFileArg } from "./docker-env-file.js";
@@ -32,6 +32,18 @@ function localSourceLabel(source) {
 function trimValue(value) {
     return String(value ?? '').trim();
 }
+function pushOptionalEnvArg(args, key, value) {
+    if (typeof value === 'string') {
+        if (!value) {
+            return;
+        }
+        args.push('-e', `${key}=${value}`);
+        return;
+    }
+    if (typeof value === 'boolean') {
+        args.push('-e', `${key}=${String(value)}`);
+    }
+}
 function normalizeDockerPlatform(value) {
     const text = trimValue(value);
     if (!text || text === 'auto') {
@@ -58,6 +70,14 @@ function formatLocalSourceRestoreFailure(envName, source, message) {
         `Details: ${message}`,
     ].join('\n');
 }
+function formatLocalPostinstallFailure(envName, message) {
+    return [
+        `Couldn't prepare NocoBase for "${envName}".`,
+        'The CLI was not able to run `nocobase-v1 postinstall` before starting the local app.',
+        'Check the local dependencies, storage path, and saved env settings, then try again.',
+        `Details: ${message}`,
+    ].join('\n');
+}
 function formatSavedDockerSettingsIncomplete(envName, missing) {
     return [
         `Can't start NocoBase for "${envName}" yet.`,
@@ -101,6 +121,9 @@ export async function buildSavedDockerRunArgs(runtime) {
     const dbDatabase = trimValue(config.dbDatabase);
     const dbUser = trimValue(config.dbUser);
     const dbPassword = trimValue(config.dbPassword);
+    const dbSchema = trimValue(config.dbSchema);
+    const dbTablePrefix = trimValue(config.dbTablePrefix);
+    const dbUnderscored = typeof config.dbUnderscored === 'boolean' ? config.dbUnderscored : undefined;
     const dockerRegistry = trimValue(config.dockerRegistry) || DEFAULT_DOCKER_REGISTRY;
     const version = trimValue(config.downloadVersion) || DEFAULT_DOCKER_VERSION;
     const imageRef = resolveDockerImageRef(dockerRegistry, version, {
@@ -155,7 +178,11 @@ export async function buildSavedDockerRunArgs(runtime) {
     if (envFile) {
         args.push('--env-file', envFile);
     }
-    args.push('-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}`, imageRef);
+    args.push('-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, 'DB_SCHEMA', dbSchema || undefined);
+    pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix || undefined);
+    pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);
+    args.push(imageRef);
     return {
         appPort: appPort || undefined,
         storagePath,
@@ -274,3 +301,16 @@ export async function ensureSavedLocalSource(runtime, runCommand, options) {
         throw new Error(formatLocalSourceRestoreFailure(runtime.envName, runtime.source, error instanceof Error ? error.message : String(error)));
     }
 }
+export async function ensureLocalPostinstall(runtime, options) {
+    options?.onStartTask?.(`Running local postinstall for "${runtime.envName}"...`);
+    try {
+        await runLocalNocoBaseCommand(runtime, ['postinstall'], {
+            stdio: commandStdio(options?.verbose),
+        });
+        options?.onSucceedTask?.(`Local postinstall finished for "${runtime.envName}".`);
+    }
+    catch (error) {
+        options?.onFailTask?.(`Failed to run local postinstall for "${runtime.envName}".`);
+        throw new Error(formatLocalPostinstallFailure(runtime.envName, error instanceof Error ? error.message : String(error)));
+    }
+}

package/dist/lib/app-runtime.js

@@ -119,8 +119,13 @@ export async function runLocalNocoBaseCommand(runtime, args, options) {
     const envVars = await buildRuntimeEnvVars(runtime);
     await runNocoBaseCommand(args, {
         cwd: runtime.projectRoot,
-        env: envVars,
+        env: {
+            ...envVars,
+            ...options?.env,
+        },
         stdio: options?.stdio,
+        onStdout: options?.onStdout,
+        onStderr: options?.onStderr,
     });
 }
 export async function dockerContainerExists(containerName) {
@@ -163,9 +168,13 @@ export async function stopDockerContainer(containerName, options) {
     });
     return 'stopped';
 }
-export async function runDockerNocoBaseCommand(containerName, args) {
-    await startDockerContainer(containerName);
-    await run('docker', ['exec', '-w', DOCKER_APP_WORKDIR, containerName, 'yarn', 'nocobase', ...args], {
+export async function runDockerNocoBaseCommand(containerName, args, options) {
+    await startDockerContainer(containerName, { stdio: options?.stdio });
+    const dockerEnvArgs = Object.entries(options?.env ?? {}).flatMap(([key, value]) => ['-e', `${key}=${value}`]);
+    await run('docker', ['exec', ...dockerEnvArgs, '-w', DOCKER_APP_WORKDIR, containerName, 'yarn', 'nocobase', ...args], {
         errorName: 'docker exec',
+        stdio: options?.stdio,
+        onStdout: options?.onStdout,
+        onStderr: options?.onStderr,
     });
 }