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

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-container.d.ts","sourceRoot":"","sources":["../../src/database/task-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,4BAA4B,CAAC;AAQhF,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,eAAe,GACvB,eAAe,CAgCjB"}

package/dist/database/task-container.js

@@ -0,0 +1,34 @@
+import { idGeneratorToken } from '../id-generator/token.js';
+/** Only registration-ready infrastructure services may be exposed to database tasks. */
+const allowedTokens = new Set([
+    idGeneratorToken,
+]);
+export function createTaskServiceResolver(source) {
+    function assertAllowed(token) {
+        if (!allowedTokens.has(token)) {
+            // Name the supported path: a migration or seed that resolved the
+            // DatabaseManager here would get the application's connection rather
+            // than its own, and in a transaction would write outside it.
+            throw new Error(`Service "${token.name}" is not allowed in migrations or seeds. ` +
+                'Read and write data through the context\'s "repository" and ' +
+                '"query", which are bound to the connection the task runs on, ' +
+                'and change structure through a migration\'s "builder".');
+        }
+    }
+    return Object.freeze({
+        has(token) {
+            return allowedTokens.has(token) && (source?.has(token) ?? false);
+        },
+        resolve(token) {
+            assertAllowed(token);
+            if (!source)
+                throw new Error(`Service "${token.name}" is not registered in the database task container.`);
+            return source.resolve(token);
+        },
+        resolveIfCreated(token) {
+            assertAllowed(token);
+            return source?.resolveIfCreated(token);
+        },
+    });
+}
+//# sourceMappingURL=task-container.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-container.js","sourceRoot":"","sources":["../../src/database/task-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,wFAAwF;AACxF,MAAM,aAAa,GAAuC,IAAI,GAAG,CAAC;IAChE,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CACvC,MAAwB;IAExB,SAAS,aAAa,CAAI,KAAsB;QAC9C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,iEAAiE;YACjE,qEAAqE;YACrE,6DAA6D;YAC7D,MAAM,IAAI,KAAK,CACb,YAAY,KAAK,CAAC,IAAI,2CAA2C;gBAC/D,8DAA8D;gBAC9D,+DAA+D;gBAC/D,wDAAwD,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAI,KAAsB;YAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAI,KAAsB;YAC/B,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM;gBACT,MAAM,IAAI,KAAK,CACb,YAAY,KAAK,CAAC,IAAI,qDAAqD,CAC5E,CAAC;YACJ,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,gBAAgB,CAAI,KAAsB;YACxC,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/database/tasks.d.ts

