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

package/dist/database/provider.js

@@ -0,0 +1,171 @@
+import { ServiceProvider, } from '@nocobase/service-provider';
+import { databaseManagerToken } from '@nocobase/db';
+import { realpathSync } from 'node:fs';
+import path from 'node:path';
+import { refreshAppCollectionsArtifact } from './collections-artifact.js';
+import { createAppDatabaseManager } from './manager.js';
+import { executeAppDatabasePlan, } from './tasks.js';
+import { defaultConnectionName, planAppDatabaseTasks, } from './plan.js';
+import { prepareAppDatabaseStorage } from './storage.js';
+import { createAppSeeder } from './seeder.js';
+import { createTaskServiceResolver } from './task-container.js';
+import { snapshotDatabaseTaskConfig } from './task-config.js';
+import { createSampleDataService } from '../sample-data/registry.js';
+import { sampleDataToken } from '../sample-data/token.js';
+import { loggingToken } from '../logging/token.js';
+/**
+ * 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 const COLLECTIONS_REFRESH_ENV = 'NOCOBASE_COLLECTIONS_REFRESH';
+export class DatabaseProvider extends ServiceProvider {
+    name = '@nocobase/app-server/database';
+    register() {
+        // Registered even without a database, so a plugin can always register its samples; they then never run.
+        if (!this.app.container.has(sampleDataToken)) {
+            this.app.container.singleton(sampleDataToken, () => createSampleDataService());
+        }
+        const config = this.getDatabaseConfig();
+        if (config.default === 'none') {
+            return;
+        }
+        this.app.container.singleton(databaseManagerToken, () => {
+            const database = createAppDatabaseManager(config, this.app.paths);
+            if (!database) {
+                throw new Error('Database is not configured.');
+            }
+            return database;
+        });
+    }
+    async boot() {
+        const { container } = this.app;
+        if (!container.has(databaseManagerToken)) {
+            return;
+        }
+        const config = this.getDatabaseConfig();
+        const plan = planAppDatabaseTasks(config, ['migrations', 'seeds'], {
+            paths: this.app.paths,
+            contributions: this.app.databaseTaskContributions,
+            autoRun: true,
+        });
+        // All SQLite connections must be usable by runtime services even without automatic tasks.
+        await prepareAppDatabaseStorage(config, this.app.paths, Object.keys(config.connections));
+        const database = container.resolve(databaseManagerToken);
+        const result = await executeAppDatabasePlan(database, config, plan, {
+            runtimeConfig: this.app.config,
+            container: this.app.container,
+            paths: this.app.paths,
+        });
+        this.reportChecksumWarnings(result);
+        this.prepareSampleData(config, plan, result, database);
+        await this.refreshCollections(config, result, database);
+    }
+    /**
+     * 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.
+     */
+    prepareSampleData(config, plan, result, database) {
+        const { container } = this.app;
+        if (!container.has(sampleDataToken))
+            return;
+        const connection = defaultConnectionName(config);
+        const task = plan.find((entry) => entry.kind === 'seeds' &&
+            entry.connection === connection &&
+            !entry.skipReason);
+        const seeded = result.results.find((entry) => entry.kind === 'seeds' &&
+            entry.connection === connection &&
+            entry.status === 'completed');
+        if (!task || !seeded)
+            return;
+        const seeder = createAppSeeder({
+            runtimeConfig: snapshotDatabaseTaskConfig(this.app.config),
+            container: createTaskServiceResolver(container),
+            database,
+            connection: task.connection,
+            config: task.config,
+            sources: task.config.sources,
+        });
+        container.resolve(sampleDataToken).prepare({
+            ledger: {
+                history: () => seeder.history(),
+                record: (entry) => seeder.record(entry),
+            },
+            enabled: seeded.freshInstall === true &&
+                this.app.config.get('app.sampleData') === true,
+        });
+    }
+    /**
+     * 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.
+     */
+    async refreshCollections(config, result, database) {
+        const target = process.env[COLLECTIONS_REFRESH_ENV];
+        if (!target || !sameDirectory(target, this.app.paths.root()))
+            return;
+        const refreshed = await refreshAppCollectionsArtifact(config, result, {
+            paths: this.app.paths,
+            database,
+        });
+        for (const entry of refreshed ?? []) {
+            if (entry.status !== 'failed')
+                continue;
+            const message = `Could not refresh the Collection cache of "${entry.connection}": ${entry.error}. Run "nocobase collections generate --connection ${entry.connection}" to rebuild it.`;
+            if (this.app.container.has(loggingToken)) {
+                this.app.container
+                    .resolve(loggingToken)
+                    .getLogger('database')
+                    .warn({ connection: entry.connection }, message);
+            }
+            else {
+                console.warn(message);
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    reportChecksumWarnings(result) {
+        const { container } = this.app;
+        if (!container.has(loggingToken))
+            return;
+        let logger;
+        for (const entry of result.results) {
+            for (const warning of entry.warnings ?? []) {
+                logger ??= container.resolve(loggingToken).getLogger('database');
+                logger.warn({
+                    connection: entry.connection,
+                    kind: entry.kind,
+                    package: warning.packageName,
+                    name: warning.name,
+                    recordedChecksum: warning.recordedChecksum,
+                    sourceChecksum: warning.sourceChecksum,
+                }, `Executed ${entry.kind === 'migrations' ? 'migration' : 'seed'} "${warning.name}" no longer matches its source. Run "nocobase db repair" when the edit left the schema identical, or "nocobase db redo" when it changed what ran.`);
+            }
+        }
+    }
+    async shutdown() {
+        await this.app.container.resolveIfCreated(databaseManagerToken)?.destroy();
+    }
+    getDatabaseConfig() {
+        return this.app.config.get('database');
+    }
+}
+function sameDirectory(left, right) {
+    const resolve = (directory) => {
+        try {
+            return realpathSync(directory);
+        }
+        catch {
+            return path.resolve(directory);
+        }
+    };
+    return resolve(left) === resolve(right);
+}
+//# sourceMappingURL=provider.js.map

package/dist/database/provider.js.map

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

package/dist/database/resolve-config.d.ts

@@ -0,0 +1,42 @@
+import type { DatabaseDriverRegistration } from '@nocobase/db';
+import type { AppDatabaseConfig } from './types.js';
+/** A dialect this runtime loads a driver for without the application registering one. */
+export type OfficialDialect = 'sqlite' | 'mysql' | 'postgres' | 'mssql' | 'oracle' | 'dameng' | 'kingbase' | 'oceanbase';
+/**
+ * The dialects above, as a list tooling can name them from.
+ *
+ * Anything that has to present the choice to a person — `nocobase config init`, the documentation it prints —
+ * reads this rather than keeping its own copy. A separate list is one that silently stops matching the loaders the
+ * day a dialect is added, and the mismatch only shows up as a dialect the CLI offers and the runtime cannot load.
+ */
+export declare const OFFICIAL_DIALECTS: readonly OfficialDialect[];
+/** A connection whose official driver package is not installed. */
+export interface MissingDatabaseDriver {
+    readonly connection: string;
+    readonly dialect: OfficialDialect;
+    readonly packageName: string;
+}
+/**
+ * Every configured connection whose driver is missing, reported at once.
+ *
+ * Stopping at the first one turned a configuration with two missing drivers — the Examples template on PostgreSQL
+ * still needs SQLite for its analytics connection — into two failed starts, each naming half the problem. The
+ * connections are listed so tooling can point at each one, and the message carries the single command that installs
+ * all of them.
+ *
+ * The remedy names the application rather than "here" on purpose: in a deployment this runs from a built `dist`, where
+ * installing a driver is undone by the next build. The driver has to reach the application's dependencies, and a
+ * deployment has to be built again afterwards.
+ */
+export declare class MissingDatabaseDriversError extends Error {
+    readonly missing: readonly MissingDatabaseDriver[];
+    constructor(missing: readonly MissingDatabaseDriver[]);
+}
+/** Configuration properties needed for driver loading; other properties are preserved. */
+export type DatabaseConfigInput = Pick<AppDatabaseConfig, 'default' | 'drivers' | 'connections'>;
+export type ResolvedDatabaseConfig<TConfig extends DatabaseConfigInput> = Omit<TConfig, 'drivers'> & {
+    drivers: Record<string, DatabaseDriverRegistration>;
+};
+/** Load only configured official dialects before constructing a synchronous manager. */
+export declare function resolveDatabaseConfig<TConfig extends DatabaseConfigInput>(config: TConfig): Promise<ResolvedDatabaseConfig<TConfig>>;
+//# sourceMappingURL=resolve-config.d.ts.map

package/dist/database/resolve-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/database/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,yFAAyF;AACzF,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,OAAO,GACP,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,WAAW,CAAC;AAkBhB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAEvD,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;gBAEvC,OAAO,EAAE,SAAS,qBAAqB,EAAE;CAc7D;AAED,0FAA0F;AAC1F,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,iBAAiB,EACjB,SAAS,GAAG,SAAS,GAAG,aAAa,CACtC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,OAAO,SAAS,mBAAmB,IAAI,IAAI,CAC5E,OAAO,EACP,SAAS,CACV,GAAG;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACrD,CAAC;AAEF,wFAAwF;AACxF,wBAAsB,qBAAqB,CACzC,OAAO,SAAS,mBAAmB,EACnC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CA4F3D"}

package/dist/database/resolve-config.js

@@ -0,0 +1,118 @@
+import { resolveDatabaseDriver } from '@nocobase/db';
+const officialDriverLoaders = {
+    sqlite: () => import('@nocobase/db-sqlite'),
+    mysql: () => import('@nocobase/db-mysql'),
+    postgres: () => import('@nocobase/db-postgres'),
+    mssql: () => import('@nocobase/db-mssql'),
+    oracle: () => import('@nocobase/db-oracle'),
+    dameng: () => import('@nocobase/db-dameng'),
+    kingbase: () => import('@nocobase/db-kingbase'),
+    oceanbase: () => import('@nocobase/db-oceanbase'),
+    // Keyed by the exported union rather than by `string`, so a dialect added to one and not the other fails to compile
+    // instead of producing a list the runtime cannot load from.
+};
+/**
+ * The dialects above, as a list tooling can name them from.
+ *
+ * Anything that has to present the choice to a person — `nocobase config init`, the documentation it prints —
+ * reads this rather than keeping its own copy. A separate list is one that silently stops matching the loaders the
+ * day a dialect is added, and the mismatch only shows up as a dialect the CLI offers and the runtime cannot load.
+ */
+export const OFFICIAL_DIALECTS = Object.freeze(Object.keys(officialDriverLoaders));
+/**
+ * Every configured connection whose driver is missing, reported at once.
+ *
+ * Stopping at the first one turned a configuration with two missing drivers — the Examples template on PostgreSQL
+ * still needs SQLite for its analytics connection — into two failed starts, each naming half the problem. The
+ * connections are listed so tooling can point at each one, and the message carries the single command that installs
+ * all of them.
+ *
+ * The remedy names the application rather than "here" on purpose: in a deployment this runs from a built `dist`, where
+ * installing a driver is undone by the next build. The driver has to reach the application's dependencies, and a
+ * deployment has to be built again afterwards.
+ */
+export class MissingDatabaseDriversError extends Error {
+    missing;
+    constructor(missing) {
+        const packages = [...new Set(missing.map((entry) => entry.packageName))];
+        const subject = missing.length === 1
+            ? `Database connection "${missing[0].connection}" requires "${missing[0].packageName}".`
+            : `Database connections ${missing
+                .map((entry) => `"${entry.connection}" (${entry.packageName})`)
+                .join(', ')} require drivers that are not installed.`;
+        super(`${subject} Add ${packages.length === 1 ? 'it' : 'them'} to the application's dependencies with "pnpm add ${packages.join(' ')}"; a deployment needs to be built again afterwards.`);
+        this.name = 'MissingDatabaseDriversError';
+        this.missing = missing;
+    }
+}
+/** Load only configured official dialects before constructing a synchronous manager. */
+export async function resolveDatabaseConfig(config) {
+    const drivers = { ...config.drivers };
+    const connections = { ...config.connections };
+    if (config.default === 'none')
+        return { ...config, drivers };
+    // Per-connection drivers must not conflict with an automatically registered
+    // default for another connection using the same dialect.
+    const suppliedDialects = new Set(Object.values(connections)
+        .filter((connection) => connection.databaseDriver)
+        .map((connection) => connection.dialect));
+    const loaded = new Map();
+    const missing = [];
+    for (const [name, connection] of Object.entries(connections)) {
+        if (resolveDatabaseDriver({
+            dialect: connection.dialect,
+            databaseDriver: connection.databaseDriver,
+        }, config.drivers, name))
+            continue;
+        const dialect = connection.dialect;
+        const loader = Object.hasOwn(officialDriverLoaders, dialect)
+            ? officialDriverLoaders[dialect]
+            : undefined;
+        if (!loader) {
+            throw new Error(`Database connection "${name}" uses unregistered dialect "${dialect}". Register a custom driver in database.drivers.`);
+        }
+        let driver = loaded.get(dialect);
+        if (!driver) {
+            const packageName = `@nocobase/db-${dialect}`;
+            let module;
+            try {
+                module = await loader();
+            }
+            catch (cause) {
+                const error = cause;
+                if (error?.code === 'ERR_MODULE_NOT_FOUND' &&
+                    error.message.startsWith(`Cannot find package '${packageName}' imported from `)) {
+                    // Collected rather than thrown, so every connection missing its driver is reported in one run.
+                    missing.push({
+                        connection: name,
+                        dialect: dialect,
+                        packageName,
+                    });
+                    continue;
+                }
+                throw new Error(`Failed to load database driver "${packageName}" for connection "${name}".`, { cause });
+            }
+            if (!module.default)
+                throw new Error(`Database driver "${packageName}" must have a default export.`);
+            driver = module.default;
+            resolveDatabaseDriver({
+                dialect: connection.dialect,
+                databaseDriver: connection.databaseDriver,
+            }, { [dialect]: driver }, name);
+            loaded.set(dialect, driver);
+        }
+        if (suppliedDialects.has(dialect)) {
+            connections[name] = {
+                ...connection,
+                databaseDriver: resolveDatabaseDriver({ dialect: connection.dialect }, { [dialect]: driver }, name),
+            };
+        }
+        else {
+            drivers[dialect] = driver;
+        }
+    }
+    if (missing.length > 0)
+        throw new MissingDatabaseDriversError(missing);
+    return { ...config, drivers, connections };
+}
+//# sourceMappingURL=resolve-config.js.map

package/dist/database/resolve-config.js.map

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

package/dist/database/seeder.d.ts

@@ -0,0 +1,50 @@
+import type { ServiceResolver } from '@nocobase/service-provider';
+import type { DatabaseTaskConfig } from '@nocobase/db';
+import { type ChecksumMismatch, type DatabaseManager, type SeedHistoryEntry, type SeedHistoryRecord, type SeedRepairOptions, type SeedSource, type StaleTaskLockTakeover, type TaskLockReleaseOptions } from '@nocobase/db';
+import type { AppDatabaseSeedConfig } from './types.js';
+import { type AppPendingTasksOptions, type AppPendingTasksResult, type AppTaskLockReleaseResult } from './migrator.js';
+export interface AppSeeder {
+    run(): Promise<AppSeedRunResult>;
+    /** Runs the sample seeds recorded as skipped; see `Seeder.runSamples()`. */
+    runSamples(): Promise<AppSeedRunResult>;
+    /** The seed history, without creating its table. */
+    history(): Promise<SeedHistoryRecord[]>;
+    /** Records an entry no seed file describes; see `Seeder.record()`. */
+    record(entry: SeedHistoryEntry): Promise<void>;
+    /** What `run()` would execute, after a fresh rebuild with `fresh` set. Reads only. */
+    pending(options?: AppPendingTasksOptions): Promise<AppPendingTasksResult>;
+    repair(options?: SeedRepairOptions): Promise<AppSeedRepairResult>;
+    unlock(options?: TaskLockReleaseOptions): Promise<AppTaskLockReleaseResult>;
+}
+export type AppSeedSkippedReason = 'missing-directory';
+export interface AppSeedRunResult {
+    status: 'completed' | 'skipped';
+    reason?: AppSeedSkippedReason;
+    executed?: string[];
+    skipped?: string[];
+    /** Sample seeds recorded as skipped without running. */
+    skippedSamples?: string[];
+    warnings?: ChecksumMismatch[];
+}
+export interface AppSeedRepairResult {
+    status: 'completed' | 'skipped';
+    reason?: AppSeedSkippedReason;
+    repaired?: ChecksumMismatch[];
+    dryRun?: boolean;
+}
+export interface CreateAppSeederOptions {
+    runtimeConfig?: DatabaseTaskConfig;
+    container?: ServiceResolver;
+    database: DatabaseManager;
+    config: AppDatabaseSeedConfig;
+    connection?: string;
+    sources?: readonly SeedSource[];
+    /** Reported when a lock whose holder stopped beating is taken over. */
+    onStaleLock?: (takeover: StaleTaskLockTakeover) => void;
+    /** Whether pending sample seeds run; recorded as skipped otherwise. */
+    sample?: {
+        readonly enabled: boolean;
+    };
+}
+export declare function createAppSeeder(options: CreateAppSeederOptions): AppSeeder;
+//# sourceMappingURL=seeder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeder.d.ts","sourceRoot":"","sources":["../../src/database/seeder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,eAAe,EAEpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAGtB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,SAAS;IACxB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjC,4EAA4E;IAC5E,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxC,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,sFAAsF;IACtF,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1E,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClE,MAAM,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAC7E;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,uEAAuE;IACvE,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACxD,uEAAuE;IACvE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CACxC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CA6E1E"}

package/dist/database/seeder.js

@@ -0,0 +1,117 @@
+import { createTaskServiceResolver } from './task-container.js';
+import { snapshotDatabaseTaskConfig } from './task-config.js';
+import { existsSync } from 'node:fs';
+import { createSeeder, loadSeeds, } from '@nocobase/db';
+import { pendingTasksResult, } from './migrator.js';
+export function createAppSeeder(options) {
+    return {
+        async run() {
+            if (!hasSeedDirectory(options)) {
+                return {
+                    status: 'skipped',
+                    reason: 'missing-directory',
+                };
+            }
+            return completedRunResult(await createDatabaseSeeder(options).run());
+        },
+        async runSamples() {
+            if (!hasSeedDirectory(options)) {
+                return {
+                    status: 'skipped',
+                    reason: 'missing-directory',
+                };
+            }
+            const { executed } = await createDatabaseSeeder(options).runSamples();
+            return { status: 'completed', executed };
+        },
+        async history() {
+            return createDatabaseSeeder(options).history();
+        },
+        async record(entry) {
+            await createDatabaseSeeder(options).record(entry);
+        },
+        async pending(pendingOptions = {}) {
+            if (!hasSeedDirectory(options)) {
+                return {
+                    status: 'skipped',
+                    reason: 'missing-directory',
+                };
+            }
+            const seeds = await loadSeeds(createDatabaseSeederOptions(options));
+            // A fresh run drops the seed history with the rest of the schema.
+            return pendingTasksResult(seeds, pendingOptions.fresh || pendingOptions.withoutHistory
+                ? []
+                : await createDatabaseSeeder(options).history());
+        },
+        // Unlocking needs no seed directory: the lock is taken by whichever run
+        // reached the connection, including one with only plugin seeds.
+        async unlock(releaseOptions) {
+            return {
+                status: 'completed',
+                ...(await createDatabaseSeeder(options).unlock(releaseOptions)),
+            };
+        },
+        async repair(repairOptions) {
+            if (!hasSeedDirectory(options)) {
+                return {
+                    status: 'skipped',
+                    reason: 'missing-directory',
+                };
+            }
+            return completedRepairResult(await createDatabaseSeeder(options).repair(repairOptions));
+        },
+    };
+}
+function createDatabaseSeeder(options) {
+    return createSeeder(createDatabaseSeederOptions(options));
+}
+function createDatabaseSeederOptions(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,
+        ...(options.sample ? { sample: options.sample } : {}),
+    };
+    if (options.sources) {
+        return {
+            ...common,
+            sources: options.sources,
+        };
+    }
+    return {
+        ...common,
+        directory: options.config.directory,
+        packageName: options.config.packageName,
+    };
+}
+function hasSeedDirectory(options) {
+    if (options.sources) {
+        return options.sources.some((source) => existsSync(source.directory));
+    }
+    return existsSync(options.config.directory);
+}
+function completedRunResult(result) {
+    return {
+        status: 'completed',
+        executed: result.executed,
+        skipped: result.skipped,
+        ...(result.skippedSamples.length > 0
+            ? { skippedSamples: result.skippedSamples }
+            : {}),
+        warnings: result.warnings,
+    };
+}
+function completedRepairResult(result) {
+    return {
+        status: 'completed',
+        repaired: result.repaired,
+        dryRun: result.dryRun,
+    };
+}
+//# sourceMappingURL=seeder.js.map

package/dist/database/seeder.js.map

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

package/dist/database/storage.d.ts

@@ -0,0 +1,10 @@
+import { type DatabaseDriverRegistration } from '@nocobase/db';
+import type { AppPaths } from '../config/index.js';
+import type { AppDatabaseConfig } from './types.js';
+export declare function prepareAppDatabaseStorage<TConfig extends AppDatabaseConfig>(config: TConfig, paths?: AppPaths, names?: readonly string[], drivers?: Record<string, DatabaseDriverRegistration>): Promise<void>;
+/**
+ * Whether the storage of connection `name` exists already. A driver that
+ * does not say, which is every driver without local storage, has it.
+ */
+export declare function appDatabaseStorageExists<TConfig extends AppDatabaseConfig>(config: TConfig, paths: AppPaths | undefined, name: string, drivers?: Record<string, DatabaseDriverRegistration>): Promise<boolean>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/database/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,wBAAsB,yBAAyB,CAC7C,OAAO,SAAS,iBAAiB,EAEjC,MAAM,EAAE,OAAO,EACf,KAAK,CAAC,EAAE,QAAQ,EAChB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,SAAS,iBAAiB,EAEjC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,GACnD,OAAO,CAAC,OAAO,CAAC,CAWlB"}

package/dist/database/storage.js

@@ -0,0 +1,37 @@
+import { mkdir } from 'node:fs/promises';
+import { resolveDatabaseDriver, } from '@nocobase/db';
+import { resolveConnections } from './manager.js';
+import { defaultConnectionName } from './plan.js';
+export async function prepareAppDatabaseStorage(config, paths, names, drivers) {
+    if (config.default === 'none')
+        return;
+    const primary = defaultConnectionName(config);
+    const availableDrivers = { ...config.drivers, ...drivers };
+    const connections = resolveConnections(config.connections, paths, availableDrivers);
+    for (const name of names ?? (primary ? [primary] : [])) {
+        const connection = connections[name];
+        if (!connection)
+            throw new Error(`Unknown database connection "${name}".`);
+        const driver = resolveDatabaseDriver(connection, availableDrivers, name);
+        await driver?.prepareStorage?.(connection, {
+            ensureDirectory: async (directory) => {
+                await mkdir(directory, { recursive: true });
+            },
+        });
+    }
+}
+/**
+ * Whether the storage of connection `name` exists already. A driver that
+ * does not say, which is every driver without local storage, has it.
+ */
+export async function appDatabaseStorageExists(config, paths, name, drivers) {
+    if (config.default === 'none')
+        return true;
+    const availableDrivers = { ...config.drivers, ...drivers };
+    const connection = resolveConnections(config.connections, paths, availableDrivers)[name];
+    if (!connection)
+        throw new Error(`Unknown database connection "${name}".`);
+    const driver = resolveDatabaseDriver(connection, availableDrivers, name);
+    return (await driver?.hasStorage?.(connection)) ?? true;
+}
+//# sourceMappingURL=storage.js.map

package/dist/database/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/database/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EACL,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAG7C,MAAe,EACf,KAAgB,EAChB,KAAyB,EACzB,OAAoD;IAEpD,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO;IACtC,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3D,MAAM,WAAW,GAAG,kBAAkB,CACpC,MAAM,CAAC,WAAW,EAClB,KAAK,EACL,gBAAgB,CACjB,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,IAAI,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,MAAM,EAAE,cAAc,EAAE,CAAC,UAAU,EAAE;YACzC,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBACnC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAG5C,MAAe,EACf,KAA2B,EAC3B,IAAY,EACZ,OAAoD;IAEpD,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,gBAAgB,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3D,MAAM,UAAU,GAAG,kBAAkB,CACnC,MAAM,CAAC,WAAW,EAClB,KAAK,EACL,gBAAgB,CACjB,CAAC,IAAI,CAAC,CAAC;IACR,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,IAAI,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,MAAM,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1D,CAAC"}

package/dist/database/task-config.d.ts

@@ -0,0 +1,7 @@
+import { type ConfigMap } from '@nocobase/config';
+import type { DatabaseTaskConfig } from '@nocobase/db';
+/** Capture ordinary configuration values once, using the application's path semantics. */
+export declare function snapshotDatabaseTaskConfig(config?: DatabaseTaskConfig & {
+    raw?(): ConfigMap;
+}): DatabaseTaskConfig;
+//# sourceMappingURL=task-config.d.ts.map

package/dist/database/task-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-config.d.ts","sourceRoot":"","sources":["../../src/database/task-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,0FAA0F;AAC1F,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,kBAAkB,GAAG;IAAE,GAAG,CAAC,IAAI,SAAS,CAAA;CAAE,GAClD,kBAAkB,CAepB"}

package/dist/database/task-config.js

@@ -0,0 +1,19 @@
+import { ConfigView } from '@nocobase/config';
+/** Capture ordinary configuration values once, using the application's path semantics. */
+export function snapshotDatabaseTaskConfig(config) {
+    // A get-only reader has no enumeration contract: preserve its lookup semantics.
+    if (config && !config.raw) {
+        return Object.freeze({
+            get(key) {
+                return config.get(key);
+            },
+        });
+    }
+    const snapshot = new ConfigView(config?.raw?.() ?? {}, '.');
+    return Object.freeze({
+        get(key) {
+            return snapshot.get(key);
+        },
+    });
+}
+//# sourceMappingURL=task-config.js.map

package/dist/database/task-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-config.js","sourceRoot":"","sources":["../../src/database/task-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAG9D,0FAA0F;AAC1F,MAAM,UAAU,0BAA0B,CACxC,MAAmD;IAEnD,gFAAgF;IAChF,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAc,GAAW;gBAC1B,OAAO,MAAM,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAc,GAAW;YAC1B,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;QAC5C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/database/task-container.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceResolver } from '@nocobase/service-provider';
+export declare function createTaskServiceResolver(source?: ServiceResolver): ServiceResolver;
+//# sourceMappingURL=task-container.d.ts.map