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

package/dist/database/collections-artifact.js

@@ -0,0 +1,397 @@
+import { resolveDatabaseConfig } from './resolve-config.js';
+import { mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
+import path from 'node:path';
+import { assertCollectionArtifactDirectoryNames, COLLECTION_ARTIFACT_FILE_NAMES, COLLECTION_ARTIFACT_MANIFEST_FILE_NAME, DirectoryCollectionMetadataStore, serializeCollectionArtifact, serializeCollectionArtifactManifest, } from '@nocobase/db';
+import { isCollectionMetadataStoreInstance, isAppCollectionsDirectory, resolveAppCollectionsDirectory, resolveAppMetadataStore, } from './collections-directory.js';
+import { createAppDatabaseManager } from './manager.js';
+import { selectAppDatabaseConnections } from './connection-selection.js';
+import { planAppDatabaseTasks } from './plan.js';
+const STAGING_PREFIX = '.staging-';
+const FILE_KINDS = [
+    'collection',
+    'metadata',
+    'schema',
+];
+const FILE_NAME_KINDS = new Map(FILE_KINDS.map((kind) => [COLLECTION_ARTIFACT_FILE_NAMES[kind], kind]));
+export async function generateAppCollectionsArtifact(config, options = {}) {
+    const check = options.check ?? false;
+    const names = selectAppDatabaseConnections(config, options);
+    if (names === undefined) {
+        return { ok: true, status: 'not-configured', check, results: [] };
+    }
+    if (!options.database) {
+        config = await resolveDatabaseConfig({
+            ...config,
+            drivers: { ...config.drivers, ...options.drivers },
+        });
+    }
+    const database = options.database ??
+        createAppDatabaseManager(config, options.paths, options.drivers);
+    if (!database) {
+        return { ok: true, status: 'not-configured', check, results: [] };
+    }
+    const results = [];
+    try {
+        for (const name of names) {
+            const directory = resolveAppCollectionsDirectory(name, options.paths);
+            try {
+                results.push(await generateForConnection(database.connection(name), directory, {
+                    check,
+                    metadataDirectory: metadataDirectoryOf(config, name, options.paths),
+                    migrationHead: () => readMigrationHead(database, config, name, options),
+                }));
+            }
+            catch (error) {
+                results.push({
+                    connection: name,
+                    directory,
+                    status: 'failed',
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    finally {
+        if (!options.database)
+            await database.destroy();
+    }
+    const status = results.some((entry) => entry.status === 'failed')
+        ? 'failed'
+        : results.some((entry) => entry.status === 'stale')
+            ? 'stale'
+            : 'completed';
+    return { ok: status === 'completed', status, check, results };
+}
+/**
+ * Mirrors the selection rules of `planAppDatabaseTasks` so the two commands
+ * read the same flags the same way — except that external connections take
+ * part: their schema is owned elsewhere, but a snapshot of what it resolves to
+ * is exactly what a reader without database access needs from them.
+ */
+/**
+ * The history table name is part of a connection's migration configuration,
+ * which planning already resolves — including the legacy top-level form. Ask
+ * the planner rather than duplicating that resolution here, but ask it about
+ * this one connection: planning validates what it plans, and a misconfigured
+ * connection nobody selected must not fail a run that never touches it. An
+ * external connection has no history table at all, so it is not planned.
+ */
+async function readMigrationHead(database, config, name, options) {
+    if (config.connections[name].schemaManagement === 'external')
+        return null;
+    const [task] = planAppDatabaseTasks(config, ['migrations'], {
+        contributions: { appPackageName: 'app', migrations: [], seeds: [] },
+        paths: options.paths,
+        drivers: options.drivers,
+        connection: name,
+    });
+    const history = await database
+        .createMigrator({
+        connection: name,
+        tableName: task?.config.tableName,
+        sources: [],
+    })
+        .history();
+    return history.at(-1)?.name ?? null;
+}
+/**
+ * The directory a connection's metadata store reads hand-written documents
+ * from, if it is a directory store. Such a directory must never be a generated
+ * collections directory — the generator rewrites and deletes files there — so
+ * a store configured onto one is refused before anything is written.
+ */
+function metadataDirectoryOf(config, name, paths) {
+    const connection = config.connections[name];
+    const store = resolveAppMetadataStore(connection.metadataStore, {
+        name,
+        external: connection.schemaManagement === 'external',
+        shared: config.metadataStore,
+        paths,
+    });
+    if (store === undefined ||
+        isCollectionMetadataStoreInstance(store) ||
+        store.type !== 'directory') {
+        return undefined;
+    }
+    if (isAppCollectionsDirectory(store.directory, paths)) {
+        throw new Error(`Connection "${name}" reads metadata from ${store.directory}, which is a generated collections directory. Keep hand-written metadata in database/<connection>/metadata/ as one <name>.json per Collection and point metadataStore there.`);
+    }
+    return path.resolve(store.directory);
+}
+async function generateForConnection(connection, directory, options) {
+    const names = [];
+    for await (const collection of connection.collections.scan()) {
+        if (collection.name)
+            names.push(collection.name);
+    }
+    names.sort();
+    assertCollectionArtifactDirectoryNames(names);
+    const expected = new Map();
+    const perCollection = new Map();
+    for (const name of names) {
+        const [resolution, physical, stored] = await Promise.all([
+            connection.collections.getResolution(name),
+            connection.collections.getPhysical(name),
+            connection.collectionMetadata.get(name),
+        ]);
+        if (!resolution || !physical) {
+            throw new Error(`Collection "${name}" disappeared while its artifact was being generated.`);
+        }
+        const files = serializeCollectionArtifact({
+            name,
+            resolution,
+            physical,
+            metadata: stored?.document,
+        });
+        const own = new Map();
+        for (const kind of FILE_KINDS) {
+            const relative = path.posix.join(name, COLLECTION_ARTIFACT_FILE_NAMES[kind]);
+            own.set(relative, files[kind]);
+            expected.set(relative, files[kind]);
+        }
+        perCollection.set(name, own);
+    }
+    const manifest = {
+        dialect: connection.dialect,
+        schemaManagement: connection.schemaManagement,
+        migrationHead: await options.migrationHead(),
+        collections: names,
+    };
+    expected.set(COLLECTION_ARTIFACT_MANIFEST_FILE_NAME, serializeCollectionArtifactManifest({
+        connection: connection.name,
+        ...manifest,
+    }));
+    const disk = readDirectory(directory);
+    const differences = diff(expected, disk);
+    const unusedMetadata = options.metadataDirectory === undefined
+        ? undefined
+        : await unusedMetadataIn(options.metadataDirectory, names);
+    const base = {
+        connection: connection.name,
+        directory,
+        manifest,
+        ...(unusedMetadata?.length ? { unusedMetadata } : {}),
+    };
+    if (options.check) {
+        return {
+            ...base,
+            status: differences.length === 0 ? 'completed' : 'stale',
+            directoryExists: disk.exists,
+            differences,
+            unchanged: countUnchanged(perCollection, differences),
+        };
+    }
+    if (disk.unexpected.length > 0) {
+        throw new Error(`Unexpected entries in ${directory}; remove them or move them out of the collections directory: ${disk.unexpected.join(', ')}.`);
+    }
+    const changed = new Set(differences
+        .filter((entry) => entry.kind !== 'unexpected')
+        .map((entry) => entry.path.split('/')[0]));
+    const written = [];
+    const deleted = [];
+    mkdirSync(directory, { recursive: true });
+    removeStaleStaging(directory);
+    const staging = mkdtempSync(path.join(directory, STAGING_PREFIX));
+    try {
+        for (const [name, files] of perCollection) {
+            if (!changed.has(name))
+                continue;
+            const stagingDirectory = path.join(staging, name);
+            mkdirSync(stagingDirectory);
+            for (const [relative, content] of files) {
+                writeFileSync(path.join(staging, relative), content);
+                written.push(relative);
+            }
+            const target = path.join(directory, name);
+            rmSync(target, { recursive: true, force: true });
+            renameSync(stagingDirectory, target);
+        }
+        for (const name of disk.collections) {
+            if (perCollection.has(name))
+                continue;
+            for (const relative of disk.files.keys()) {
+                if (relative.startsWith(`${name}/`))
+                    deleted.push(relative);
+            }
+            rmSync(path.join(directory, name), { recursive: true, force: true });
+        }
+        if (changed.has(COLLECTION_ARTIFACT_MANIFEST_FILE_NAME)) {
+            const stagingManifest = path.join(staging, COLLECTION_ARTIFACT_MANIFEST_FILE_NAME);
+            writeFileSync(stagingManifest, expected.get(COLLECTION_ARTIFACT_MANIFEST_FILE_NAME));
+            renameSync(stagingManifest, path.join(directory, COLLECTION_ARTIFACT_MANIFEST_FILE_NAME));
+            written.push(COLLECTION_ARTIFACT_MANIFEST_FILE_NAME);
+        }
+    }
+    finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
+    return {
+        ...base,
+        status: 'completed',
+        written: written.sort(),
+        deleted: deleted.sort(),
+        unchanged: countUnchanged(perCollection, differences),
+    };
+}
+async function unusedMetadataIn(directory, collections) {
+    const present = new Set(collections);
+    const store = new DirectoryCollectionMetadataStore({ directory });
+    const unused = [];
+    let cursor;
+    do {
+        const page = await store.list(cursor === undefined ? {} : { cursor });
+        for (const item of page.items) {
+            if (!present.has(item.name))
+                unused.push(item.name);
+        }
+        cursor = page.nextCursor;
+    } while (cursor !== undefined);
+    return unused.sort();
+}
+/**
+ * Dot-prefixed entries are ignored rather than reported: editors and operating
+ * systems drop them everywhere, and the generator's own staging directories
+ * use the prefix too.
+ */
+function readDirectory(directory) {
+    const files = new Map();
+    const collections = [];
+    const unexpected = [];
+    let entries;
+    try {
+        entries = readdirSync(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return { exists: false, files, collections, unexpected };
+        }
+        throw error;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        if (entry.isFile() &&
+            entry.name === COLLECTION_ARTIFACT_MANIFEST_FILE_NAME) {
+            files.set(entry.name, readFileSync(path.join(directory, entry.name), 'utf8'));
+            continue;
+        }
+        if (!entry.isDirectory() || entry.name.startsWith('_')) {
+            unexpected.push(entry.name);
+            continue;
+        }
+        collections.push(entry.name);
+        const collectionDirectory = path.join(directory, entry.name);
+        for (const child of readdirSync(collectionDirectory, {
+            withFileTypes: true,
+        })) {
+            if (child.name.startsWith('.'))
+                continue;
+            const relative = path.posix.join(entry.name, child.name);
+            if (child.isFile() && FILE_NAME_KINDS.has(child.name)) {
+                files.set(relative, readFileSync(path.join(collectionDirectory, child.name), 'utf8'));
+            }
+            else {
+                unexpected.push(relative);
+            }
+        }
+    }
+    return {
+        exists: true,
+        files,
+        collections: collections.sort(),
+        unexpected: unexpected.sort(),
+    };
+}
+function diff(expected, disk) {
+    const differences = [];
+    for (const [relative, content] of expected) {
+        const current = disk.files.get(relative);
+        if (current === undefined)
+            differences.push({ path: relative, kind: 'missing' });
+        else if (current !== content)
+            differences.push({ path: relative, kind: 'stale' });
+    }
+    for (const relative of disk.files.keys()) {
+        if (!expected.has(relative))
+            differences.push({ path: relative, kind: 'unexpected' });
+    }
+    for (const relative of disk.unexpected) {
+        differences.push({ path: relative, kind: 'unexpected' });
+    }
+    return differences.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+}
+function countUnchanged(perCollection, differences) {
+    const touched = new Set(differences.map((entry) => entry.path.split('/')[0]));
+    let unchanged = 0;
+    for (const name of perCollection.keys())
+        if (!touched.has(name))
+            unchanged += 1;
+    return unchanged;
+}
+function removeStaleStaging(directory) {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+        if (entry.isDirectory() && entry.name.startsWith(STAGING_PREFIX)) {
+            rmSync(path.join(directory, entry.name), {
+                recursive: true,
+                force: true,
+            });
+        }
+    }
+}
+/**
+ * Regenerates the Collection cache of every connection whose schema a
+ * database run changed: migrations executed, rolled back, or rebuilt from
+ * empty. Seeds write rows, never structure, and a preview changes nothing, so
+ * neither triggers a refresh. Returns `undefined` when nothing changed.
+ *
+ * A failure is reported in the result, never raised: the migrations it
+ * follows are already committed, and the cache can always be rebuilt with
+ * `collections generate`.
+ */
+export async function refreshAppCollectionsArtifact(config, result, options) {
+    const names = new Set();
+    for (const entry of result.results) {
+        if (entry.kind === 'migrations' &&
+            entry.status === 'completed' &&
+            !entry.dryRun &&
+            (entry.fresh ||
+                (entry.executed?.length ?? 0) > 0 ||
+                (entry.rolledBack?.length ?? 0) > 0)) {
+            names.add(entry.connection);
+        }
+    }
+    if (names.size === 0)
+        return undefined;
+    const refreshed = [];
+    for (const connection of names) {
+        try {
+            const outcome = await generateAppCollectionsArtifact(config, {
+                paths: options.paths,
+                database: options.database,
+                connection,
+            });
+            const entry = outcome.results[0];
+            refreshed.push(entry?.status === 'completed'
+                ? {
+                    connection,
+                    status: 'completed',
+                    written: entry.written ?? [],
+                    deleted: entry.deleted ?? [],
+                }
+                : {
+                    connection,
+                    status: 'failed',
+                    error: entry?.error ?? 'No Collection cache was generated.',
+                });
+        }
+        catch (error) {
+            refreshed.push({
+                connection,
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return refreshed;
+}
+//# sourceMappingURL=collections-artifact.js.map

package/dist/database/collections-artifact.js.map

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

package/dist/database/collections-directory.d.ts

@@ -0,0 +1,36 @@
+import type { CollectionMetadataStore, CollectionMetadataStoreConfig } from '@nocobase/db';
+import type { AppPaths } from '../config/index.js';
+import type { AppMetadataStoreConfig } from './types.js';
+/**
+ * Where a connection's generated Collection artifacts live:
+ * `database/<connection>/collections`, next to its `migrations` and `seeds`.
+ * Everything under it is a cache the generator owns, for every connection.
+ */
+export declare function resolveAppCollectionsDirectory(name: string, paths?: AppPaths): string;
+/**
+ * Where a connection's hand-written Collection metadata lives by default:
+ * `database/<connection>/metadata`, one `<name>.json` per Collection. It is
+ * the source an external connection's metadata store reads, and is committed.
+ * Kept apart from `collections/` so a directory is either written by people
+ * or generated, never both.
+ */
+export declare function resolveAppMetadataDirectory(name: string, paths?: AppPaths): string;
+/** Whether `directory` is, or lies inside, a connection's generated collections directory. */
+export declare function isAppCollectionsDirectory(directory: string, paths?: AppPaths): boolean;
+export interface ResolveAppMetadataStoreOptions {
+    readonly name: string;
+    readonly external: boolean;
+    /** The top-level `database.metadataStore`, which a connection without its own falls back to. */
+    readonly shared?: AppMetadataStoreConfig;
+    readonly paths?: AppPaths;
+}
+/**
+ * Turns the application-level forms into what `createDatabaseManager` takes:
+ * a string becomes a directory store on that path, a relative directory is
+ * resolved against the application root, and an external connection with no
+ * store at either level gets one on its own metadata directory. A store
+ * instance and a managed connection without configuration pass through.
+ */
+export declare function resolveAppMetadataStore(value: AppMetadataStoreConfig | undefined, options: ResolveAppMetadataStoreOptions): CollectionMetadataStore | CollectionMetadataStoreConfig | undefined;
+export declare function isCollectionMetadataStoreInstance(value: unknown): value is CollectionMetadataStore;
+//# sourceMappingURL=collections-directory.d.ts.map

package/dist/database/collections-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections-directory.d.ts","sourceRoot":"","sources":["../../src/database/collections-directory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,QAAQ,GACf,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,QAAQ,GACf,MAAM,CAER;AAED,8FAA8F;AAC9F,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,QAAQ,GACf,OAAO,CAIT;AAMD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAAG,SAAS,EACzC,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,GAAG,6BAA6B,GAAG,SAAS,CAgBrE;AA0DD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAElC"}

package/dist/database/collections-directory.js

@@ -0,0 +1,115 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Where a connection's generated Collection artifacts live:
+ * `database/<connection>/collections`, next to its `migrations` and `seeds`.
+ * Everything under it is a cache the generator owns, for every connection.
+ */
+export function resolveAppCollectionsDirectory(name, paths) {
+    return path.join(databaseRoot(paths), name, 'collections');
+}
+/**
+ * Where a connection's hand-written Collection metadata lives by default:
+ * `database/<connection>/metadata`, one `<name>.json` per Collection. It is
+ * the source an external connection's metadata store reads, and is committed.
+ * Kept apart from `collections/` so a directory is either written by people
+ * or generated, never both.
+ */
+export function resolveAppMetadataDirectory(name, paths) {
+    return path.join(databaseRoot(paths), name, 'metadata');
+}
+/** Whether `directory` is, or lies inside, a connection's generated collections directory. */
+export function isAppCollectionsDirectory(directory, paths) {
+    const relative = path.relative(databaseRoot(paths), path.resolve(directory));
+    if (relative.startsWith('..') || path.isAbsolute(relative))
+        return false;
+    return relative.split(path.sep)[1] === 'collections';
+}
+function databaseRoot(paths) {
+    return paths?.database() ?? path.resolve('database');
+}
+/**
+ * Turns the application-level forms into what `createDatabaseManager` takes:
+ * a string becomes a directory store on that path, a relative directory is
+ * resolved against the application root, and an external connection with no
+ * store at either level gets one on its own metadata directory. A store
+ * instance and a managed connection without configuration pass through.
+ */
+export function resolveAppMetadataStore(value, options) {
+    if (value === undefined) {
+        if (options.external && options.shared === undefined) {
+            assertNoLegacyCollectionMetadata(options.name, options.paths);
+            return {
+                type: 'directory',
+                directory: resolveAppMetadataDirectory(options.name, options.paths),
+            };
+        }
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        return { type: 'directory', directory: resolveRoot(value, options.paths) };
+    }
+    if (isStoreInstance(value))
+        return value;
+    return { ...value, directory: resolveRoot(value.directory, options.paths) };
+}
+/**
+ * Earlier releases kept an external connection's hand-written metadata inside
+ * its collections directory, as `collections/<name>/metadata.json`. Reading
+ * the new default directory instead would find nothing and resolve every
+ * Collection without its titles and relations, so the old layout is refused
+ * with the move spelled out. It is recognised by what the generator never
+ * writes: a collections directory whose manifest is missing or does not say
+ * `generated`, holding a `metadata.json` with a document in it.
+ */
+function assertNoLegacyCollectionMetadata(name, paths) {
+    if (existsSync(resolveAppMetadataDirectory(name, paths)))
+        return;
+    const collections = resolveAppCollectionsDirectory(name, paths);
+    if (!existsSync(collections) || isGeneratedDirectory(collections))
+        return;
+    const legacy = readdirSync(collections, { withFileTypes: true }).filter((entry) => entry.isDirectory() &&
+        !entry.name.startsWith('.') &&
+        !entry.name.startsWith('_') &&
+        holdsMetadataDocument(path.join(collections, entry.name, 'metadata.json')));
+    if (legacy.length === 0)
+        return;
+    throw new Error(`Connection "${name}" keeps hand-written metadata in the old location, ${path.join(collections, legacy[0].name, 'metadata.json')}. Move each file's "document" to database/${name}/metadata/<name>.json, delete ${collections}, and run "nocobase collections generate --connection ${name}" to rebuild the cache.`);
+}
+function isGeneratedDirectory(directory) {
+    const manifest = path.join(directory, '_manifest.json');
+    if (!existsSync(manifest))
+        return false;
+    try {
+        return (JSON.parse(readFileSync(manifest, 'utf8'))
+            .generated === true);
+    }
+    catch {
+        return false;
+    }
+}
+function holdsMetadataDocument(file) {
+    if (!existsSync(file))
+        return false;
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return parsed.document !== null && parsed.document !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+export function isCollectionMetadataStoreInstance(value) {
+    return isStoreInstance(value);
+}
+function isStoreInstance(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.initialize === 'function');
+}
+function resolveRoot(directory, paths) {
+    return path.isAbsolute(directory)
+        ? directory
+        : path.resolve(paths?.root() ?? process.cwd(), directory);
+}
+//# sourceMappingURL=collections-directory.js.map

package/dist/database/collections-directory.js.map

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

package/dist/database/collections-doctor.d.ts

@@ -0,0 +1,43 @@
+import type { CollectionDiagnosisIssue, DatabaseDriverRegistration, DatabaseManager } from '@nocobase/db';
+import type { AppPaths } from '../config/index.js';
+import type { AppDatabaseConfig } from './types.js';
+export interface AppCollectionsDoctorOptions {
+    readonly paths?: AppPaths;
+    readonly drivers?: Record<string, DatabaseDriverRegistration>;
+    /** One connection; defaults to the default connection. Exclusive with `all`. */
+    readonly connection?: string;
+    /** Every configured connection, external ones included. */
+    readonly all?: boolean;
+    /** Delete the metadata records whose tables are missing. */
+    readonly fix?: boolean;
+    /** Reuse an open manager instead of creating and destroying one. */
+    readonly database?: DatabaseManager;
+}
+export interface AppCollectionsDoctorConnectionResult {
+    readonly connection: string;
+    readonly status: 'completed' | 'failed';
+    /** Metadata records examined. */
+    readonly checked?: number;
+    readonly issues?: readonly CollectionDiagnosisIssue[];
+    /** Records deleted, which `fix` does for orphaned ones alone. */
+    readonly repaired?: readonly string[];
+    readonly error?: string;
+}
+export interface AppCollectionsDoctorResult {
+    readonly ok: boolean;
+    readonly status: 'completed' | 'failed' | 'not-configured';
+    readonly fix: boolean;
+    readonly results: readonly AppCollectionsDoctorConnectionResult[];
+}
+/**
+ * Compares each connection's stored Collection metadata with the physical
+ * schema behind it, and optionally deletes the records whose tables are gone.
+ *
+ * The two are separate records of what exists. A table dropped outside a
+ * migration leaves its metadata record behind, and from then on resolving that
+ * Collection fails — including inside the migration that would recreate it.
+ * That state is reachable by hand, so there has to be a way out of it that is
+ * not "edit the internal table yourself".
+ */
+export declare function runAppCollectionsDoctor(config: AppDatabaseConfig, options?: AppCollectionsDoctorOptions): Promise<AppCollectionsDoctorResult>;
+//# sourceMappingURL=collections-doctor.d.ts.map

package/dist/database/collections-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections-doctor.d.ts","sourceRoot":"","sources":["../../src/database/collections-doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC9D,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACrC;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC3D,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,oCAAoC,EAAE,CAAC;CACnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CA2CrC"}