@ailnaf/zoddb 0.0.0-stage → 0.2.0

package/dist/migrations.js

@@ -0,0 +1,281 @@
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { DestructiveMigrationError } from './errors.js';
+import { diffSchema } from './migrate.js';
+import { relationGraph } from './relation-graph.js';
+/** 迁移历史表；与业务表同一 schema */
+export const MIGRATIONS_TABLE = '_zoddb_migrations';
+function isTableArray(input) {
+    return Array.isArray(input);
+}
+function migrationTables(input) {
+    return isTableArray(input) ? input : input.tableList;
+}
+function migrationGraph(input) {
+    return isTableArray(input) ? undefined : relationGraph(input);
+}
+const checksum = (content) => createHash('sha256').update(content).digest('hex');
+const stamp = (d) => d.toISOString().replace(/[-:T.]/g, '').slice(0, 17);
+const safeName = (name) => name.replace(/[^a-zA-Z0-9_]+/g, '_').replace(/^_+|_+$/g, '') || 'migration';
+/** 生成下一个不冲突的文件名（同毫秒同名/同毫秒多次生成） */
+function nextFile(dir, base) {
+    let file = join(dir, `${base}.sql`);
+    for (let i = 2; existsSync(file); i++)
+        file = join(dir, `${base}_${i}.sql`);
+    return file;
+}
+/** 单调时间戳：即使同一毫秒多次 generate，文件名也严格递增 */
+async function nextStamp(dir, now) {
+    let max = 0;
+    try {
+        for (const e of await readdir(dir, { withFileTypes: true })) {
+            const m = /^(\d{17})_/.exec(e.name);
+            if (m)
+                max = Math.max(max, Number(m[1]));
+        }
+    }
+    catch {
+        // 目录不存在时从 now 开始
+    }
+    return String(Math.max(Number(stamp(now)), max + 1)).padStart(17, '0');
+}
+/** 对比 schema 与当前库，写一个迁移文件；无差异返回 null。不执行任何 DDL。 */
+export async function generateMigration(db, input, opts) {
+    const tables = migrationTables(input);
+    const diff = await diffSchema(db, tables, { graph: migrationGraph(input) });
+    if (diff.destructive.length > 0 && !opts.allowDestructive) {
+        throw new DestructiveMigrationError(diff.destructive);
+    }
+    const all = [...(opts.allowDestructive ? diff.destructive : []), ...diff.statements];
+    if (all.length === 0)
+        return null;
+    const base = `${await nextStamp(opts.dir, opts.now ?? new Date())}_${safeName(opts.name ?? 'migration')}`;
+    await mkdir(opts.dir, { recursive: true });
+    const file = nextFile(opts.dir, base);
+    const body = all.map(s => `${s.replace(/;\s*$/, '')};`).join('\n\n');
+    const content = [
+        `-- zoddb migration ${base}`,
+        diff.destructive.length > 0 ? '-- 包含破坏性语句（生成时显式允许）' : null,
+        '',
+        body,
+        '',
+    ].filter((line) => line !== null).join('\n');
+    await writeFile(file, content, 'utf8');
+    return { file, content, diff };
+}
+async function ensureMigrationsTable(db) {
+    await db.raw.unsafe(`
+    create table if not exists "${MIGRATIONS_TABLE}" (
+      id text primary key,
+      checksum text not null,
+      applied_at timestamptz not null default now()
+    )
+  `);
+}
+async function listMigrationFiles(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    const names = entries.filter(e => e.isFile() && e.name.endsWith('.sql')).map(e => e.name).sort();
+    return Promise.all(names.map(async (name) => {
+        const path = join(dir, name);
+        const content = await readFile(path, 'utf8');
+        return { id: name, path, content, checksum: checksum(content) };
+    }));
+}
+function reservedMigrationDb(conn) {
+    return {
+        raw: conn,
+        async begin(fn) {
+            await conn.unsafe('begin');
+            try {
+                const result = await fn({ raw: conn });
+                await conn.unsafe('commit');
+                return result;
+            }
+            catch (err) {
+                await conn.unsafe('rollback').catch(() => { });
+                throw err;
+            }
+        },
+    };
+}
+async function appliedMigrations(db) {
+    const [table] = await db.raw.unsafe('select to_regclass($1) as table_name', [MIGRATIONS_TABLE]);
+    if (!table?.table_name)
+        return [];
+    const rows = await db.raw.unsafe(`select id, checksum, applied_at from "${MIGRATIONS_TABLE}" order by id`);
+    return rows.map(r => ({ id: r.id, checksum: r.checksum, appliedAt: r.applied_at }));
+}
+const DEFAULT_LOCK_TIMEOUT_MS = 10_000;
+const LOCK_POLL_MS = 50;
+const LOCK_SQL = (fn) => `select ${fn}(hashtext(current_schema()), hashtext($1)) as locked`;
+async function acquireMigrationLock(conn, timeoutMs) {
+    const deadline = Date.now() + Math.max(0, timeoutMs);
+    while (true) {
+        const rows = await conn.unsafe(LOCK_SQL('pg_try_advisory_lock'), [MIGRATIONS_TABLE]);
+        if (rows[0]?.locked)
+            return;
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) {
+            throw new Error(`migrations: 获取迁移锁超时（${timeoutMs}ms）；另一个迁移可能正在执行`);
+        }
+        await delay(Math.min(LOCK_POLL_MS, remaining));
+    }
+}
+async function releaseMigrationLock(conn) {
+    try {
+        await conn.unsafe(LOCK_SQL('pg_advisory_unlock'), [MIGRATIONS_TABLE]);
+    }
+    finally {
+        conn.release();
+    }
+}
+async function applyMigrationsLocked(db, dir, opts) {
+    await ensureMigrationsTable(db);
+    const applied = await appliedMigrations(db);
+    const files = await listMigrationFiles(dir);
+    const known = new Map(applied.map(a => [a.id, a.checksum]));
+    const fileIds = new Set(files.map(f => f.id));
+    const missing = applied.filter(a => !fileIds.has(a.id)).map(a => a.id);
+    if (missing.length > 0) {
+        throw new Error(`migrations: 已应用文件缺失: ${missing.join(', ')}`);
+    }
+    // 先整体检查已应用文件的完整性，避免“执行了一半才发现被篡改”
+    for (const f of files) {
+        const prev = known.get(f.id);
+        if (prev !== undefined && prev !== f.checksum) {
+            throw new Error(`迁移 ${f.id} 已应用但内容被修改（checksum 不符）`);
+        }
+    }
+    const empty = files.filter(f => f.content.trim() === '').map(f => f.id);
+    if (empty.length > 0) {
+        throw new Error(`migrations: 迁移文件 ${empty.join(', ')} 是空文件`);
+    }
+    const maxApplied = applied.at(-1)?.id;
+    const outOfOrder = files
+        .filter(f => !known.has(f.id) && maxApplied !== undefined && f.id < maxApplied)
+        .map(f => f.id);
+    if (outOfOrder.length > 0 && !opts.allowOutOfOrder) {
+        throw new Error(`migrations: 迁移文件 ${outOfOrder.join(', ')} 早于已应用的最新迁移 ${maxApplied}；设置 allowOutOfOrder 才能继续`);
+    }
+    const result = { applied: [], skipped: [] };
+    for (const f of files) {
+        if (known.has(f.id)) {
+            result.skipped.push(f.id);
+            continue;
+        }
+        await db.begin(async (tx) => {
+            await tx.raw.unsafe(f.content);
+            await tx.raw.unsafe(`insert into "${MIGRATIONS_TABLE}" (id, checksum) values ($1, $2)`, [f.id, f.checksum]);
+        });
+        result.applied.push(f.id);
+    }
+    return result;
+}
+async function withMigrationLock(db, opts, fn) {
+    const conn = await db.raw.reserve();
+    const lockDb = reservedMigrationDb(conn);
+    let acquired = false;
+    try {
+        await acquireMigrationLock(conn, opts.lockTimeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS);
+        acquired = true;
+        return await fn(lockDb);
+    }
+    finally {
+        if (acquired) {
+            try {
+                await releaseMigrationLock(conn);
+            }
+            catch {
+                // releaseMigrationLock 的 finally 已负责 release；避免重复归还连接。
+            }
+        }
+        else {
+            conn.release();
+        }
+    }
+}
+/** 应用迁移：先获取 schema 级 advisory lock，再用保留连接执行全部文件。 */
+export async function applyMigrations(db, dir, opts = {}) {
+    return withMigrationLock(db, opts, lockDb => applyMigrationsLocked(lockDb, dir, opts));
+}
+/**
+ * 把 through 及之前的迁移标记为已应用，不执行任何文件 SQL。
+ * 默认要求 schema 与当前库一致，避免把未落地的结构“伪装”成已迁移。
+ */
+export async function baselineMigrations(db, dir, opts) {
+    return withMigrationLock(db, opts, async (lockDb) => {
+        const files = await listMigrationFiles(dir);
+        const throughIndex = files.findIndex(f => f.id === opts.through);
+        if (throughIndex < 0) {
+            throw new Error(`baseline: through 文件不存在: ${opts.through}`);
+        }
+        const selected = files.slice(0, throughIndex + 1);
+        const empty = selected.filter(f => f.content.trim() === '').map(f => f.id);
+        if (empty.length > 0) {
+            throw new Error(`baseline: 迁移文件 ${empty.join(', ')} 是空文件`);
+        }
+        await ensureMigrationsTable(lockDb);
+        const applied = await appliedMigrations(lockDb);
+        const fileIds = new Set(files.map(f => f.id));
+        const missing = applied.filter(a => !fileIds.has(a.id)).map(a => a.id);
+        if (missing.length > 0) {
+            throw new Error(`baseline: 已应用文件缺失: ${missing.join(', ')}`);
+        }
+        const known = new Map(applied.map(a => [a.id, a.checksum]));
+        for (const f of files) {
+            const prev = known.get(f.id);
+            if (prev !== undefined && prev !== f.checksum) {
+                throw new Error(`baseline: 迁移 ${f.id} 已应用但内容被修改（checksum 不符）`);
+            }
+        }
+        const diff = await diffSchema(lockDb, migrationTables(opts.schema), { graph: migrationGraph(opts.schema) });
+        const drift = [...diff.destructive, ...diff.statements];
+        if (drift.length > 0 && !opts.allowDrift) {
+            throw new Error(`baseline: 数据库 schema 与定义不一致；请先运行 migrate/push 或显式 allowDrift\n${drift.join('\n')}`);
+        }
+        const pending = selected.filter(f => !known.has(f.id));
+        const skipped = selected.filter(f => known.has(f.id)).map(f => f.id);
+        const appliedIds = [];
+        if (pending.length > 0) {
+            await lockDb.begin(async (tx) => {
+                for (const f of pending) {
+                    await tx.raw.unsafe(`insert into "${MIGRATIONS_TABLE}" (id, checksum) values ($1, $2)`, [f.id, f.checksum]);
+                    appliedIds.push(f.id);
+                }
+            });
+        }
+        return { applied: appliedIds, skipped };
+    });
+}
+/** 已应用 / 待应用 / drift / 被篡改；drift 需要传 tables（否则跳过）。 */
+export async function migrationStatus(db, dir, input) {
+    const applied = await appliedMigrations(db);
+    const files = await listMigrationFiles(dir);
+    const byId = new Map(files.map(f => [f.id, f]));
+    const appliedIds = new Set(applied.map(a => a.id));
+    const pending = files.filter(f => !appliedIds.has(f.id)).map(f => f.id);
+    const missing = applied.filter(a => !byId.has(a.id)).map(a => a.id);
+    const empty = files.filter(f => f.content.trim() === '').map(f => f.id);
+    const maxApplied = applied.at(-1)?.id;
+    const outOfOrder = pending.filter(id => maxApplied !== undefined && id < maxApplied);
+    const tampered = applied
+        .filter(a => byId.has(a.id) && byId.get(a.id).checksum !== a.checksum)
+        .map(a => a.id);
+    const diff = input
+        ? await diffSchema(db, migrationTables(input), { graph: migrationGraph(input) })
+        : undefined;
+    const drift = diff ? [...diff.destructive, ...diff.statements] : [];
+    return { applied, pending, missing, outOfOrder, empty, drift, tampered };
+}
+//# sourceMappingURL=migrations.js.map

