ormbridge 0.0.0-stage → 0.2.0

package/dist/cliRunner.js

@@ -0,0 +1,343 @@
+import { createRequire } from 'node:module';
+import { extname, isAbsolute, relative, resolve } from 'node:path';
+import { Command, CommanderError } from 'commander';
+import { findConfigFile, loadConfigFile, } from './config.js';
+import { PRISMA_PROVIDERS } from './emitters/prisma.js';
+import { describeFormats, getFormat, getFormatByExtension, listFormatNames, listFormats, } from './formats.js';
+import { countLines, runConversion, } from './io.js';
+/** Exit codes of the `ormbridge` command. */
+export const EXIT_OK = 0;
+/** A conversion failed: unreadable input, parse error, unwritable output. */
+export const EXIT_CONVERSION_ERROR = 1;
+/** The command line or the config file is invalid. */
+export const EXIT_USAGE_ERROR = 2;
+/** `--check` found an output file that is stale or missing. */
+export const EXIT_CHECK_FAILED = 3;
+function readPackageVersion() {
+    const requireFromHere = createRequire(import.meta.url);
+    const packageJson = requireFromHere('../package.json');
+    return packageJson.version ?? '0.0.0';
+}
+function inferFormatFromPath(filePath) {
+    if (filePath === undefined) {
+        return undefined;
+    }
+    const adapter = getFormatByExtension(extname(filePath));
+    return adapter?.name;
+}
+function failure(code, message) {
+    return { ok: false, error: { code, message } };
+}
+/** Validates merged settings and builds the options for one conversion. */
+function buildRunOptions(settings, mode) {
+    const inputs = settings.input ?? [];
+    if (inputs.length === 0) {
+        return failure('INVALID_OPTION', 'No input was given. Pass -i/--input, or set "input" in the config file.');
+    }
+    if (mode === 'check' && settings.output === undefined) {
+        return failure('INVALID_OPTION', '--check compares the conversion with an existing output, so an output path is required. Pass -o/--output, or set "output" in the config file.');
+    }
+    const fromValue = settings.from ?? inferFormatFromPath(inputs[0]) ?? 'django';
+    if (!getFormat(fromValue).ok) {
+        return failure('INVALID_OPTION', `Invalid --from value "${fromValue}". Expected one of: ${listFormatNames().join(', ')}.`);
+    }
+    const toValue = settings.to ??
+        inferFormatFromPath(settings.output) ??
+        (fromValue === 'django' ? 'prisma' : 'django');
+    if (!getFormat(toValue).ok) {
+        return failure('INVALID_OPTION', `Invalid --to value "${toValue}". Expected one of: ${listFormatNames().join(', ')}.`);
+    }
+    const namingValue = settings.naming ?? 'preserve';
+    if (namingValue !== 'preserve' && namingValue !== 'normalize') {
+        return failure('INVALID_OPTION', `Invalid --naming value "${namingValue}". Expected "preserve" or "normalize".`);
+    }
+    const naming = namingValue;
+    const providerValue = settings.provider ?? 'postgresql';
+    if (!PRISMA_PROVIDERS.includes(providerValue)) {
+        return failure('INVALID_OPTION', `Invalid --provider value "${providerValue}". Expected one of: ${PRISMA_PROVIDERS.join(', ')}.`);
+    }
+    const provider = providerValue;
+    const autoFieldValue = (settings.autoField ?? 'int').toLowerCase();
+    if (autoFieldValue !== 'int' && autoFieldValue !== 'bigint') {
+        return failure('INVALID_OPTION', `Invalid --auto-field value "${settings.autoField ?? ''}". Expected "int" or "bigint".`);
+    }
+    return {
+        ok: true,
+        value: {
+            from: fromValue,
+            to: toValue,
+            naming,
+            provider,
+            header: settings.header ?? true,
+            autoField: autoFieldValue === 'bigint' ? 'bigInt' : 'int',
+            inputs,
+            dryRun: mode === 'dry-run',
+            check: mode === 'check',
+            ...(settings.output === undefined ? {} : { output: settings.output }),
+            ...(settings.appLabel === undefined
+                ? {}
+                : { appLabel: settings.appLabel }),
+            ...(settings.namespace === undefined
+                ? {}
+                : { namespace: settings.namespace }),
+        },
+    };
+}
+/** Finds and loads the config file according to --config / --no-config. */
+async function resolveConfig(flags, env) {
+    if (flags.config === false) {
+        return { ok: true, value: undefined };
+    }
+    if (typeof flags.config === 'string') {
+        return loadConfigFile(resolve(env.cwd, flags.config));
+    }
+    const found = await findConfigFile(env.cwd);
+    if (found === undefined) {
+        return { ok: true, value: undefined };
+    }
+    return loadConfigFile(found);
+}
+/**
+ * Merges the config file and the flags into the conversions to run. Flags
+ * override config values. With no -i and a config that lists `conversions`,
+ * every listed conversion runs.
+ */
+function planRuns(flags, headerFromFlag, config, env, mode) {
+    const useConversionList = config !== undefined &&
+        config.conversions.length > 0 &&
+        flags.input === undefined;
+    const entries = config === undefined
+        ? [{}]
+        : useConversionList
+            ? config.conversions.map((conversion) => ({
+                ...config.defaults,
+                ...conversion,
+            }))
+            : [config.defaults];
+    if (entries.length > 1 && flags.output !== undefined) {
+        return failure('INVALID_OPTION', `--output cannot be combined with the ${entries.length} conversions in the config file, because they would all write to the same path. Remove -o, or pass -i to run a single conversion.`);
+    }
+    const runs = [];
+    for (const [index, entry] of entries.entries()) {
+        const label = entries.length === 1 ? undefined : (entry.name ?? `#${index + 1}`);
+        const settings = { ...entry };
+        if (flags.input !== undefined) {
+            settings.input = flags.input.map((path) => resolve(env.cwd, path));
+        }
+        if (flags.output !== undefined) {
+            settings.output = resolve(env.cwd, flags.output);
+        }
+        if (flags.from !== undefined) {
+            settings.from = flags.from;
+        }
+        if (flags.to !== undefined) {
+            settings.to = flags.to;
+        }
+        if (flags.naming !== undefined) {
+            settings.naming = flags.naming;
+        }
+        if (flags.provider !== undefined) {
+            settings.provider = flags.provider;
+        }
+        if (headerFromFlag !== undefined) {
+            settings.header = headerFromFlag;
+        }
+        if (flags.appLabel !== undefined) {
+            settings.appLabel = flags.appLabel;
+        }
+        if (flags.autoField !== undefined) {
+            settings.autoField = flags.autoField;
+        }
+        if (flags.namespace !== undefined) {
+            settings.namespace = flags.namespace;
+        }
+        const options = buildRunOptions(settings, mode);
+        if (!options.ok) {
+            const where = label === undefined ? '' : `conversion ${label}: `;
+            return failure('INVALID_OPTION', `${where}${options.error.message}`);
+        }
+        runs.push({ label, options: options.value });
+    }
+    return { ok: true, value: runs };
+}
+function formatBytes(bytes) {
+    return bytes < 1024 ? `${bytes} B` : `${(bytes / 1024).toFixed(1)} KB`;
+}
+function describeFile(file) {
+    return `${file.lines} line(s), ${formatBytes(file.bytes)}`;
+}
+/** Shows a path relative to the working directory when it is inside it. */
+function displayPath(path, cwd) {
+    const relativePath = relative(cwd, path);
+    return relativePath !== '' &&
+        !relativePath.startsWith('..') &&
+        !isAbsolute(relativePath)
+        ? relativePath
+        : path;
+}
+/** Prints the result of one conversion. Returns true when --check found it stale. */
+function report(run, summary, mode, env) {
+    const prefix = run.label === undefined ? '' : `[${run.label}] `;
+    const options = run.options;
+    for (const warning of summary.warnings) {
+        env.stderr(`${prefix}warning: ${warning}\n`);
+    }
+    const description = `${summary.modelCount} model(s) from ${summary.inputFiles.length} file(s) ` +
+        `(${options.from} -> ${options.to})`;
+    if (summary.outputPath === undefined) {
+        if (mode === 'dry-run') {
+            env.stderr(`${prefix}Dry run: converted ${description}; the result would be printed to stdout (${countLines(summary.output)} line(s)).\n`);
+        }
+        else {
+            env.stdout(summary.output);
+        }
+        return false;
+    }
+    let stale = false;
+    if (mode === 'check') {
+        for (const file of summary.plannedFiles) {
+            const path = displayPath(file.path, env.cwd);
+            if (file.state === 'unchanged') {
+                env.stderr(`${prefix}up to date: ${path}\n`);
+            }
+            else {
+                stale = true;
+                env.stderr(file.state === 'created'
+                    ? `${prefix}error: ${path} is missing; the conversion would create it (${describeFile(file)}).\n`
+                    : `${prefix}error: ${path} is out of date: ${file.diff ?? 'contents differ'}.\n`);
+            }
+        }
+        return stale;
+    }
+    const heading = mode === 'dry-run'
+        ? `Dry run, nothing written: ${description}`
+        : `Converted ${description}`;
+    env.stderr(`${prefix}${heading}\n`);
+    for (const file of summary.plannedFiles) {
+        const path = displayPath(file.path, env.cwd);
+        const verb = file.state === 'unchanged'
+            ? 'unchanged'
+            : mode === 'dry-run'
+                ? file.state === 'created'
+                    ? 'would create'
+                    : 'would update'
+                : file.state === 'created'
+                    ? 'created'
+                    : 'updated';
+        const detail = file.diff === undefined
+            ? describeFile(file)
+            : `${describeFile(file)}; ${file.diff}`;
+        env.stderr(`${prefix}  ${verb} ${path} (${detail})\n`);
+    }
+    return false;
+}
+async function handleConvert(flags, headerFromFlag, env) {
+    const usageError = (message) => {
+        env.stderr(`error [USAGE]: ${message}\n`);
+        return EXIT_USAGE_ERROR;
+    };
+    if (flags.check === true && flags.dryRun === true) {
+        return usageError('--check and --dry-run cannot be combined: --check already writes nothing.');
+    }
+    const mode = flags.check === true
+        ? 'check'
+        : flags.dryRun === true
+            ? 'dry-run'
+            : 'write';
+    const config = await resolveConfig(flags, env);
+    if (!config.ok) {
+        return usageError(config.error.message);
+    }
+    const runs = planRuns(flags, headerFromFlag, config.value, env, mode);
+    if (!runs.ok) {
+        return usageError(runs.error.message);
+    }
+    if (config.value !== undefined && runs.value.length > 1) {
+        env.stderr(`Using ${displayPath(config.value.path, env.cwd)}: ${runs.value.length} conversions\n`);
+    }
+    let failedConversions = 0;
+    let staleOutputs = 0;
+    for (const run of runs.value) {
+        const prefix = run.label === undefined ? '' : `[${run.label}] `;
+        const summary = await runConversion(run.options);
+        if (!summary.ok) {
+            env.stderr(`${prefix}error [${summary.error.code}]: ${summary.error.message}\n`);
+            failedConversions += 1;
+            continue;
+        }
+        if (report(run, summary.value, mode, env)) {
+            staleOutputs += 1;
+        }
+    }
+    if (failedConversions > 0) {
+        return EXIT_CONVERSION_ERROR;
+    }
+    if (staleOutputs > 0) {
+        env.stderr('Generated output is stale. Run "ormbridge convert" without --check to regenerate it.\n');
+        return EXIT_CHECK_FAILED;
+    }
+    return EXIT_OK;
+}
+/**
+ * Runs the CLI with the given arguments (without the node and script
+ * entries) and returns the exit code. Nothing is written to the real
+ * process streams, so tests can call this in-process.
+ */
+export async function runCli(argv, env) {
+    const program = new Command();
+    program
+        .name('ormbridge')
+        .description('Convert ORM schemas between Django, Prisma, TypeORM and more.')
+        .version(readPackageVersion())
+        .exitOverride()
+        .configureOutput({ writeOut: env.stdout, writeErr: env.stderr });
+    let exitCode = EXIT_OK;
+    program
+        .command('convert')
+        .description('Convert models from one ORM format to another')
+        .option('-i, --input <paths...>', 'file(s) or directories to read (models.py, models/ package, or .prisma); optional when a config file supplies them')
+        .option('-o, --output <path>', 'file to write (a directory for formats that produce several files); prints to stdout when omitted')
+        .option('-f, --from <format>', `source format (${listFormatNames().join(' | ')}); inferred from the input when omitted`)
+        .option('-t, --to <format>', `target format (${listFormatNames().join(' | ')}); inferred from the output when omitted`)
+        .option('--naming <mode>', 'preserve existing database names, or normalize to singular snake_case + UUID ids (default: preserve)')
+        .option('--provider <name>', `Prisma datasource provider (${PRISMA_PROVIDERS.join(' | ')}) (default: postgresql)`)
+        .option('--no-header', 'omit the Prisma generator and datasource blocks')
+        .option('--app-label <name>', 'Django app label used for default table names (default: derived from the directory)')
+        .option('--auto-field <type>', 'primary key type for Django models without one (int | bigint) (default: int)')
+        .option('--namespace <name>', 'PHP namespace of the Doctrine entities (default: App\\Entity) or Laravel models (default: App\\Models)')
+        .option('--dry-run', 'run the conversion and report what would be written, without touching any file')
+        .option('--check', 'exit with code 3 if an output file is missing or differs from the conversion; writes nothing')
+        .option('--config <path>', 'read settings from this JSON config file instead of searching for ormbridge.config.json')
+        .option('--no-config', 'ignore any config file')
+        .action(async (flags, command) => {
+        const conflict = argv.includes('--no-config') &&
+            argv.some((arg) => arg === '--config' || arg.startsWith('--config='));
+        if (conflict) {
+            env.stderr('error [USAGE]: --config and --no-config cannot be combined.\n');
+            exitCode = EXIT_USAGE_ERROR;
+            return;
+        }
+        const headerFromFlag = command.getOptionValueSource('header') === 'cli'
+            ? flags.header
+            : undefined;
+        exitCode = await handleConvert(flags, headerFromFlag, env);
+    });
+    program
+        .command('formats')
+        .description('List the supported formats, their file extensions, and whether each can be read and/or written')
+        .action(() => {
+        env.stdout(describeFormats(listFormats()));
+    });
+    try {
+        await program.parseAsync(argv, { from: 'user' });
+    }
+    catch (thrown) {
+        if (thrown instanceof CommanderError) {
+            // Commander already printed the message; help and version are not failures.
+            return thrown.exitCode === 0 ? EXIT_OK : EXIT_USAGE_ERROR;
+        }
+        throw thrown;
+    }
+    return exitCode;
+}
+//# sourceMappingURL=cliRunner.js.map

