@ailnaf/zoddb 0.0.0-stage → 0.1.0

package/dist/filter.js

@@ -0,0 +1,219 @@
+import { resolveRelationColumn } from './relations.js';
+const OPS = new Set([
+    'eq', 'ne', 'lt', 'lte', 'gt', 'gte', 'in', 'notIn',
+    'like', 'contains', 'startsWith', 'endsWith', 'isNull', 'mode',
+]);
+const quoteIdent = (s) => `"${s.replace(/"/g, '""')}"`;
+export const escapeLike = (s) => s.replace(/[\\%_]/g, m => `\\${m}`);
+const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) && !(v instanceof Date) && !(v instanceof Uint8Array);
+function compileField(col, v, push) {
+    if (v === null)
+        return `${col} is null`;
+    if (!isPlainObject(v))
+        return `${col} = ${push(v)}`;
+    if (!Object.keys(v).some(k => OPS.has(k)))
+        return `${col} = ${push(v)}`; // jsonb 等值
+    const mode = v.mode;
+    const likeOp = mode === 'insensitive' ? 'ilike' : 'like';
+    const parts = [];
+    for (const [op, val] of Object.entries(v)) {
+        if (op === 'mode' || val === undefined)
+            continue;
+        switch (op) {
+            case 'eq':
+                parts.push(val === null ? `${col} is null` : `${col} = ${push(val)}`);
+                break;
+            case 'ne':
+                parts.push(val === null ? `${col} is not null` : `${col} <> ${push(val)}`);
+                break;
+            case 'lt':
+                parts.push(`${col} < ${push(val)}`);
+                break;
+            case 'lte':
+                parts.push(`${col} <= ${push(val)}`);
+                break;
+            case 'gt':
+                parts.push(`${col} > ${push(val)}`);
+                break;
+            case 'gte':
+                parts.push(`${col} >= ${push(val)}`);
+                break;
+            case 'in': {
+                const arr = val;
+                parts.push(arr.length === 0 ? 'false' : `${col} = any(${push(arr)})`);
+                break;
+            }
+            case 'notIn': {
+                const arr = val;
+                parts.push(arr.length === 0 ? 'true' : `not (${col} = any(${push(arr)}))`);
+                break;
+            }
+            case 'like':
+                parts.push(`${col} ${likeOp} ${push(val)}`);
+                break;
+            case 'contains':
+                parts.push(`${col} ${likeOp} ${push(`%${escapeLike(String(val))}%`)} escape '\\'`);
+                break;
+            case 'startsWith':
+                parts.push(`${col} ${likeOp} ${push(`${escapeLike(String(val))}%`)} escape '\\'`);
+                break;
+            case 'endsWith':
+                parts.push(`${col} ${likeOp} ${push(`%${escapeLike(String(val))}`)} escape '\\'`);
+                break;
+            case 'isNull':
+                parts.push(val ? `${col} is null` : `${col} is not null`);
+                break;
+            default: throw new Error(`where: 未知操作符 ${op}`);
+        }
+    }
+    return parts.length === 0 ? null : parts.join(' and ');
+}
+export function compileWhere(table, filter, offset = 0, relations = [], sourceAlias) {
+    const params = [];
+    const push = (x) => {
+        params.push(x);
+        return `$${offset + params.length}`;
+    };
+    let aliasSeq = 0;
+    const maxRelationDepth = 2;
+    const compile = (f, alias, currentTable = table, depth = 0) => {
+        const parts = [];
+        const obj = f;
+        const rels = relations.find(r => r.table === currentTable);
+        for (const [k, v] of Object.entries(obj)) {
+            if (v === undefined || k === 'AND' || k === 'OR' || k === 'NOT')
+                continue;
+            const plan = currentTable.__plan.find(p => p.outKey === k);
+            if (plan) {
+                const col = alias ? `${quoteIdent(alias)}.${quoteIdent(plan.dbKey)}` : quoteIdent(plan.dbKey);
+                const text = compileField(col, v, push);
+                if (text)
+                    parts.push(text);
+                continue;
+            }
+            const def = rels?.map[k];
+            if (!def)
+                throw new Error(`where: 未知列 ${currentTable.name}.${k}`);
+            if (depth >= maxRelationDepth) {
+                throw new Error(`where: 关系过滤超过最大深度 ${maxRelationDepth}`);
+            }
+            if (!isPlainObject(v))
+                throw new Error(`where: 关系 ${currentTable.name}.${k} 需要 { some } 或 { none }`);
+            const ops = Object.entries(v).filter(([, value]) => value !== undefined);
+            if (ops.length === 0)
+                continue;
+            for (const [op, value] of ops) {
+                if (op !== 'some' && op !== 'none') {
+                    throw new Error(`where: 关系 ${currentTable.name}.${k} 只支持 some/none（收到 ${op}）`);
+                }
+                if (!isPlainObject(value))
+                    throw new Error(`where: 关系 ${currentTable.name}.${k}.${op} 必须是对象`);
+                const target = def.table;
+                const fromCol = resolveRelationColumn(def.from);
+                const toCol = resolveRelationColumn(def.to);
+                const sourceRef = alias
+                    ? `${quoteIdent(alias)}.${quoteIdent(fromCol.dbKey)}`
+                    : `${quoteIdent(currentTable.name)}.${quoteIdent(fromCol.dbKey)}`;
+                let sub;
+                let targetAliasName;
+                if (def.through) {
+                    const throughFrom = resolveRelationColumn(def.through.from);
+                    const throughTo = resolveRelationColumn(def.through.to);
+                    const throughAlias = quoteIdent(`t${aliasSeq++}`);
+                    targetAliasName = `r${aliasSeq++}`;
+                    const targetAlias = quoteIdent(targetAliasName);
+                    sub = `select 1 from ${quoteIdent(def.through.table.name)} as ${throughAlias}`
+                        + ` join ${quoteIdent(target.name)} as ${targetAlias}`
+                        + ` on ${targetAlias}.${quoteIdent(toCol.dbKey)} = ${throughAlias}.${quoteIdent(throughTo.dbKey)}`
+                        + ` where ${throughAlias}.${quoteIdent(throughFrom.dbKey)} = ${sourceRef}`;
+                }
+                else {
+                    targetAliasName = `r${aliasSeq++}`;
+                    const targetAlias = quoteIdent(targetAliasName);
+                    sub = `select 1 from ${quoteIdent(target.name)} as ${targetAlias} where ${targetAlias}.${quoteIdent(toCol.dbKey)} = ${sourceRef}`;
+                }
+                const predicate = compile(value, targetAliasName, target, depth + 1);
+                if (predicate)
+                    sub += ` and (${predicate})`;
+                parts.push(op === 'some' ? `exists (${sub})` : `not exists (${sub})`);
+            }
+        }
+        const and = obj.AND;
+        if (and)
+            for (const sub of and) {
+                const t = compile(sub, alias, currentTable, depth);
+                if (t)
+                    parts.push(t);
+            }
+        const or = obj.OR;
+        if (or)
+            parts.push(or.length === 0 ? 'false' : `(${or.map(sub => compile(sub, alias, currentTable, depth) || 'true').join(' or ')})`);
+        const not = obj.NOT;
+        if (not)
+            parts.push(`not (${compile(not, alias, currentTable, depth) || 'true'})`);
+        return parts.length === 0 ? '' : parts.length === 1 ? parts[0] : `(${parts.join(' and ')})`;
+    };
+    return { text: compile(filter, sourceAlias), params };
+}
+/** keyset：把游标编译为参数化条件；startParam 用于与 where 参数拼接 */
+export function compileCursor(table, orderBy, cursor, startParam) {
+    if (!orderBy)
+        throw new Error('cursor: 需要同时提供 orderBy');
+    const items = Array.isArray(orderBy) ? orderBy : [orderBy];
+    const order = [];
+    for (const item of items) {
+        for (const [k, dir] of Object.entries(item)) {
+            const plan = table.__plan.find(p => p.outKey === k);
+            if (!plan)
+                throw new Error(`cursor: 未知列 ${table.name}.${k}`);
+            if (dir !== 'asc' && dir !== 'desc')
+                throw new Error(`cursor: 方向必须是 asc 或 desc（${k}）`);
+            order.push([k, dir]);
+        }
+    }
+    if (order.length === 0)
+        throw new Error('cursor: orderBy 不能为空');
+    for (const k of Object.keys(cursor)) {
+        if (!order.some(([c]) => c === k))
+            throw new Error(`cursor 含未知列 ${table.name}.${k}`);
+    }
+    const values = order.map(([k]) => {
+        const v = cursor[k];
+        if (v === undefined)
+            throw new Error(`cursor 缺少排序列 ${k}`);
+        if (v === null)
+            throw new Error(`cursor 不能为 null（${k}）`);
+        return v;
+    });
+    const cols = order.map(([k]) => quoteIdent(table.__plan.find(p => p.outKey === k).dbKey));
+    const placeholders = order.map((_, i) => `$${startParam + i}`);
+    const dirs = order.map(([, d]) => d);
+    if (dirs.every(d => d === dirs[0])) {
+        return {
+            text: `(${cols.join(', ')}) ${dirs[0] === 'asc' ? '>' : '<'} (${placeholders.join(', ')})`,
+            params: values,
+        };
+    }
+    const terms = order.map(([k, dir], i) => {
+        const parts = order.slice(0, i).map(([prev], j) => `${quoteIdent(table.__plan.find(p => p.outKey === prev).dbKey)} = $${startParam + j}`);
+        parts.push(`${cols[i]} ${dir === 'asc' ? '>' : '<'} $${startParam + i}`);
+        return `(${parts.join(' and ')})`;
+    });
+    return { text: `(${terms.join(' or ')})`, params: values };
+}
+export function compileOrderBy(table, orderBy) {
+    const items = Array.isArray(orderBy) ? orderBy : [orderBy];
+    const parts = [];
+    for (const item of items) {
+        for (const [k, dir] of Object.entries(item)) {
+            const plan = table.__plan.find(p => p.outKey === k);
+            if (!plan)
+                throw new Error(`orderBy: 未知列 ${table.name}.${k}`);
+            if (dir !== 'asc' && dir !== 'desc')
+                throw new Error(`orderBy: 方向必须是 asc 或 desc（${k}）`);
+            parts.push(`${quoteIdent(plan.dbKey)} ${dir}`);
+        }
+    }
+    return parts.join(', ');
+}
+//# sourceMappingURL=filter.js.map

