@fett/sql-translator 0.0.1-beta

package/lib/driver/mysql/version.js

@@ -0,0 +1,77 @@
+export const MYSQL5_CAPS = {
+    major: 5,
+    supportsCTE: false,
+    supportsWindowFunctions: false,
+    supportsJson: true,
+};
+export const MYSQL8_CAPS = {
+    major: 8,
+    supportsCTE: true,
+    supportsWindowFunctions: true,
+    supportsJson: true,
+};
+/** 解析 VERSION() 字符串 → 能力矩阵 */
+export function parseMysqlVersion(version) {
+    const m = String(version || '').match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return { major: 0, supportsCTE: false, supportsWindowFunctions: false, supportsJson: false };
+    const major = Number(m[1]);
+    const minor = Number(m[2]);
+    const patch = Number(m[3]);
+    return {
+        major,
+        supportsCTE: major >= 8,
+        supportsWindowFunctions: major >= 8,
+        supportsJson: major > 5 || (major === 5 && (minor > 7 || (minor === 7 && patch >= 8))),
+    };
+}
+/** 通过 SELECT VERSION() 探测（knex raw 对 mysql2 返回 [rows, fields]） */
+export async function detectMysqlVersion(k) {
+    const res = (await k.raw('SELECT VERSION() AS v'));
+    const rows = (Array.isArray(res) ? res[0] : res);
+    const version = rows?.[0]?.v ?? '';
+    return parseMysqlVersion(version);
+}
+/** 解析 MariaDB VERSION() → 能力矩阵（10.2+ CTE / 10.3+ 窗口函数 / 10.2+ JSON） */
+export function parseMariaDbVersion(version) {
+    // MariaDB 常见格式：'10.11.4-MariaDB'、'5.5.5-10.6.12-MariaDB-0+deb11u1'
+    const m = String(version || '').match(/(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return { major: 0, supportsCTE: false, supportsWindowFunctions: false, supportsJson: false };
+    const major = Number(m[1]);
+    const minor = Number(m[2]);
+    return {
+        major,
+        supportsCTE: major >= 10 && minor >= 2,
+        supportsWindowFunctions: major >= 10 && minor >= 3,
+        supportsJson: major >= 10 && minor >= 2,
+    };
+}
+/** 探测 VERSION() 原始字符串 */
+export async function detectVersionString(k) {
+    const res = (await k.raw('SELECT VERSION() AS v'));
+    const rows = (Array.isArray(res) ? res[0] : res);
+    return rows?.[0]?.v ?? '';
+}
+/** 按 config.version 解析能力（强制模式 / auto 探测；isMariaDb 决定解析器） */
+export async function resolveMysqlCapabilities(k, versionChoice, isMariaDb = false) {
+    if (!isMariaDb) {
+        if (versionChoice === '5')
+            return MYSQL5_CAPS;
+        if (versionChoice === '8')
+            return MYSQL8_CAPS;
+        return detectMysqlVersion(k);
+    }
+    // MariaDB：强制模式 10/11 走对应矩阵，auto 探测
+    const mariaMajor = versionChoice === '10' ? 10 : versionChoice === '11' ? 11 : 0;
+    if (mariaMajor) {
+        return {
+            major: mariaMajor,
+            supportsCTE: true,
+            supportsWindowFunctions: mariaMajor >= 11,
+            supportsJson: true,
+        };
+    }
+    return parseMariaDbVersion(await detectVersionString(k));
+}
+//# sourceMappingURL=version.js.map

package/lib/driver/mysql/version.js.map

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

package/lib/driver/postgresql/index.d.ts

@@ -0,0 +1,34 @@
+import type { SqlDriver, PoolHandle } from '../interface.js';
+import type { PostgresqlConfig, SchemaOptions } from '../../types/config.js';
+import type { ExecResult, Field, RunSqlRequest, TestResult } from '../../types/result.js';
+import type { TableSchema } from '../../types/schema.js';
+import type { IntrospectTask } from '../../types/task.js';
+import type { TransactionHandle } from '../../types/transaction.js';
+import { PostgresqlPoolHandle } from './pool.js';
+type Knex = Awaited<ReturnType<PostgresqlPoolHandle['getKnex']>>;
+/** PG $n 占位符 → knex '?'（knex pg 只支持 ? bindings） */
+export declare function pgParamsToQuestion(sql: string): string;
+export declare class PostgresqlDriver implements SqlDriver {
+    readonly dialect = "postgresql";
+    createPool(config: PostgresqlConfig): Promise<PoolHandle>;
+    testConnection(config: PostgresqlConfig): Promise<TestResult>;
+    getTableList(pool: PoolHandle): Promise<string[]>;
+    getTableDDL(pool: PoolHandle, table: string): Promise<string>;
+    getPreviewRows(pool: PoolHandle, table: string, offset: number, limit: number, whereClause?: string): Promise<any[]>;
+    getColumns(pool: PoolHandle, table: string): Promise<Field[]>;
+    getRowsCount(pool: PoolHandle, table: string, whereClause?: string): Promise<number>;
+    runSql(pool: PoolHandle, request: RunSqlRequest): Promise<ExecResult>;
+    /** 事务/常规共用执行核心（k 可指定为事务连接） */
+    runSqlWithKnex(k: Knex, handle: PostgresqlPoolHandle, request: RunSqlRequest): Promise<ExecResult>;
+    /** 事务：knex.transaction（fn 抛错自动回滚，成功自动提交） */
+    withTransaction<T>(pool: PoolHandle, fn: (tx: TransactionHandle) => Promise<T>): Promise<T>;
+    private bind;
+    private runSelect;
+    private mapFields;
+    private runDml;
+    getTableSchema(pool: PoolHandle, table: string): Promise<TableSchema>;
+    getAllTableSchemas(pool: PoolHandle, opts?: SchemaOptions): IntrospectTask<TableSchema[]>;
+}
+export declare const postgresqlDriver: PostgresqlDriver;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/driver/postgresql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/driver/postgresql/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EACV,UAAU,EACV,KAAK,EAEL,aAAa,EACb,UAAU,EAEX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAA+C,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAoB,MAAM,WAAW,CAAC;AAEnE,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEjE,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAmBD,qBAAa,gBAAiB,YAAW,SAAS;IAChD,QAAQ,CAAC,OAAO,gBAAgB;IAE1B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IASzD,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC7D,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUjD,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB7D,cAAc,CAClB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,EAAE,CAAC;IAQX,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA+B7D,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWpF,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAM3E,8BAA8B;IAC9B,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBlG,4CAA4C;IACtC,eAAe,CAAC,CAAC,EACrB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC;IAsBb,OAAO,CAAC,IAAI;YAIE,SAAS;YAwCT,SAAS;YAaT,MAAM;IA+Cd,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA6H3E,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;CAoB1F;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/lib/driver/postgresql/index.js

@@ -0,0 +1,383 @@
+/**
+ * PostgreSQL 驱动
+ * 元数据：pg_tables / information_schema / pg_type OID 解析
+ * 执行：SELECT 分页（CTE 包装）、DML（rowCount + RETURNING）、DDL 透传
+ */
+import knex from 'knex';
+import { SqlEngineError, wrapError } from '../../errors.js';
+import { normalizeSql } from '../../core/sql/normalize.js';
+import { hasPaginationClause, buildPagedSql, buildCountSql, wrapWithWhereClause, } from '../../core/sql/pagination.js';
+import { detectStatementType, isDmlStatement, hasDmlWhere, countInsertValueRows, } from '../../core/sql/statement.js';
+import { createTask } from '../../types/task.js';
+import { mapPostgresColumnsToFields } from '../../core/field-mapper/postgresql.js';
+import { PostgresqlPoolHandle, buildPgSslConfig } from './pool.js';
+/** PG $n 占位符 → knex '?'（knex pg 只支持 ? bindings） */
+export function pgParamsToQuestion(sql) {
+    return String(sql).replace(/\$(\d+)/g, '?');
+}
+/** 批量解析 OID → typname */
+async function resolvePostgresTypeOids(k, oids) {
+    const map = new Map();
+    if (!oids.length)
+        return map;
+    const res = (await k.raw('SELECT oid, typname FROM pg_type WHERE oid = ANY(?)', [oids]));
+    for (const row of res.rows || [])
+        map.set(row.oid, row.typname);
+    return map;
+}
+export class PostgresqlDriver {
+    dialect = 'postgresql';
+    async createPool(config) {
+        if (config.type !== 'postgresql') {
+            throw new SqlEngineError('UNSUPPORTED_DIALECT', `postgresql 驱动收到 ${config.type} 配置`);
+        }
+        return new PostgresqlPoolHandle(config);
+    }
+    // ==================== 连接测试 ====================
+    async testConnection(config) {
+        let k = null;
+        try {
+            k = knex({
+                client: 'pg',
+                connection: {
+                    host: config.host,
+                    port: Number(config.port ?? 5432),
+                    user: config.user || config.username,
+                    password: config.password,
+                    database: config.database,
+                    ssl: buildPgSslConfig(config),
+                    connectionTimeoutMillis: 5000,
+                },
+            });
+            await k.raw('SELECT 1');
+            return { success: true, message: 'PostgreSQL connection test successful' };
+        }
+        catch (err) {
+            const e = err;
+            return { success: false, message: `PostgreSQL connection test failed: ${e.message}` };
+        }
+        finally {
+            if (k) {
+                try {
+                    await k.destroy();
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+    }
+    // ==================== 元信息 ====================
+    async getTableList(pool) {
+        const k = await pool.getKnex();
+        const schema = pool.config.schema || 'public';
+        const res = (await k.raw('SELECT tablename FROM pg_tables WHERE schemaname = ? ORDER BY tablename', [schema]));
+        return (res.rows || []).map((r) => r.tablename);
+    }
+    async getTableDDL(pool, table) {
+        const k = await pool.getKnex();
+        const schema = pool.config.schema || 'public';
+        const res = (await k.raw(`SELECT column_name, data_type, character_maximum_length,
+              numeric_precision, numeric_scale, is_nullable, column_default
+       FROM information_schema.columns
+       WHERE table_schema = ? AND table_name = ?
+       ORDER BY ordinal_position`, [schema, table]));
+        const columns = res.rows || [];
+        if (!columns.length)
+            return '';
+        const lines = columns.map((col) => {
+            let typeStr = col.data_type;
+            if (col.character_maximum_length)
+                typeStr += `(${col.character_maximum_length})`;
+            if (col.numeric_precision && col.numeric_scale)
+                typeStr += `(${col.numeric_precision},${col.numeric_scale})`;
+            const nullable = col.is_nullable === 'YES' ? '' : ' NOT NULL';
+            const defaultVal = col.column_default ? ` DEFAULT ${col.column_default}` : '';
+            return `  "${col.column_name}" ${typeStr}${nullable}${defaultVal}`;
+        });
+        return `CREATE TABLE "${table}" (\n${lines.join(',\n')}\n);`;
+    }
+    async getPreviewRows(pool, table, offset, limit, whereClause) {
+        const k = await pool.getKnex();
+        let query = k(table).select('*');
+        if (whereClause)
+            query = query.whereRaw(whereClause);
+        const rows = await query.limit(limit).offset(offset);
+        return rows;
+    }
+    async getColumns(pool, table) {
+        const k = await pool.getKnex();
+        const schema = pool.config.schema || 'public';
+        const res = (await k.raw(`SELECT
+         c.column_name AS "Field",
+         c.data_type AS "Type",
+         c.is_nullable AS "Null",
+         c.column_default AS "Default",
+         col_description(
+           (quote_ident(c.table_schema) || '.' || quote_ident(c.table_name))::regclass,
+           c.ordinal_position
+         ) AS "Comment",
+         (CASE WHEN EXISTS (
+           SELECT 1 FROM information_schema.table_constraints tc
+           JOIN information_schema.key_column_usage kcu
+             ON tc.constraint_name = kcu.constraint_name
+             AND tc.table_schema = kcu.table_schema
+           WHERE tc.constraint_type = 'PRIMARY KEY'
+             AND tc.table_schema = ?
+             AND kcu.table_name = ?
+             AND kcu.column_name = c.column_name
+         ) THEN 'PRI' ELSE '' END) AS "Key"
+       FROM information_schema.columns c
+       WHERE c.table_schema = ? AND c.table_name = ?
+       ORDER BY c.ordinal_position`, [schema, table, schema, table]));
+        return mapPostgresColumnsToFields((res.rows || []));
+    }
+    async getRowsCount(pool, table, whereClause) {
+        const k = await pool.getKnex();
+        let query = k(table).count({ total: '*' });
+        if (whereClause)
+            query = query.whereRaw(whereClause);
+        const row = await query.first();
+        const total = row ? Number(row.total) : 0;
+        return Number.isNaN(total) ? 0 : total;
+    }
+    // ==================== SQL 执行 ====================
+    async runSql(pool, request) {
+        const handle = pool;
+        const k = await handle.getKnex();
+        return this.runSqlWithKnex(k, handle, request);
+    }
+    /** 事务/常规共用执行核心（k 可指定为事务连接） */
+    runSqlWithKnex(k, handle, request) {
+        const sql = pgParamsToQuestion(normalizeSql(request.sql));
+        const type = detectStatementType(sql);
+        try {
+            if (isDmlStatement(type)) {
+                return this.runDml(handle, k, sql, request.params, type, request.dml);
+            }
+            if (type === 'SELECT') {
+                return this.runSelect(k, sql, request);
+            }
+            if (type === 'DDL' || type === 'TRANSACTION') {
+                return k.raw(sql, this.bind(request.params)).then((res) => ({
+                    affectedRows: Number(res.rowCount ?? 0),
+                }));
+            }
+            throw new SqlEngineError('QUERY_FAILED', `暂不支持执行 ${type} 语句`);
+        }
+        catch (err) {
+            if (err instanceof SqlEngineError)
+                return Promise.reject(err);
+            return Promise.reject(wrapError('QUERY_FAILED', err));
+        }
+    }
+    /** 事务：knex.transaction（fn 抛错自动回滚，成功自动提交） */
+    async withTransaction(pool, fn) {
+        const handle = pool;
+        const k = await handle.getKnex();
+        const self = this;
+        return k.transaction(async (trx) => {
+            const tx = {
+                runSql: (req) => self.runSqlWithKnex(trx, handle, req),
+                query: (sql, params) => self.runSqlWithKnex(trx, handle, { sql, params }),
+                execute: (sql, params) => self.runSqlWithKnex(trx, handle, { sql, params }),
+                commit: async () => {
+                    await trx.commit();
+                },
+                rollback: async () => {
+                    await trx.rollback();
+                },
+            };
+            return fn(tx);
+        });
+    }
+    bind(params) {
+        return (params ?? []);
+    }
+    async runSelect(k, sql, request) {
+        const offset = Math.max(Number(request.offset ?? 0), 0);
+        const limit = Math.max(Number(request.limit ?? 100), 0);
+        const params = this.bind(request.params);
+        let baseSql = sql;
+        if (request.whereClause) {
+            baseSql = wrapWithWhereClause(sql, request.whereClause, { supportsCTE: true }); // PG 8.4+
+        }
+        // 用户 SQL 自带分页 → 直接执行
+        if (hasPaginationClause(baseSql, [/\bfetch\s+first\b/i, /\btop\b/i])) {
+            const res = (await k.raw(baseSql, params));
+            const fields = await this.mapFields(k, res.fields || []);
+            return { rows: res.rows, fields, total: res.rows.length, offset, limit };
+        }
+        const countRes = (await k.raw(buildCountSql(baseSql), params));
+        const total = Number(countRes.rows?.[0]?.total ?? 0);
+        const pageRes = (await k.raw(buildPagedSql(baseSql, limit, offset), params));
+        const fields = await this.mapFields(k, pageRes.fields || []);
+        return {
+            rows: pageRes.rows,
+            fields,
+            total: Number.isNaN(total) ? 0 : total,
+            offset,
+            limit,
+        };
+    }
+    async mapFields(k, rawFields) {
+        const oidMap = await resolvePostgresTypeOids(k, rawFields.map((f) => f.dataTypeID).filter(Boolean));
+        const columns = rawFields.map((field) => ({
+            Field: field.name,
+            Type: oidMap.get(field.dataTypeID) || 'text',
+            Default: null,
+        }));
+        return mapPostgresColumnsToFields(columns);
+    }
+    async runDml(handle, k, sql, params, type, dmlOverride) {
+        const dml = dmlOverride ?? handle.config.dml ?? {};
+        const args = this.bind(params);
+        if ((type === 'UPDATE' || type === 'DELETE') &&
+            dml.requireWhereForUpdateDelete !== false &&
+            !hasDmlWhere(sql)) {
+            throw new SqlEngineError('DML_BLOCKED', `禁止无 WHERE 的 ${type}（config.dml.requireWhereForUpdateDelete 可关闭）`);
+        }
+        if (type === 'INSERT' && dml.maxInsertRows) {
+            const rows = countInsertValueRows(sql);
+            if (rows > dml.maxInsertRows) {
+                throw new SqlEngineError('DML_BLOCKED', `INSERT 行数 ${rows} 超过上限 ${dml.maxInsertRows}`);
+            }
+        }
+        let execSql = sql;
+        const hasReturning = /\breturning\b/i.test(sql);
+        const needReturning = dml.returning && !hasReturning;
+        if (needReturning) {
+            execSql = `${sql} RETURNING *`;
+        }
+        const res = (await k.raw(execSql, args));
+        const writeResult = { affectedRows: Number(res.rowCount ?? 0) };
+        // SQL 自带 RETURNING 或 dml.returning → 回传被写行
+        if (hasReturning || needReturning) {
+            writeResult.returning = res.rows || [];
+            writeResult.affectedRows = writeResult.returning.length;
+        }
+        return writeResult;
+    }
+    // ==================== 结构 JSON 检出 ====================
+    async getTableSchema(pool, table) {
+        const handle = pool;
+        const k = await handle.getKnex();
+        const schema = handle.config.schema || 'public';
+        // 字段（复用 getColumns 的查询，扩展序号与注释）
+        const colRes = (await k.raw(`SELECT
+         c.column_name AS "Field", c.data_type AS "Type", c.is_nullable AS "Null",
+         c.column_default AS "Default", c.ordinal_position,
+         col_description((quote_ident(c.table_schema) || '.' || quote_ident(c.table_name))::regclass, c.ordinal_position) AS "Comment",
+         (CASE WHEN EXISTS (
+           SELECT 1 FROM information_schema.table_constraints tc
+           JOIN information_schema.key_column_usage kcu
+             ON tc.constraint_name = kcu.constraint_name AND tc.table_schema = kcu.table_schema
+           WHERE tc.constraint_type = 'PRIMARY KEY' AND tc.table_schema = ? AND kcu.table_name = ? AND kcu.column_name = c.column_name
+         ) THEN 'PRI' ELSE '' END) AS "Key"
+       FROM information_schema.columns c
+       WHERE c.table_schema = ? AND c.table_name = ?
+       ORDER BY c.ordinal_position`, [schema, table, schema, table]));
+        const columns = colRes.rows || [];
+        if (!columns.length) {
+            throw new SqlEngineError('TABLE_NOT_FOUND', `表 ${table} 不存在`);
+        }
+        // 索引
+        const idxRes = (await k.raw(`SELECT i.relname AS index_name, ix.indisunique AS is_unique,
+              x.attname AS column_name, ix.indkey
+       FROM pg_index ix
+       JOIN pg_class t ON t.oid = ix.indrelid
+       JOIN pg_class i ON i.oid = ix.indexrelid
+       JOIN pg_namespace n ON n.oid = t.relnamespace
+       JOIN unnest(ix.indkey) WITH ORDINALITY AS k(attnum, ord) ON true
+       JOIN pg_attribute x ON x.attrelid = t.oid AND x.attnum = k.attnum
+       WHERE n.nspname = ? AND t.relname = ?
+       ORDER BY i.relname, k.ord`, [schema, table]));
+        const indexMap = new Map();
+        for (const r of idxRes.rows || []) {
+            let idx = indexMap.get(r.index_name);
+            if (!idx) {
+                idx = { name: r.index_name, unique: r.is_unique, columns: [], type: undefined };
+                indexMap.set(r.index_name, idx);
+            }
+            idx.columns.push(r.column_name);
+        }
+        // 外键
+        const fkRes = (await k.raw(`SELECT tc.constraint_name, kcu.column_name AS column_name,
+              ccu.table_name AS ref_table, ccu.column_name AS ref_column,
+              rc.delete_rule, rc.update_rule
+       FROM information_schema.table_constraints tc
+       JOIN information_schema.key_column_usage kcu
+         ON tc.constraint_name = kcu.constraint_name AND tc.table_schema = kcu.table_schema
+       JOIN information_schema.constraint_column_usage ccu
+         ON ccu.constraint_name = tc.constraint_name AND ccu.table_schema = tc.table_schema
+       JOIN information_schema.referential_constraints rc
+         ON rc.constraint_name = tc.constraint_name AND rc.constraint_schema = tc.table_schema
+       WHERE tc.constraint_type = 'FOREIGN KEY' AND tc.table_schema = ? AND tc.table_name = ?
+       ORDER BY tc.constraint_name, kcu.ordinal_position`, [schema, table]));
+        const fkMap = new Map();
+        for (const r of fkRes.rows || []) {
+            let fk = fkMap.get(r.constraint_name);
+            if (!fk) {
+                fk = {
+                    name: r.constraint_name,
+                    columns: [],
+                    refTable: r.ref_table,
+                    refColumns: [],
+                    onDelete: r.delete_rule || undefined,
+                    onUpdate: r.update_rule || undefined,
+                };
+                fkMap.set(r.constraint_name, fk);
+            }
+            fk.columns.push(r.column_name);
+            fk.refColumns.push(r.ref_column);
+        }
+        // 表注释
+        const cmtRes = (await k.raw(`SELECT obj_description((quote_ident(?) || '.' || quote_ident(?))::regclass) AS comment`, [schema, table]));
+        const comment = cmtRes.rows?.[0]?.comment || undefined;
+        const columnSchemas = columns.map((c) => ({
+            name: c.Field,
+            type: String(c.Type),
+            nullable: c.Null === 'YES',
+            default: c.Default,
+            comment: c.Comment || undefined,
+            primaryKey: String(c.Key || '').toUpperCase() === 'PRI',
+            autoIncrement: false, // PG 无列级 auto_increment 概念（serial 反映在 default）
+            ordinal: Number(c.ordinal_position),
+        }));
+        return {
+            name: table,
+            schema,
+            kind: 'table',
+            comment,
+            columns: columnSchemas,
+            indexes: [...indexMap.values()],
+            foreignKeys: [...fkMap.values()],
+            ddl: await this.getTableDDL(handle, table),
+            raw: {},
+        };
+    }
+    getAllTableSchemas(pool, opts) {
+        const handle = pool;
+        const self = this;
+        return createTask(async (ctx) => {
+            const tables = await self.getTableList(handle);
+            const total = tables.length;
+            const schemas = [];
+            for (let i = 0; i < tables.length; i++) {
+                if (ctx.isCancelled())
+                    break;
+                ctx.report({ stage: 'introspecting', processed: i, total, message: tables[i] });
+                try {
+                    schemas.push(await self.getTableSchema(handle, tables[i]));
+                }
+                catch {
+                    // 单表失败不中断
+                }
+            }
+            void opts;
+            return schemas;
+        });
+    }
+}
+export const postgresqlDriver = new PostgresqlDriver();
+//# sourceMappingURL=index.js.map

package/lib/driver/postgresql/index.js.map

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

package/lib/driver/postgresql/pool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PostgreSQL 连接池句柄（Knex/pg）
+ */
+import { type Knex } from 'knex';
+import type { PoolHandle } from '../interface.js';
+import type { PostgresqlConfig } from '../../types/config.js';
+/** 构建 PostgreSQL SSL 配置 */
+export declare function buildPgSslConfig(config: PostgresqlConfig): {
+    ca: string | undefined;
+    cert: string | undefined;
+    key: string | undefined;
+    rejectUnauthorized: boolean;
+} | undefined;
+export declare class PostgresqlPoolHandle implements PoolHandle {
+    readonly fingerprint: string;
+    readonly config: PostgresqlConfig;
+    private knexInstance;
+    private destroyedFlag;
+    constructor(config: PostgresqlConfig);
+    get destroyed(): boolean;
+    /** 获取 Knex 实例（懒创建） */
+    getKnex(): Promise<Knex>;
+    get stats(): {
+        active: number;
+        idle: number;
+        waiting: number;
+        createdTotal: number;
+        destroyedTotal: number;
+    };
+    ping(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=pool.d.ts.map

package/lib/driver/postgresql/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/driver/postgresql/pool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAa,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,2BAA2B;AAC3B,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB;;;;;cAQxD;AAED,qBAAa,oBAAqB,YAAW,UAAU;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,gBAAgB;IAKpC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,sBAAsB;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC9B,IAAI,KAAK;;;;;;MAqBR;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B"}