package/dist/cliRunner.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+import { type Result } from './result.js';
+/** File names searched for in each directory, in priority order. */
+export declare const CONFIG_FILE_NAMES: readonly string[];
+/** The settings of one conversion. Every key is optional; missing keys fall back to defaults. */
+export interface ConversionConfig {
+    /** Label used in messages. Only meaningful inside `conversions`. */
+    name?: string;
+    /** Input files or directories (absolute: relative paths resolve against the config file). */
+    input?: string[];
+    /** Output file or directory (absolute). */
+    output?: string;
+    from?: string;
+    to?: string;
+    naming?: 'preserve' | 'normalize';
+    provider?: string;
+    header?: boolean;
+    appLabel?: string;
+    autoField?: 'int' | 'bigint';
+    /** PHP namespace of the Doctrine entities or Laravel models. */
+    namespace?: string;
+}
+/** A parsed config file. Top-level settings are defaults shared by every entry in `conversions`. */
+export interface ConfigFile {
+    /** Absolute path of the file the config was read from. */
+    path: string;
+    /** Top-level settings, used as defaults for each conversion. */
+    defaults: ConversionConfig;
+    /** Named conversions. Empty when the file describes a single conversion at the top level. */
+    conversions: ConversionConfig[];
+}
+/**
+ * Looks for a config file in `startDirectory` and each parent directory. The
+ * search stops after the first directory that contains a package.json (the
+ * project root) and at the filesystem root. Returns undefined when none exists.
+ */
+export declare function findConfigFile(startDirectory: string): Promise<string | undefined>;
+/** Reads and validates a JSON config file. Relative paths inside it resolve against its directory. */
+export declare function loadConfigFile(path: string): Promise<Result<ConfigFile>>;
+/** Validates already-parsed JSON. Every message names the config file and the offending key. */
+export declare function parseConfig(raw: unknown, path: string): Result<ConfigFile>;