package/dist/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gBAAgB,CAAA;AA2E5G,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;IAClB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO;IACnD,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;CAC/D,CAAC,CAAA;AAEF,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAA;AAEtE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAEpF,MAAM,aAAa,GAAG,CAAC,CAAU,EAAgC,EAAE,CACjE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,CAAA;AAEhH,SAAS,YAAY,CAAC,GAAW,EAAE,CAAU,EAAE,IAA4B;IACzE,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,GAAG,GAAG,UAAU,CAAA;IACvC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA,CAAC,WAAW;IAEnF,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAA;IACnB,MAAM,MAAM,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;IACxD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,IAAI,EAAE,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS;YAAE,SAAQ;QAChD,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YACvF,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YAC5F,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YACrD,KAAK,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YACvD,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YACrD,KAAK,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YACvD,KAAK,IAAI,EAAE,CAAC;gBACV,MAAM,GAAG,GAAG,GAAgB,CAAA;gBAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACrE,MAAK;YACP,CAAC;YACD,KAAK,OAAO,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAgB,CAAA;gBAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,GAAG,UAAU,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC1E,MAAK;YACP,CAAC;YACD,KAAK,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAK;YAC/D,KAAK,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAAC,MAAK;YAC1G,KAAK,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAAC,MAAK;YAC3G,KAAK,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC;gBAAC,MAAK;YACzG,KAAK,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,cAAc,CAAC,CAAC;gBAAC,MAAK;YAC/E,SAAS,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAY,EACZ,MAAgD,EAChD,MAAM,GAAG,CAAC,EACV,SAAS,GAAyB,EAAE,EACpC,WAAoB;IAEpB,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,CAAC,CAAU,EAAU,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACd,OAAO,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;IACrC,CAAC,CAAA;IACD,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,MAAM,gBAAgB,GAAG,CAAC,CAAA;IAE1B,MAAM,OAAO,GAAG,CACd,CAA2C,EAC3C,KAAc,EACd,YAAY,GAAU,KAAK,EAC3B,KAAK,GAAG,CAAC,EACD,EAAE;QACV,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,GAAG,GAAG,CAA4B,CAAA;QACxC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,CAAA;QAC1D,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;gBAAE,SAAQ;YACzE,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;YAC1D,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC7F,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;gBACvC,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC1B,SAAQ;YACV,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YACxB,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,YAAY,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;YACjE,IAAI,KAAK,IAAI,gBAAgB,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,gBAAgB,EAAE,CAAC,CAAA;YAC1D,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,CAAC,IAAI,IAAI,CAAC,yBAAyB,CAAC,CAAA;YACpG,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;YACxE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAC9B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC9B,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,CAAC,IAAI,IAAI,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAA;gBAChF,CAAC;gBACD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;gBAC7F,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAA;gBACxB,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC/C,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBAC3C,MAAM,SAAS,GAAG,KAAK;oBACrB,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;oBACrD,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAA;gBACnE,IAAI,GAAW,CAAA;gBACf,IAAI,eAAuB,CAAA;gBAC3B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAChB,MAAM,WAAW,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;oBAC3D,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;oBACvD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAA;oBACjD,eAAe,GAAG,IAAI,QAAQ,EAAE,EAAE,CAAA;oBAClC,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;oBAC/C,GAAG,GAAG,iBAAiB,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,YAAY,EAAE;0BAC1E,SAAS,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,EAAE;0BACpD,OAAO,WAAW,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,YAAY,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;0BAChG,UAAU,YAAY,IAAI,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,SAAS,EAAE,CAAA;gBAC9E,CAAC;qBAAM,CAAC;oBACN,eAAe,GAAG,IAAI,QAAQ,EAAE,EAAE,CAAA;oBAClC,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;oBAC/C,GAAG,GAAG,iBAAiB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,UAAU,WAAW,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,EAAE,CAAA;gBACnI,CAAC;gBACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAiD,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;gBAChH,IAAI,SAAS;oBAAE,GAAG,IAAI,SAAS,SAAS,GAAG,CAAA;gBAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,eAAe,GAAG,GAAG,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAsE,CAAA;QACtF,IAAI,GAAG;YAAE,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAA;gBAClD,IAAI,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACtB,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,EAAqE,CAAA;QACpF,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACrI,MAAM,GAAG,GAAG,GAAG,CAAC,GAA2D,CAAA;QAC3E,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,IAAI,MAAM,GAAG,CAAC,CAAA;QAClF,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAA;IAC9F,CAAC,CAAA;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;AACvD,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAC3B,KAAY,EACZ,OAA+D,EAC/D,MAA+B,EAC/B,UAAkB;IAElB,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAoC,EAAE,CAAA;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;YACnD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;YAC5D,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAA;YACtF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IAC/D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IACtF,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAA;QACzD,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;QACxD,OAAO,CAAC,CAAA;IACV,CAAC,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1F,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC,CAAA;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACpC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC1F,MAAM,EAAE,MAAM;SACf,CAAA;IACH,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAE,CAAC,KAAK,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,CAAC,CAAA;QAC1I,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,GAAG,CAAC,EAAE,CAAC,CAAA;QACxE,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAA;IACnC,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAAmD;IAC9F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAyB,CAAC,CAAA;IAC5E,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;YACnD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;YAC7D,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,CAAA;YACvF,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/graph.d.ts

