@nocobase/app-server 0.11.1-alpha.5 → 2.0.0-beta.2

package/dist/database/migrator.d.ts

@@ -0,0 +1,88 @@
+import type { ServiceResolver } from '@nocobase/service-provider';
+import type { DatabaseTaskConfig } from '@nocobase/db';
+import { type ChecksumMismatch, type DatabaseManager, type MigrationRepairOptions, type MigrationHistoryRecord, type MigrationSource, type MigrationRollbackOptions, type StaleTaskLockTakeover, type TaskLockReleaseOptions, type TaskLockReleaseResult } from '@nocobase/db';
+import type { AppDatabaseMigrationConfig } from './types.js';
+export interface AppMigrator {
+    latest(): Promise<AppMigrationRunResult>;
+    fresh(): Promise<AppMigrationRunResult>;
+    /** What `latest()`, or `fresh()` with `fresh` set, would execute. Reads only. */
+    pending(options?: AppPendingTasksOptions): Promise<AppPendingTasksResult>;
+    rollback(options?: MigrationRollbackOptions): Promise<AppMigrationRollbackResult>;
+    repair(options?: MigrationRepairOptions): Promise<AppMigrationRepairResult>;
+    unlock(options?: TaskLockReleaseOptions): Promise<AppTaskLockReleaseResult>;
+    /** The migration history, without creating its table. */
+    history(): Promise<MigrationHistoryRecord[]>;
+}
+export interface AppPendingTasksOptions {
+    /** Plan a fresh run: the schema is emptied first, so every task is pending. */
+    readonly fresh?: boolean;
+    /**
+     * The database does not exist yet, so nothing has run and every task is
+     * pending. No connection is opened to find out, because opening one to
+     * missing storage creates it.
+     */
+    readonly withoutHistory?: boolean;
+}
+/**
+ * What a run would execute, read without running anything, taking the lock or
+ * writing history. It is a plan rather than a promise: a migration whose
+ * `shouldRun()` would decline is still listed, because that is evaluated under
+ * the lock against the database as the run finds it, and history the sources
+ * cannot explain is reported by the run rather than here.
+ */
+export interface AppPendingTasksResult {
+    status: 'completed' | 'skipped';
+    reason?: 'missing-directory';
+    /** Tasks with no history record, in the order a run would execute them. */
+    pending?: string[];
+    /** Tasks already recorded, which a run would skip. */
+    skipped?: string[];
+    dryRun?: true;
+}
+/** A lock release, or the reason it was left alone. */
+export interface AppTaskLockReleaseResult extends TaskLockReleaseResult {
+    status: 'completed';
+}
+export type AppMigrationSkippedReason = 'missing-directory';
+export interface AppMigrationRunResult {
+    status: 'completed' | 'skipped';
+    reason?: AppMigrationSkippedReason;
+    batch?: number;
+    executed?: string[];
+    skipped?: string[];
+    warnings?: ChecksumMismatch[];
+}
+export interface AppMigrationRollbackResult {
+    status: 'completed' | 'skipped';
+    reason?: AppMigrationSkippedReason;
+    batch?: number;
+    rolledBack?: string[];
+    /** The batch's history records, in the order they roll back. */
+    records?: MigrationHistoryRecord[];
+    warnings?: ChecksumMismatch[];
+    dryRun?: boolean;
+}
+export interface AppMigrationRepairResult {
+    status: 'completed' | 'skipped';
+    reason?: AppMigrationSkippedReason;
+    repaired?: ChecksumMismatch[];
+    dryRun?: boolean;
+}
+export interface CreateAppMigratorOptions {
+    runtimeConfig?: DatabaseTaskConfig;
+    container?: ServiceResolver;
+    database: DatabaseManager;
+    config: AppDatabaseMigrationConfig;
+    connection?: string;
+    sources?: readonly MigrationSource[];
+    /** Reported when a lock whose holder stopped beating is taken over. */
+    onStaleLock?: (takeover: StaleTaskLockTakeover) => void;
+}
+export declare function createAppMigrator(options: CreateAppMigratorOptions): AppMigrator;
+/** Splits loaded tasks into those a run would execute and those it would skip. */
+export declare function pendingTasksResult(tasks: readonly {
+    readonly name: string;
+}[], history: readonly {
+    readonly name: string;
+}[]): AppPendingTasksResult;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/database/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../src/database/migrator.ts"],"names":[],"mappings":"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"}

