@ailnaf/zoddb 0.0.0-stage → 0.1.0

package/dist/cli.js

@@ -0,0 +1,341 @@
+#!/usr/bin/env node
+import { watch } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import postgres from 'postgres';
+import { createDb } from './db.js';
+import { loadConfig, loadConfigAt, loadDotEnv } from './config.js';
+import { devCycle } from './dev.js';
+import { initProject } from './init.js';
+import { applyMigrations, baselineMigrations, generateMigration, migrationStatus } from './migrations.js';
+const USAGE = `zoddb <init|generate|migrate|baseline|status|dev|studio> [options]
+
+  init      生成 zoddb.config.mts / schema.mts / .env.example
+  generate  把 schema 与当前库的差异写成迁移文件
+  migrate   按文件名顺序应用未执行的迁移
+  baseline  把 through 及之前的迁移标记为已应用，不执行文件 SQL
+  status    查看已应用/待应用/drift
+  dev       生成并应用 additive 迁移；默认监听 schema
+  studio    启动只读 schema explorer（127.0.0.1）
+
+options:
+  --schema <file>        schema 模块（导出 tables 或 defineSchema）；默认读 zoddb.config.ts/.mts
+  --dir <dir>            迁移目录（默认 config.migrations 或 ./migrations）
+  --name <name>          generate 的文件名后缀（默认 migration）
+  --through <file>       baseline 的目标迁移文件 id
+  --url <url>            数据库 URL（默认 config.url 或 DATABASE_URL）
+  --config <file>        指定 config（默认 ./zoddb.config.ts/.mts）
+  --once                 dev 只执行一次（CI/测试）
+  --force                init 覆盖已存在的 scaffold 文件
+  --docker               init 额外生成 docker-compose.yml
+  --allow-destructive    允许 generate 写入删列/改类型等破坏性语句
+  --allow-out-of-order   允许 migrate 应用早于已应用最大 id 的 pending 文件
+  --lock-timeout <ms>    migrate/baseline 获取迁移锁的等待时间（默认 10000）
+  --dry-run              migrate 只输出计划，不执行、不写历史
+  --json                 status 只输出 JSON
+  --port <port>          studio 监听端口（默认 5555；0 为随机端口）
+  --write                studio 开启写模式（默认只读）
+`;
+const FLAG_KEYS = new Set([
+    'schema', 'dir', 'name', 'url', 'config',
+    'allow-destructive', 'allow-out-of-order', 'lock-timeout', 'through', 'dry-run', 'json', 'once', 'force', 'docker', 'port', 'write',
+]);
+function parseArgs(argv) {
+    const [command = 'help', ...rest] = argv;
+    const flags = new Map();
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (!arg.startsWith('--'))
+            throw new Error(`未知参数 ${arg}`);
+        const eq = arg.indexOf('=');
+        const key = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
+        if (!FLAG_KEYS.has(key))
+            throw new Error(`未知选项 --${key}`);
+        if (['allow-destructive', 'allow-out-of-order', 'dry-run', 'json', 'once', 'force', 'docker', 'write'].includes(key)) {
+            flags.set(key, true);
+            continue;
+        }
+        const value = eq === -1 ? rest[++i] : arg.slice(eq + 1);
+        if (value === undefined || value.startsWith('--'))
+            throw new Error(`--${key} 缺少值`);
+        flags.set(key, value);
+    }
+    const lockRaw = flags.get('lock-timeout');
+    const lockTimeoutMs = lockRaw === undefined ? undefined : Number(lockRaw);
+    if (lockTimeoutMs !== undefined && (!Number.isInteger(lockTimeoutMs) || lockTimeoutMs < 0)) {
+        throw new Error('--lock-timeout 必须是非负整数毫秒');
+    }
+    const portRaw = flags.get('port');
+    const port = portRaw === undefined ? undefined : Number(portRaw);
+    if (port !== undefined && (!Number.isInteger(port) || port < 0 || port > 65535)) {
+        throw new Error('--port 必须是 0–65535 的整数');
+    }
+    return {
+        command,
+        schema: flags.get('schema'),
+        dir: flags.get('dir'),
+        name: flags.get('name'),
+        url: flags.get('url'),
+        config: flags.get('config'),
+        allowDestructive: flags.get('allow-destructive') === true,
+        allowOutOfOrder: flags.get('allow-out-of-order') === true,
+        lockTimeoutMs,
+        through: flags.get('through'),
+        dryRun: flags.get('dry-run') === true,
+        json: flags.get('json') === true,
+        once: flags.get('once') === true,
+        force: flags.get('force') === true,
+        docker: flags.get('docker') === true,
+        port,
+        write: flags.get('write') === true,
+    };
+}
+async function loadSchemaInput(path) {
+    const url = `${pathToFileURL(resolve(path)).href}?t=${Date.now()}`;
+    const mod = await import(url);
+    const exported = mod.schema ?? mod.tables ?? mod.default;
+    const isSchema = exported !== null
+        && typeof exported === 'object'
+        && exported._tag === 'schema';
+    const tables = isSchema
+        ? exported.tableList
+        : exported;
+    if (!Array.isArray(tables) || tables.length === 0) {
+        throw new Error('schema 模块必须导出非空 tables 数组，或 defineSchema() 返回的 schema');
+    }
+    for (const t of tables) {
+        if (!t || typeof t !== 'object' || typeof t.name !== 'string') {
+            throw new Error('tables 里存在非表定义值');
+        }
+    }
+    return exported;
+}
+async function loadGraphSchema(path) {
+    const input = await loadSchemaInput(path);
+    if (Array.isArray(input)) {
+        throw new Error('studio 需要 schema 模块导出 defineSchema() 返回的 schema，而不是 tables 数组');
+    }
+    return input;
+}
+function printList(title, items) {
+    if (items.length === 0)
+        return;
+    console.log(`${title}:`);
+    for (const item of items)
+        console.log(`  - ${item}`);
+}
+function statusExit(st) {
+    return st.pending.length > 0 || st.missing.length > 0 || st.outOfOrder.length > 0
+        || st.empty.length > 0 || st.tampered.length > 0 || st.drift.length > 0 ? 1 : 0;
+}
+function printStatus(st, json) {
+    if (json) {
+        console.log(JSON.stringify(st));
+        return statusExit(st);
+    }
+    console.log(`已应用: ${st.applied.length}, 待应用: ${st.pending.length}, 缺失: ${st.missing.length}, ` +
+        `乱序: ${st.outOfOrder.length}, 空文件: ${st.empty.length}, 篡改: ${st.tampered.length}, drift: ${st.drift.length}`);
+    printList('待应用', st.pending);
+    printList('缺失', st.missing);
+    printList('乱序', st.outOfOrder);
+    printList('空文件', st.empty);
+    printList('被篡改', st.tampered);
+    printList('drift', st.drift);
+    return statusExit(st);
+}
+function loadConfigOrUndefined(path) {
+    return path ? loadConfigAt(path) : loadConfig();
+}
+async function runDev(url, dir, schemaPath, once) {
+    const runOnce = async () => {
+        const input = await loadSchemaInput(schemaPath);
+        const res = await devCycle(url, dir, input);
+        if (res.generated)
+            console.log(`已生成 ${res.generated}`);
+        else
+            console.log('没有 schema 变化');
+        console.log(`已应用: ${res.applied.length}, skipped: ${res.skipped.length}`);
+    };
+    if (once) {
+        await runOnce();
+        return 0;
+    }
+    await runOnce();
+    console.log(`正在监听 ${schemaPath}；Ctrl+C 退出`);
+    // Bun 会忽略 import() 的 query cache-bust；watch 的每次变更用独立进程重载 schema，
+    // 避免“文件已改但还是旧 schema”的假阴性。
+    const runOnceFresh = () => new Promise((resolveChild, rejectChild) => {
+        const entry = process.argv[1] ? resolve(process.argv[1]) : undefined;
+        if (!entry) {
+            void runOnce().then(() => resolveChild(0), rejectChild);
+            return;
+        }
+        const proc = spawn(process.execPath, [
+            entry, 'dev', '--once',
+            '--schema', schemaPath,
+            '--dir', dir,
+            '--url', url,
+        ], { cwd: process.cwd(), env: process.env, stdio: 'inherit' });
+        proc.once('error', rejectChild);
+        proc.once('exit', code => resolveChild(code ?? 1));
+    });
+    let running = false;
+    let timer;
+    const schedule = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            void (async () => {
+                if (running)
+                    return;
+                running = true;
+                try {
+                    const code = await runOnceFresh();
+                    if (code !== 0)
+                        console.error(`zoddb: dev cycle 退出码 ${code}`);
+                }
+                catch (err) {
+                    console.error(`zoddb: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                finally {
+                    running = false;
+                }
+            })();
+        }, 150);
+    };
+    const watcher = watch(schemaPath, { persistent: true }, schedule);
+    watcher.on('error', err => console.error(`zoddb: watch: ${err.message}`));
+    await new Promise(resolveStop => {
+        const stop = () => {
+            watcher.close();
+            resolveStop();
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+    return 0;
+}
+async function main(argv) {
+    const opts = parseArgs(argv);
+    if (opts.command === 'help' || opts.command === '--help' || opts.command === '-h') {
+        console.log(USAGE);
+        return 0;
+    }
+    if (!['init', 'generate', 'migrate', 'baseline', 'status', 'dev', 'studio'].includes(opts.command)) {
+        throw new Error(`未知命令 ${opts.command}\n\n${USAGE}`);
+    }
+    // 标准的项目 .env；已有环境变量优先，不覆盖。
+    loadDotEnv();
+    if (opts.command === 'init') {
+        const res = initProject({ cwd: process.cwd(), force: opts.force, docker: opts.docker });
+        if (res.created.length > 0)
+            console.log(`已创建: ${res.created.join(', ')}`);
+        if (res.skipped.length > 0)
+            console.log(`已存在，跳过: ${res.skipped.join(', ')}`);
+        console.log('下一步:');
+        console.log('  1. 将 DATABASE_URL 写入 .env（或 docker compose up -d）');
+        console.log('  2. npx zoddb dev --once');
+        return 0;
+    }
+    const config = await loadConfigOrUndefined(opts.config);
+    const schemaPath = opts.schema ? resolve(opts.schema) : config?.schema;
+    const dir = opts.dir ? resolve(opts.dir) : (config?.migrations ?? resolve('./migrations'));
+    if (opts.command === 'studio') {
+        if (!schemaPath)
+            throw new Error('studio 需要 --schema，或在 zoddb.config.ts/.mts 配置 schema');
+        const cliEntry = process.argv[1];
+        if (!cliEntry)
+            throw new Error('studio 无法定位 CLI 入口');
+        const schema = await loadGraphSchema(schemaPath);
+        const studioUrl = opts.url ?? config?.url ?? process.env.DATABASE_URL;
+        if (opts.write && !studioUrl) {
+            throw new Error('studio --write 需要数据库 URL（--url、config.url 或 DATABASE_URL）');
+        }
+        const { startStudio } = await import('./studio/server.js');
+        const studio = await startStudio({
+            schema,
+            url: studioUrl,
+            write: opts.write,
+            port: opts.port,
+            schemaPath,
+            migrationsDir: dir,
+            cli: { command: process.execPath, args: [cliEntry] },
+        });
+        console.log(`zoddb studio: ${studio.url}`);
+        console.log(opts.write ? '写模式；Ctrl+C 退出' : '只读模式；Ctrl+C 退出');
+        try {
+            await new Promise((resolveStop) => {
+                const stop = () => resolveStop();
+                process.once('SIGINT', stop);
+                process.once('SIGTERM', stop);
+            });
+        }
+        finally {
+            await studio.close();
+        }
+        return 0;
+    }
+    const url = opts.url ?? config?.url ?? process.env.DATABASE_URL;
+    if (!url)
+        throw new Error('缺少数据库 URL（--url、config.url 或 DATABASE_URL）');
+    if (opts.command === 'generate' && !schemaPath)
+        throw new Error('generate 需要 --schema，或在 zoddb.config.ts/.mts 配置 schema');
+    if (opts.command === 'baseline' && !schemaPath)
+        throw new Error('baseline 需要 --schema，或在 zoddb.config.ts/.mts 配置 schema');
+    if (opts.command === 'baseline' && !opts.through)
+        throw new Error('baseline 需要 --through <file>');
+    if (opts.command === 'dev' && !schemaPath)
+        throw new Error('dev 需要 --schema，或在 zoddb.config.ts/.mts 配置 schema');
+    const input = schemaPath ? await loadSchemaInput(schemaPath) : undefined;
+    if (opts.command === 'dev')
+        return runDev(url, dir, schemaPath, opts.once);
+    const raw = postgres(url, { max: 1, onnotice: () => { } });
+    const db = createDb(raw);
+    try {
+        if (opts.command === 'generate') {
+            const gen = await generateMigration(db, input, {
+                dir,
+                name: opts.name,
+                allowDestructive: opts.allowDestructive,
+            });
+            console.log(gen ? `已生成 ${gen.file}` : '没有差异，未生成文件');
+            return 0;
+        }
+        if (opts.command === 'migrate') {
+            if (opts.dryRun) {
+                const st = await migrationStatus(db, dir, input);
+                console.log('dry-run: 未执行、未写历史');
+                return printStatus(st, false);
+            }
+            const res = await applyMigrations(db, dir, {
+                lockTimeoutMs: opts.lockTimeoutMs,
+                allowOutOfOrder: opts.allowOutOfOrder,
+            });
+            console.log(`applied: ${res.applied.length}, skipped: ${res.skipped.length}`);
+            printList('已应用', res.applied);
+            return 0;
+        }
+        if (opts.command === 'baseline') {
+            const res = await baselineMigrations(db, dir, {
+                through: opts.through,
+                schema: input,
+                allowDrift: opts.force,
+                lockTimeoutMs: opts.lockTimeoutMs,
+            });
+            console.log(`baseline applied: ${res.applied.length}, skipped: ${res.skipped.length}`);
+            printList('已标记', res.applied);
+            return 0;
+        }
+        const st = await migrationStatus(db, dir, input);
+        return printStatus(st, opts.json);
+    }
+    finally {
+        await db.close();
+    }
+}
+main(process.argv.slice(2)).then(code => { process.exitCode = code; }, err => {
+    console.error(`zoddb: ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+/** zoddb.config.ts 的默认导出；路径相对 config 文件 */
+export interface ZoddbConfigFile {
+    schema?: string;
+    migrations?: string;
+    url?: string;
+    /** 从环境变量读取 URL（避免把连接串写进仓库） */
+    urlEnv?: string;
+}
+export interface LoadedConfig extends ZoddbConfigFile {
+    path: string;
+    dir: string;
+    schema?: string;
+    migrations: string;
+}
+/** 从当前工作目录加载 .env；不覆盖已存在的环境变量。 */
+export declare function loadDotEnv(cwd?: string): void;
+export declare function findConfig(cwd?: string): string | undefined;
+/** 读取指定 config 文件；路径一律解析成绝对路径。 */
+export declare function loadConfigAt(configPath: string): Promise<LoadedConfig>;
+/** 读取 ./zoddb.config.*；不存在返回 undefined。 */
+export declare function loadConfig(cwd?: string): Promise<LoadedConfig | undefined>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,IAAI,CAI5D;AAED,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAM1E;AAED,kCAAkC;AAClC,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwB5E;AAED,2CAA2C;AAC3C,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAG/F"}

package/dist/config.js

@@ -0,0 +1,52 @@
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const CONFIG_NAMES = ['zoddb.config.ts', 'zoddb.config.mts', 'zoddb.config.js', 'zoddb.config.mjs'];
+/** 从当前工作目录加载 .env；不覆盖已存在的环境变量。 */
+export function loadDotEnv(cwd = process.cwd()) {
+    const path = resolve(cwd, '.env');
+    if (!existsSync(path))
+        return;
+    process.loadEnvFile(path);
+}
+export function findConfig(cwd = process.cwd()) {
+    for (const name of CONFIG_NAMES) {
+        const path = resolve(cwd, name);
+        if (existsSync(path))
+            return path;
+    }
+    return undefined;
+}
+/** 读取指定 config 文件；路径一律解析成绝对路径。 */
+export async function loadConfigAt(configPath) {
+    const path = resolve(configPath);
+    let mod;
+    try {
+        mod = await import(`${pathToFileURL(path).href}?t=${Date.now()}`);
+    }
+    catch (err) {
+        throw new Error(`无法加载 ${path}：${err instanceof Error ? err.message : String(err)}`);
+    }
+    const raw = mod.default ?? mod.config;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error(`${path} 必须默认导出一个对象`);
+    }
+    const cfg = raw;
+    const dir = dirname(path);
+    const schema = typeof cfg.schema === 'string' ? resolve(dir, cfg.schema) : undefined;
+    const migrations = typeof cfg.migrations === 'string'
+        ? resolve(dir, cfg.migrations)
+        : resolve(dir, 'migrations');
+    const url = typeof cfg.url === 'string'
+        ? cfg.url
+        : typeof cfg.urlEnv === 'string'
+            ? process.env[cfg.urlEnv]
+            : undefined;
+    return { ...cfg, path, dir, schema, migrations, url };
+}
+/** 读取 ./zoddb.config.*；不存在返回 undefined。 */
+export async function loadConfig(cwd = process.cwd()) {
+    const path = findConfig(cwd);
+    return path ? loadConfigAt(path) : undefined;
+}
+//# 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/db.d.ts

@@ -0,0 +1,183 @@
+import postgres from 'postgres';
+import { type FindManyOptions, type WhereFilter } from './filter.js';
+import { type AggKey, type AggRow, type AggregateOptions } from './aggregate.js';
+import { type CreateResult, type NestedWrite, type RelationDef, type RelationOptions, type Relations, type UpdateInput, type WithInput, type WithResult, type WithRow } from './relations.js';
+import type { FastMapper, InsertOf, RowOf, SqlFragment, Table } from './table.js';
+export type ValidateMode = 'always' | 'never';
+export type IsolationLevel = 'read committed' | 'repeatable read' | 'serializable';
+export interface BeginOptions {
+    isolation?: IsolationLevel;
+}
+export interface QueryEvent {
+    sql: string;
+    params: readonly unknown[];
+    durationMs: number;
+    operation: string;
+    table?: string;
+    rows?: number;
+    error?: unknown;
+    slow: boolean;
+    replica?: boolean;
+}
+export interface DbHooks {
+    onQuery?: (event: QueryEvent) => void;
+    onSlowQuery?: (event: QueryEvent) => void;
+}
+export interface DbRuntimeOptions {
+    hooks?: DbHooks;
+    slowQueryMs?: number;
+    /** 只读副本连接；读 API 走它，写/事务/db.sql 走主库 */
+    replica?: postgres.Sql;
+}
+/** 条件：过滤对象（支持操作符）或 sql 片段；写操作空条件会被拒绝（防全表操作） */
+export type WhereInput<T extends Table, R extends readonly Relations[] = []> = SqlFragment | WhereFilter<T, R>;
+export type SelectMap<T extends Table> = {
+    [K in keyof RowOf<T>]?: boolean;
+};
+type TrueKeys<S> = {
+    [K in keyof S]-?: S[K] extends true ? K : never;
+}[keyof S];
+export type SelectedOf<T extends Table, S> = Pick<RowOf<T>, Extract<TrueKeys<S>, keyof RowOf<T>>>;
+export interface Many<T extends Table = Table> {
+    readonly _rel: 'many';
+    readonly table: T;
+}
+export interface One<T extends Table = Table> {
+    readonly _rel: 'one';
+    readonly table: T;
+}
+export declare function many<T extends Table>(table: T): Many<T>;
+export declare function many<T extends Table>(table: T, opts: RelationOptions): RelationDef<'many', T>;
+export declare function one<T extends Table>(table: T): One<T>;
+export declare function one<T extends Table>(table: T, opts: RelationOptions): RelationDef<'one', T>;
+export type IncludeMap = Record<string, Many<Table> | One<Table>>;
+export type IncludeRow<I extends IncludeMap> = {
+    [K in keyof I]: I[K] extends Many<infer T> ? RowOf<T>[] : I[K] extends One<infer T> ? RowOf<T> | null : never;
+};
+export type Row = Record<string, any>;
+interface Ctx {
+    readonly raw: postgres.Sql;
+    readonly validate: ValidateMode;
+    readonly shouldValidate: boolean;
+    readonly relations: readonly Relations[];
+    readonly hooks?: DbHooks;
+    readonly slowQueryMs?: number;
+    readonly replica?: postgres.Sql;
+    readonly onReplica?: boolean;
+}
+export type SelectedKeys<T extends Table, C> = Extract<keyof C, keyof RowOf<T>> & string;
+export interface SelectFragment<T extends Table = Table, R = RowOf<T>> {
+    readonly _tag: 'select';
+    readonly table: T;
+    readonly keys: readonly string[];
+    /** postgres.js 片段：可安全插进 sql`...` 模板 */
+    readonly __fragment: unknown;
+    readonly __mapFast: FastMapper;
+    readonly __mapValid: (row: Row, index: number) => Row;
+    /** phantom：只用于类型收窄，运行时不读写 */
+    readonly $row: R;
+    as(alias: string): SelectFragment<T, R>;
+    toSQL(): string;
+}
+export declare class Query<R extends postgres.MaybeRow = Row> implements PromiseLike<R[]> {
+    #private;
+    constructor(ctx: Ctx, factory: () => postgres.PendingQuery<R[]>, sql?: string, params?: readonly unknown[]);
+    private pending;
+    private run;
+    then<TResult1 = R[], TResult2 = never>(onfulfilled?: ((value: R[]) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<R[] | TResult>;
+    finally(onfinally?: (() => void) | null): Promise<R[]>;
+    /** 原始行：不映射、不校验（逃生舱） */
+    execute(): Promise<R[]>;
+    rows<T extends Table>(table: T): Promise<RowOf<T>[]>;
+    rows<T extends Table, R>(sel: SelectFragment<T, R>): Promise<R[]>;
+    rows<T extends Table, I extends IncludeMap>(table: T, opts: {
+        include: I;
+    }): Promise<(RowOf<T> & IncludeRow<I>)[]>;
+    one<T extends Table>(table: T): Promise<RowOf<T>>;
+    one<T extends Table, R>(sel: SelectFragment<T, R>): Promise<R>;
+    one<T extends Table, I extends IncludeMap>(table: T, opts: {
+        include: I;
+    }): Promise<RowOf<T> & IncludeRow<I>>;
+    maybeOne<T extends Table>(table: T): Promise<RowOf<T> | null>;
+    maybeOne<T extends Table, R>(sel: SelectFragment<T, R>): Promise<R | null>;
+    maybeOne<T extends Table, I extends IncludeMap>(table: T, opts: {
+        include: I;
+    }): Promise<(RowOf<T> & IncludeRow<I>) | null>;
+}
+export interface SqlTag {
+    <R extends postgres.MaybeRow = Row>(strings: TemplateStringsArray, ...params: unknown[]): Query<R>;
+}
+export interface Db<R extends readonly Relations[] = readonly Relations[]> {
+    readonly sql: SqlTag;
+    readonly raw: postgres.Sql;
+    select<T extends Table>(table: T): SelectFragment<T, RowOf<T>>;
+    select<T extends Table, const C extends Partial<Record<keyof RowOf<T>, true>>>(table: T, columns: C): SelectFragment<T, Pick<RowOf<T>, SelectedKeys<T, C>>>;
+    insert<T extends Table>(table: T, values: InsertOf<T>): Promise<RowOf<T>[]>;
+    insertMany<T extends Table>(table: T, values: InsertOf<T>[], opts?: {
+        chunkSize?: number;
+    }): Promise<RowOf<T>[]>;
+    create<T extends Table, const C extends NestedWrite<R, T>>(table: T, input: InsertOf<T> & C): Promise<CreateResult<R, T, C>>;
+    seed<T extends Table>(table: T, rows: readonly InsertOf<T>[], opts: {
+        conflict: readonly (keyof RowOf<T> & string)[];
+        update?: readonly (keyof RowOf<T> & string)[];
+    }): Promise<RowOf<T>[]>;
+    update<T extends Table>(table: T, values: UpdateInput<R, T>, where: WhereInput<T>): Promise<RowOf<T>[]>;
+    delete<T extends Table>(table: T, where: WhereInput<T>): Promise<number>;
+    upsert<T extends Table>(table: T, values: InsertOf<T>, opts: {
+        conflict: readonly (keyof RowOf<T> & string)[];
+        update?: readonly (keyof RowOf<T> & string)[];
+    }): Promise<RowOf<T>[]>;
+    count<T extends Table>(table: T, where?: WhereInput<T>): Promise<number>;
+    aggregate<T extends Table, const S extends readonly AggKey<T>[] = [], const A extends readonly AggKey<T>[] = [], const N extends readonly AggKey<T>[] = [], const X extends readonly AggKey<T>[] = []>(table: T, opts: AggregateOptions<T> & {
+        sum?: S;
+        avg?: A;
+        min?: N;
+        max?: X;
+    }): Promise<AggRow<T, [], S, A, N, X>>;
+    groupBy<T extends Table, const G extends readonly AggKey<T>[], const S extends readonly AggKey<T>[] = [], const A extends readonly AggKey<T>[] = [], const N extends readonly AggKey<T>[] = [], const X extends readonly AggKey<T>[] = []>(table: T, opts: AggregateOptions<T> & {
+        groupBy: G;
+        sum?: S;
+        avg?: A;
+        min?: N;
+        max?: X;
+    }): Promise<AggRow<T, G, S, A, N, X>[]>;
+    findMany<T extends Table, const S extends SelectMap<T>, const W extends WithInput<R, T>>(table: T, opts: FindManyOptions<T> & {
+        select: S;
+        with: W;
+    }): Promise<(SelectedOf<T, S> & WithRow<R, T, W>)[]>;
+    findMany<T extends Table, const S extends SelectMap<T>>(table: T, opts: FindManyOptions<T> & {
+        select: S;
+    }): Promise<SelectedOf<T, S>[]>;
+    findMany<T extends Table, const W extends WithInput<R, T>>(table: T, opts: FindManyOptions<T> & {
+        with: W;
+    }): Promise<WithResult<R, T, W>[]>;
+    findMany<T extends Table>(table: T, opts?: FindManyOptions<T>): Promise<RowOf<T>[]>;
+    findOne<T extends Table, const S extends SelectMap<T>, const W extends WithInput<R, T>>(table: T, opts: FindManyOptions<T> & {
+        select: S;
+        with: W;
+    }): Promise<(SelectedOf<T, S> & WithRow<R, T, W>) | null>;
+    findOne<T extends Table, const S extends SelectMap<T>>(table: T, opts: FindManyOptions<T> & {
+        select: S;
+    }): Promise<SelectedOf<T, S> | null>;
+    findOne<T extends Table, const W extends WithInput<R, T>>(table: T, opts: FindManyOptions<T> & {
+        with: W;
+    }): Promise<WithResult<R, T, W> | null>;
+    findOne<T extends Table>(table: T, opts?: FindManyOptions<T>): Promise<RowOf<T> | null>;
+    begin<X>(fn: (tx: Db<R>) => Promise<X>, opts?: BeginOptions): Promise<X>;
+    close(): Promise<void>;
+}
+export declare function createDb<R extends readonly Relations[] = readonly Relations[]>(conn: postgres.Sql, validate?: ValidateMode, relations?: R, opts?: DbRuntimeOptions): Db<R>;
+export interface DbOptions<R extends readonly Relations[] = readonly Relations[]> {
+    connection?: postgres.Sql;
+    url?: string;
+    validate?: ValidateMode;
+    relations?: R;
+    hooks?: DbHooks;
+    slowQueryMs?: number;
+    replica?: postgres.Sql;
+    replicaUrl?: string;
+}
+export declare function defineDb<const R extends readonly Relations[] = []>(opts: DbOptions<R>): Db<R>;
+export {};
+//# sourceMappingURL=db.d.ts.map