@rex0220/kintone-sql-tools 3.75.0 → 3.77.0

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

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-09-03T13:52:07.158Z",
+  "generatedAt": "2026-09-04T05:52:08.271Z",
   "baseline": "B66 Phase1 initial measured values; no arbitrary size ceiling",
   "bundles": {
     "index.cjs": {
       "inputCount": 115,
-      "minifiedBytes": 690398,
-      "gzipBytes": 189172,
+      "minifiedBytes": 690947,
+      "gzipBytes": 189428,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -24,8 +24,8 @@
     },
     "index.mjs": {
       "inputCount": 115,
-      "minifiedBytes": 689853,
-      "gzipBytes": 188905,
+      "minifiedBytes": 690402,
+      "gzipBytes": 189139,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],
@@ -44,8 +44,8 @@
     },
     "ksql-engine.umd.js": {
       "inputCount": 117,
-      "minifiedBytes": 690877,
-      "gzipBytes": 189213,
+      "minifiedBytes": 691426,
+      "gzipBytes": 189464,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],

package/dist-engine/meta/cjs.json

@@ -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": 636914,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -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": 244324
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2517,7 +2517,7 @@
           "bytesInOutput": 1446
         }
       },
-      "bytes": 690398
+      "bytes": 690947
     }
   }
 }

package/dist-engine/meta/esm.json

@@ -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": 636914,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -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": 244324
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2524,7 +2524,7 @@
           "bytesInOutput": 16
         }
       },
-      "bytes": 689853
+      "bytes": 690402
     }
   }
 }

package/dist-engine/meta/umd.json

@@ -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": 636914,
       "imports": [
         {
           "path": "src/lexer/lexer.ts",
@@ -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": 244324
         },
         "src/engine-library/errors.ts": {
           "bytesInOutput": 1441
@@ -2544,7 +2544,7 @@
           "bytesInOutput": 127
         }
       },
-      "bytes": 690877
+      "bytes": 691426
     }
   }
 }

package/dist-flow/export/types.d.ts

@@ -0,0 +1,56 @@
+export type ExportEncoding = "utf8" | "sjis";
+export interface CsvExportColumnMeta {
+    readonly fieldType?: string;
+}
+export interface CsvExportInput {
+    readonly columns: readonly string[];
+    readonly rows: readonly Readonly<Record<string, string | null | undefined>>[];
+    readonly columnMeta?: ReadonlyMap<string, CsvExportColumnMeta>;
+}
+export interface ExportTextEncoder {
+    readonly encoding: "sjis";
+    encode(text: string): Uint8Array;
+}
+export interface CsvExportOptions {
+    readonly encoding?: ExportEncoding;
+    readonly timezone?: string;
+    readonly encoder?: ExportTextEncoder;
+}
+export interface CsvExportReceipt {
+    readonly rows: number;
+    readonly columns: number;
+    readonly bytes: number;
+    readonly encoding: ExportEncoding;
+}
+export interface CsvExportResult {
+    readonly text: string;
+    readonly data: Uint8Array;
+    readonly receipt: CsvExportReceipt;
+}
+export type ExportSerializerErrorCode = "ExportSinkDuplicateHeaderError" | "ExportSinkUnsupportedColumnError" | "ExportSinkInvalidValueError" | "ExportSinkInvalidTimezoneError" | "ExportSinkEncoderRequiredError" | "ExportSinkEncodingError" | "ExportSinkInvalidEncoderResultError";
+export declare class ExportSerializerError extends Error {
+    readonly code: ExportSerializerErrorCode;
+    readonly cause?: unknown;
+    constructor(code: ExportSerializerErrorCode, message: string, cause?: unknown);
+}
+export declare class ExportSinkDuplicateHeaderError extends ExportSerializerError {
+    constructor(message: string);
+}
+export declare class ExportSinkUnsupportedColumnError extends ExportSerializerError {
+    constructor(message: string);
+}
+export declare class ExportSinkInvalidValueError extends ExportSerializerError {
+    constructor(message: string);
+}
+export declare class ExportSinkInvalidTimezoneError extends ExportSerializerError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ExportSinkEncoderRequiredError extends ExportSerializerError {
+    constructor(message: string);
+}
+export declare class ExportSinkEncodingError extends ExportSerializerError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ExportSinkInvalidEncoderResultError extends ExportSerializerError {
+    constructor(message: string);
+}

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

