sqlite-executor 4.0.4 → 4.0.6

package/dist/esm/utils/interpolate.d.mts

@@ -1,3 +1,14 @@
+import type { SQLTemplate } from "./normalize";
+
+/**
+ * 使用预解析的模板替换参数，避免重新扫描 SQL。
+ *
+ * @param template - 由 `normalizeSQLTemplate` 返回的预解析模板
+ * @param params   - 要插值的参数数组
+ * @returns 插值后的完整 SQL 字符串
+ */
+export function interpolateFromTemplate(template: SQLTemplate, params: any[]): string;
+
 /**
  * 替换 SQL 语句中的 `?` 占位符为转义后的参数值。
  *

package/dist/esm/utils/normalize.d.mts

@@ -5,3 +5,27 @@
  * @returns 规范化后的 SQL 语句
  */
 export function normalizeSQL(sql: string): string;
+
+export interface SQLTemplate {
+	/** 规范化后的完整 SQL 字符串 */
+	normalized: string;
+	/**
+	 * 以 `?` 为分隔符的片段数组。
+	 * - segments[0] 为第一个 `?` 之前的部分
+	 * - segments[n] 为第 n 个 `?` 之后、第 n+1 个 `?` 之前的部分
+	 * - 最后一个元素为最后一个 `?` 之后的部分
+	 * - 无 `?` 时 segments 为 [normalized]
+	 */
+	segments: string[];
+	/** `?` 占位符的数量 */
+	paramCount: number;
+}
+
+/**
+ * 单次扫描同时完成 SQL 规范化和 `?` 占位符追踪。
+ * 避免 `normalizeSQL` + `_parseTemplate` 两次扫描的重复开销。
+ *
+ * @param sql - 原始 SQL 语句
+ * @returns 包含规范化结果和占位符信息的模板对象
+ */
+export function normalizeSQLTemplate(sql: string): SQLTemplate;

package/dist/esm/utils/timeout.d.mts

@@ -3,9 +3,10 @@ export const DEFAULT_STATEMENT_TIMEOUT: 30000;
 
 /**
  * 创建包含 SQL 上下文的超时错误。
+ * 注意：sql 应已由调用方完成规范化，本函数不再内部调用 normalizeSQL。
  *
  * @param timeout - 超时时间（毫秒）
- * @param sql     - 超时发生时正在执行的 SQL 语句
+ * @param sql     - 超时发生时正在执行的 SQL 语句（已规范化）
  * @returns 包含超时时间和 SQL 信息的 Error 实例
  */
 export function createTimeoutError(timeout: number, sql: string): Error;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sqlite-executor",
-    "version": "4.0.4",
+    "version": "4.0.6",
     "private": false,
     "description": "SQLite executor for Node.js",
     "sideEffects": false,