@rex0220/kintone-sql-tools 3.74.0 → 3.76.0

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

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-08-25T06:21:06.325Z",
+  "generatedAt": "2026-09-03T15:14:36.649Z",
   "baseline": "B66 Phase1 initial measured values; no arbitrary size ceiling",
   "bundles": {
     "index.cjs": {
       "inputCount": 115,
-      "minifiedBytes": 688906,
-      "gzipBytes": 188782,
+      "minifiedBytes": 690851,
+      "gzipBytes": 189359,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -24,8 +24,8 @@
     },
     "index.mjs": {
       "inputCount": 115,
-      "minifiedBytes": 688361,
-      "gzipBytes": 188486,
+      "minifiedBytes": 690306,
+      "gzipBytes": 189087,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -44,8 +44,8 @@
     },
     "ksql-engine.umd.js": {
       "inputCount": 117,
-      "minifiedBytes": 689385,
-      "gzipBytes": 188812,
+      "minifiedBytes": 691330,
+      "gzipBytes": 189408,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],

package/dist-engine/meta/cjs.json

@@ -1294,7 +1294,7 @@
       "format": "esm"
     },
     "src/import/sourceLoader.ts": {
-      "bytes": 1311,
+      "bytes": 4453,
       "imports": [],
       "format": "esm"
     },