@@ -0,0 +1,104 @@
+import type { ServiceResolver } from '@nocobase/service-provider';
+import type { DatabaseTaskConfig } from '@nocobase/db';
+import { type AppDatabaseTaskPlanOptions, type AppDatabaseTask, type AppDatabaseTaskKind } from './plan.js';
+import { type ChecksumMismatch, type DatabaseDriverRegistration, type DatabaseManager, type MigrationHistoryRecord, type TaskLockState } from '@nocobase/db';
+import type { AppPaths } from '../config/index.js';
+import { type AppMigrationRunResult } from './migrator.js';
+import { type AppSeedRunResult } from './seeder.js';
+import type { AppDatabaseConfig } from './types.js';
+/**
+ * `repair` realigns recorded checksums; it executes no migration or seed.
+ * `rollback` runs the latest migration batch's `down`, and applies to
+ * migrations alone: seeds have no inverse. `sample` runs the sample seeds a
+ * run recorded as skipped, and applies to seeds alone.
+ */
+export type AppDatabaseTaskOperation = 'run' | 'repair' | 'rollback' | 'unlock' | 'sample';
+export interface AppDatabaseTaskResult {
+    connection: string;
+    kind: AppDatabaseTaskKind;
+    status: 'completed' | 'skipped' | 'failed' | 'not-run';
+    reason?: string;
+    error?: string;
+    batch?: number;
+    executed?: string[];
+    skipped?: string[];
+    /** Sample seeds a run recorded as skipped without running them. */
+    skippedSamples?: string[];
+    /**
+     * Seeds only: whether this run installed the connection — it held no
+     * migration or seed history before the run, or a fresh run rebuilt it. Sample
+     * data loads only then, and only with `app.sampleData` set.
+     */
+    freshInstall?: boolean;
+    fresh?: boolean;
+    /** Migrations a rollback undid, or that a dry run would undo. */
+    rolledBack?: string[];
+    /** The rolled back batch's history records, in the order they roll back. */
+    records?: MigrationHistoryRecord[];
+    /** The task lock as it stood when an unlock ran. */
+    lock?: TaskLockState;
+    /** Whether an unlock deleted the lock row, and why it did not. */
+    released?: boolean;
+    lockReason?: 'not-held' | 'active';
+    /** Checksum drift tolerated by the `warn` policy during a run. */
+    warnings?: ChecksumMismatch[];
+    /** Records a repair rewrote, or that a dry run would rewrite. */
+    repaired?: ChecksumMismatch[];
+    /** Migrations or seeds a run would execute, as a dry run reports them. */
+    pending?: string[];
+    dryRun?: boolean;
+}
+export interface AppDatabaseTasksResult {
+    ok: boolean;
+    status: 'completed' | 'failed' | 'not-configured';
+    results: AppDatabaseTaskResult[];
+}
+export declare class AppDatabaseTaskError extends Error {
+    readonly result: AppDatabaseTasksResult;
+    constructor(result: AppDatabaseTasksResult, cause: unknown);
+}
+export interface AppDatabasePlanExecutionOptions {
+    readonly runtimeConfig?: DatabaseTaskConfig;
+    readonly container?: ServiceResolver;
+    readonly paths?: AppPaths;
+    readonly drivers?: Record<string, DatabaseDriverRegistration>;
+    readonly fresh?: boolean;
+    /** Unlock only: release a lock that is still sending heartbeats. */
+    readonly force?: boolean;
+    readonly operation?: AppDatabaseTaskOperation;
+    /**
+     * Report what the operation would do without doing it. A run lists its
+     * pending tasks, reading history without taking the lock; a rollback reports
+     * the batch it would undo and a repair the records it would rewrite. Not
+     * supported by unlock.
+     */
+    readonly dryRun?: boolean;
+}
+/** Manual commands and startup share the same resolved, connection-bound plan. */
+export declare function executeAppDatabasePlan(database: DatabaseManager, config: AppDatabaseConfig, plan: readonly AppDatabaseTask[], { paths, drivers, fresh, force, operation, dryRun, runtimeConfig, container, }?: AppDatabasePlanExecutionOptions): Promise<AppDatabaseTasksResult>;
+export interface AppDatabaseTaskRunOptions extends AppDatabaseTaskPlanOptions {
+    /** The configuration reader migrations and seeds receive as `config`. */
+    readonly runtimeConfig?: DatabaseTaskConfig;
+    /** Borrow a database manager; its owner remains responsible for disposal. */
+    readonly database?: () => DatabaseManager;
+    readonly container?: ServiceResolver;
+    /**
+     * One task kind, or several planned together. Several kinds share one plan
+     * so their order is the plan's, which is what lets `fresh` rebuild a
+     * connection's schema before that connection's seeds run.
+     */
+    readonly kind: AppDatabaseTaskKind | readonly AppDatabaseTaskKind[];
+    readonly operation?: AppDatabaseTaskOperation;
+    /**
+     * Report what the operation would do without doing it; see
+     * {@link AppDatabasePlanExecutionOptions.dryRun}. A fresh dry run confirms
+     * nothing, because it drops nothing.
+     */
+    readonly dryRun?: boolean;
+    /** Unlock only: release a lock that is still sending heartbeats. */
+    readonly force?: boolean;
+}
+export declare function runAppDatabaseTasks(config: AppDatabaseConfig, options: AppDatabaseTaskRunOptions): Promise<AppDatabaseTasksResult>;
+export declare function runAppMigrations(config: AppDatabaseConfig, options: Omit<AppDatabaseTaskRunOptions, 'kind'>): Promise<AppMigrationRunResult | undefined>;
+export declare function runAppSeeds(config: AppDatabaseConfig, options: Omit<AppDatabaseTaskRunOptions, 'kind'>): Promise<AppSeedRunResult | undefined>;
+//# sourceMappingURL=tasks.d.ts.map

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

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

package/dist/database/tasks.js