package/dist/database/migrator.js

@@ -0,0 +1,143 @@
+import { createTaskServiceResolver } from './task-container.js';
+import { snapshotDatabaseTaskConfig } from './task-config.js';
+import { existsSync } from 'node:fs';
+import { createMigrator, loadMigrations, } from '@nocobase/db';
+export function createAppMigrator(options) {
+    return {
+        async latest() {
+            if (!hasMigrationDirectory(options)) {
+                return skippedMigrationResult();
+            }
+            return completedRunResult(await createDatabaseMigrator(options).latest());
+        },
+        async fresh() {
+            const connection = options.database.connection(options.connection);
+            await connection.resetManagedSchema();
+            if (!hasMigrationDirectory(options)) {
+                return {
+                    status: 'completed',
+                    batch: 0,
+                    executed: [],
+                    skipped: [],
+                };
+            }
+            return completedRunResult(await createDatabaseMigrator(options).latest());
+        },
+        async pending(pendingOptions = {}) {
+            if (!hasMigrationDirectory(options)) {
+                // `fresh()` empties the schema whether or not there is anything to
+                // apply afterwards, so a fresh plan still has something to do.
+                return pendingOptions.fresh
+                    ? { status: 'completed', pending: [], skipped: [], dryRun: true }
+                    : { status: 'skipped', reason: 'missing-directory' };
+            }
+            const migrations = await loadMigrations(createDatabaseMigratorOptions(options));
+            return pendingTasksResult(migrations, pendingOptions.fresh || pendingOptions.withoutHistory
+                ? []
+                : await createDatabaseMigrator(options).history());
+        },
+        async history() {
+            return createDatabaseMigrator(options).history();
+        },
+        async rollback(rollbackOptions) {
+            if (!hasMigrationDirectory(options)) {
+                return skippedMigrationResult();
+            }
+            return completedRollbackResult(await createDatabaseMigrator(options).rollback(rollbackOptions));
+        },
+        // Unlocking needs no migration directory: the lock exists whether or not
+        // this application owns migrations, because plugins and startup share it.
+        async unlock(releaseOptions) {
+            return {
+                status: 'completed',
+                ...(await createDatabaseMigrator(options).unlock(releaseOptions)),
+            };
+        },
+        async repair(repairOptions) {
+            if (!hasMigrationDirectory(options)) {
+                return skippedMigrationResult();
+            }
+            return completedRepairResult(await createDatabaseMigrator(options).repair(repairOptions));
+        },
+    };
+}
+function createDatabaseMigrator(options) {
+    return createMigrator(createDatabaseMigratorOptions(options));
+}
+function createDatabaseMigratorOptions(options) {
+    const common = {
+        config: snapshotDatabaseTaskConfig(options.runtimeConfig),
+        container: createTaskServiceResolver(options.container),
+        database: options.database,
+        connection: options.connection,
+        tableName: options.config.tableName,
+        lockTableName: options.config.lockTableName,
+        extensions: options.config.extensions,
+        onChecksumMismatch: options.config.onChecksumMismatch,
+        onStaleLock: options.onStaleLock,
+    };
+    if (options.sources) {
+        return {
+            ...common,
+            sources: options.sources,
+        };
+    }
+    return {
+        ...common,
+        directory: options.config.directory,
+        packageName: options.config.packageName,
+    };
+}
+function hasMigrationDirectory(options) {
+    if (options.sources) {
+        return options.sources.some((source) => existsSync(source.directory));
+    }
+    return existsSync(options.config.directory);
+}
+function skippedMigrationResult() {
+    return {
+        status: 'skipped',
+        reason: 'missing-directory',
+    };
+}
+/** Splits loaded tasks into those a run would execute and those it would skip. */
+export function pendingTasksResult(tasks, history) {
+    const executed = new Set(history.map((record) => record.name));
+    return {
+        status: 'completed',
+        pending: tasks
+            .filter((task) => !executed.has(task.name))
+            .map((task) => task.name),
+        skipped: tasks
+            .filter((task) => executed.has(task.name))
+            .map((task) => task.name),
+        dryRun: true,
+    };
+}
+function completedRunResult(result) {
+    return {
+        status: 'completed',
+        batch: result.batch,
+        executed: result.executed,
+        skipped: result.skipped,
+        warnings: result.warnings,
+    };
+}
+function completedRollbackResult(result) {
+    return {
+        status: 'completed',
+        batch: result.batch,
+        rolledBack: result.rolledBack,
+        records: result.records,
+        warnings: result.warnings,
+        dryRun: result.dryRun,
+    };
+}
+function completedRepairResult(result) {
+    return {
+        status: 'completed',
+        repaired: result.repaired,
+        dryRun: result.dryRun,
+    };
+}
+//# sourceMappingURL=migrator.js.map

