@rex0220/kintone-sql-tools 3.69.0 → 3.71.0

package/dist-engine/meta/bundle-baseline.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-08-21T12:27:30.712Z",
+  "generatedAt": "2026-08-21T22:20:59.339Z",
   "baseline": "B66 Phase1 initial measured values; no arbitrary size ceiling",
   "bundles": {
     "index.cjs": {
       "inputCount": 115,
-      "minifiedBytes": 679936,
-      "gzipBytes": 185593,
+      "minifiedBytes": 680354,
+      "gzipBytes": 185838,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -24,8 +24,8 @@
     },
     "index.mjs": {
       "inputCount": 115,
-      "minifiedBytes": 679391,
-      "gzipBytes": 185273,
+      "minifiedBytes": 679809,
+      "gzipBytes": 185514,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -44,8 +44,8 @@
     },
     "ksql-engine.umd.js": {
       "inputCount": 117,
-      "minifiedBytes": 680415,
-      "gzipBytes": 185617,
+      "minifiedBytes": 680833,
+      "gzipBytes": 185830,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],

package/dist-engine/meta/cjs.json

@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 590529,
+      "bytes": 611305,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2460,7 +2460,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 235571
+          "bytesInOutput": 235989
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2517,7 +2517,7 @@
           "bytesInOutput": 1406
         }
       },
-      "bytes": 679936
+      "bytes": 680354
     }
   }
 }

package/dist-engine/meta/esm.json

@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 590529,
+      "bytes": 611305,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2464,7 +2464,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 235571
+          "bytesInOutput": 235989
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2524,7 +2524,7 @@
           "bytesInOutput": 16
         }
       },
-      "bytes": 679391
+      "bytes": 679809
     }
   }
 }

package/dist-engine/meta/umd.json

@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 590529,
+      "bytes": 611305,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2478,7 +2478,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 235571
+          "bytesInOutput": 235989
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2544,7 +2544,7 @@
           "bytesInOutput": 127
         }
       },
-      "bytes": 680415
+      "bytes": 680833
     }
   }
 }

package/dist-flow/flow-library/index.d.ts

@@ -1,12 +1,14 @@
 import { createKintoneClient } from "./writableClient";
 import { KsqlFlowError } from "./errors";
-import type { CreateExecutionContextOptions, Diagnostic, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, ParseScriptOptions, ParseScriptResult, Statement, StatementResult, ValidateScriptOptions } from "./publicTypes";
+import type { CreateExecutionContextOptions, Diagnostic, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, ParseScriptOptions, ParseScriptResult, PreviewResult, PreviewStatementOptions, Statement, StatementResult, ValidateScriptOptions } from "./publicTypes";
 export declare const version: string;
 export declare function parseScript(source: string, opts?: ParseScriptOptions): ParseScriptResult;
 export declare function validateScript(source: string, opts?: ValidateScriptOptions): Promise<Diagnostic[]>;
 export declare function explainScript(source: string, opts: ExplainScriptOptions): Promise<ExplainScriptResult>;
 export declare function createExecutionContext(opts: CreateExecutionContextOptions): ExecutionContext;
+export declare function previewStatement(statement: Statement, context: ExecutionContext, opts?: PreviewStatementOptions): Promise<PreviewResult>;
 export declare function executeStatement(statement: Statement, context: ExecutionContext): Promise<StatementResult>;
 export declare function disposeExecutionContext(context: ExecutionContext): Promise<void>;
+export { isDmlResult } from "./publicTypes";
 export { createKintoneClient, KsqlFlowError };
-export type { CreateExecutionContextOptions, CreateKintoneClientConfig, Diagnostic, DiagnosticCode, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, FieldInfo, FlowKintoneClient, ParseScriptOptions, ParseScriptResult, SchemaResolver, ScriptHeaderMeta, Statement, StatementResult, StatementResultKind, ValidateScriptOptions, } from "./publicTypes";
+export type { CreateExecutionContextOptions, CreateKintoneClientConfig, Diagnostic, DiagnosticCode, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, FieldInfo, FlowChunkWrittenInfo, FlowDeleteResult, FlowDmlResult, FlowInsertResult, FlowKintoneClient, FlowUpdateResult, FlowUpsertResult, ParseScriptOptions, ParseScriptResult, PreviewResult, PreviewSample, PreviewStatementOptions, SchemaResolver, ScriptHeaderMeta, Statement, StatementResult, StatementResultKind, ValidateScriptOptions, } from "./publicTypes";

package/dist-flow/flow-library/publicTypes.d.ts

