@rex0220/kintone-sql-tools 3.18.0 → 3.19.0

package/dist-engine/publicTypes.d.ts

@@ -0,0 +1,98 @@
+export interface ReadonlyKintoneFieldValue {
+    readonly value: unknown;
+}
+export type ReadonlyKintoneRecord = Readonly<Record<string, ReadonlyKintoneFieldValue>>;
+export interface ReadonlyGetRecordsParams {
+    app: number;
+    query: string;
+    fields: string[];
+}
+export interface ReadonlyGetRecordsResult {
+    records: ReadonlyKintoneRecord[];
+    searchAborted?: boolean;
+}
+export interface ReadonlyCursorOpenParams {
+    app: number;
+    fields?: string[];
+    query: string;
+    size: 500;
+}
+export interface ReadonlyCursorPage {
+    records: ReadonlyKintoneRecord[];
+    next: boolean;
+}
+export interface ReadonlyCursorHandle {
+    readonly totalCount: number;
+    nextPage(): Promise<ReadonlyCursorPage>;
+    close(): Promise<void>;
+}
+export interface ReadonlyAppInfo {
+    appId: number;
+    name: string;
+    description: string;
+}
+export interface ReadonlyFieldInfo {
+    code: string;
+    label: string;
+    fieldType: string;
+    optionOrder?: Record<string, number>;
+    sortKind?: "number" | "string";
+    inSubtable?: boolean;
+    subtableCode?: string;
+}
+export type ReadonlyNumberRoundingMode = "HALF_EVEN" | "UP" | "DOWN";
+export interface ReadonlyNumberPrecision {
+    digits: number;
+    decimalPlaces: number;
+    roundingMode: ReadonlyNumberRoundingMode;
+}
+export interface ReadonlyProcessStatusState {
+    readonly name: string;
+    readonly index: number;
+}
+export interface ReadonlyProcessStatuses {
+    enable: boolean;
+    states: ReadonlyProcessStatusState[] | null;
+}
+export interface ReadonlyKintoneClient {
+    getRecords(params: ReadonlyGetRecordsParams): Promise<ReadonlyGetRecordsResult>;
+    openCursor(params: ReadonlyCursorOpenParams): Promise<ReadonlyCursorHandle>;
+    getApps(): Promise<readonly ReadonlyAppInfo[]>;
+    getFields(appId: number): Promise<readonly ReadonlyFieldInfo[]>;
+    getNumberPrecision(appId: number): Promise<ReadonlyNumberPrecision>;
+    getProcessStatuses(appId: number): Promise<ReadonlyProcessStatuses>;
+}
+export interface RunQueryOptions {
+    client: ReadonlyKintoneClient;
+    maxRecords?: number;
+    onLimitReached?: "error" | "truncate";
+    fetchParallel?: number;
+    cursorMaxActive?: number;
+}
+export interface QueryColumn {
+    name: string;
+    valueType: "string";
+}
+export interface QueryMetrics {
+    recordGetCalls: number;
+    fetchedRows: number;
+    elapsedMs: number;
+    cursorRecordsScanned: number;
+}
+export interface QueryResult {
+    type: "query";
+    rows: readonly Readonly<Record<string, string>>[];
+    columns: readonly QueryColumn[];
+    rowCount: number;
+    warnings: readonly string[];
+    metrics: QueryMetrics;
+}
+export interface ExplainResult {
+    type: "explain";
+    lines: readonly string[];
+    text: string;
+    metrics: QueryMetrics;
+}
+export interface CreateReadonlyKintoneClientOptions {
+    cursorMaxActive?: number;
+}

package/dist-engine/query.d.ts

@@ -0,0 +1,3 @@
+import type { ExplainResult, QueryResult, RunQueryOptions } from "./publicTypes";
+export declare function runQuery(sql: string, options: RunQueryOptions): Promise<QueryResult>;
+export declare function explainQuery(sql: string, options: Omit<RunQueryOptions, "onLimitReached">): Promise<ExplainResult>;

package/dist-mcp/ksql-mcp.js