@@ -1342,7 +1342,7 @@
       "format": "esm"
     },
     "src/import/jsonMaterializer.ts": {
-      "bytes": 4146,
+      "bytes": 4121,
       "imports": [
         {
           "path": "src/import/jsonDecoder.ts",
@@ -1358,7 +1358,7 @@
       "format": "esm"
     },
     "src/import/materializeDmlSource.ts": {
-      "bytes": 5608,
+      "bytes": 5639,
       "imports": [
         {
           "path": "src/import/csvDecoder.ts",
@@ -1384,7 +1384,7 @@
       "format": "esm"
     },
     "src/import/importRecordsMaterializer.ts": {
-      "bytes": 7833,
+      "bytes": 7835,
       "imports": [
         {
           "path": "src/import/csvDecoder.ts",
@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 633278,
+      "bytes": 635459,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2415,7 +2415,7 @@
           "bytesInOutput": 4827
         },
         "src/import/sourceLoader.ts": {
-          "bytesInOutput": 527
+          "bytesInOutput": 2019
         },
         "src/import/csvDecoder.ts": {
           "bytesInOutput": 1386
@@ -2430,13 +2430,13 @@
           "bytesInOutput": 1388
         },
         "src/import/jsonMaterializer.ts": {
-          "bytesInOutput": 1973
+          "bytesInOutput": 2013
         },
         "src/import/materializeDmlSource.ts": {
-          "bytesInOutput": 2490
+          "bytesInOutput": 2586
         },
         "src/import/importRecordsMaterializer.ts": {
-          "bytesInOutput": 3344
+          "bytesInOutput": 3428
         },
         "src/import/importRecordValidation.ts": {
           "bytesInOutput": 3332
@@ -2460,7 +2460,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 243995
+          "bytesInOutput": 244228
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2517,7 +2517,7 @@
           "bytesInOutput": 1446
         }
       },
-      "bytes": 688906
+      "bytes": 690851
     }
   }
 }

package/dist-engine/meta/esm.json

@@ -1294,7 +1294,7 @@
       "format": "esm"
     },
     "src/import/sourceLoader.ts": {
-      "bytes": 1311,
+      "bytes": 4453,
       "imports": [],
       "format": "esm"
     },
@@ -1342,7 +1342,7 @@
       "format": "esm"
     },
     "src/import/jsonMaterializer.ts": {
-      "bytes": 4146,
+      "bytes": 4121,
       "imports": [
         {
           "path": "src/import/jsonDecoder.ts",
@@ -1358,7 +1358,7 @@
       "format": "esm"
     },
     "src/import/materializeDmlSource.ts": {
-      "bytes": 5608,
+      "bytes": 5639,
       "imports": [
         {
           "path": "src/import/csvDecoder.ts",
@@ -1384,7 +1384,7 @@
       "format": "esm"
     },
     "src/import/importRecordsMaterializer.ts": {
-      "bytes": 7833,
+      "bytes": 7835,
       "imports": [
         {
           "path": "src/import/csvDecoder.ts",
@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 633278,
+      "bytes": 635459,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2419,7 +2419,7 @@
           "bytesInOutput": 4827
         },
         "src/import/sourceLoader.ts": {
-          "bytesInOutput": 527
+          "bytesInOutput": 2019
         },
         "src/import/csvDecoder.ts": {
           "bytesInOutput": 1386
@@ -2434,13 +2434,13 @@
           "bytesInOutput": 1388
         },
         "src/import/jsonMaterializer.ts": {
-          "bytesInOutput": 1973
+          "bytesInOutput": 2013
         },
         "src/import/materializeDmlSource.ts": {
-          "bytesInOutput": 2490
+          "bytesInOutput": 2586
         },
         "src/import/importRecordsMaterializer.ts": {
-          "bytesInOutput": 3344
+          "bytesInOutput": 3428
         },
         "src/import/importRecordValidation.ts": {
           "bytesInOutput": 3332
@@ -2464,7 +2464,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 243995
+          "bytesInOutput": 244228
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2524,7 +2524,7 @@
           "bytesInOutput": 16
         }
       },
-      "bytes": 688361
+      "bytes": 690306
     }
   }
 }

package/dist-engine/meta/umd.json

@@ -1294,7 +1294,7 @@
       "format": "esm"
     },
     "src/import/sourceLoader.ts": {
-      "bytes": 1311,
+      "bytes": 4453,
       "imports": [],
       "format": "esm"
     },
@@ -1342,7 +1342,7 @@
       "format": "esm"
     },
     "src/import/jsonMaterializer.ts": {
-      "bytes": 4146,
+      "bytes": 4121,
       "imports": [
         {
           "path": "src/import/jsonDecoder.ts",
@@ -1358,7 +1358,7 @@
       "format": "esm"
     },
     "src/import/materializeDmlSource.ts": {
-      "bytes": 5608,
+      "bytes": 5639,
       "imports": [
         {
           "path": "src/import/csvDecoder.ts",
@@ -1384,7 +1384,7 @@
       "format": "esm"
     },
     "src/import/importRecordsMaterializer.ts": {
-      "bytes": 7833,
+      "bytes": 7835,
       "imports": [
         {
           "path": "src/import/csvDecoder.ts",
@@ -1446,7 +1446,7 @@
       "format": "esm"
     },
     "src/execute.ts": {
-      "bytes": 633278,
+      "bytes": 635459,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -2433,7 +2433,7 @@
           "bytesInOutput": 4827
         },
         "src/import/sourceLoader.ts": {
-          "bytesInOutput": 527
+          "bytesInOutput": 2019
         },
         "src/import/csvDecoder.ts": {
           "bytesInOutput": 1386
@@ -2448,13 +2448,13 @@
           "bytesInOutput": 1388
         },
         "src/import/jsonMaterializer.ts": {
-          "bytesInOutput": 1973
+          "bytesInOutput": 2013
         },
         "src/import/materializeDmlSource.ts": {
-          "bytesInOutput": 2490
+          "bytesInOutput": 2586
         },
         "src/import/importRecordsMaterializer.ts": {
-          "bytesInOutput": 3344
+          "bytesInOutput": 3428
         },
         "src/import/importRecordValidation.ts": {
           "bytesInOutput": 3332
@@ -2478,7 +2478,7 @@
           "bytesInOutput": 412
         },
         "src/execute.ts": {
-          "bytesInOutput": 243995
+          "bytesInOutput": 244228
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2544,7 +2544,7 @@
           "bytesInOutput": 127
         }
       },
-      "bytes": 689385
+      "bytes": 691330
     }
   }
 }

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

@@ -0,0 +1,7 @@
+import type { FlowImportProviderErrorCode, FlowImportSourceResolver, FlowNamedImportSource } from "./publicTypes";
+export declare class FlowImportProviderError extends Error {
+    readonly code: FlowImportProviderErrorCode;
+    readonly cause?: unknown;
+    constructor(code: FlowImportProviderErrorCode, message: string, cause?: unknown);
+}
+export declare function createImportSourceResolver(sources: readonly FlowNamedImportSource[]): FlowImportSourceResolver;

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

@@ -1,5 +1,6 @@
 import { createKintoneClient } from "./writableClient";
 import { KsqlFlowError } from "./errors";
+import { createImportSourceResolver, FlowImportProviderError } from "./importSources";
 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;
@@ -10,5 +11,5 @@ export declare function previewStatement(statement: Statement, context: Executio
 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, KintoneNativeUpdateKey, KintoneNativeUpsertRecord, KintoneNativeUpsertParams, KintoneNativeUpsertRecordResult, KintoneNativeUpsertResult, FlowUpdateResult, FlowUpsertResult, ParseScriptOptions, ParseScriptResult, PreviewResult, PreviewSample, PreviewStatementOptions, SchemaResolver, ScriptHeaderMeta, Statement, StatementResult, StatementResultKind, ValidateScriptOptions, } from "./publicTypes";
+export { createImportSourceResolver, createKintoneClient, FlowImportProviderError, KsqlFlowError };
+export type { CreateExecutionContextOptions, CreateKintoneClientConfig, Diagnostic, DiagnosticCode, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, FieldInfo, FlowImportProviderErrorCode, FlowImportSourceLoader, FlowImportSourceMaterializedInfo, FlowImportSourcePayload, FlowImportSourceResolver, FlowNamedImportSource, FlowChunkWrittenInfo, FlowDeleteResult, FlowDmlResult, FlowInsertResult, FlowKintoneClient, KintoneNativeUpdateKey, KintoneNativeUpsertRecord, KintoneNativeUpsertParams, KintoneNativeUpsertRecordResult, KintoneNativeUpsertResult, FlowUpdateResult, FlowUpsertResult, ImportEncoding, ParseScriptOptions, ParseScriptResult, PreviewResult, PreviewSample, PreviewStatementOptions, SchemaResolver, ScriptHeaderMeta, Statement, StatementResult, StatementResultKind, ValidateScriptOptions, } from "./publicTypes";

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

@@ -125,8 +125,37 @@ export interface FlowKintoneClient {
     }>;
 }
 export type SchemaResolver = (appId: number) => readonly FieldInfo[] | Promise<readonly FieldInfo[]>;
+export type ImportEncoding = "utf8" | "sjis";
+export interface FlowImportSourcePayload {
+    readonly bytes: Uint8Array;
+    readonly encoding?: ImportEncoding;
+}
+export interface FlowImportSourceLoader {
+    load(): Promise<FlowImportSourcePayload>;
+}
+/** Exact, case-sensitive SQL source name to lazy, path-free loader. */
+export type FlowImportSourceResolver = (name: string) => FlowImportSourceLoader | undefined;
+export interface FlowNamedImportSource {
+    readonly name: string;
+    readonly loader: FlowImportSourceLoader;
+}
+export interface FlowImportSourceMaterializedInfo {
+    /** バッチ内の文 index。StatementResult.index と同じ0始まり。 */
+    readonly statementIndex: number;
+    /** SQL の FROM CSV <name> / FROM JSON <name> で指定された source name。 */
+    readonly name: string;
+    /** materialize した source 種別。 */
+    readonly kind: "CSV" | "JSON";
+    /** decoder が返した物理 input record 数。CSV は header 除外、JSON は top-level record 数。 */
+    readonly rows: number;
+    /** SQL、payload、既定値を解決した後の有効文字コード。 */
+    readonly encoding: ImportEncoding;
+}
+export type FlowImportProviderErrorCode = "ImportSourceReadError" | "ImportSourceNotRegularFileError";
 export interface ParseScriptOptions {
     apps?: Readonly<Record<string, number>>;
+    /** Omitted/false keeps IMPORT unavailable and preserves KSQL1202. */
+    enableImport?: boolean;
 }
 export interface ParseScriptResult {
     meta: ScriptHeaderMeta;
@@ -189,6 +218,13 @@ export interface CreateExecutionContextOptions extends ParseScriptOptions {
     asOf?: Date;
     timezone?: string;
     continueOnError?: boolean;
+    /** Named, path-free source resolver. It never enables IMPORT implicitly. */
+    importSource?: FlowImportSourceResolver;
+    /**
+     * IMPORT source の raw materialize 成功直後、mutation 前に1回 await される。
+     * throw/reject は当該文を error にし、その文の mutation は0回となる。
+     */
+    onImportSourceMaterialized?: (info: FlowImportSourceMaterializedInfo) => void | Promise<void>;
     /** 素の UPSERT で native UPSERT を許可する。省略時は true。 */
     enableNativeUpsert?: boolean;
     /**