@@ -0,0 +1,350 @@
+import { createTaskServiceResolver } from './task-container.js';
+import { loggingToken } from '../logging/token.js';
+import { snapshotDatabaseTaskConfig } from './task-config.js';
+import { resolveDatabaseConfig } from './resolve-config.js';
+import { planAppDatabaseTasks, } from './plan.js';
+import { resolveDatabaseDriver, } from '@nocobase/db';
+import { createAppDatabaseManager } from './manager.js';
+import { createAppMigrator } from './migrator.js';
+import { createAppSeeder } from './seeder.js';
+import { appDatabaseStorageExists, prepareAppDatabaseStorage, } from './storage.js';
+export class AppDatabaseTaskError extends Error {
+    result;
+    constructor(result, cause) {
+        const failed = result.results.find((entry) => entry.status === 'failed');
+        super(`Database ${failed?.kind} failed for connection "${failed?.connection}": ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        this.result = result;
+        this.name = 'AppDatabaseTaskError';
+    }
+}
+/** Manual commands and startup share the same resolved, connection-bound plan. */
+export async function executeAppDatabasePlan(database, config, plan, { paths, drivers, fresh = false, force = false, operation = 'run', dryRun = false, runtimeConfig, container, } = {}) {
+    if (fresh) {
+        if (operation !== 'run')
+            throw new Error(`A fresh run cannot be combined with ${operation}.`);
+        assertFreshPlanOrder(plan);
+    }
+    if (operation === 'rollback' && plan.some((task) => task.kind === 'seeds')) {
+        throw new Error('A rollback covers migrations only; seeds have no down.');
+    }
+    if (operation === 'sample' &&
+        plan.some((task) => task.kind === 'migrations')) {
+        throw new Error('Sample data covers seeds only.');
+    }
+    if (operation === 'sample' && (dryRun || fresh)) {
+        throw new Error('Sample data has no dry run or fresh run.');
+    }
+    if (operation === 'unlock' && fresh) {
+        throw new Error('A fresh run cannot be combined with unlock.');
+    }
+    if (operation === 'unlock' && dryRun) {
+        throw new Error('An unlock has no dry run; it reports the lock it finds.');
+    }
+    const taskContainer = createTaskServiceResolver(container);
+    const taskConfig = snapshotDatabaseTaskConfig(runtimeConfig);
+    // Decided before any task runs: the migrations a run applies would make
+    // every database look installed by the time its seeds run.
+    const freshInstalls = operation === 'run' && !dryRun
+        ? await detectFreshInstalls(database, config, plan, {
+            paths,
+            drivers,
+            fresh,
+            runtimeConfig: taskConfig,
+            container: taskContainer,
+        })
+        : new Map();
+    const sampleData = taskConfig.get('app.sampleData') === true;
+    const result = {
+        ok: true,
+        status: 'completed',
+        results: [],
+    };
+    for (const [index, task] of plan.entries()) {
+        const identity = { connection: task.connection, kind: task.kind };
+        if (task.skipReason) {
+            result.results.push({
+                ...identity,
+                status: 'skipped',
+                reason: task.skipReason,
+            });
+            continue;
+        }
+        try {
+            // A dry run changes nothing, and opening a connection to storage that
+            // does not exist yet would create it: it answers for an empty database
+            // instead, without preparing storage or connecting.
+            const storageMissing = dryRun &&
+                !(await appDatabaseStorageExists(config, paths, task.connection, drivers));
+            if (!storageMissing) {
+                await prepareAppDatabaseStorage(config, paths, [task.connection], drivers);
+            }
+            const options = {
+                runtimeConfig: taskConfig,
+                container: taskContainer,
+                database,
+                connection: task.connection,
+                config: task.config,
+                sources: task.config.sources,
+                onStaleLock: (takeover) => reportStaleLock(container, task, takeover),
+            };
+            const freshInstall = freshInstalls.get(task.connection);
+            const completed = operation === 'unlock'
+                ? await unlockTask(task, options, force)
+                : operation === 'sample'
+                    ? await createAppSeeder(options).runSamples()
+                    : storageMissing
+                        ? await emptyDatabasePreview(operation, task, options, fresh)
+                        : operation === 'repair'
+                            ? task.kind === 'migrations'
+                                ? await createAppMigrator(options).repair({ dryRun })
+                                : await createAppSeeder(options).repair({ dryRun })
+                            : operation === 'rollback'
+                                ? await createAppMigrator(options).rollback({ dryRun })
+                                : dryRun
+                                    ? task.kind === 'migrations'
+                                        ? await createAppMigrator(options).pending({ fresh })
+                                        : await createAppSeeder(options).pending({ fresh })
+                                    : task.kind === 'migrations'
+                                        ? await (fresh
+                                            ? createAppMigrator(options).fresh()
+                                            : createAppMigrator(options).latest())
+                                        : await createAppSeeder({
+                                            ...options,
+                                            sample: {
+                                                enabled: freshInstall === true && sampleData,
+                                            },
+                                        }).run();
+            result.results.push({
+                ...identity,
+                ...completed,
+                ...(task.kind === 'seeds' &&
+                    freshInstall !== undefined &&
+                    completed.status === 'completed'
+                    ? { freshInstall }
+                    : {}),
+                ...(fresh ? { fresh: true } : {}),
+            });
+        }
+        catch (error) {
+            result.ok = false;
+            result.status = 'failed';
+            result.results.push({
+                ...identity,
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            result.results.push(...plan.slice(index + 1).map((pending) => ({
+                connection: pending.connection,
+                kind: pending.kind,
+                status: 'not-run',
+                reason: 'previous-task-failed',
+            })));
+            throw new AppDatabaseTaskError(result, error);
+        }
+    }
+    return result;
+}
+/**
+ * Which connections this run installs: those with a seeds task whose storage
+ * does not exist yet, or that hold neither seed history nor, when the plan
+ * migrates them too, migration history. A fresh run installs every one. Reads
+ * only, without creating a history table or the storage itself.
+ */
+async function detectFreshInstalls(database, config, plan, options) {
+    const installs = new Map();
+    for (const task of plan) {
+        if (task.kind !== 'seeds' || task.skipReason)
+            continue;
+        if (options.fresh) {
+            installs.set(task.connection, true);
+            continue;
+        }
+        if (!(await appDatabaseStorageExists(config, options.paths, task.connection, options.drivers))) {
+            installs.set(task.connection, true);
+            continue;
+        }
+        const common = {
+            runtimeConfig: options.runtimeConfig,
+            container: options.container,
+            database,
+            connection: task.connection,
+        };
+        const seeded = await createAppSeeder({
+            ...common,
+            config: task.config,
+            sources: task.config.sources,
+        }).history();
+        const migrations = plan.find((entry) => entry.kind === 'migrations' &&
+            entry.connection === task.connection &&
+            !entry.skipReason);
+        const migrated = migrations
+            ? await createAppMigrator({
+                ...common,
+                config: migrations.config,
+                sources: migrations.config.sources,
+            }).history()
+            : [];
+        installs.set(task.connection, seeded.length === 0 && migrated.length === 0);
+    }
+    return installs;
+}
+/**
+ * What a dry run reports for a database that does not exist yet: every task
+ * pending, nothing to roll back, nothing to repair.
+ */
+async function emptyDatabasePreview(operation, task, options, fresh) {
+    if (operation === 'rollback') {
+        return {
+            status: 'completed',
+            batch: 0,
+            rolledBack: [],
+            records: [],
+            dryRun: true,
+        };
+    }
+    if (operation === 'repair') {
+        return { status: 'completed', repaired: [], dryRun: true };
+    }
+    return task.kind === 'migrations'
+        ? createAppMigrator(options).pending({ fresh, withoutHistory: true })
+        : createAppSeeder(options).pending({ fresh, withoutHistory: true });
+}
+/** Releases whichever lock belongs to the task's kind. */
+async function unlockTask(task, options, force) {
+    const released = task.kind === 'migrations'
+        ? await createAppMigrator(options).unlock({ force })
+        : await createAppSeeder(options).unlock({ force });
+    // `reason` on a task result says why it was skipped, so the lock's own
+    // reason gets its own field rather than being read as a skip.
+    return {
+        status: 'completed',
+        released: released.released,
+        ...(released.lock ? { lock: released.lock } : {}),
+        ...(released.reason ? { lockReason: released.reason } : {}),
+    };
+}
+/**
+ * A lock taken over because its holder stopped beating means a previous run
+ * was killed. Nothing else records that, so it belongs in the application log.
+ */
+function reportStaleLock(container, task, takeover) {
+    if (!container?.has(loggingToken))
+        return;
+    container.resolve(loggingToken).getLogger('database').warn({
+        connection: task.connection,
+        kind: task.kind,
+        table: takeover.tableName,
+        lockedBy: takeover.lockedBy,
+        staleForMs: takeover.staleForMs,
+    }, `Took over the ${task.kind} lock "${takeover.tableName}" after its holder stopped responding; the run holding it did not shut down cleanly.`);
+}
+/**
+ * A fresh run drops a connection's managed schema inside its migrations task,
+ * so every other task on that connection has to come after it. The planner
+ * already orders tasks this way; the check guards hand-built plans, which
+ * would otherwise seed a database that is about to be emptied.
+ */
+function assertFreshPlanOrder(plan) {
+    const rebuilt = new Set();
+    for (const task of plan) {
+        if (task.skipReason)
+            continue;
+        if (task.kind === 'migrations') {
+            rebuilt.add(task.connection);
+            continue;
+        }
+        if (!rebuilt.has(task.connection)) {
+            throw new Error(`A fresh run must rebuild connection "${task.connection}" before its ${task.kind} run.`);
+        }
+    }
+    if (!rebuilt.size) {
+        throw new Error('A fresh run must include migrations.');
+    }
+}
+export async function runAppDatabaseTasks(config, options) {
+    const { paths, drivers } = options;
+    const kinds = Array.isArray(options.kind)
+        ? options.kind
+        : [options.kind];
+    if (options.fresh && !kinds.includes('migrations')) {
+        throw new Error('A fresh run must include migrations.');
+    }
+    config = await resolveDatabaseConfig({
+        ...config,
+        drivers: { ...config.drivers, ...drivers },
+    });
+    const plan = planAppDatabaseTasks(config, kinds, options);
+    if (!plan.length)
+        return { ok: true, status: 'not-configured', results: [] };
+    if (options.fresh) {
+        for (const task of plan) {
+            if (task.skipReason)
+                continue;
+            const connection = config.connections[task.connection];
+            const driver = resolveDatabaseDriver({
+                dialect: connection.dialect,
+                databaseDriver: connection.databaseDriver,
+            }, { ...config.drivers, ...drivers }, task.connection);
+            if (!driver?.resetManagedSchema) {
+                throw new Error(`Database driver for connection "${task.connection}" does not support managed schema reset.`);
+            }
+        }
+        if (!options.dryRun &&
+            options.confirmFresh &&
+            !(await options.confirmFresh(plan))) {
+            throw new Error('Fresh migration cancelled.');
+        }
+    }
+    const database = options.database
+        ? options.database()
+        : createAppDatabaseManager(config, paths, {
+            ...config.drivers,
+            ...drivers,
+        });
+    if (!database)
+        return { ok: true, status: 'not-configured', results: [] };
+    try {
+        return await executeAppDatabasePlan(database, config, plan, {
+            paths,
+            drivers,
+            fresh: options.fresh,
+            force: options.force,
+            operation: options.operation,
+            dryRun: options.dryRun,
+            runtimeConfig: options.runtimeConfig,
+            container: options.container,
+        });
+    }
+    finally {
+        if (!options.database)
+            await database.destroy();
+    }
+}
+export async function runAppMigrations(config, options) {
+    const result = await runAppDatabaseTasks(config, {
+        ...options,
+        kind: 'migrations',
+    });
+    const first = result.results[0];
+    return (first && {
+        status: first.status,
+        reason: first.reason,
+        batch: first.batch,
+        executed: first.executed,
+        skipped: first.skipped,
+    });
+}
+export async function runAppSeeds(config, options) {
+    const result = await runAppDatabaseTasks(config, {
+        ...options,
+        kind: 'seeds',
+    });
+    const first = result.results[0];
+    return (first && {
+        status: first.status,
+        reason: first.reason,
+        executed: first.executed,
+        skipped: first.skipped,
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/database/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/database/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,oBAAoB,GAIrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,GAOtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAA8B,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAyB,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAsDtB,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IADlB,YACkB,MAA8B,EAC9C,KAAc;QAEd,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACzE,KAAK,CACH,YAAY,MAAM,EAAE,IAAI,2BAA2B,MAAM,EAAE,UAAU,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACnI,EAAE,KAAK,EAAE,CACV,CAAC;QAPc,WAAM,GAAN,MAAM,CAAwB;QAQ9C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAoBD,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAyB,EACzB,MAAyB,EACzB,IAAgC,EAChC,EACE,KAAK,EACL,OAAO,EACP,KAAK,GAAG,KAAK,EACb,KAAK,GAAG,KAAK,EACb,SAAS,GAAG,KAAK,EACjB,MAAM,GAAG,KAAK,EACd,aAAa,EACb,SAAS,MAC0B,EAAE;IAEvC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,SAAS,KAAK,KAAK;YACrB,MAAM,IAAI,KAAK,CAAC,uCAAuC,SAAS,GAAG,CAAC,CAAC;QACvE,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IACE,SAAS,KAAK,QAAQ;QACtB,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,EAC/C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,aAAa,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;IAC7D,wEAAwE;IACxE,2DAA2D;IAC3D,MAAM,aAAa,GACjB,SAAS,KAAK,KAAK,IAAI,CAAC,MAAM;QAC5B,CAAC,CAAC,MAAM,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;YAChD,KAAK;YACL,OAAO;YACP,KAAK;YACL,aAAa,EAAE,UAAU;YACzB,SAAS,EAAE,aAAa;SACzB,CAAC;QACJ,CAAC,CAAC,IAAI,GAAG,EAAmB,CAAC;IACjC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAU,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACtE,MAAM,MAAM,GAA2B;QACrC,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAClE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;gBAClB,GAAG,QAAQ;gBACX,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,IAAI,CAAC,UAAU;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,sEAAsE;YACtE,uEAAuE;YACvE,oDAAoD;YACpD,MAAM,cAAc,GAClB,MAAM;gBACN,CAAC,CAAC,MAAM,wBAAwB,CAC9B,MAAM,EACN,KAAK,EACL,IAAI,CAAC,UAAU,EACf,OAAO,CACR,CAAC,CAAC;YACL,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,yBAAyB,CAC7B,MAAM,EACN,KAAK,EACL,CAAC,IAAI,CAAC,UAAU,CAAC,EACjB,OAAO,CACR,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,aAAa,EAAE,UAAU;gBACzB,SAAS,EAAE,aAAa;gBACxB,QAAQ;gBACR,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC5B,WAAW,EAAE,CAAC,QAA+B,EAAQ,EAAE,CACrD,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC;aAC7C,CAAC;YACF,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxD,MAAM,SAAS,GACb,SAAS,KAAK,QAAQ;gBACpB,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;gBACxC,CAAC,CAAC,SAAS,KAAK,QAAQ;oBACtB,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE;oBAC7C,CAAC,CAAC,cAAc;wBACd,CAAC,CAAC,MAAM,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;wBAC7D,CAAC,CAAC,SAAS,KAAK,QAAQ;4BACtB,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;gCAC1B,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;gCACrD,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;4BACrD,CAAC,CAAC,SAAS,KAAK,UAAU;gCACxB,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;gCACvD,CAAC,CAAC,MAAM;oCACN,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;wCAC1B,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;wCACrD,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;oCACrD,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;wCAC1B,CAAC,CAAC,MAAM,CAAC,KAAK;4CACV,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE;4CACpC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;wCAC1C,CAAC,CAAC,MAAM,eAAe,CAAC;4CACpB,GAAG,OAAO;4CACV,MAAM,EAAE;gDACN,OAAO,EAAE,YAAY,KAAK,IAAI,IAAI,UAAU;6CAC7C;yCACF,CAAC,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;gBAClB,GAAG,QAAQ;gBACX,GAAG,SAAS;gBACZ,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;oBACzB,YAAY,KAAK,SAAS;oBAC1B,SAAS,CAAC,MAAM,KAAK,WAAW;oBAC9B,CAAC,CAAC,EAAE,YAAY,EAAE;oBAClB,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;YAClB,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;YACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;gBAClB,GAAG,QAAQ;gBACX,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,IAAI,CACjB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAyB,EAAE,CAAC,CAAC;gBAChE,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,sBAAsB;aAC/B,CAAC,CAAC,CACJ,CAAC;YACF,MAAM,IAAI,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,mBAAmB,CAChC,QAAyB,EACzB,MAAyB,EACzB,IAAgC,EAChC,OAMC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU;YAAE,SAAS;QACvD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IACE,CAAC,CAAC,MAAM,wBAAwB,CAC9B,MAAM,EACN,OAAO,CAAC,KAAK,EACb,IAAI,CAAC,UAAU,EACf,OAAO,CAAC,OAAO,CAChB,CAAC,EACF,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG;YACb,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ;YACR,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,GAAG,MAAM;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC7B,CAAC,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC1B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,YAAY;YAC3B,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU;YACpC,CAAC,KAAK,CAAC,UAAU,CACpB,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU;YACzB,CAAC,CAAC,MAAM,iBAAiB,CAAC;gBACtB,GAAG,MAAM;gBACT,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO;aACnC,CAAC,CAAC,OAAO,EAAE;YACd,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,oBAAoB,CACjC,SAAsD,EACtD,IAAqB,EACrB,OAAgD,EAChD,KAAc;IAEd,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,KAAK,YAAY;QAC/B,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QACrE,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,0DAA0D;AAC1D,KAAK,UAAU,UAAU,CACvB,IAAqB,EACrB,OAAgD,EAChD,KAAc;IAId,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,KAAK,YAAY;QACxB,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QACpD,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CACtB,SAAsC,EACtC,IAAqB,EACrB,QAA+B;IAE/B,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO;IAC1C,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CACxD;QACE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,QAAQ,CAAC,SAAS;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,EACD,iBAAiB,IAAI,CAAC,IAAI,UAAU,QAAQ,CAAC,SAAS,sFAAsF,CAC7I,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,IAAgC;IAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,UAAU;YAAE,SAAS;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,UAAU,gBAAgB,IAAI,CAAC,IAAI,OAAO,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAyBD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAyB,EACzB,OAAkC;IAElC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,CAAC,CAAE,OAAO,CAAC,IAAuC;QAClD,CAAC,CAAC,CAAC,OAAO,CAAC,IAA2B,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,GAAG,MAAM,qBAAqB,CAAC;QACnC,GAAG,MAAM;QACT,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE;KAC3C,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC7E,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,qBAAqB,CAClC;gBACE,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,cAAc,EAAE,UAAU,CAAC,cAAc;aAC1C,EACD,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,EACjC,IAAI,CAAC,UAAU,CAChB,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,UAAU,0CAA0C,CAC7F,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IACE,CAAC,OAAO,CAAC,MAAM;YACf,OAAO,CAAC,YAAY;YACpB,CAAC,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EACnC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;QAC/B,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;QACpB,CAAC,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE;YACtC,GAAG,MAAM,CAAC,OAAO;YACjB,GAAG,OAAO;SACX,CAAC,CAAC;IACP,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1E,IAAI,CAAC;QACH,OAAO,MAAM,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;YAC1D,KAAK;YACL,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,OAAgD;IAEhD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE;QAC/C,GAAG,OAAO;QACV,IAAI,EAAE,YAAY;KACnB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,CACL,KAAK,IAAI;QACP,MAAM,EAAE,KAAK,CAAC,MAAyC;QACvD,MAAM,EAAE,KAAK,CAAC,MAAyC;QACvD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAyB,EACzB,OAAgD;IAEhD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE;QAC/C,GAAG,OAAO;QACV,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,CACL,KAAK,IAAI;QACP,MAAM,EAAE,KAAK,CAAC,MAAoC;QAClD,MAAM,EAAE,KAAK,CAAC,MAAoC;QAClD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CACF,CAAC;AACJ,CAAC"}

package/dist/database/types.d.ts

@@ -0,0 +1,92 @@
+import type { AnyConnectionConfig, ChecksumMismatchPolicy, CollectionMetadataStore, CollectionMetadataStoreConfig, ConnectionConfig, ConnectionConfigFromDrivers, DatabaseConfigFromDrivers, DatabaseDriverRegistration, ExtensibleDatabaseConfig, MigrationSource, SeedSource } from '@nocobase/db';
+/**
+ * A metadata store as an application may configure it: the instance, the
+ * declarative form `@nocobase/db` understands, or — the form `config.yml` can
+ * carry — the collections directory alone. Relative directories resolve
+ * against the application root.
+ */
+export type AppMetadataStoreConfig = string | CollectionMetadataStoreConfig | CollectionMetadataStore;
+/**
+ * Application configuration over dialect-independent connections by default.
+ * Supply a dialect's connection type for explicit checking, or use
+ * `AppDatabaseConfigFromDrivers` to infer it from registered drivers.
+ */
+export interface AppDatabaseConfig<TConnection extends AnyConnectionConfig = ConnectionConfig> extends Omit<ExtensibleDatabaseConfig<TConnection>, 'connections' | 'metadataStore'> {
+    connections: Record<string, AppDatabaseConnectionConfig<TConnection>>;
+    metadataStore?: AppMetadataStoreConfig;
+    /** @deprecated Configure tasks on connections instead. Applies to the default connection. */
+    migrations?: Partial<AppDatabaseMigrationConfig>;
+    /** @deprecated Configure tasks on connections instead. Applies to the default connection. */
+    seeds?: Partial<AppDatabaseSeedConfig>;
+}
+/**
+ * Infer accepted dialects and their connection fields from the installed drivers.
+ * `defineAppDatabaseConfig` infers this type from a callback's returned drivers.
+ * Use this alias when an explicit annotation is needed outside that helper.
+ */
+export type AppDatabaseConfigFromDrivers<TDrivers extends Record<string, DatabaseDriverRegistration>> = Omit<AppDatabaseConfig<ConnectionConfigFromDrivers<TDrivers>>, 'drivers'> & {
+    drivers: DatabaseConfigFromDrivers<TDrivers>['drivers'];
+};
+/**
+ * Runtime facts that task planning needs and configuration cannot supply: the
+ * application's own package identity, and the migration and seed directories
+ * contributed by its server plugins.
+ *
+ * These are derived from resolved plugins rather than configured, so they are
+ * passed alongside the configuration instead of being merged into it — a value
+ * inside the `database` namespace can be overwritten from `config.yml`, and
+ * silently dropping a plugin's migrations is not a configurable outcome.
+ */
+export interface AppDatabaseTaskContributions {
+    readonly appPackageName: string;
+    readonly migrations: readonly MigrationSource[];
+    readonly seeds: readonly SeedSource[];
+}
+export interface AppDatabaseMigrationConfig {
+    directory: string;
+    packageName?: string;
+    autoRun: boolean;
+    sources?: readonly MigrationSource[];
+    tableName?: string;
+    lockTableName?: string;
+    extensions?: readonly string[];
+    /**
+     * How to react when an executed migration's source no longer hashes to the
+     * checksum recorded for it. `warn` (the default) reports the drift and
+     * continues; `error` refuses to run until `nocobase db repair` realigns the
+     * history. A migration the sources cannot explain at all always fails.
+     */
+    onChecksumMismatch?: ChecksumMismatchPolicy;
+}
+export interface AppDatabaseSeedConfig {
+    directory: string;
+    packageName?: string;
+    autoRun: boolean;
+    sources?: readonly SeedSource[];
+    tableName?: string;
+    lockTableName?: string;
+    extensions?: readonly string[];
+    /**
+     * How to react when an executed seed's source no longer hashes to the
+     * checksum recorded for it. `warn` (the default) reports the drift and
+     * continues; `error` refuses to run until `nocobase db repair` realigns the
+     * history.
+     */
+    onChecksumMismatch?: ChecksumMismatchPolicy;
+}
+/** `Omit` over a union keeps only the common keys; distribute it so each dialect keeps its own. */
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+export type AppDatabaseConnectionConfig<TConnection extends AnyConnectionConfig = ConnectionConfig> = DistributiveOmit<TConnection, 'metadataStore'> & {
+    migrations?: Partial<AppDatabaseMigrationConfig>;
+    seeds?: Partial<AppDatabaseSeedConfig>;
+    /**
+     * Where supplemental metadata comes from. An `external` connection that
+     * sets nothing here or at the top level reads the hand-written
+     * `database/<connection>/metadata/<name>.json` files. A string is a
+     * directory in that layout, relative to the application root; it may not
+     * be a generated `collections/` directory.
+     */
+    metadataStore?: AppMetadataStoreConfig;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/database/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/database/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":""}

package/dist/drive/config.d.ts

@@ -0,0 +1,2 @@
+export type { AppDriveConfig } from '@nocobase/drive';
+//# sourceMappingURL=config.d.ts.map

package/dist/drive/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/drive/config.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/drive/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/drive/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/drive/config.ts"],"names":[],"mappings":""}