package/dist/config.js

@@ -0,0 +1,204 @@
+import { readFile, stat } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { PRISMA_PROVIDERS } from './emitters/prisma.js';
+import { describeThrown, err, ok } from './result.js';
+/** File names searched for in each directory, in priority order. */
+export const CONFIG_FILE_NAMES = [
+    'ormbridge.config.json',
+    '.ormbridgerc.json',
+];
+const CONVERSION_KEYS = [
+    'name',
+    'input',
+    'output',
+    'from',
+    'to',
+    'naming',
+    'provider',
+    'header',
+    'appLabel',
+    'autoField',
+    'namespace',
+];
+/**
+ * Looks for a config file in `startDirectory` and each parent directory. The
+ * search stops after the first directory that contains a package.json (the
+ * project root) and at the filesystem root. Returns undefined when none exists.
+ */
+export async function findConfigFile(startDirectory) {
+    let directory = resolve(startDirectory);
+    for (;;) {
+        for (const name of CONFIG_FILE_NAMES) {
+            const candidate = join(directory, name);
+            if (await isFile(candidate)) {
+                return candidate;
+            }
+        }
+        if (await isFile(join(directory, 'package.json'))) {
+            return undefined;
+        }
+        const parent = dirname(directory);
+        if (parent === directory) {
+            return undefined;
+        }
+        directory = parent;
+    }
+}
+async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** Reads and validates a JSON config file. Relative paths inside it resolve against its directory. */
+export async function loadConfigFile(path) {
+    const absolutePath = resolve(path);
+    let text;
+    try {
+        text = await readFile(absolutePath, 'utf8');
+    }
+    catch (thrown) {
+        return err('INVALID_CONFIG', `Could not read the config file "${absolutePath}": ${describeThrown(thrown)}`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (thrown) {
+        return err('INVALID_CONFIG', `The config file "${absolutePath}" is not valid JSON: ${describeThrown(thrown)}`);
+    }
+    return parseConfig(raw, absolutePath);
+}
+/** Validates already-parsed JSON. Every message names the config file and the offending key. */
+export function parseConfig(raw, path) {
+    const fail = (message) => err('INVALID_CONFIG', `${path}: ${message}`);
+    if (!isRecord(raw)) {
+        return fail('the config must be a JSON object.');
+    }
+    const baseDirectory = dirname(path);
+    const topLevel = {};
+    let rawConversions;
+    for (const [key, value] of Object.entries(raw)) {
+        if (key === '$schema') {
+            continue;
+        }
+        if (key === 'conversions') {
+            rawConversions = value;
+        }
+        else if (key === 'name') {
+            return fail('"name" is only valid inside an entry of "conversions", not at the top level.');
+        }
+        else {
+            topLevel[key] = value;
+        }
+    }
+    const defaults = parseConversion(topLevel, '', baseDirectory);
+    if (!defaults.ok) {
+        return fail(defaults.error.message);
+    }
+    const conversions = [];
+    if (rawConversions !== undefined) {
+        if (!Array.isArray(rawConversions) || rawConversions.length === 0) {
+            return fail('"conversions" must be a non-empty array of objects.');
+        }
+        const names = new Set();
+        for (const [index, entry] of rawConversions.entries()) {
+            if (!isRecord(entry)) {
+                return fail(`"conversions[${index}]" must be an object.`);
+            }
+            const parsed = parseConversion(entry, `conversions[${index}].`, baseDirectory);
+            if (!parsed.ok) {
+                return fail(parsed.error.message);
+            }
+            const name = parsed.value.name;
+            if (name !== undefined) {
+                if (names.has(name)) {
+                    return fail(`"conversions[${index}].name" duplicates the name "${name}" used by another conversion.`);
+                }
+                names.add(name);
+            }
+            conversions.push(parsed.value);
+        }
+    }
+    return ok({ path, defaults: defaults.value, conversions });
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function describeValue(value) {
+    return JSON.stringify(value) ?? String(value);
+}
+/** Validates one conversion object. Error messages name the key (with its prefix) and the problem. */
+function parseConversion(raw, prefix, baseDirectory) {
+    const fail = (key, problem) => err('INVALID_CONFIG', `"${prefix}${key}" ${problem}`);
+    const config = {};
+    for (const key of Object.keys(raw)) {
+        if (!CONVERSION_KEYS.includes(key)) {
+            const valid = CONVERSION_KEYS.filter((candidate) => prefix !== '' || candidate !== 'name');
+            if (prefix === '') {
+                valid.push('conversions');
+            }
+            return err('INVALID_CONFIG', `unknown key "${prefix}${key}". Valid keys: ${valid.join(', ')}.`);
+        }
+    }
+    for (const key of ['name', 'from', 'to', 'appLabel', 'namespace']) {
+        const value = raw[key];
+        if (value === undefined) {
+            continue;
+        }
+        if (typeof value !== 'string' || value.trim() === '') {
+            return fail(key, `must be a non-empty string (got ${describeValue(value)}).`);
+        }
+        config[key] = value;
+    }
+    const output = raw['output'];
+    if (output !== undefined) {
+        if (typeof output !== 'string' || output.trim() === '') {
+            return fail('output', `must be a non-empty path string (got ${describeValue(output)}).`);
+        }
+        config.output = resolve(baseDirectory, output);
+    }
+    const input = raw['input'];
+    if (input !== undefined) {
+        const entries = Array.isArray(input) ? input : [input];
+        if (entries.length === 0 ||
+            entries.some((entry) => typeof entry !== 'string' || entry === '')) {
+            return fail('input', `must be a path string or a non-empty array of path strings (got ${describeValue(input)}).`);
+        }
+        config.input = entries.map((entry) => resolve(baseDirectory, entry));
+    }
+    const naming = raw['naming'];
+    if (naming !== undefined) {
+        if (naming !== 'preserve' && naming !== 'normalize') {
+            return fail('naming', `must be "preserve" or "normalize" (got ${describeValue(naming)}).`);
+        }
+        config.naming = naming;
+    }
+    const provider = raw['provider'];
+    if (provider !== undefined) {
+        if (typeof provider !== 'string' ||
+            !PRISMA_PROVIDERS.includes(provider)) {
+            return fail('provider', `must be one of ${PRISMA_PROVIDERS.join(', ')} (got ${describeValue(provider)}).`);
+        }
+        config.provider = provider;
+    }
+    const header = raw['header'];
+    if (header !== undefined) {
+        if (typeof header !== 'boolean') {
+            return fail('header', `must be true or false (got ${describeValue(header)}).`);
+        }
+        config.header = header;
+    }
+    const autoField = raw['autoField'];
+    if (autoField !== undefined) {
+        const lowered = typeof autoField === 'string' ? autoField.toLowerCase() : undefined;
+        if (lowered !== 'int' && lowered !== 'bigint') {
+            return fail('autoField', `must be "int" or "bigint" (got ${describeValue(autoField)}).`);
+        }
+        config.autoField = lowered;
+    }
+    return ok(config);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/convert.d.ts

@@ -0,0 +1,20 @@
+import { DEFAULT_APP_LABEL, type FormatName, type FormatOptions, type SourceText } from './formats.js';
+import { type Result } from './result.js';
+export { DEFAULT_APP_LABEL };
+export type { FormatName, SourceText };
+/** Names of the built-in formats. Use listFormatNames() for the live registry contents. */
+export declare const FORMAT_NAMES: readonly FormatName[];
+export interface ConvertOptions extends FormatOptions {
+    from: FormatName;
+    to: FormatName;
+}
+export interface ConvertResult {
+    /** The converted text. Empty when the emitter produced several files; see `files`. */
+    output: string;
+    /** Relative path to file text, present only when the emitter produced several files. */
+    files?: Record<string, string>;
+    warnings: string[];
+    modelCount: number;
+}
+/** Converts in-memory source text from one ORM format to another. */
+export declare function convertText(sources: SourceText[], options: ConvertOptions): Promise<Result<ConvertResult>>;