@rex0220/kintone-sql-tools 3.70.0 → 3.71.0

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

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-08-21T15:03:34.935Z",
+  "generatedAt": "2026-08-21T22:20:59.339Z",
   "baseline": "B66 Phase1 initial measured values; no arbitrary size ceiling",
   "bundles": {
     "index.cjs": {
       "inputCount": 115,
-      "minifiedBytes": 680144,
-      "gzipBytes": 185767,
+      "minifiedBytes": 680354,
+      "gzipBytes": 185838,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -24,8 +24,8 @@
     },
     "index.mjs": {
       "inputCount": 115,
-      "minifiedBytes": 679599,
-      "gzipBytes": 185448,
+      "minifiedBytes": 679809,
+      "gzipBytes": 185514,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -44,8 +44,8 @@
     },
     "ksql-engine.umd.js": {
       "inputCount": 117,
-      "minifiedBytes": 680623,
-      "gzipBytes": 185765,
+      "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": 593690,
+      "bytes": 611305,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2460,7 +2460,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 235779
+          "bytesInOutput": 235989
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2517,7 +2517,7 @@
           "bytesInOutput": 1406
         }
       },
-      "bytes": 680144
+      "bytes": 680354
     }
   }
 }

package/dist-engine/meta/esm.json

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

package/dist-engine/meta/umd.json

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

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

@@ -1,13 +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, FlowChunkWrittenInfo, FlowDeleteResult, FlowDmlResult, FlowInsertResult, FlowKintoneClient, FlowUpdateResult, FlowUpsertResult, 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

@@ -254,6 +254,36 @@ export interface StatementResult {
     /** コンテキスト開始から当該文終了時までの累積 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;