dsh-db-tool 1.7.0 → 1.7.1

package/dist/adapters/dmdb/index.js

@@ -9,9 +9,10 @@
  *  - DM 事务隐式开始，无需 SET TRANSACTION。
  *
  * 驱动要点：
- *  - db.createPool({ connectString: 'dm://user:pass@host:5236', poolMin: 1, poolMax: 10,
- *    poolTimeout: 60, queueTimeout: 60000 })；不启用压缩（默认 compress=0，规避
- *    @napi-rs/snappy 跨平台坑）。
+ *  - db.createPool({ connectString: 'dm://user:pass@host:5236', poolAlias: <逐池唯一>,
+ *    poolMin: 1, poolMax: 10, poolTimeout: 60, queueTimeout: 60000 })；不启用压缩
+ *    （默认 compress=0，规避 @napi-rs/snappy 跨平台坑）。
+ *  - poolAlias 必须逐池唯一（不传即撞驱动缺省 'default' 并抛 [20006]；见 nextPoolAlias 注释）。
  *  - execute 必须显式 maxRows（默认 0=无限制）；autoCommit 显式传 true 使语义
  *    不依赖驱动默认（驱动连接属性默认已是自动提交：dmdb connection.js
  *    conn_prop_autoCommit = !0；d.ts 三级优先链 执行选项 > dmdb.autoCommit > 连接属性）。
@@ -84,6 +85,39 @@ export function resolveDmConn(conn) {
     const password = typeof f.password === 'string' ? f.password : '';
     return { connectString: `dm://${encodeURIComponent(user)}:${encodeURIComponent(password)}@${host}:${port}`, user, password };
 }
+/**
+ * 连接池别名：dmdb 把池登记在模块级全局 Map（dmdb.pools），key 即 poolAlias。
+ * 驱动缺省别名恒为 'default'（driver/pool.js `_poolAlias = "default"`，仅显式传参才覆盖），
+ * 且判重无条件执行 → 不传别名时第二个池必抛 [20006] 连接池别名已存在（src/dm.js:236）。
+ * 本插件同进程内可并存多个池（连接的 ro/rw 各一份缓存、testConnection/testDraft 的
+ * 一次性池、控制台事务会话、数据传输独立池），故必须逐池唯一。
+ * 别名同时是 close 的回收键：正常路径 driver/pool.js 会 `pools.delete(alias)`，
+ * 但 close 抛错的异常分支会跳过该删除（登记项残留，插件侧无可观测点）。
+ */
+let poolSeq = 0;
+function nextPoolAlias(conn) {
+    return `dsh-dm-${conn.meta.id}-${++poolSeq}`;
+}
+/** 建池（连接串解析、池参数与别名单点维护，供适配器与数据传输入口共用） */
+async function createDmPool(conn) {
+    const { connectString } = resolveDmConn(conn);
+    try {
+        // 注意：实参对象不要直接包进 `as unknown as` 断言——变异工具不为该形态生成
+        // ObjectLiteral 变异体，「删掉 poolAlias」这类关键退化会在变异报告中不可见（已验证）。
+        const pool = await db.createPool({
+            connectString,
+            poolAlias: nextPoolAlias(conn),
+            poolMin: 1,
+            poolMax: 10,
+            poolTimeout: 60,
+            queueTimeout: 60000,
+        });
+        return pool;
+    }
+    catch (e) {
+        throw humanizeDmError(e);
+    }
+}
 export async function createDmAdapter(conn, opts) {
     const mode = opts?.mode ?? 'rw';
     let pool;
@@ -91,19 +125,7 @@ export async function createDmAdapter(conn, opts) {
         pool = opts.pool;
     }
     else {
-        const { connectString } = resolveDmConn(conn);
-        try {
-            pool = (await db.createPool({
-                connectString,
-                poolMin: 1,
-                poolMax: 10,
-                poolTimeout: 60,
-                queueTimeout: 60000,
-            }));
-        }
-        catch (e) {
-            throw humanizeDmError(e);
-        }
+        pool = await createDmPool(conn);
     }
     /** 默认 execute 选项：显式 maxRows（dmdb 默认 0=无限制，必须覆盖）+ 显式 autoCommit:true
      *  （驱动连接属性默认已是 true，显式传递仅让语义不依赖驱动默认；SELECT 立即结束隐式事务，避免 ro 事务悬挂） */
@@ -335,19 +357,7 @@ export async function createDmAdapter(conn, opts) {
     return adapter;
 }
 export const factory = async (conn) => createDmAdapter(conn);
-/** 数据传输读写端用的独立连接池 */
+/** 数据传输读写端用的独立连接池（别名逐池唯一，可与主连接池并存） */
 export async function openDmPool(conn) {
-    const { connectString } = resolveDmConn(conn);
-    try {
-        return (await db.createPool({
-            connectString,
-            poolMin: 1,
-            poolMax: 10,
-            poolTimeout: 60,
-            queueTimeout: 60000,
-        }));
-    }
-    catch (e) {
-        throw humanizeDmError(e);
-    }
+    return await createDmPool(conn);
 }

package/dist/adapters/oracle/index.js

@@ -2,8 +2,10 @@
  * Oracle 适配器（oracledb v7 thin 模式，DB 12.1+）。
  *
  * 设计要点（依据官方文档调研）：
- *  - oracledb.createPool({ user, password, connectString, poolMin: 1, poolMax: 10, poolTimeout: 60 })。
+ *  - oracledb.createPool({ user, password, connectString, poolAlias: <逐池唯一>,
+ *    poolMin: 1, poolMax: 10, poolTimeout: 60 })。
  *    禁止 SYSDBA 等特权连接（不透传 privilege）。
+ *  - poolAlias 显式传唯一值：不传则落到匿名池（不可经 getPool() 检索），见 createOraPool 注释。
  *  - CLOB 经全局 fetchAsString 转字符串；BLOB 经全局 fetchAsBuffer 转 Buffer。
  *    （fetchInfo 的键是【列名】而非类型名，按类型统一转换只能用全局 fetchXXX 属性——
  *    官方 connection.rst「fetchInfo」节：「Each column is specified by name」）
@@ -129,6 +131,37 @@ export function resolveOracleConn(conn) {
         connectString: `${host}:${port}/${service}`,
     };
 }