@@ -0,0 +1,54 @@
+import type { ZodOnDelete, ZodRelationSpec } from './schema.js';
+export interface EdgeOptions<From extends string = string, To extends string = string> {
+    /** 源表字段（outKey） */
+    from: From;
+    /** 目标列；默认目标表主键 id */
+    to?: To;
+    kind?: 'one' | 'many';
+    onDelete?: ZodOnDelete;
+    /** false 时只生成读取关系，不生成 FK */
+    foreignKey?: boolean;
+    /** 反向关系名；省略则不生成反向关系 */
+    reverse?: string;
+    /** 反向关系基数；默认 many。仅 reverse 存在时生效 */
+    reverseKind?: 'one' | 'many';
+}
+/** 关系边：目标表只写一次，目标列默认 id */
+export type EdgeSpec<Target extends string, From extends string, To extends string = 'id', Reverse extends string | undefined = undefined, ReverseKind extends 'one' | 'many' = 'many'> = ZodRelationSpec & {
+    readonly to: `${Target}.${To}`;
+    readonly from: From;
+    /** 内部标记：用于 defineSchema 的 target key 类型校验 */
+    readonly _target: Target;
+} & (Reverse extends string ? {
+    readonly reverse: Reverse;
+    readonly reverseKind: ReverseKind;
+} : {});
+export interface ManyToManyOptions<Through extends string, From extends string, To extends string, Source extends string = 'id', TargetColumn extends string = 'id'> {
+    /** through 表的 schema key */
+    through: Through;
+    /** through 表中指向当前表的列 */
+    from: From;
+    /** through 表中指向目标表的列 */
+    to: To;
+    /** 当前表的连接列；默认 id */
+    source?: Source;
+    /** 目标表的连接列；默认 id */
+    target?: TargetColumn;
+}
+/** many-to-many：通过显式 through 表连接；只读关系，不生成 FK */
+export type ManyToManySpec<Target extends string, Through extends string, From extends string, To extends string, Source extends string = 'id', TargetColumn extends string = 'id'> = ZodRelationSpec & {
+    readonly to: `${Target}.${TargetColumn}`;
+    readonly from: Source;
+    readonly through: Through;
+    readonly throughFrom: From;
+    readonly throughTo: To;
+    readonly _manyToMany: true;
+    /** 内部标记：用于 defineSchema 的 target key 类型校验 */
+    readonly _target: Target;
+};
+export declare function manyToMany<const Target extends string, const Through extends string, const From extends string, const To extends string, const Source extends string = 'id', const TargetColumn extends string = 'id'>(target: Target, opts: ManyToManyOptions<Through, From, To, Source, TargetColumn>): ManyToManySpec<Target, Through, From, To, Source, TargetColumn>;
+export declare function edge<const Target extends string, const From extends string, const To extends string = 'id', const Reverse extends string | undefined = undefined, const ReverseKind extends 'one' | 'many' = 'many'>(target: Target, opts: EdgeOptions<From, To> & {
+    reverse?: Reverse;
+    reverseKind?: ReverseKind;
+}): EdgeSpec<Target, From, To, Reverse, ReverseKind>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

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

