@rex0220/kintone-sql-tools 3.11.0 → 3.12.0

package/README.md

@@ -71,6 +71,8 @@ npm run build:plugin
   - 一時テーブルで中間結果をサーバー内に保持し、AI のコンテキスト消費を抑えたい場合
   - validation / EXPLAIN で論理名から最終的な物理アプリ ID への解決を確認したい場合
 
+言語リファレンス・レシピは MCP resources（`ksql://language-reference` / `ksql://recipes`）に加えて、read-only ツール **`ksql_docs`** でも読めます。中継環境（リモート接続のプロキシ等）が resources を通さないクライアントでは、`ksql_docs` を引数なしで呼ぶと全章キーの索引が返るので、必要な章だけ `{"section":"language-reference/05-string-number-functions"}` の形で取得してください。
+
 注意:
 
 - `APP@profile` と `LAPP_<NAME>[@profile]` は Node.js runtime（CLI / MCP）の拡張です。plugin 側では非対応です。

package/dist-cli/ksql.js

@@ -577,6 +577,87 @@ function numberLiteralText(node) {
 
 // src/parser/parser.ts
 var MAX_BATCH_STATEMENTS = 20;
+var PARSER_SCALAR_FUNCTION_TOKEN_MAP = Object.freeze({
+  ["UPPER" /* UPPER */]: "UPPER",
+  ["LOWER" /* LOWER */]: "LOWER",
+  ["TRIM" /* TRIM */]: "TRIM",
+  ["LTRIM" /* LTRIM */]: "LTRIM",
+  ["RTRIM" /* RTRIM */]: "RTRIM",
+  ["LENGTH" /* LENGTH */]: "LENGTH",
+  ["LENGTH_CHAR" /* LENGTH_CHAR */]: "LENGTH_CHAR",
+  ["SUBSTRING" /* SUBSTRING */]: "SUBSTRING",
+  ["SUBSTR" /* SUBSTR */]: "SUBSTRING",
+  ["LEFT" /* LEFT */]: "LEFT",
+  ["RIGHT" /* RIGHT */]: "RIGHT",
+  ["INSTR" /* INSTR */]: "INSTR",
+  ["CONCAT" /* CONCAT */]: "CONCAT",
+  ["REPLACE" /* REPLACE */]: "REPLACE",
+  ["REGEXP_LIKE" /* REGEXP_LIKE */]: "REGEXP_LIKE",
+  ["REGEXP_REPLACE" /* REGEXP_REPLACE */]: "REGEXP_REPLACE",
+  ["REGEXP_SUBSTR" /* REGEXP_SUBSTR */]: "REGEXP_SUBSTR",
+  ["TRANSLATE" /* TRANSLATE */]: "TRANSLATE",
+  ["COALESCE" /* COALESCE */]: "COALESCE",
+  ["ISNULL" /* ISNULL */]: "ISNULL",
+  ["NULLIF" /* NULLIF */]: "NULLIF",
+  ["GREATEST" /* GREATEST */]: "GREATEST",
+  ["LEAST" /* LEAST */]: "LEAST",
+  ["LPAD" /* LPAD */]: "LPAD",
+  ["RPAD" /* RPAD */]: "RPAD",
+  ["ROUND" /* ROUND */]: "ROUND",
+  ["FLOOR" /* FLOOR */]: "FLOOR",
+  ["CEIL" /* CEIL */]: "CEIL",
+  ["CEILING" /* CEILING */]: "CEIL",
+  ["TRUNCATE" /* TRUNCATE */]: "TRUNCATE",
+  ["TRUNC" /* TRUNC */]: "TRUNCATE",
+  ["ABS" /* ABS */]: "ABS",
+  ["MOD" /* MOD */]: "MOD",
+  ["POWER" /* POWER */]: "POWER",
+  ["POW" /* POW */]: "POWER",
+  ["SQRT" /* SQRT */]: "SQRT",
+  ["FORMAT" /* FORMAT */]: "FORMAT",
+  ["CAST" /* CAST */]: "CAST",
+  ["CONVERT" /* CONVERT */]: "CAST",
+  ["YEAR" /* YEAR */]: "YEAR",
+  ["MONTH" /* MONTH */]: "MONTH",
+  ["DAY" /* DAY */]: "DAY",
+  ["DATE_FORMAT" /* DATE_FORMAT */]: "DATE_FORMAT",
+  ["DATEDIFF" /* DATEDIFF */]: "DATEDIFF",
+  ["DATE_ADD" /* DATE_ADD */]: "DATE_ADD",
+  ["LAST_DAY" /* LAST_DAY */]: "LAST_DAY"
+});
+var PARSER_IDENT_SCALAR_FUNCTIONS = Object.freeze([
+  "CURRENT_DATE",
+  "CURRENT_TIMESTAMP"
+]);
+var PARSER_AGGREGATE_FUNCTION_TOKEN_MAP = Object.freeze({
+  ["COUNT" /* COUNT */]: "COUNT",
+  ["SUM" /* SUM */]: "SUM",
+  ["AVG" /* AVG */]: "AVG",
+  ["MAX" /* MAX */]: "MAX",
+  ["MIN" /* MIN */]: "MIN",
+  ["GROUP_CONCAT" /* GROUP_CONCAT */]: "GROUP_CONCAT"
+});
+var PARSER_WINDOW_FUNCTION_TOKEN_MAP = Object.freeze({
+  ["ROW_NUMBER" /* ROW_NUMBER */]: "ROW_NUMBER",
+  ["RANK" /* RANK */]: "RANK",
+  ["DENSE_RANK" /* DENSE_RANK */]: "DENSE_RANK"
+});
+var PARSER_CONTEXTUAL_FUNCTION_TOKEN_MAP = Object.freeze({
+  ["TODAY" /* TODAY */]: "TODAY",
+  ["NOW" /* NOW */]: "NOW",
+  ["LOGINUSER" /* LOGINUSER */]: "LOGINUSER"
+});
+function isContextualFunctionToken(kind) {
+  return PARSER_CONTEXTUAL_FUNCTION_TOKEN_MAP[kind] !== void 0;
+}
+var PARSER_FUNCTION_SPELLINGS = Object.freeze(Array.from(/* @__PURE__ */ new Set([
+  ...Object.keys(PARSER_SCALAR_FUNCTION_TOKEN_MAP),
+  ...PARSER_IDENT_SCALAR_FUNCTIONS,
+  ...Object.keys(PARSER_AGGREGATE_FUNCTION_TOKEN_MAP),
+  ...Object.keys(PARSER_WINDOW_FUNCTION_TOKEN_MAP),
+  ...Object.keys(PARSER_CONTEXTUAL_FUNCTION_TOKEN_MAP),
+  "IF"
+])));
 var FUNC_CALL_PREFIX_KINDS = /* @__PURE__ */ new Set([
   "IDENT" /* IDENT */,
   "BIDENT" /* BIDENT */,
@@ -820,13 +901,14 @@ var Parser = class {
       this.advance();
       return { type: "STRING", value: tok.value };
     }
-    if (tok.kind === "LOGINUSER" /* LOGINUSER */) {
+    const contextualFunction = PARSER_CONTEXTUAL_FUNCTION_TOKEN_MAP[tok.kind];
+    if (contextualFunction === "LOGINUSER") {
       throw new ParseError(
         `${context} \u306E\u53F3\u8FBA\u3067 LOGINUSER() \u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093\uFF08\u5B9F\u884C\u74B0\u5883\u5171\u901A\u306E\u30ED\u30B0\u30A4\u30F3\u30E6\u30FC\u30B6\u30FC\u89E3\u6C7A\u306F\u672A\u5BFE\u5FDC\u3067\u3059\uFF09`,
         tok
       );
     }
-    if (tok.kind === "TODAY" /* TODAY */ || tok.kind === "NOW" /* NOW */) {
+    if (contextualFunction !== void 0) {
       return this.parseSqlValue();
     }
     const expr = this.parseArithAddSub();
@@ -1581,16 +1663,7 @@ var Parser = class {
     return { type: "FIELD", field, alias };
   }
   tryWindowFunc() {
-    switch (this.peek().kind) {
-      case "ROW_NUMBER" /* ROW_NUMBER */:
-        return "ROW_NUMBER";
-      case "RANK" /* RANK */:
-        return "RANK";
-      case "DENSE_RANK" /* DENSE_RANK */:
-        return "DENSE_RANK";
-      default:
-        return null;
-    }
+    return PARSER_WINDOW_FUNCTION_TOKEN_MAP[this.peek().kind] ?? null;
   }
   parseWindowColumn(func) {
     this.advance();
@@ -1947,64 +2020,14 @@ var Parser = class {
   // ──────────────────────────────────────────────────
   tryStringFuncName() {
     if (this.peekAt(1).kind === "(" /* LPAREN */) {
-      if (this.peek().kind === "LEFT" /* LEFT */) return "LEFT";
-      if (this.peek().kind === "RIGHT" /* RIGHT */) return "RIGHT";
-    }
-    const map = {
-      ["UPPER" /* UPPER */]: "UPPER",
-      ["LOWER" /* LOWER */]: "LOWER",
-      ["TRIM" /* TRIM */]: "TRIM",
-      ["LTRIM" /* LTRIM */]: "LTRIM",
-      ["RTRIM" /* RTRIM */]: "RTRIM",
-      ["LENGTH" /* LENGTH */]: "LENGTH",
-      ["LENGTH_CHAR" /* LENGTH_CHAR */]: "LENGTH_CHAR",
-      ["SUBSTRING" /* SUBSTRING */]: "SUBSTRING",
-      ["SUBSTR" /* SUBSTR */]: "SUBSTRING",
-      ["CONCAT" /* CONCAT */]: "CONCAT",
-      ["REPLACE" /* REPLACE */]: "REPLACE",
-      ["REGEXP_LIKE" /* REGEXP_LIKE */]: "REGEXP_LIKE",
-      ["REGEXP_REPLACE" /* REGEXP_REPLACE */]: "REGEXP_REPLACE",
-      ["REGEXP_SUBSTR" /* REGEXP_SUBSTR */]: "REGEXP_SUBSTR",
-      ["TRANSLATE" /* TRANSLATE */]: "TRANSLATE",
-      ["COALESCE" /* COALESCE */]: "COALESCE",
-      ["NULLIF" /* NULLIF */]: "NULLIF",
-      ["ISNULL" /* ISNULL */]: "ISNULL",
-      ["INSTR" /* INSTR */]: "INSTR",
-      ["GREATEST" /* GREATEST */]: "GREATEST",
-      ["LEAST" /* LEAST */]: "LEAST",
-      ["LPAD" /* LPAD */]: "LPAD",
-      ["RPAD" /* RPAD */]: "RPAD",
-      ["CAST" /* CAST */]: "CAST",
-      ["CONVERT" /* CONVERT */]: "CAST",
-      // CONVERT → CAST に正規化
-      ["FORMAT" /* FORMAT */]: "FORMAT",
-      ["ROUND" /* ROUND */]: "ROUND",
-      ["FLOOR" /* FLOOR */]: "FLOOR",
-      ["CEIL" /* CEIL */]: "CEIL",
-      ["CEILING" /* CEILING */]: "CEIL",
-      // CEILING → CEIL に正規化
-      ["TRUNCATE" /* TRUNCATE */]: "TRUNCATE",
-      ["TRUNC" /* TRUNC */]: "TRUNCATE",
-      // TRUNC → TRUNCATE に正規化
-      ["YEAR" /* YEAR */]: "YEAR",
-      ["MONTH" /* MONTH */]: "MONTH",
-      ["DAY" /* DAY */]: "DAY",
-      ["DATE_FORMAT" /* DATE_FORMAT */]: "DATE_FORMAT",
-      ["DATEDIFF" /* DATEDIFF */]: "DATEDIFF",
-      ["DATE_ADD" /* DATE_ADD */]: "DATE_ADD",
-      ["LAST_DAY" /* LAST_DAY */]: "LAST_DAY",
-      ["ABS" /* ABS */]: "ABS",
-      ["MOD" /* MOD */]: "MOD",
-      ["POWER" /* POWER */]: "POWER",
-      ["POW" /* POW */]: "POWER",
-      // POW → POWER に正規化
-      ["SQRT" /* SQRT */]: "SQRT"
-    };
-    const byKind = map[this.peek().kind] ?? null;
-    if (byKind !== null) return byKind;
+      const conditional = PARSER_SCALAR_FUNCTION_TOKEN_MAP[this.peek().kind];
+      if (conditional === "LEFT" || conditional === "RIGHT") return conditional;
+    }
+    const byKind = PARSER_SCALAR_FUNCTION_TOKEN_MAP[this.peek().kind] ?? null;
+    if (byKind !== null && byKind !== "LEFT" && byKind !== "RIGHT") return byKind;
     if (this.peek().kind === "IDENT" /* IDENT */) {
       const name = this.peek().value.toUpperCase();
-      if (name === "CURRENT_DATE" || name === "CURRENT_TIMESTAMP") {
+      if (PARSER_IDENT_SCALAR_FUNCTIONS.includes(name)) {
         if (this.peekAt(1).kind === "(" /* LPAREN */) {
           return name;
         }
@@ -2094,16 +2117,7 @@ var Parser = class {
     return false;
   }
   tryAggregateFunc() {
-    const map = {
-      ["COUNT" /* COUNT */]: "COUNT",
-      ["SUM" /* SUM */]: "SUM",
-      ["AVG" /* AVG */]: "AVG",
-      ["MAX" /* MAX */]: "MAX",
-      ["MIN" /* MIN */]: "MIN",
-      ["GROUP_CONCAT" /* GROUP_CONCAT */]: "GROUP_CONCAT"
-    };
-    const kind = this.peek().kind;
-    return map[kind] ?? null;
+    return PARSER_AGGREGATE_FUNCTION_TOKEN_MAP[this.peek().kind] ?? null;
   }
   /** 集計関数参照を読む。SELECT 列の alias は呼び出し側で式全体の後に処理する。 */
   parseAggregateRef(func) {
@@ -2464,13 +2478,13 @@ var Parser = class {
       this.advance();
       return { type: "STRING", value: tok.value };
     }
-    if (tok.kind === "TODAY" /* TODAY */ || tok.kind === "NOW" /* NOW */ || tok.kind === "LOGINUSER" /* LOGINUSER */) {
+    if (isContextualFunctionToken(tok.kind)) {
       this.advance();
       this.expect("(" /* LPAREN */);
       this.expect(")" /* RPAREN */);
       return {
         type: "KINTONE_FUNC",
-        name: tok.value
+        name: PARSER_CONTEXTUAL_FUNCTION_TOKEN_MAP[tok.kind]
       };
     }
     if (tok.kind === "CASE" /* CASE */) {
@@ -3267,7 +3281,7 @@ var Parser = class {
     }
     if (tok.kind === "VARIABLE" /* VARIABLE */) return this.parseSqlValue();
     if (tok.kind === "STRING" /* STRING */) return this.parseSqlValue();
-    if (tok.kind === "TODAY" /* TODAY */ || tok.kind === "NOW" /* NOW */ || tok.kind === "LOGINUSER" /* LOGINUSER */) return this.parseSqlValue();
+    if (isContextualFunctionToken(tok.kind)) return this.parseSqlValue();
     if (tok.kind === "IN" /* IN */) return this.parseSqlValue();
     if (tok.kind === "CASE" /* CASE */ || tok.kind === "IF" /* IF */) {
       return this.parseSqlValue();