package/dist/database/migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.js","sourceRoot":"","sources":["../../src/database/migrator.ts"],"names":[],"mappings":"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"}

package/dist/database/ownership.d.ts

@@ -0,0 +1,6 @@
+import type { AppPaths } from '../config/index.js';
+import type { AppDatabaseConfig } from './types.js';
+import { type DatabaseDriverRegistration } from '@nocobase/db';
+/** Catch identical configured targets. Network aliases still require operator validation. */
+export declare function validateDatabaseOwnership(config: AppDatabaseConfig, paths?: AppPaths, drivers?: Record<string, DatabaseDriverRegistration>): void;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/database/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../src/database/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,cAAc,CAAC;AAEtB,6FAA6F;AAC7F,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,KAAK,CAAC,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,GACnD,IAAI,CA6BN"}

package/dist/database/ownership.js

@@ -0,0 +1,50 @@
+import { resolveConnections } from './manager.js';
+import { resolveDatabaseDriver, } from '@nocobase/db';
+/** Catch identical configured targets. Network aliases still require operator validation. */
+export function validateDatabaseOwnership(config, paths, drivers) {
+    const owners = new Map();
+    for (const [name, connection] of Object.entries(resolveConnections(config.connections, paths, {
+        ...config.drivers,
+        ...drivers,
+    }))) {
+        if (connection.schemaManagement === 'external')
+            continue;
+        const driver = resolveDatabaseDriver(connection, { ...config.drivers, ...drivers }, name);
+        const target = driver?.resolveOwnershipTarget
+            ? driver.resolveOwnershipTarget(connection)
+            : genericOwnershipTarget(connection);
+        if (!target)
+            continue;
+        const key = JSON.stringify(target);
+        const owner = owners.get(key);
+        if (owner) {
+            throw new Error(`Managed database connections "${owner}" and "${name}" target the same database and schema. Use one managed connection per target; aliases must not own separate migration histories.`);
+        }
+        owners.set(key, name);
+    }
+}
+function genericOwnershipTarget(connection) {
+    const ignored = new Set([
+        'capabilities',
+        'databaseDriver',
+        'debug',
+        'driverOptions',
+        'metadataStore',
+        'naming',
+        'onCollectionMetadataInvalidationError',
+        'onRepositoryEventError',
+        'onTransactionCallbackError',
+        'password',
+        'pool',
+        'repositoryEventMaxDepth',
+        'schemaManagement',
+        'ssl',
+    ]);
+    return [
+        connection.dialect,
+        ...Object.entries(connection)
+            .filter(([key, value]) => !ignored.has(key) && value !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right)),
+    ];
+}
+//# sourceMappingURL=ownership.js.map