package/dist/graph.js

@@ -0,0 +1,52 @@
+export function manyToMany(target, opts) {
+    if (!opts.through)
+        throw new Error('manyToMany: through 不能为空');
+    if (!opts.from || opts.from.includes('.')) {
+        throw new Error(`manyToMany: from 必须是 through 表的单列名（收到 "${opts.from}"）`);
+    }
+    if (!opts.to || opts.to.includes('.')) {
+        throw new Error(`manyToMany: to 必须是 through 表的单列名（收到 "${opts.to}"）`);
+    }
+    if (opts.from === opts.to)
+        throw new Error('manyToMany: from 和 to 不能是同一列');
+    const source = opts.source ?? 'id';
+    const targetColumn = opts.target ?? 'id';
+    return {
+        from: source,
+        to: `${target}.${targetColumn}`,
+        through: opts.through,
+        throughFrom: opts.from,
+        throughTo: opts.to,
+        _manyToMany: true,
+        _target: target,
+    };
+}
+export function edge(target, opts) {
+    const column = opts.to ?? 'id';
+    if (!column || column.includes('.')) {
+        throw new Error(`edge: 目标列必须是不含 "." 的单列名（收到 "${column}"）`);
+    }
+    if (opts.reverse !== undefined && !opts.reverse) {
+        throw new Error('edge: reverse 不能为空字符串');
+    }
+    if (opts.reverse === undefined && opts.reverseKind !== undefined) {
+        throw new Error('edge: reverseKind 需要同时提供 reverse');
+    }
+    const base = {
+        from: opts.from,
+        to: `${target}.${column}`,
+        _target: target,
+        ...(opts.kind ? { kind: opts.kind } : {}),
+        ...(opts.onDelete ? { onDelete: opts.onDelete } : {}),
+        ...(opts.foreignKey !== undefined ? { foreignKey: opts.foreignKey } : {}),
+    };
+    if (opts.reverse !== undefined) {
+        return {
+            ...base,
+            reverse: opts.reverse,
+            reverseKind: opts.reverseKind ?? 'many',
+        };
+    }
+    return base;
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAwEA,MAAM,UAAU,UAAU,CAQxB,MAAc,EACd,IAAgE;IAEhE,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC9D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,CAAC,IAAI,IAAI,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;IACtE,CAAC;IACD,IAAK,IAAI,CAAC,IAAe,KAAM,IAAI,CAAC,EAAa;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IAClG,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAA;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAA;IACxC,OAAO;QACL,IAAI,EAAE,MAAgB;QACtB,EAAE,EAAE,GAAG,MAAM,IAAI,YAAY,EAAiC;QAC9D,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,IAAI;QACtB,SAAS,EAAE,IAAI,CAAC,EAAE;QAClB,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,MAAM;KAChB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAOlB,MAAc,EACd,IAA8E;IAE9E,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAA;IAC9B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,IAAI,CAAC,CAAA;IAC5D,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC1C,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,GAAG,MAAM,IAAI,MAAM,EAAuB;QAC9C,OAAO,EAAE,MAAM;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAA;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,MAAM;SACuB,CAAA;IAClE,CAAC;IACD,OAAO,IAAwD,CAAA;AACjE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { defineSchema, node, zoddb, type DefinedSchema, type GraphEdges, type GraphNode, type GraphNodeOptions, type GraphNodes, type GraphSchemaInput, type SchemaDb, type SchemaDefinition, type SchemaInsertOf, type TableClient, type ZodColumnMeta, type ZodDbOptions, type ZodOnDelete, type ZodRelationSpec, type ZodSchemaOptions, type ZodSchemaShape, type ZodTableOptions, type ZodTables, } from './schema.js';
+export { edge, manyToMany, type EdgeOptions, type EdgeSpec, type ManyToManyOptions, type ManyToManySpec, } from './graph.js';
+export { relationGraph, type RelationGraph, type RelationGraphColumn, type RelationGraphEdge, type RelationGraphNode, type RelationGraphThrough, } from './relation-graph.js';
+export type { CreateInput, CreateResult, LinkWrite, NestedWrite, UpdateInput, UpdateNestedWrite, WithInput, WithRelationOptions, WithResult, WithRow, } from './relations.js';
+export type { FilterOperator, FilterValue, FindManyOptions, OrderBy, WhereFilter, } from './filter.js';
+export type { AggregateOptions, AggKey, AggRow } from './aggregate.js';
+export { ZodDbError, UndefinedParamError, NoRowsError, RowValidationError, IncludeAliasError, PgError, UniqueViolationError, NotNullViolationError, ForeignKeyViolationError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EAAE,IAAI,EAAE,KAAK,EACzB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAC3F,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAClG,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAC7E,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,GACjF,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,IAAI,EAAE,UAAU,EAChB,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,GAC7E,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EACpE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,GAClD,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EACjF,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,OAAO,GACpD,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,GACnE,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EACL,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EACnF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,wBAAwB,GAC/E,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// graph-only public surface：开发者只需要建模入口 + zoddb 运行时 + graph IR。
+export { defineSchema, node, zoddb, } from './schema.js';
+export { edge, manyToMany, } from './graph.js';
+export { relationGraph, } from './relation-graph.js';
+export { ZodDbError, UndefinedParamError, NoRowsError, RowValidationError, IncludeAliasError, PgError, UniqueViolationError, NotNullViolationError, ForeignKeyViolationError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EACL,YAAY,EAAE,IAAI,EAAE,KAAK,GAK1B,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,IAAI,EAAE,UAAU,GAEjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,aAAa,GAGd,MAAM,qBAAqB,CAAA;AAS5B,OAAO,EACL,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EACnF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,wBAAwB,GAC/E,MAAM,aAAa,CAAA"}

package/dist/init.d.ts

@@ -0,0 +1,12 @@
+export interface InitOptions {
+    cwd: string;
+    force?: boolean;
+    docker?: boolean;
+}
+export interface InitResult {
+    created: string[];
+    skipped: string[];
+}
+/** 只写已知 scaffold 文件；已有文件默认跳过，force 才覆盖。 */
+export declare function initProject(opts: InitOptions): InitResult;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAyCD,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAsBzD"}

package/dist/init.js

@@ -0,0 +1,62 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const CONFIG = `export default {
+  schema: './schema.mts',
+  migrations: './migrations',
+}
+`;
+const SCHEMA = `import { z } from 'zod'
+import { defineSchema, node } from '@ailnaf/zoddb'
+
+export const schema = defineSchema({
+  nodes: {
+    posts: node(z.object({
+      id: z.uuid(),
+      title: z.string(),
+      createdAt: z.date(),
+    })),
+  },
+})
+`;
+const ENV = `DATABASE_URL=postgres://postgres:postgres@localhost:5432/zoddb
+`;
+const COMPOSE = `services:
+  db:
+    image: postgres:17
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: zoddb
+    ports:
+      - "5432:5432"
+    volumes:
+      - zoddb-data:/var/lib/postgresql/data
+
+volumes:
+  zoddb-data:
+`;
+/** 只写已知 scaffold 文件；已有文件默认跳过，force 才覆盖。 */
+export function initProject(opts) {
+    const cwd = opts.cwd;
+    mkdirSync(cwd, { recursive: true });
+    const files = [
+        ['zoddb.config.mts', CONFIG],
+        ['schema.mts', SCHEMA],
+        ['.env.example', ENV],
+    ];
+    if (opts.docker)
+        files.push(['docker-compose.yml', COMPOSE]);
+    const created = [];
+    const skipped = [];
+    for (const [name, content] of files) {
+        const path = join(cwd, name);
+        if (existsSync(path) && !opts.force) {
+            skipped.push(name);
+            continue;
+        }
+        writeFileSync(path, content, 'utf8');
+        created.push(name);
+    }
+    return { created, skipped };
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAahC,MAAM,MAAM,GAAG;;;;CAId,CAAA;AAED,MAAM,MAAM,GAAG;;;;;;;;;;;;CAYd,CAAA;AAED,MAAM,GAAG,GAAG;CACX,CAAA;AAED,MAAM,OAAO,GAAG;;;;;;;;;;;;;;CAcf,CAAA;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;IACpB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,MAAM,KAAK,GAA4B;QACrC,CAAC,kBAAkB,EAAE,MAAM,CAAC;QAC5B,CAAC,YAAY,EAAE,MAAM,CAAC;QACtB,CAAC,cAAc,EAAE,GAAG,CAAC;KACtB,CAAA;IACD,IAAI,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAA;IAE5D,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACpC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC7B,CAAC"}

package/dist/migrate.d.ts

@@ -0,0 +1,58 @@
+import type postgres from 'postgres';
+import type { Db } from './db.js';
+import type { Table } from './table.js';
+import type { RelationGraph } from './relation-graph.js';
+export interface LiveColumn {
+    name: string;
+    type: string;
+    notNull: boolean;
+    default: string | null;
+}
+export interface SchemaDiff {
+    /** 可直接执行的 SQL（additive） */
+    statements: string[];
+    /** 破坏性语句：默认拒绝，需要 allowDestructive */
+    destructive: string[];
+}
+export interface LiveIndex {
+    table: string;
+    name: string;
+    columns: string[];
+    unique: boolean;
+}
+export interface LiveConstraint {
+    table: string;
+    name: string;
+    kind: 'u' | 'f' | 'p';
+    columns: string[];
+    /** FK 目标表 */
+    refTable?: string;
+    /** FK 目标列 */
+    refColumns?: string[];
+    /** FK on delete 动作 */
+    onDelete?: string;
+}
+export interface LiveCheck {
+    table: string;
+    name: string;
+    definition: string;
+}
+/** 把 format_type() 与我们的 sqlType 归一到同一写法 */
+export declare function normalizeType(t: string): string;
+/** 去掉 PG 的 ::cast 与外层括号，便于比较默认值 */
+export declare function normalizeDefault(d: string | null): string | null;
+export declare function introspect(client: postgres.Sql, tableNames: readonly string[]): Promise<Map<string, Map<string, LiveColumn>>>;
+export interface DiffOptions {
+    /** defineSchema 的 relationGraph；用于校验 graph 与 references() 的 FK 语义一致 */
+    graph?: RelationGraph;
+}
+export declare function diffSchema(db: {
+    raw: postgres.Sql;
+}, tables: readonly Table[], opts?: DiffOptions): Promise<SchemaDiff>;
+export interface PushOptions {
+    /** 明确允许删列/改类型等破坏性操作 */
+    allowDestructive?: boolean;
+}
+/** 把数据库推到 tables 定义的结构；返回本次 diff。幂等：无差异时不执行任何 SQL。 */
+export declare function pushSchema(db: Db, tables: readonly Table[], opts?: PushOptions): Promise<SchemaDiff>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAGpC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qCAAqC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAID,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACrB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AAsBD,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAMhE;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,QAAQ,CAAC,GAAG,EACpB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAiC/C;AA2MD,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE;IAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAA;CAAE,EACzB,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAkLrB;AAED,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,sDAAsD;AACtD,wBAAsB,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW9G"}