+/**
+ * 连接池别名：oracledb 的规则与 dmdb 不同——只有「显式传入的别名」或
+ * 「'default' 尚空闲时取到的缺省值」会登记进模块级 poolCache；两者都被占用时
+ * 驱动创建的是 poolAlias === undefined 的匿名池（不报错，也无法经 getPool() 检索），
+ * 只有显式重复别名才抛 NJS-046（lib/oracledb.js:640-649、lib/errors.js:352）。
+ * 本插件同进程内可并存多个池（连接的 ro/rw 各一份缓存、testConnection/testDraft 的
+ * 一次性池、控制台事务会话、数据传输独立池），故显式传唯一别名：每池身份可检索，
+ * 且不抢占 getPool() 的缺省键 'default'。回收靠 '_afterPoolClose' 事件（close 抛错则不触发）。
+ */
+let poolSeq = 0;
+function nextPoolAlias(conn) {
+    return `dsh-ora-${conn.meta.id}-${++poolSeq}`;
+}
+/** 建池（连接串解析、池参数与别名单点维护，供适配器与数据传输入口共用） */
+async function createOraPool(conn) {
+    const { user, password, connectString } = resolveOracleConn(conn);
+    try {
+        return await oracledb.createPool({
+            user,
+            password,
+            connectString,
+            poolAlias: nextPoolAlias(conn),
+            poolMin: 1,
+            poolMax: 10,
+            poolTimeout: 60,
+        });
+    }
+    catch (e) {
+        throw humanizeOraError(e);
+    }
+}
 export async function createOracleAdapter(conn, opts) {
     const mode = opts?.mode ?? 'rw';
     let pool;
@@ -136,20 +169,7 @@ export async function createOracleAdapter(conn, opts) {
         pool = opts.pool;
     }
     else {
-        const { user, password, connectString } = resolveOracleConn(conn);
-        try {
-            pool = await oracledb.createPool({
-                user,
-                password,
-                connectString,
-                poolMin: 1,
-                poolMax: 10,
-                poolTimeout: 60,
-            });
-        }
-        catch (e) {
-            throw humanizeOraError(e);
-        }
+        pool = await createOraPool(conn);
     }
     function requireRw(action) {
         if (mode === 'ro') {
@@ -387,20 +407,7 @@ export async function createOracleAdapter(conn, opts) {
     return adapter;
 }
 export const factory = async (conn) => createOracleAdapter(conn);
-/** 数据传输读写端用的独立连接池（复用 resolveOracleConn 与错误包装） */
+/** 数据传输读写端用的独立连接池（别名逐池唯一，可与主连接池并存） */
 export async function openOraclePool(conn) {
-    const { user, password, connectString } = resolveOracleConn(conn);
-    try {
-        return await oracledb.createPool({
-            user,
-            password,
-            connectString,
-            poolMin: 1,
-            poolMax: 10,
-            poolTimeout: 60,
-        });
-    }
-    catch (e) {
-        throw humanizeOraError(e);
-    }
+    return await createOraPool(conn);
 }

package/dist/adapters/sql-shared/pg-like.js

@@ -202,6 +202,10 @@ export async function createPgLikeAdapter(kind, Driver, conn, opts) {
     setupPool(pool);
     // 事务激活期间所有 query/execute 路由到同一 client
     let txClient = null;
+    /** close 幂等标志：pg-pool 的 end() 二次调用会抛 "Called end on pool more than once"，
+     *  而 manager 的 console 会话在授权复核失败路径会重复关闭同一适配器（见 manager 的
+     *  finish('rollback') 与外层 catch）——重复 close 须为 no-op。 */
+    let closed = false;
     const run = (sql, params) => txClient ? txClient.query(sql, params) : pool.query(sql, params);
     // 跨库浏览（Navicat 行为）：树列出服务器上所有库，展开非连接库时用同一凭据开指向该库的池。
     // 池按库缓存复用；ro 模式下新池同样套会话只读。连接自身的库（fields.database 或 url 库名）直接复用主池。
@@ -387,6 +391,9 @@ export async function createPgLikeAdapter(kind, Driver, conn, opts) {
             return toQueryResult(res);
         }),
         close: () => humanize(`${kind} 关闭连接`, async () => {
+            if (closed)
+                return; // 幂等：重复 close 为 no-op（见 closed 声明处注释）
+            closed = true;
             await Promise.all([pool.end(), ...[...dbPools.values()].map((p) => p.end())]);
         }),
     };

package/dist/adapters/sqlite/index.js

@@ -114,6 +114,10 @@ export function stmtColumns(stmt, raw) {
 export async function createSqliteAdapter(conn, opts) {
     const readOnly = opts?.mode === 'ro';
     const { db, driver } = await openRaw(conn, readOnly);
+    /** close 幂等：node:sqlite 的 DatabaseSync.close() 二次调用抛 "database is not open"，
+     *  而 manager 的 runScript 超时路径会对同一会话适配器重复 close
+     *  （onTimeout 与 finally 各一次）——重复 close 必须为 no-op。 */
+    let closed = false;
     return {
         kind: 'sqlite',
         connId: conn.meta.id,
@@ -175,6 +179,9 @@ export async function createSqliteAdapter(conn, opts) {
             return toQueryResult(raw, stmtColumns(stmt, raw));
         }),
         close: () => humanize('sqlite 关闭连接', async () => {
+            if (closed)
+                return; // 幂等：重复 close 为 no-op（见 closed 声明处注释）
+            closed = true;
             db.close();
         }),
     };

package/dist/adapters/transfer/model.js

@@ -35,8 +35,16 @@ export async function createTransferReader(rc, loc) {
         const pool = kind === 'oracle'
             ? (await (await import('../oracle/index.js')).openOraclePool(rc))
             : (await (await import('../dmdb/index.js')).openDmPool(rc));
-        // owner = 定位第一层（oracle/dm 单库多 schema 模型），缺省连接用户
-        return oralike.createOraLikeTransferReader(kind, pool, loc?.database ?? oralike.ownerOfFromConn(rc));
+        // owner = 定位第一层（oracle/dm 单库多 schema 模型），缺省连接用户。
+        // owner 非法（超长/含 NUL 换行）或缺失在构造期同步抛错，此时池已建而无人持有 →
+        // 登记项永不释放（池泄漏）。故构造期任何抛错都要回收该池。
+        try {
+            return oralike.createOraLikeTransferReader(kind, pool, loc?.database ?? oralike.ownerOfFromConn(rc));
+        }
+        catch (e) {
+            await pool.close().catch(() => { });
+            throw e;
+        }
     }
     if (kind === 'mongodb') {
         const { createMongoTransferReaderFromConn } = await import('./kinds/mongo.js');
@@ -66,8 +74,15 @@ export async function createTransferWriter(rc, writeMode = 'insert', loc) {
         const pool = kind === 'oracle'
             ? (await (await import('../oracle/index.js')).openOraclePool(rc))
             : (await (await import('../dmdb/index.js')).openDmPool(rc));
-        // 写入 owner = 定位第一层，缺省连接用户默认 schema（写端以 owner 前缀显式限定）
-        return oralike.createOraLikeTransferWriter(kind, pool, writeMode, loc?.database ?? oralike.ownerOfFromConn(rc));
+        // 写入 owner = 定位第一层，缺省连接用户默认 schema（写端以 owner 前缀显式限定）。
+        // 与读端同理：owner 非法/缺失在构造期同步抛错，池已建而无人持有 → 必须回收。
+        try {
+            return oralike.createOraLikeTransferWriter(kind, pool, writeMode, loc?.database ?? oralike.ownerOfFromConn(rc));
+        }
+        catch (e) {
+            await pool.close().catch(() => { });
+            throw e;
+        }
     }
     if (kind === 'mongodb') {
         const { createMongoTransferWriterFromConn } = await import('./kinds/mongo.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-db-tool",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "DSH community plugin: chat-operated multi-database admin tool with sidebar management, project-scoped grants, ro/rw modes and dangerous-operation confirmation",
   "type": "module",
   "license": "MIT",