package/dist/database/ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.js","sourceRoot":"","sources":["../../src/database/ownership.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AAEtB,6FAA6F;AAC7F,MAAM,UAAU,yBAAyB,CACvC,MAAyB,EACzB,KAAgB,EAChB,OAAoD;IAEpD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAC7C,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE;QAC5C,GAAG,MAAM,CAAC,OAAO;QACjB,GAAG,OAAO;KACX,CAAC,CACH,EAAE,CAAC;QACF,IAAI,UAAU,CAAC,gBAAgB,KAAK,UAAU;YAAE,SAAS;QACzD,MAAM,MAAM,GAAG,qBAAqB,CAClC,UAAU,EACV,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,EACjC,IAAI,CACL,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,EAAE,sBAAsB;YAC3C,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,UAAU,CAAC;YAC3C,CAAC,CAAC,sBAAsB,CACpB,UAAgD,CACjD,CAAC;QACN,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,UAAU,IAAI,kIAAkI,CACvL,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,UAAmC;IAEnC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;QACtB,cAAc;QACd,gBAAgB;QAChB,OAAO;QACP,eAAe;QACf,eAAe;QACf,QAAQ;QACR,uCAAuC;QACvC,wBAAwB;QACxB,4BAA4B;QAC5B,UAAU;QACV,MAAM;QACN,yBAAyB;QACzB,kBAAkB;QAClB,KAAK;KACN,CAAC,CAAC;IACH,OAAO;QACL,UAAU,CAAC,OAAO;QAClB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,CAAC;aAClE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/dist/database/plan.d.ts

@@ -0,0 +1,36 @@
+import type { AppPaths } from '../config/index.js';
+import type { DatabaseDriverRegistration, MigrationSource } from '@nocobase/db';
+import type { AppDatabaseConfig, AppDatabaseMigrationConfig, AppDatabaseTaskContributions } from './types.js';
+export type AppDatabaseTaskKind = 'migrations' | 'seeds';
+export interface AppDatabaseTaskSelection {
+    connection?: string;
+    all?: boolean;
+    autoRun?: boolean;
+    fresh?: boolean;
+    confirmFresh?: (plan: readonly AppDatabaseTask[]) => Promise<boolean>;
+}
+/**
+ * Everything planning needs beyond the configuration itself. `contributions` is
+ * required so that a caller which has not been updated fails to compile rather
+ * than silently planning without its plugins' migrations.
+ */
+export interface AppDatabaseTaskPlanOptions extends AppDatabaseTaskSelection {
+    readonly migrationSources?: readonly AppDatabaseMigrationSource[];
+    readonly contributions: AppDatabaseTaskContributions;
+    readonly paths?: AppPaths;
+    readonly drivers?: Record<string, DatabaseDriverRegistration>;
+}
+export interface AppDatabaseMigrationSource {
+    readonly connection: string;
+    readonly source: MigrationSource;
+}
+export interface AppDatabaseTask {
+    connection: string;
+    kind: AppDatabaseTaskKind;
+    config: AppDatabaseMigrationConfig;
+    skipReason?: 'external' | 'auto-run-disabled';
+}
+export declare function defaultConnectionName(config: AppDatabaseConfig): string | undefined;
+/** Resolve the entire plan before any database is opened or modified. */
+export declare function planAppDatabaseTasks(config: AppDatabaseConfig, kinds: readonly AppDatabaseTaskKind[], planOptions: AppDatabaseTaskPlanOptions): AppDatabaseTask[];
+//# sourceMappingURL=plan.d.ts.map

package/dist/database/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/database/plan.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,wBAAwB;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAClE,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,0BAA0B,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,GAAG,mBAAmB,CAAC;CAC/C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,GACxB,MAAM,GAAG,SAAS,CAEpB;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,WAAW,EAAE,0BAA0B,GACtC,eAAe,EAAE,CAqJnB"}