@@ -55126,7 +55126,7 @@ Nested JSON/CSV subtable mutation is fail-closed on MCP: use VALIDATE ONLY/EXPLA
 JSON child IDs are rejected and replacement renumbers all rows.
 `);
 }
-var SERVER_VERSION = true ? "3.18.0" : "0.0.0-dev";
+var SERVER_VERSION = true ? "3.19.0" : "0.0.0-dev";
 var FUNCTION_CATALOG_PARAGRAPH = `Complete function catalog \u2014 Scalar: ${KSQL_FUNCTION_CATALOG.scalar.join(" ")}. Aggregate: ${KSQL_FUNCTION_CATALOG.aggregate.join(" ")}. Variance and standard-deviation aggregates use explicit POP/SAMP names; unqualified STDDEV and VARIANCE are unsupported. Window: ${KSQL_FUNCTION_CATALOG.window.join(" ")} (OVER and AS alias required). Contextual: ${KSQL_FUNCTION_CATALOG.contextual.join(" ")} (kintone predicates; LOGINUSER resolves to an empty string in Node/MCP). Aliases: ${KSQL_FUNCTION_CATALOG.aliases.join(" ")}. Syntax: ${KSQL_FUNCTION_CATALOG.syntax.join(" ")}. This list is complete; functions from other dialects such as IFNULL do not exist. Use ksql_docs for arguments and constraints.`;
 var KSQL_MCP_INSTRUCTIONS = `kSQL is a SQL-like dialect for kintone, not generic SQL. Supports cataloged families plus JOIN, aggregates, windows, subtable virtual tables, CHECK, KLIKE, KORDER BY, @variables, and LAPP_<NAME>.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex0220/kintone-sql-tools",
-  "version": "3.18.0",
+  "version": "3.19.0",
   "description": "kintone SQL plugin, CLI, and MCP tools (ksql)",
   "publishConfig": {
     "access": "public"
@@ -18,15 +18,28 @@
     "ksql": "dist-cli/ksql.js",
     "ksql-mcp": "dist-mcp/ksql-mcp.js"
   },
+  "exports": {
+    "./engine": {
+      "types": "./dist-engine/index.d.ts",
+      "import": "./dist-engine/index.mjs",
+      "require": "./dist-engine/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "test": "node scripts/run-tests.mjs",
     "test:parallel": "jest --maxWorkers=2 --testPathIgnorePatterns=console\\.e2e\\.test\\.ts dml_guard\\.e2e\\.test\\.ts",
     "test:subprocess": "jest --runInBand src/cli/__tests__/console.e2e.test.ts src/cli/__tests__/dml_guard.e2e.test.ts",
-    "build": "npm run build:plugin && npm run build:cli && npm run build:mcp && npm run build:mcpb",
+    "build": "npm run build:plugin && npm run build:cli && npm run build:mcp && npm run build:mcpb && npm run build:engine",
     "build:plugin": "node build.mjs",
     "build:cli": "node build-cli.mjs",
     "build:mcp": "node build-mcp.mjs",
     "build:mcpb": "node build-mcpb.mjs",
+    "build:engine": "node build-engine.mjs",
+    "engine:bundle-guard": "node scripts/engine-bundle-guard.mjs",
+    "engine:declaration-smoke": "node scripts/engine-declaration-smoke.mjs",
+    "engine:pack-smoke": "node scripts/engine-pack-smoke.mjs",
+    "engine:docs-smoke": "node scripts/engine-docs-examples-smoke.mjs",
     "mcp:smoke": "node scripts/mcp-smoke.mjs",
     "mcp:pack-smoke": "node scripts/mcp-pack-smoke.mjs",
     "mcp:kintone-smoke": "node scripts/mcp-kintone-smoke.mjs",
@@ -34,12 +47,13 @@
     "mcpb:verify": "npm run build:mcp && npm run build:mcpb && node scripts/mcpb-verify.mjs",
     "benchmark:b65": "node --expose-gc scripts/b65-grouping-benchmark.mjs",
     "mcp:inspector": "npx -y @modelcontextprotocol/inspector node dist-mcp/ksql-mcp.js",
-    "prepack": "npm run build:cli && npm run build:mcp && npm run build:mcpb",
+    "prepack": "npm run build:cli && npm run build:mcp && npm run build:mcpb && npm run build:engine && npm run engine:bundle-guard && npm run engine:declaration-smoke",
     "start": "run-p develop upload",
     "develop": "node build.mjs --watch",
     "upload": "node scripts/upload-plugin.cjs"
   },
   "files": [
+    "dist-engine/",
     "dist-cli/",
     "dist-mcp/",
     "dist-mcpb/",