@rex0220/kintone-sql-tools 3.70.0 → 3.71.0

package/README.md

@@ -267,7 +267,7 @@ npm パッケージは 2 つのサブパスを **semver 対象の公開 API**
 | サブパス | 用途 | 主な export |
 |---|---|---|
 | `@rex0220/kintone-sql-tools/engine` | **read-only** のクエリ実行（ダッシュボード等）。書込 API は構造的に遮断 | `runQuery` / `runBatch` / `explainQuery` / `createReadonlyKintoneClient` / `KsqlEngineError` / `version` |
-| `@rex0220/kintone-sql-tools/flow` | **Flow dialect 1**（→ [言語リファレンス §27](docs/ksql_language_reference.md)）のスクリプト解析・検証・**文単位実行**（バッチランナー向け・書込可能） | `parseScript` / `validateScript` / `explainScript`（`asOf`/`timezone` 注入可） / `createExecutionContext`（`onChunkWritten` 書込チャンク通知） / `executeStatement` / `disposeExecutionContext` / `createKintoneClient` / `isDmlResult`（`FlowDmlResult` 型ガード） / `version` |
+| `@rex0220/kintone-sql-tools/flow` | **Flow dialect 1**（→ [言語リファレンス §27](docs/ksql_language_reference.md)）のスクリプト解析・検証・**文単位実行**（バッチランナー向け・書込可能） | `parseScript` / `validateScript` / `explainScript`（`asOf`/`timezone` 注入可） / `createExecutionContext`（`onChunkWritten` 書込チャンク通知） / `executeStatement` / `previewStatement`（dry-run 差分プレビュー・書込 0 回） / `disposeExecutionContext` / `createKintoneClient` / `isDmlResult`（`FlowDmlResult` 型ガード） / `version` |
 
 `/flow` の典型的な使い方（1 文ずつ実行して結果で継続判断する）:
 

package/dist-cli/ksql.js

@@ -22791,11 +22791,16 @@ function lookupUpsertTarget(index, keyParts) {
   if (!index.numericKey.some(Boolean)) return void 0;
   return index.normalized.get(upsertNormalizedKey(keyParts, index.numericKey));
 }
-async function resolveUpsertTargets(appId, keyFields, rowKeyValues, client, options, fieldTypes) {
+async function resolveUpsertTargets(appId, keyFields, rowKeyValues, client, options, fieldTypes, previewFields) {
   const maxRecords = options.maxRecords ?? 1e4;
   const parallel = options.fetchParallel ?? 1;
   const numericKey = keyFields.map((f) => fieldTypes.get(f) === "NUMBER");
-  const index = { raw: /* @__PURE__ */ new Map(), normalized: /* @__PURE__ */ new Map(), numericKey };
+  const index = {
+    raw: /* @__PURE__ */ new Map(),
+    normalized: /* @__PURE__ */ new Map(),
+    numericKey,
+    ...previewFields ? { snapshots: /* @__PURE__ */ new Map() } : {}
+  };
   const setMax = (map, key, id) => {
     const cur = map.get(key);
     if (cur === void 0 || id > cur) map.set(key, id);
@@ -22816,20 +22821,26 @@ async function resolveUpsertTargets(appId, keyFields, rowKeyValues, client, opti
     if (parts.some((p) => p === "")) perRowKeys.push(parts);
     else batchFirstKeys.add(parts[0]);
   }
-  const fields = ["$id", ...keyFields];
+  const fields = previewFields ? [.../* @__PURE__ */ new Set(["$id", ...keyFields, ...previewFields])] : ["$id", ...keyFields];
   for (const chunk3 of splitChunks([...batchFirstKeys], UPSERT_IN_CHUNK_SIZE)) {
     const query = `${keyFields[0]} in (${chunk3.map(sqlQuote).join(",")})`;
     const records = await fetchAll(client.getRecords, appId, query, fields, { maxRecords, parallel });
     for (const rec of records) {
       const id = Number(rec["$id"]?.value);
       if (!Number.isFinite(id)) continue;
+      index.snapshots?.set(id, rec);
       addRecordToIndex(keyFields.map((f) => toScalarText(rec[f]?.value)), id);
     }
   }
   for (const parts of perRowKeys) {
     const query = keyFields.map((f, i) => `${f} = ${sqlQuote(parts[i])}`).join(" and ");
-    const existing = await fetchAll(client.getRecords, appId, query, ["$id"], { maxRecords, parallel });
+    const perRowFields = previewFields ? [.../* @__PURE__ */ new Set(["$id", ...previewFields])] : ["$id"];
+    const existing = await fetchAll(client.getRecords, appId, query, perRowFields, { maxRecords, parallel });
     if (existing.length === 0) continue;
+    for (const rec of existing) {
+      const id = Number(rec["$id"]?.value);
+      if (Number.isFinite(id)) index.snapshots?.set(id, rec);
+    }
     addRecordToIndex(parts, maxRecordId(existing));
   }
   return index;