@@ -0,0 +1,5 @@
+import type { ExecutionContext, FlowCsvExportInput, FlowCsvExportOptions, FlowCsvExportResult, FlowExportSinkStatus, StatementResult } from "./publicTypes";
+export declare function serializeCsvExport(input: FlowCsvExportInput, options?: FlowCsvExportOptions): FlowCsvExportResult;
+export declare function serializeSelectResultAsCsv(statement: StatementResult, options?: FlowCsvExportOptions): FlowCsvExportResult;
+export declare function exportSinkStatus(context: ExecutionContext, name: string): FlowExportSinkStatus;
+export declare function serializeExportSink(context: ExecutionContext, name: string, options?: FlowCsvExportOptions): FlowCsvExportResult;

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

@@ -11,5 +11,6 @@ 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 { exportSinkStatus, serializeCsvExport, serializeExportSink, serializeSelectResultAsCsv, } from "./exportSinks";
 export { createImportSourceResolver, createKintoneClient, FlowImportProviderError, KsqlFlowError };
-export type { CreateExecutionContextOptions, CreateKintoneClientConfig, Diagnostic, DiagnosticCode, ExecutionContext, ExplainScriptOptions, ExplainScriptResult, FieldInfo, FlowImportProviderErrorCode, FlowImportSourceLoader, 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";
+export type { CreateExecutionContextOptions, CreateKintoneClientConfig, Diagnostic, DiagnosticCode, ExecutionContext, ExportEncoding, ExplainScriptOptions, ExplainScriptResult, FieldInfo, FlowImportProviderErrorCode, FlowCsvExportColumnMeta, FlowCsvExportInput, FlowCsvExportOptions, FlowCsvExportReceipt, FlowCsvExportResult, FlowExportSinkStatus, FlowExportTextEncoder, FlowImportSourceLoader, FlowImportSourceMaterializedInfo, FlowImportSourcePayload, FlowImportSourceResolver, FlowNamedImportSource, FlowNamedExportSink, 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

@@ -139,6 +139,31 @@ export interface FlowNamedImportSource {
     readonly name: string;
     readonly loader: FlowImportSourceLoader;
 }
+/** Browser-neutral CSV export types shared with the engine serializer. */
+export type ExportEncoding = import("../export/types").ExportEncoding;
+export type FlowCsvExportColumnMeta = import("../export/types").CsvExportColumnMeta;
+export type FlowCsvExportInput = import("../export/types").CsvExportInput;
+export type FlowExportTextEncoder = import("../export/types").ExportTextEncoder;
+export type FlowCsvExportOptions = import("../export/types").CsvExportOptions;
+export type FlowCsvExportReceipt = import("../export/types").CsvExportReceipt;
+export type FlowCsvExportResult = import("../export/types").CsvExportResult;
+export interface FlowNamedExportSink {
+    /** Exact, case-sensitive temp-table name without the leading #. */
+    readonly name: string;
+}
+export type FlowExportSinkStatus = "materialized" | "not-created" | "failed" | "incomplete";
+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>>;
@@ -206,8 +231,15 @@ export interface CreateExecutionContextOptions extends ParseScriptOptions {
     asOf?: Date;
     timezone?: string;
     continueOnError?: boolean;
+    /** Named CREATE TEMP TABLE outputs made available to the export API. */
+    exportSinks?: readonly FlowNamedExportSink[];
     /** 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;
     /**