@rex0220/kintone-sql-tools 3.27.0 → 3.29.0

package/dist-engine/batch.d.ts

@@ -0,0 +1,13 @@
+import type { BatchResult, RunBatchOptions } from "./publicTypes";
+/**
+ * Executes a read-only multi-statement batch.
+ *
+ * In addition to the row-returning statements accepted by runQuery, this API
+ * accepts CREATE/DROP TEMP TABLE, SET, DECLARE, ASSERT, and EXPLAIN. IMPORT,
+ * APPLY, DML VALIDATE ONLY, and writing DML remain outside the library boundary.
+ *
+ * If any statement fails, this function throws KsqlEngineError without
+ * returning partial results. statementIndex and statementType identify the
+ * failed statement.
+ */
+export declare function runBatch(sql: string, options: RunBatchOptions): Promise<BatchResult>;

package/dist-engine/errors.d.ts

@@ -1,8 +1,13 @@
 export declare class KsqlEngineError extends Error {
     readonly code: "PARSE_ERROR" | "READ_ONLY_VIOLATION" | "SEARCH_ABORTED" | "FETCH_LIMIT_EXCEEDED" | "CLIENT_ERROR" | "EXECUTION_ERROR";
     readonly cause?: unknown;
+    /** Zero-based index of the failed statement when raised by runBatch. */
+    readonly statementIndex?: number;
+    /** Parser statement type of the failed statement when raised by runBatch. */
+    readonly statementType?: string;
     constructor(code: KsqlEngineError["code"], message: string, cause?: unknown);
 }
+export declare function withStatementDiagnostic(error: KsqlEngineError, statementIndex: number, statementType: string): KsqlEngineError;
 export declare function readOnlyViolation(message: string): KsqlEngineError;
 export declare function parseError(message: string, cause?: unknown): KsqlEngineError;
 export declare function searchAborted(): KsqlEngineError;