@rex0220/kintone-sql-tools 3.72.0 → 3.73.0

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

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-08-22T14:12:52.270Z",
+  "generatedAt": "2026-08-25T05:07:37.449Z",
   "baseline": "B66 Phase1 initial measured values; no arbitrary size ceiling",
   "bundles": {
     "index.cjs": {
       "inputCount": 115,
-      "minifiedBytes": 681350,
-      "gzipBytes": 186055,
+      "minifiedBytes": 688651,
+      "gzipBytes": 188753,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -24,8 +24,8 @@
     },
     "index.mjs": {
       "inputCount": 115,
-      "minifiedBytes": 680805,
-      "gzipBytes": 185758,
+      "minifiedBytes": 688106,
+      "gzipBytes": 188456,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -44,8 +44,8 @@
     },
     "ksql-engine.umd.js": {
       "inputCount": 117,
-      "minifiedBytes": 681829,
-      "gzipBytes": 186076,
+      "minifiedBytes": 689130,
+      "gzipBytes": 188779,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],

package/dist-engine/meta/cjs.json

@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 612635,
+      "bytes": 632385,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -1941,7 +1941,7 @@
       "format": "esm"
     },
     "src/engine-library/readonlyClient.ts": {
-      "bytes": 3122,
+      "bytes": 3057,
       "imports": [
         {
           "path": "src/engine-library/errors.ts",
@@ -2016,7 +2016,7 @@
       "format": "esm"
     },
     "src/engine-library/statementGuard.ts": {
-      "bytes": 5196,
+      "bytes": 5179,
       "imports": [
         {
           "path": "src/core/sql.ts",
@@ -2093,7 +2093,7 @@
       "format": "esm"
     },
     "src/engine-library/query.ts": {
-      "bytes": 4939,
+      "bytes": 5015,
       "imports": [
         {
           "path": "src/execute.ts",
@@ -2460,7 +2460,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 236495
+          "bytesInOutput": 243740
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2484,7 +2484,7 @@
           "bytesInOutput": 4310
         },
         "src/engine-library/readonlyClient.ts": {
-          "bytesInOutput": 1111
+          "bytesInOutput": 1127
         },
         "src/engine-library/cursorScope.ts": {
           "bytesInOutput": 766
@@ -2514,10 +2514,10 @@
           "bytesInOutput": 1025
         },
         "src/engine-library/query.ts": {
-          "bytesInOutput": 1406
+          "bytesInOutput": 1446
         }
       },
-      "bytes": 681350
+      "bytes": 688651
     }
   }
 }

package/dist-engine/meta/esm.json

@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 612635,
+      "bytes": 632385,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -1941,7 +1941,7 @@
       "format": "esm"
     },
     "src/engine-library/readonlyClient.ts": {
-      "bytes": 3122,
+      "bytes": 3057,
       "imports": [
         {
           "path": "src/engine-library/errors.ts",
@@ -2016,7 +2016,7 @@
       "format": "esm"
     },
     "src/engine-library/statementGuard.ts": {
-      "bytes": 5196,
+      "bytes": 5179,
       "imports": [
         {
           "path": "src/core/sql.ts",
@@ -2093,7 +2093,7 @@
       "format": "esm"
     },
     "src/engine-library/query.ts": {
-      "bytes": 4939,
+      "bytes": 5015,
       "imports": [
         {
           "path": "src/execute.ts",
@@ -2464,7 +2464,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 236495
+          "bytesInOutput": 243740
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2488,7 +2488,7 @@
           "bytesInOutput": 4313
         },
         "src/engine-library/readonlyClient.ts": {
-          "bytesInOutput": 1111
+          "bytesInOutput": 1127
         },
         "src/engine-library/cursorScope.ts": {
           "bytesInOutput": 766
@@ -2518,13 +2518,13 @@
           "bytesInOutput": 1025
         },
         "src/engine-library/query.ts": {
-          "bytesInOutput": 1406
+          "bytesInOutput": 1446
         },
         "src/engine-library/index.ts": {
           "bytesInOutput": 16
         }
       },
-      "bytes": 680805
+      "bytes": 688106
     }
   }
 }

package/dist-engine/meta/umd.json

@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 612635,
+      "bytes": 632385,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -1941,7 +1941,7 @@
       "format": "esm"
     },
     "src/engine-library/readonlyClient.ts": {
-      "bytes": 3122,
+      "bytes": 3057,
       "imports": [
         {
           "path": "src/engine-library/errors.ts",
@@ -2016,7 +2016,7 @@
       "format": "esm"
     },
     "src/engine-library/statementGuard.ts": {
-      "bytes": 5196,
+      "bytes": 5179,
       "imports": [
         {
           "path": "src/core/sql.ts",
@@ -2093,7 +2093,7 @@
       "format": "esm"
     },
     "src/engine-library/query.ts": {
-      "bytes": 4939,
+      "bytes": 5015,
       "imports": [
         {
           "path": "src/execute.ts",
@@ -2478,7 +2478,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 236495
+          "bytesInOutput": 243740
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2502,7 +2502,7 @@
           "bytesInOutput": 4313
         },
         "src/engine-library/readonlyClient.ts": {
-          "bytesInOutput": 1111
+          "bytesInOutput": 1127
         },
         "src/engine-library/cursorScope.ts": {
           "bytesInOutput": 766
@@ -2532,7 +2532,7 @@
           "bytesInOutput": 1025
         },
         "src/engine-library/query.ts": {
-          "bytesInOutput": 1406
+          "bytesInOutput": 1446
         },
         "src/engine-library/index.ts": {
           "bytesInOutput": 16
@@ -2544,7 +2544,7 @@
           "bytesInOutput": 127
         }
       },
-      "bytes": 681829
+      "bytes": 689130
     }
   }
 }

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

@@ -11,4 +11,4 @@ export declare function executeStatement(statement: Statement, context: Executio
 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, PreviewResult, PreviewSample, PreviewStatementOptions, SchemaResolver, ScriptHeaderMeta, Statement, StatementResult, StatementResultKind, ValidateScriptOptions, } from "./publicTypes";
+export type { CreateExecutionContextOptions, CreateKintoneClientConfig, Diagnostic, DiagnosticCode, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, FieldInfo, FlowChunkWrittenInfo, FlowDeleteResult, FlowDmlResult, FlowInsertResult, FlowKintoneClient, KintoneNativeUpdateKey, KintoneNativeUpsertRecord, KintoneNativeUpsertParams, KintoneNativeUpsertRecordResult, KintoneNativeUpsertResult, FlowUpdateResult, FlowUpsertResult, ParseScriptOptions, ParseScriptResult, PreviewResult, PreviewSample, PreviewStatementOptions, SchemaResolver, ScriptHeaderMeta, Statement, StatementResult, StatementResultKind, ValidateScriptOptions, } from "./publicTypes";

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

@@ -41,6 +41,27 @@ export interface KintoneRecordValue {
     }>;
 }
 export type KintoneRecord = Record<string, KintoneRecordValue>;
+export interface KintoneNativeUpdateKey {
+    field: string;
+    value: string;
+}
+export interface KintoneNativeUpsertRecord {
+    updateKey: KintoneNativeUpdateKey;
+    record: KintoneRecord;
+}
+export interface KintoneNativeUpsertParams {
+    app: number;
+    upsert: true;
+    records: KintoneNativeUpsertRecord[];
+}
+export interface KintoneNativeUpsertRecordResult {
+    id: string;
+    revision: string;
+    operation: "INSERT" | "UPDATE";
+}
+export interface KintoneNativeUpsertResult {
+    records: KintoneNativeUpsertRecordResult[];
+}
 export interface FlowKintoneClient {
     getRecords(params: {
         app: number;
@@ -79,6 +100,7 @@ export interface FlowKintoneClient {
             record: KintoneRecord;
         }>;
     }): Promise<void>;
+    upsertRecords?(params: KintoneNativeUpsertParams): Promise<KintoneNativeUpsertResult>;
     deleteRecords(params: {
         app: number;
         ids: number[];
@@ -122,6 +144,8 @@ export interface ValidateScriptOptions extends ParseScriptOptions {
 }
 export interface ExplainScriptOptions extends ParseScriptOptions {
     client: FlowKintoneClient;
+    /** /flow 本実行を想定する native UPSERT 設定。省略時は有効、false は opt-out。 */
+    enableNativeUpsert?: boolean;
     variables?: Readonly<Record<string, string>>;
     /** dialect 1 の @ 付き時刻関数が共有する explain 呼出し単位の基準時刻。 */
     asOf?: Date;
@@ -165,6 +189,8 @@ export interface CreateExecutionContextOptions extends ParseScriptOptions {
     asOf?: Date;
     timezone?: string;
     continueOnError?: boolean;
+    /** 素の UPSERT で native UPSERT を許可する。省略時は true。 */
+    enableNativeUpsert?: boolean;
     /**
      * 書込 API の各成功直後に await される。順序は現在の書込順であり、キー順は保証しない。
      * コールバックが throw した場合、その文は error になるが、通知対象チャンクは書込済み。
@@ -176,12 +202,14 @@ export interface FlowChunkWrittenInfo {
     statementIndex: number;
     /** 書込 API に渡される物理アプリ ID（LAPP は解決済み）。 */
     appId: number;
-    operation: "INSERT" | "UPDATE" | "DELETE";
+    operation: "INSERT" | "UPDATE" | "DELETE" | "UPSERT";
     records: number;
     /** その文で成功した書込 API リクエストの index（0 始まり）。 */
     chunkIndex: number;
     /** 単一キー UPSERT でキー値を payload から特定できる場合のみ設定される。 */
     lastKeyValue?: string;
+    insertedCount?: number;
+    updatedCount?: number;
 }
 declare const executionContextBrand: unique symbol;
 /** Opaque, sequential-only statement execution handle. */
@@ -197,6 +225,8 @@ export interface ExecutionMetrics {
     getCalls: number;
     postCalls: number;
     putCalls: number;
+    /** upsertRecords の呼出し回数。putCalls の内数。 */
+    nativeUpsertCalls: number;
     deleteCalls: number;
     fieldCalls: number;
     numberPrecisionCalls: number;