@@ -123,6 +123,10 @@ export interface ValidateScriptOptions extends ParseScriptOptions {
 export interface ExplainScriptOptions extends ParseScriptOptions {
     client: FlowKintoneClient;
     variables?: Readonly<Record<string, string>>;
+    /** dialect 1 の @ 付き時刻関数が共有する explain 呼出し単位の基準時刻。 */
+    asOf?: Date;
+    /** @TODAY() などの暦日境界に使う IANA timezone。省略時はホスト timezone。 */
+    timezone?: string;
     maxRecords?: number;
     cursorMaxActive?: number;
     dmlMaxRows?: number;
@@ -161,6 +165,23 @@ export interface CreateExecutionContextOptions extends ParseScriptOptions {
     asOf?: Date;
     timezone?: string;
     continueOnError?: boolean;
+    /**
+     * 書込 API の各成功直後に await される。順序は現在の書込順であり、キー順は保証しない。
+     * コールバックが throw した場合、その文は error になるが、通知対象チャンクは書込済み。
+     */
+    onChunkWritten?: (info: FlowChunkWrittenInfo) => void | Promise<void>;
+}
+export interface FlowChunkWrittenInfo {
+    /** バッチ内の文 index（0 始まり）。 */
+    statementIndex: number;
+    /** 書込 API に渡される物理アプリ ID（LAPP は解決済み）。 */
+    appId: number;
+    operation: "INSERT" | "UPDATE" | "DELETE";
+    records: number;
+    /** その文で成功した書込 API リクエストの index（0 始まり）。 */
+    chunkIndex: number;
+    /** 単一キー UPSERT でキー値を payload から特定できる場合のみ設定される。 */
+    lastKeyValue?: string;
 }
 declare const executionContextBrand: unique symbol;
 /** Opaque, sequential-only statement execution handle. */
@@ -195,6 +216,30 @@ export interface ExecutionMetrics {
     limitReachedApps: number[];
     elapsedMs: number;
 }
+export interface FlowInsertResult {
+    type: "INSERT";
+    createdIds: string[][];
+    insertedCount: number;
+}
+export interface FlowUpdateResult {
+    type: "UPDATE";
+    updatedCount: number;
+}
+export interface FlowDeleteResult {
+    type: "DELETE";
+    deletedCount: number;
+}
+export interface FlowUpsertResult {
+    type: "UPSERT";
+    insertedCount: number;
+    updatedCount: number;
+}
+/**
+ * /flow が安定契約とする通常 DML 結果。
+ * 実体に APPLY / IMPORT 系の任意フィールドが載っていても、それらはこの契約の対象外。
+ */
+export type FlowDmlResult = FlowInsertResult | FlowUpdateResult | FlowDeleteResult | FlowUpsertResult;
+export declare function isDmlResult(result: unknown): result is FlowDmlResult;
 export type StatementResultKind = "STATEMENT" | "ASSERT_PASSED" | "ASSERT_WARNING" | "ASSERT_VIOLATION" | "EXIT_NO_DATA";
 export interface StatementResult {
     index: number;
@@ -206,8 +251,39 @@ export interface StatementResult {
     rowCount?: number;
     error?: StatementError;
     skippedReason?: string;
+    /** コンテキスト開始から当該文終了時までの累積 deep-copy スナップショット。文単位値は前回との差分で求める。 */
     metrics: ExecutionMetrics;
 }
+export interface PreviewStatementOptions {
+    /** Number of write-order samples to return. Defaults to 5. */
+    maxSamples?: number;
+}
+export interface PreviewSample {
+    kind: "insert" | "update" | "delete";
+    /** UPSERT key, or the kintone record ID for DELETE. */
+    key?: string;
+    /** Current values of assignment target fields only. */
+    before?: Record<string, string>;
+    /** Values that the DML statement would write. */
+    after?: Record<string, string>;
+}
+export interface PreviewResult {
+    kind: "PREVIEW";
+    operation: "INSERT" | "UPDATE" | "DELETE" | "UPSERT";
+    /** Physical kintone app ID after logical-app routing. */
+    appId: number;
+    counts: {
+        insert: number;
+        update: number;
+        delete: number;
+    };
+    /** First maxSamples entries in actual write order. */
+    samples: PreviewSample[];
+    /** Record-read API calls consumed by this preview. */
+    reads: number;
+    /** Estimated 100-record write API calls for an ordinary execution. */
+    estimatedWrites: number;
+}
 export interface CreateKintoneClientConfig {
     baseUrl: string;
     guestSpaceId?: number;