sqlite-executor 4.0.2 → 4.0.4

package/dist/esm/core/pipelineEngine.d.mts

@@ -12,6 +12,8 @@ export interface PipelineEngineOptions {
 	logger?: { error?: (...args: any[]) => void };
 	/** 管线化批量大小，控制一次 stdin.write 合并几条语句，默认 10 */
 	batchSize?: number;
+	/** 最大 inflight 任务数，默认 50 */
+	maxInflight?: number;
 	/** 任务超时时的回调 */
 	onTaskTimeout?: (task: any) => void;
 }

package/dist/esm/core/process.d.mts

@@ -11,8 +11,14 @@ export declare class ProcessManager {
 	 * @param options.initMode 初始化模式
 	 *   - `"wal"` （默认）：启动时通过 `-cmd` 设置 WAL 模式 + busy_timeout
 	 *   - `"none"`：不添加任何初始化参数（适用于 reader，直接继承数据库已有 WAL 模式）
+	 * @param options.onDrain  drain 回调，当 stdin pipe 重新可写时调用
 	 */
-	constructor(options?: { binary?: string; database?: string; initMode?: "wal" | "none" });
+	constructor(options?: {
+		binary?: string;
+		database?: string;
+		initMode?: "wal" | "none";
+		onDrain?: () => void;
+	});
 
 	/** 当前使用的 sqlite3 可执行文件路径 */
 	get binary(): string;
@@ -20,6 +26,12 @@ export declare class ProcessManager {
 	/** 底层子进程实例，未启动时为 null */
 	get process(): ChildProcess | null;
 
+	/**
+	 * drain 状态，true 表示 OS pipe 已满，应暂停写入 stdin。
+	 * 当 pipe 重新可写时 drain 事件触发，draining 恢复为 false。
+	 */
+	get draining(): boolean;
+
 	/**
 	 * 启动子进程（json 模式），返回 ChildProcess 实例。
 	 * @throws {Error} 如果 binary 路径为空或文件不存在
@@ -29,6 +41,9 @@ export declare class ProcessManager {
 	/** 向子进程的 stdin 写入数据 */
 	write(data: string): void;
 
+	/** 注册 drain 回调，当 pipe 重新可写时被调用。 */
+	setOnDrainCallback(fn: () => void): void;
+
 	/**
 	 * 终止子进程。
 	 * 先尝试 SIGTERM，3 秒后未退出则 SIGKILL。

package/dist/esm/core/taskWorker.d.mts

@@ -1,3 +1,5 @@
+import { Metrics } from "./metrics.mts";
+
 /**
  * 单个 sqlite3 进程 Worker，支持管线化（pipelining）。
  *
@@ -18,6 +20,8 @@ export class TaskWorker {
 	 * @param options.name              Worker 名称，用于日志和调试
 	 * @param options.initMode          子进程初始化模式（参考 ProcessManager）
 	 * @param options.batchSize         管线化批量大小，默认 10
+	 * @param options.maxInflight       最大 inflight 任务数，默认 50
+	 * @param options.metrics           指标收集器
 	 */
 	constructor(options: {
 		binary: string;
@@ -27,6 +31,8 @@ export class TaskWorker {
 		name?: string;
 		initMode?: "wal" | "none";
 		batchSize?: number;
+		maxInflight?: number;
+		metrics?: Metrics;
 	});
 
 	/** Worker 名称 */