package/dist/migrations.js.map

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

package/dist/relation-graph.d.ts

@@ -0,0 +1,50 @@
+import type { ZodOnDelete, SchemaDefinition } from './schema.js';
+/** 图中的一列；key 是 schema 字段名，column 是 SQL 列名。 */
+export interface RelationGraphColumn {
+    readonly key: string;
+    readonly column: string;
+    readonly type: string;
+    readonly nullable: boolean;
+    readonly primaryKey: boolean;
+    readonly unique: boolean;
+}
+/** 图中的一张表。 */
+export interface RelationGraphNode {
+    readonly key: string;
+    readonly table: string;
+    readonly primaryKey: readonly string[];
+    readonly columns: readonly RelationGraphColumn[];
+}
+/** M2M 边的中间表信息；table/from/to 都是 schema key。 */
+export interface RelationGraphThrough {
+    readonly table: string;
+    readonly from: string;
+    readonly to: string;
+}
+/** 图中的一条已编译关系边。 */
+export interface RelationGraphEdge {
+    readonly from: string;
+    readonly name: string;
+    readonly to: string;
+    readonly kind: 'one' | 'many';
+    readonly fromColumn: string;
+    readonly toColumn: string;
+    readonly foreignKey: boolean;
+    readonly onDelete?: ZodOnDelete;
+    readonly write: boolean;
+    readonly through?: RelationGraphThrough;
+}
+/** 可直接 JSON.stringify 的关系图 IR。 */
+export interface RelationGraph {
+    readonly nodes: readonly RelationGraphNode[];
+    readonly edges: readonly RelationGraphEdge[];
+}
+/**
+ * 把已编译的 `defineSchema()` 结果导出为纯 JSON 关系图。
+ *
+ * - 自动包含 edge 反向关系和 manyToMany through 边
+ * - 不连接数据库，不执行 SQL，不修改 schema
+ * - 节点/边使用 schema key；SQL 名在 node.table / column.column
+ */
+export declare function relationGraph(schema: SchemaDefinition): RelationGraph;
+//# sourceMappingURL=relation-graph.d.ts.map