package/dist/database/plan.js

@@ -0,0 +1,136 @@
+import { existsSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { validateDatabaseOwnership } from './ownership.js';
+export function defaultConnectionName(config) {
+    return config.default ?? Object.keys(config.connections)[0];
+}
+/** Resolve the entire plan before any database is opened or modified. */
+export function planAppDatabaseTasks(config, kinds, planOptions) {
+    const { contributions, paths, drivers } = planOptions;
+    const selection = planOptions;
+    if (selection.connection !== undefined && selection.all) {
+        throw new Error('--connection and --all are mutually exclusive.');
+    }
+    const primary = defaultConnectionName(config);
+    const migrationTargets = kinds.includes('migrations')
+        ? (planOptions.migrationSources ?? [])
+        : [];
+    for (const target of migrationTargets) {
+        if (!Object.hasOwn(config.connections, target.connection)) {
+            throw new Error(`Unknown migration target database connection "${target.connection}".`);
+        }
+    }
+    if (primary === 'none' || !primary) {
+        if (selection.connection !== undefined)
+            throw new Error('Database is not configured.');
+        return [];
+    }
+    if (!Object.hasOwn(config.connections, primary)) {
+        throw new Error(`Unknown default database connection "${primary}".`);
+    }
+    validateDatabaseOwnership(config, paths, drivers);
+    const names = selection.all || selection.autoRun
+        ? Object.keys(config.connections).sort((a, b) => a === primary ? -1 : b === primary ? 1 : a < b ? -1 : a > b ? 1 : 0)
+        : [selection.connection ?? primary];
+    return names.flatMap((name) => {
+        if (!Object.hasOwn(config.connections, name)) {
+            throw new Error(`Unknown database connection "${name}".`);
+        }
+        if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+            throw new Error(`Database connection "${name}" must use letters, digits, underscores or hyphens.`);
+        }
+        const connection = config.connections[name];
+        const external = connection.schemaManagement === 'external';
+        if (external && !selection.all && !selection.autoRun) {
+            throw new Error(`Database connection "${name}" is external; migrations and seeds are not supported.`);
+        }
+        return kinds.map((kind) => {
+            const local = connection[kind];
+            const legacy = name === primary ? config[kind] : undefined;
+            // Legacy values (including existing DB_* environment mappings) retain precedence.
+            // Source selection is exclusive: different explicit sources must never be merged.
+            if (legacy?.directory &&
+                local?.directory &&
+                legacy.directory !== local.directory) {
+                throw new Error(`Conflicting legacy and connection ${kind} directories for "${name}".`);
+            }
+            if (legacy?.sources && local?.sources) {
+                throw new Error(`Configure ${kind} sources only once for "${name}".`);
+            }
+            const options = { ...local, ...legacy };
+            if (options.directory && options.sources) {
+                throw new Error(`Configure either ${kind} directory or sources for "${name}", not both.`);
+            }
+            const root = paths?.database() ?? path.resolve('database');
+            const modern = path.join(root, name, kind);
+            const old = path.join(root, kind);
+            let directory = options.directory;
+            if (!directory && !options.sources && !external) {
+                if (name === primary && existsSync(old)) {
+                    if (existsSync(modern)) {
+                        throw new Error(`Both legacy and connection ${kind} directories exist for "${name}". Configure one directory explicitly.`);
+                    }
+                    directory = old;
+                }
+                else
+                    directory = modern;
+            }
+            const resolvePath = (value) => path.resolve(paths?.root() ?? process.cwd(), value);
+            const packageName = options.packageName ?? contributions.appPackageName;
+            const appSources = options.sources?.map((source) => ({
+                ...source,
+                directory: resolvePath(source.directory),
+            })) ?? [
+                {
+                    packageName,
+                    directory: resolvePath(directory ?? modern),
+                    extensions: options.extensions,
+                },
+            ];
+            // Plugins contribute to the default connection only; they cannot know
+            // which additional connections an application happens to define.
+            const sources = [
+                ...(kind === 'migrations'
+                    ? migrationTargets
+                        .filter((target) => target.connection === name)
+                        .map((target) => target.source)
+                    : []),
+                ...appSources,
+                ...(name === primary ? contributions[kind] : []),
+            ];
+            const autoRun = options.autoRun ?? name === primary;
+            if (!external && (!selection.autoRun || autoRun)) {
+                for (const source of sources) {
+                    if (existsSync(source.directory) &&
+                        !statSync(source.directory).isDirectory()) {
+                        throw new Error(`Database ${kind} source is not a directory: ${source.directory}`);
+                    }
+                }
+                if (options.directory || options.sources) {
+                    for (const source of appSources) {
+                        if (!existsSync(source.directory)) {
+                            throw new Error(`Explicit database ${kind} source is missing for "${name}": ${source.directory}`);
+                        }
+                    }
+                }
+            }
+            return {
+                connection: name,
+                kind,
+                config: {
+                    ...options,
+                    packageName,
+                    directory: resolvePath(directory ?? modern),
+                    sources,
+                    autoRun,
+                },
+                skipReason: external
+                    ? 'external'
+                    : selection.autoRun && !autoRun
+                        ? 'auto-run-disabled'
+                        : undefined,
+            };
+        });
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/database/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/database/plan.ts"],"names":[],"mappings":"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"}

package/dist/database/provider.d.ts

@@ -0,0 +1,43 @@
+import { ServiceProvider, type ServiceContainer } from '@nocobase/service-provider';
+import type { AppConfigAccessor, AppPaths } from '../config/index.js';
+import type { AppDatabaseTaskContributions } from './types.js';
+export interface DatabaseProviderApplication {
+    readonly config: AppConfigAccessor;
+    readonly container: ServiceContainer;
+    readonly paths: AppPaths;
+    readonly databaseTaskContributions: AppDatabaseTaskContributions;
+}
+/**
+ * Set by `nocobase dev` on the server process it starts, to that
+ * application's root. Naming the root rather than switching the behavior on
+ * matters for a Hub: applications it hosts in the same process see the same
+ * environment, and their directories are deployed revisions a cache must not
+ * be written into.
+ */
+export declare const COLLECTIONS_REFRESH_ENV = "NOCOBASE_COLLECTIONS_REFRESH";
+export declare class DatabaseProvider extends ServiceProvider<DatabaseProviderApplication> {
+    readonly name: string;
+    register(): void;
+    boot(): Promise<void>;
+    /**
+     * Tells the sample data service where samples are recorded — the default connection's seed history — and whether
+     * this start installed that connection with `app.sampleData` set. Without a seeds run on the default connection,
+     * nothing is prepared and no sample is built or recorded.
+     */
+    private prepareSampleData;
+    /**
+     * Startup migrations make `database/<connection>/collections/` stale just
+     * as `db apply` does, and under `nocobase dev` they are the usual cause. So
+     * the development server refreshes the cache of every connection they
+     * changed. Nothing else does: production never sets the variable.
+     */
+    private refreshCollections;
+    /**
+     * Automatic startup tasks have no console to report to, so drift tolerated by
+     * the `warn` policy is only visible if it reaches the application log.
+     */
+    private reportChecksumWarnings;
+    shutdown(): Promise<void>;
+    private getDatabaseConfig;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/database/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/database/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAuBpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;CAClE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE,qBAAa,gBAAiB,SAAQ,eAAe,CAAC,2BAA2B,CAAC;IAChF,SAAgB,IAAI,EAAE,MAAM,CAAmC;IAE/C,QAAQ,IAAI,IAAI;IAsBV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3C;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAyCzB;;;;;OAKG;YACW,kBAAkB;IAyBhC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsBR,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/C,OAAO,CAAC,iBAAiB;CAG1B"}