dsh-sql 0.2.0 → 0.3.0

package/README.en.md

@@ -38,6 +38,8 @@ dsh plugin --profile web add dsh-sql
         user: root
         database: legacy
     maxRows: 1000                     # query row cap (1-10000)
+    queryTimeoutMs: 60000             # per-query timeout (default 60s, 5s - 10min)
+    execTimeoutMs: 120000             # per-write timeout (default 120s, 5s - 10min)
     readOnly: false                   # true disables sql_exec
     writeApproval: true               # approve write operations first (default true)
 ```
@@ -80,7 +82,7 @@ sql_exec { sql: UPDATE orders SET status = 'paid' WHERE id = 42 }
 
 ```bash
 pnpm install
-pnpm test       # build + 33 tests, including a real SQLite integration suite
+pnpm test       # build + 35 tests, including a real SQLite integration suite
 ```
 
 ## License

package/README.md

@@ -38,6 +38,8 @@ dsh plugin --profile web add dsh-sql
         user: root
         database: legacy
     maxRows: 1000                     # 查询返回行数上限（1-10000）
+    queryTimeoutMs: 60000             # 单次查询超时（默认 60 秒，5 秒 - 10 分钟）
+    execTimeoutMs: 120000             # 单次写操作超时（默认 120 秒，5 秒 - 10 分钟）
     readOnly: false                   # true 时禁用 sql_exec
     writeApproval: true               # 写操作先弹审批（默认 true）
 ```
@@ -80,7 +82,7 @@ sql_exec { sql: UPDATE orders SET status = 'paid' WHERE id = 42 }
 
 ```bash
 pnpm install
-pnpm test       # 构建 + 33 个测试（含真实 SQLite 集成）
+pnpm test       # 构建 + 35 个测试（含真实 SQLite 集成）
 ```
 
 ## License

package/cordis.patch.yml

@@ -12,6 +12,8 @@
 #           engine: sqlite
 #           file: E:\data\app.db
 #       maxRows: 1000      # sql_query 返回行数上限（1-10000，默认 1000）
+      queryTimeoutMs: 60000 # 单次查询超时（5 秒 - 10 分钟）
+      execTimeoutMs: 120000 # 单次写操作超时（5 秒 - 10 分钟）
 #       readOnly: false    # true 时 sql_exec 被禁用
 #       writeApproval: true # 写操作先弹审批（默认 true）
 #

package/lib/config.d.ts

@@ -20,6 +20,8 @@ export interface SqlConfig {
     maxRows?: number;
     readOnly?: boolean;
     writeApproval?: boolean;
+    queryTimeoutMs?: number;
+    execTimeoutMs?: number;
 }
 /** 解析后的配置。 */
 export interface ResolvedSqlConfig {
@@ -27,6 +29,8 @@ export interface ResolvedSqlConfig {
     maxRows: number;
     readOnly: boolean;
     writeApproval: boolean;
+    queryTimeoutMs: number;
+    execTimeoutMs: number;
 }
 /** 连接密码环境变量名：DSH_SQL_PASSWORD_<NAME 大写>。 */
 export declare function passwordEnvName(name: string): string;

package/lib/config.js

@@ -53,9 +53,21 @@ export function resolveConfig(config, env = process.env) {
             throw new Error('maxRows 必须是大于 0 的整数。');
         maxRows = Math.min(10000, cfg.maxRows);
     }
+    let queryTimeoutMs = 60000;
+    if (cfg.queryTimeoutMs !== undefined) {
+        if (typeof cfg.queryTimeoutMs !== 'number' || !Number.isFinite(cfg.queryTimeoutMs) || cfg.queryTimeoutMs <= 0)
+            throw new Error('queryTimeoutMs 必须是大于 0 的数字（毫秒）。');
+        queryTimeoutMs = Math.min(600000, Math.max(5000, Math.round(cfg.queryTimeoutMs)));
+    }
+    let execTimeoutMs = 120000;
+    if (cfg.execTimeoutMs !== undefined) {
+        if (typeof cfg.execTimeoutMs !== 'number' || !Number.isFinite(cfg.execTimeoutMs) || cfg.execTimeoutMs <= 0)
+            throw new Error('execTimeoutMs 必须是大于 0 的数字（毫秒）。');
+        execTimeoutMs = Math.min(600000, Math.max(5000, Math.round(cfg.execTimeoutMs)));
+    }
     const readOnly = cfg.readOnly === true;
     const writeApproval = cfg.writeApproval !== false;
-    return { connections, maxRows, readOnly, writeApproval };
+    return { connections, maxRows, readOnly, writeApproval, queryTimeoutMs, execTimeoutMs };
 }
 /** 校验表名/标识符，防注入到 schema 语句。 */
 export function assertIdentifier(name, label) {

package/lib/tools.js

@@ -306,7 +306,7 @@ export function buildSqlTools(config) {
                 maxRows: cfg.maxRows,
             };
         },
-        timeoutMs: 60000,
+        timeoutMs: cfg.queryTimeoutMs,
     };
     const sqlExec = {
         name: 'sql_exec',
@@ -334,7 +334,7 @@ export function buildSqlTools(config) {
         gate(exec, next) {
             return next(); // 审批门由 index.ts 注入（需要宿主 ctx）
         },
-        timeoutMs: 120000,
+        timeoutMs: cfg.execTimeoutMs,
     };
     const sqlSchema = {
         name: 'sql_schema',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-sql",
-  "version": "0.2.0",
-  "description": "DSH 工程师级数据库插件：sql_list/query/exec/schema 四工具，SQLite/MySQL/PostgreSQL 三引擎、多连接、只读模式与写操作审批门、词法级只读保护与流式行数钳制。",
+  "version": "0.3.0",
+  "description": "DSH 工程师级数据库插件：sql_list/query/exec/schema 四工具，SQLite/MySQL/PostgreSQL 三引擎、多连接、只读模式与写操作审批门、词法级只读保护、流式行数钳制与可配置查询/写超时。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",