package/dist/relation-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-graph.d.ts","sourceRoot":"","sources":["../src/relation-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAIhE,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACjD;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,mBAAmB;AACnB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CACxC;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC7C;AAUD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CA2ErE"}

package/dist/relation-graph.js

@@ -0,0 +1,93 @@
+import { resolveRelationColumn } from './relations.js';
+function columnIsPrimary(table, dbKey, pk) {
+    return pk || table.__primaryKey.includes(dbKey);
+}
+function columnIsUnique(table, dbKey, unique) {
+    return unique || table.__uniques.some(group => group.length === 1 && group[0] === dbKey);
+}
+/**
+ * 把已编译的 `defineSchema()` 结果导出为纯 JSON 关系图。
+ *
+ * - 自动包含 edge 反向关系和 manyToMany through 边
+ * - 不连接数据库，不执行 SQL，不修改 schema
+ * - 节点/边使用 schema key；SQL 名在 node.table / column.column
+ */
+export function relationGraph(schema) {
+    const tables = schema.tables;
+    const keyOf = new Map();
+    for (const [key, table] of Object.entries(tables))
+        keyOf.set(table, key);
+    const nodes = Object.entries(tables).map(([key, table]) => {
+        const primaryKey = table.__plan
+            .filter(p => columnIsPrimary(table, p.dbKey, p.pk))
+            .map(p => p.outKey);
+        return {
+            key,
+            table: table.name,
+            primaryKey,
+            columns: table.__plan.map(p => ({
+                key: p.outKey,
+                column: p.dbKey,
+                type: p.sqlType,
+                nullable: p.nullable,
+                primaryKey: columnIsPrimary(table, p.dbKey, p.pk),
+                unique: columnIsUnique(table, p.dbKey, p.unique),
+            })),
+        };
+    });
+    const edges = [];
+    for (const group of schema.relations) {
+        const from = keyOf.get(group.table);
+        if (!from)
+            throw new Error(`relationGraph: 关系源表 ${group.table.name} 不在 schema.tables 中`);
+        for (const [name, def] of Object.entries(group.map)) {
+            const to = keyOf.get(def.table);
+            if (!to)
+                throw new Error(`relationGraph: 关系目标表 ${def.table.name} 不在 schema.tables 中`);
+            const fromColumn = resolveRelationColumn(def.from);
+            const toColumn = resolveRelationColumn(def.to);
+            const sourcePlan = group.table.__plan.find(p => p.outKey === fromColumn.outKey);
+            const ref = sourcePlan?.ref;
+            let foreignKey = false;
+            let onDelete;
+            if (ref && !def.through) {
+                try {
+                    const target = ref.thunk();
+                    const owner = target._owner;
+                    if (owner?.table === def.table && owner.outKey === toColumn.outKey) {
+                        foreignKey = true;
+                        onDelete = ref.onDelete;
+                    }
+                }
+                catch {
+                    // 列的 references thunk 异常时不让只读图导出失败；该边标记为非 FK。
+                }
+            }
+            let through;
+            if (def.through) {
+                const throughKey = keyOf.get(def.through.table);
+                if (!throughKey)
+                    throw new Error(`relationGraph: through 表 ${def.through.table.name} 不在 schema.tables 中`);
+                through = {
+                    table: throughKey,
+                    from: resolveRelationColumn(def.through.from).outKey,
+                    to: resolveRelationColumn(def.through.to).outKey,
+                };
+            }
+            edges.push({
+                from,
+                name,
+                to,
+                kind: def._kind,
+                fromColumn: fromColumn.outKey,
+                toColumn: toColumn.outKey,
+                foreignKey,
+                ...(onDelete ? { onDelete } : {}),
+                write: def._write !== false,
+                ...(through ? { through } : {}),
+            });
+        }
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=relation-graph.js.map

package/dist/relation-graph.js.map

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

package/dist/relations.d.ts

@@ -0,0 +1,128 @@
+import type { ColumnBuilder, InsertOf, RowOf, Table, UpdateOf } from './table.js';
+import type { OrderBy, WhereFilter } from './filter.js';
+export interface RelationOptions {
+    from: ColumnBuilder<any, any, any, any>;
+    to: ColumnBuilder<any, any, any, any>;
+}
+export interface ThroughRelation {
+    readonly table: Table;
+    readonly from: ColumnBuilder<any, any, any, any>;
+    readonly to: ColumnBuilder<any, any, any, any>;
+}
+export interface RelationDef<Kind extends 'many' | 'one' = 'many' | 'one', T extends Table = Table> {
+    readonly _kind: Kind;
+    readonly table: T;
+    readonly from: ColumnBuilder<any, any, any, any>;
+    readonly to: ColumnBuilder<any, any, any, any>;
+    /** many-to-many 的中间表元数据 */
+    readonly through?: ThroughRelation;
+    /** false 表示只读关系，不支持 nested create/connect */
+    readonly _write?: boolean;
+}
+export interface Relations<T extends Table = Table, M extends Record<string, RelationDef> = Record<string, RelationDef>> {
+    readonly _tag: 'relations';
+    readonly table: T;
+    readonly map: M;
+}
+export interface ResolvedColumn {
+    table: Table;
+    outKey: string;
+    dbKey: string;
+}
+export declare function resolveRelationColumn(col: ColumnBuilder<any, any, any, any>): ResolvedColumn;
+export declare function relations<T extends Table, M extends Record<string, RelationDef>>(table: T, map: M): Relations<T, M>;
+type EntryOf<R extends readonly Relations[], T extends Table> = Extract<R[number], {
+    table: T;
+}>;
+type UnionToIntersection<U> = (U extends unknown ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
+type MapOfEntry<E> = E extends Relations<any, infer M> ? M : never;
+export type RelationMapOf<R extends readonly Relations[], T extends Table> = [
+    EntryOf<R, T>
+] extends [never] ? {} : [UnionToIntersection<MapOfEntry<EntryOf<R, T>>>] extends [never] ? {} : UnionToIntersection<MapOfEntry<EntryOf<R, T>>>;
+type NumericKeys<T extends Table> = {
+    [K in keyof RowOf<T>]: RowOf<T>[K] extends number | bigint ? K : never;
+}[keyof RowOf<T>];
+export type RelationAggregateInput<T extends Table> = {
+    count?: true;
+    sum?: Partial<Record<NumericKeys<T>, true>>;
+    max?: Partial<Record<keyof RowOf<T>, true>>;
+};
+type PrevWithDepth<D extends number> = D extends 3 ? 2 : D extends 2 ? 1 : D extends 1 ? 0 : never;
+export interface WithRelationOptions<R extends readonly Relations[], T extends Table, D extends number = 3> {
+    where?: WhereFilter<T>;
+    orderBy?: OrderBy<T> | readonly OrderBy<T>[];
+    limit?: number;
+    offset?: number;
+    with?: D extends 0 ? never : WithInput<R, T, D>;
+    aggregate?: RelationAggregateInput<T>;
+}
+export type WithInput<R extends readonly Relations[], T extends Table, D extends number = 3> = {
+    [K in keyof RelationMapOf<R, T>]?: RelationMapOf<R, T>[K] extends RelationDef<'many' | 'one', infer U> ? true | false | WithRelationOptions<R, U, PrevWithDepth<D>> : never;
+};
+type RelationValue<R extends readonly Relations[], U extends Table, V> = V extends {
+    with: infer W2;
+} ? WithResult<R, U, W2> : RowOf<U>;
+type AggregateResult<U extends Table, A> = (A extends {
+    count: true;
+} ? {
+    count: number;
+} : {}) & (A extends {
+    sum: infer S;
+} ? {
+    sum: {
+        [C in keyof S & NumericKeys<U>]: number | null;
+    };
+} : {}) & (A extends {
+    max: infer M;
+} ? {
+    max: {
+        [C in keyof M & keyof RowOf<U>]: RowOf<U>[C] | null;
+    };
+} : {});
+type AggregateRow<R extends readonly Relations[], T extends Table, W> = {
+    [K in keyof W & keyof RelationMapOf<R, T> as W[K] extends {
+        aggregate: unknown;
+    } ? `${K & string}Aggregate` : never]: RelationMapOf<R, T>[K] extends RelationDef<'many' | 'one', infer U> ? W[K] extends {
+        aggregate: infer A;
+    } ? AggregateResult<U, A> : never : never;
+};
+export type WithRow<R extends readonly Relations[], T extends Table, W> = {
+    [K in keyof W & keyof RelationMapOf<R, T>]: RelationMapOf<R, T>[K] extends RelationDef<'many', infer U> ? RelationValue<R, U, W[K]>[] : RelationMapOf<R, T>[K] extends RelationDef<'one', infer U> ? RelationValue<R, U, W[K]> | null : never;
+} & AggregateRow<R, T, W>;
+export type WithResult<R extends readonly Relations[], T extends Table, W> = RowOf<T> & WithRow<R, T, W>;
+/** M2M 关系只管理 through link，不创建 target 行 */
+export type LinkWrite<U extends Table> = {
+    connect?: readonly Partial<RowOf<U>>[];
+    disconnect?: readonly Partial<RowOf<U>>[];
+    set?: readonly Partial<RowOf<U>>[];
+};
+/** create 只允许 connect；update 可使用完整 LinkWrite */
+export type CreateLinkWrite<U extends Table> = Pick<LinkWrite<U>, 'connect'>;
+/** 嵌套写：many 支持 create/connect；M2M 只支持 connect；one 只支持 connect（目标已存在） */
+export type NestedWrite<R extends readonly Relations[], T extends Table> = {
+    [K in keyof RelationMapOf<R, T>]?: RelationMapOf<R, T>[K] extends {
+        through: ThroughRelation;
+        table: infer U extends Table;
+    } ? CreateLinkWrite<U> : RelationMapOf<R, T>[K] extends {
+        _write: false;
+    } ? never : RelationMapOf<R, T>[K] extends RelationDef<'many', infer U> ? {
+        create?: readonly Partial<InsertOf<U>>[];
+        connect?: readonly Partial<RowOf<U>>[];
+    } : RelationMapOf<R, T>[K] extends RelationDef<'one', infer U> ? {
+        connect?: Partial<RowOf<U>>;
+    } : never;
+};
+export type CreateInput<R extends readonly Relations[], T extends Table> = InsertOf<T> & NestedWrite<R, T>;
+export type CreateResult<R extends readonly Relations[], T extends Table, C> = RowOf<T> & {
+    [K in keyof C & keyof RelationMapOf<R, T>]: RelationMapOf<R, T>[K] extends RelationDef<'many', infer U> ? RowOf<U>[] : RelationMapOf<R, T>[K] extends RelationDef<'one', infer U> ? RowOf<U> | null : never;
+};
+/** update 只扩展 M2M through 关系；普通 relation 仍不支持关系写入 */
+export type UpdateNestedWrite<R extends readonly Relations[], T extends Table> = {
+    [K in keyof RelationMapOf<R, T>]?: RelationMapOf<R, T>[K] extends {
+        through: ThroughRelation;
+        table: infer U extends Table;
+    } ? LinkWrite<U> : never;
+};
+export type UpdateInput<R extends readonly Relations[], T extends Table> = UpdateOf<T> & UpdateNestedWrite<R, T>;
+export {};
+//# sourceMappingURL=relations.d.ts.map

package/dist/relations.d.ts.map

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

package/dist/relations.js

@@ -0,0 +1,21 @@
+export function resolveRelationColumn(col) {
+    const owner = col._owner;
+    if (!owner)
+        throw new Error('relations: from/to 必须来自表定义里的列');
+    const plan = owner.table.__plan.find(p => p.outKey === owner.outKey);
+    if (!plan)
+        throw new Error(`relations: 找不到 ${owner.table.name}.${owner.outKey} 的列定义`);
+    return { table: owner.table, outKey: owner.outKey, dbKey: plan.dbKey };
+}
+export function relations(table, map) {
+    for (const [key, def] of Object.entries(map)) {
+        const from = resolveRelationColumn(def.from);
+        const to = resolveRelationColumn(def.to);
+        if (from.table !== table)
+            throw new Error(`relations: ${table.name}.${key} 的 from 必须来自 ${table.name}`);
+        if (to.table !== def.table)
+            throw new Error(`relations: ${table.name}.${key} 的 to 必须来自 ${def.table.name}`);
+    }
+    return { _tag: 'relations', table, map };
+}
+//# sourceMappingURL=relations.js.map

package/dist/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../src/relations.ts"],"names":[],"mappings":"AAwCA,MAAM,UAAU,qBAAqB,CAAC,GAAsC;IAC1E,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAA;IACxB,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAA;IACpE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,OAAO,CAAC,CAAA;IACrF,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,SAAS,CAAyD,KAAQ,EAAE,GAAM;IAChG,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACxC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,IAAI,GAAG,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACtG,IAAI,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,IAAI,GAAG,cAAc,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AAC1C,CAAC"}