@first-ch/tools-mcp 0.4.1 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/sql-format.mjs ADDED
@@ -0,0 +1,694 @@
1
+ // SQLクエリの整形(tools.first-ch.com/sql-format/ と同一ロジック)
2
+ //
3
+ // 「整形コア」ブロックは site 側の site/sql-format/app.js と同一の実装。
4
+ // 2箇所ルール: 片方を直したらもう片方も同じ内容で直す(site側が正本)。
5
+ // 使っているのは String/RegExp/Array/Set だけなので、ブラウザ版のコードをそのまま持ってこられる。
6
+ import { readFile, writeFile } from 'node:fs/promises';
7
+ import { basename } from 'node:path';
8
+
9
+ /* ==================== ここから整形コア(site / MCP で同一) ==================== */
10
+
11
+ export const SQL_CASE_MODES = ['upper', 'lower', 'preserve'];
12
+ export const SQL_INDENT_STYLES = ['2', '4', '8', 'tab'];
13
+ export const SQL_COMMA_STYLES = ['trailing', 'leading'];
14
+ export const SQL_LOGIC_STYLES = ['leading', 'trailing'];
15
+ const SQL_INDENT_TEXT = { 2: ' ', 4: ' ', 8: ' ', tab: '\t' };
16
+
17
+ // 予約語(大文字化の対象)。型名まで含めるのは CREATE TABLE を貼られたときのため
18
+ const SQL_KEYWORDS = new Set((
19
+ 'ADD ALL ALTER ANALYZE AND ANY AS ASC BEGIN BETWEEN BY CASCADE CASE CAST CHECK COLLATE COLUMN ' +
20
+ 'COMMIT CONFLICT CONSTRAINT CREATE CROSS CUBE CURRENT DATABASE DECLARE DEFAULT DEFERRABLE DELETE ' +
21
+ 'DESC DESCRIBE DISTINCT DO DROP ELSE END ESCAPE EXCEPT EXCLUDE EXISTS EXPLAIN FALSE FETCH FILTER ' +
22
+ 'FIRST FOLLOWING FOR FOREIGN FROM FULL GRANT GROUP GROUPING HAVING IF IGNORE ILIKE IN INDEX INNER ' +
23
+ 'INSERT INTERSECT INTERVAL INTO IS JOIN KEY LAST LATERAL LEFT LIKE LIMIT MATCHED MERGE MINUS ' +
24
+ 'NATURAL NEXT NO NOT NOTHING NULL NULLS OFFSET ON ONLY OR ORDER OUTER OVER PARTITION PRECEDING ' +
25
+ 'PRIMARY RANGE RECURSIVE REFERENCES REGEXP RENAME REPLACE RESTRICT RETURNING REVOKE RIGHT RLIKE ' +
26
+ 'ROLLBACK ROLLUP ROW ROWS SAVEPOINT SELECT SET SETS SHOW SIMILAR SOME TABLE TEMPORARY THEN TIES ' +
27
+ 'TO TOP TRANSACTION TRIGGER TRUE TRUNCATE UNBOUNDED UNION UNIQUE UNKNOWN UPDATE USE USING VALUES ' +
28
+ 'VIEW WHEN WHERE WHILE WINDOW WITH WITHOUT ' +
29
+ // 型名
30
+ 'BIGINT BIGSERIAL BINARY BIT BLOB BOOL BOOLEAN BYTEA CHAR CLOB DATE DATETIME DECIMAL DOUBLE ENUM ' +
31
+ 'FLOAT INT INT2 INT4 INT8 INTEGER JSON JSONB MONEY NCHAR NUMERIC NVARCHAR PRECISION REAL SERIAL ' +
32
+ 'SMALLINT TEXT TIME TIMESTAMP TIMESTAMPTZ TINYINT UUID VARBINARY VARCHAR XML ZONE'
33
+ ).split(' '));
34
+
35
+ // 関数名(大文字化の対象。予約語と重なるものは「関数名の直後の ( の前を空けない」ためにも使う)
36
+ const SQL_FUNCTIONS = new Set((
37
+ 'ABS ACOS ARRAY_AGG ASCII ASIN ATAN AVG BOOL_AND BOOL_OR CAST CEIL CEILING CHAR_LENGTH ' +
38
+ 'CHARACTER_LENGTH COALESCE CONCAT CONCAT_WS COS COUNT CUME_DIST CURRENT_DATE CURRENT_TIME ' +
39
+ 'CURRENT_TIMESTAMP CURRENT_USER DATE_ADD DATE_FORMAT DATE_PART DATE_SUB DATE_TRUNC DATEADD ' +
40
+ 'DATEDIFF DAY DENSE_RANK EXP EXTRACT FIRST_VALUE FLOOR FORMAT GENERATE_SERIES GETDATE GREATEST ' +
41
+ 'GROUP_CONCAT HOUR IFNULL INITCAP INSTR ISNULL JSON_AGG JSON_BUILD_OBJECT JSON_EXTRACT LAG ' +
42
+ 'LAST_VALUE LEAD LEAST LEFT LENGTH LN LOG LOWER LPAD LTRIM MAX MD5 MIN MINUTE MOD MONTH NOW ' +
43
+ 'NTILE NULLIF NVL PERCENT_RANK PERCENTILE_CONT POSITION POW POWER QUARTER RANDOM RANK ' +
44
+ 'REGEXP_REPLACE REPEAT REPLACE REVERSE RIGHT ROUND ROW_NUMBER RPAD RTRIM SECOND SIGN SIN ' +
45
+ 'SPLIT_PART SQRT STDDEV STRFTIME STRING_AGG STRPOS SUBSTR SUBSTRING SUM TAN TO_CHAR TO_DATE ' +
46
+ 'TO_NUMBER TO_TIMESTAMP TRIM TRUNC UNIX_TIMESTAMP UPPER VARIANCE WEEK YEAR'
47
+ ).split(' '));
48
+
49
+ // 1つの構文キーワードとして扱う語の並び(長いものから順に照合する)
50
+ const SQL_MULTI = [
51
+ ['LEFT', 'OUTER', 'JOIN'], ['RIGHT', 'OUTER', 'JOIN'], ['FULL', 'OUTER', 'JOIN'],
52
+ ['LEFT', 'SEMI', 'JOIN'], ['ORDER', 'SIBLINGS', 'BY'], ['WITH', 'RECURSIVE'],
53
+ ['GROUP', 'BY'], ['ORDER', 'BY'], ['PARTITION', 'BY'], ['INSERT', 'INTO'], ['DELETE', 'FROM'],
54
+ ['UNION', 'ALL'], ['UNION', 'DISTINCT'], ['EXCEPT', 'ALL'], ['INTERSECT', 'ALL'],
55
+ ['INNER', 'JOIN'], ['LEFT', 'JOIN'], ['RIGHT', 'JOIN'], ['FULL', 'JOIN'], ['CROSS', 'JOIN'],
56
+ ['NATURAL', 'JOIN'], ['STRAIGHT', 'JOIN'], ['CROSS', 'APPLY'], ['OUTER', 'APPLY'],
57
+ ['ON', 'CONFLICT'], ['ON', 'DUPLICATE'], ['FETCH', 'FIRST'], ['FETCH', 'NEXT'],
58
+ ['CREATE', 'TABLE'], ['CREATE', 'VIEW'], ['CREATE', 'INDEX'], ['ALTER', 'TABLE'],
59
+ ['DROP', 'TABLE'], ['TRUNCATE', 'TABLE'],
60
+ ];
61
+
62
+ // 行頭に置く句
63
+ const SQL_CLAUSES = new Set([
64
+ 'WITH', 'WITH RECURSIVE', 'SELECT', 'FROM', 'WHERE', 'GROUP BY', 'HAVING', 'ORDER BY',
65
+ 'ORDER SIBLINGS BY', 'LIMIT', 'OFFSET', 'FETCH FIRST', 'FETCH NEXT', 'VALUES', 'SET',
66
+ 'RETURNING', 'INSERT INTO', 'UPDATE', 'DELETE FROM', 'ON CONFLICT', 'ON DUPLICATE', 'WINDOW',
67
+ 'CREATE TABLE', 'CREATE VIEW', 'CREATE INDEX', 'ALTER TABLE', 'DROP TABLE', 'TRUNCATE TABLE',
68
+ ]);
69
+ // 集合演算(前後を1行空けずに行頭へ置く)
70
+ const SQL_SETOPS = new Set([
71
+ 'UNION', 'UNION ALL', 'UNION DISTINCT', 'EXCEPT', 'EXCEPT ALL', 'INTERSECT', 'INTERSECT ALL', 'MINUS',
72
+ ]);
73
+ // JOIN の仲間(行頭に置く)
74
+ const SQL_JOINS = new Set([
75
+ 'JOIN', 'INNER JOIN', 'LEFT JOIN', 'LEFT OUTER JOIN', 'LEFT SEMI JOIN', 'RIGHT JOIN',
76
+ 'RIGHT OUTER JOIN', 'FULL JOIN', 'FULL OUTER JOIN', 'CROSS JOIN', 'NATURAL JOIN',
77
+ 'STRAIGHT JOIN', 'CROSS APPLY', 'OUTER APPLY',
78
+ ]);
79
+ // 中身を必ず次の行から書く句(1項目1行にするとき)
80
+ const SQL_BODY_BREAK = new Set(['SELECT', 'SET', 'VALUES', 'RETURNING', 'WITH', 'WITH RECURSIVE']);
81
+ // 条件の AND / OR を折り返す句
82
+ const SQL_LOGIC_CLAUSES = new Set(['WHERE', 'HAVING', 'ON', 'ON CONFLICT']);
83
+ // 「テーブル名 (列, 列)」のように、識別子と ( の間を空ける句
84
+ const SQL_PAREN_AFTER_NAME = new Set(['INSERT INTO', 'CREATE TABLE', 'CREATE VIEW', 'CREATE INDEX', 'ALTER TABLE']);
85
+ // SELECT の直後に同じ行へ置く語
86
+ const SQL_SELECT_MODIFIERS = new Set(['DISTINCT', 'ALL', 'TOP', 'DISTINCTROW', 'SQL_CALC_FOUND_ROWS']);
87
+ // 2文字以上の演算子(長いものから照合する)
88
+ const SQL_OPERATORS = ['->>', '#>>', '<=>', '||', '::', '->', '#>', '<=', '>=', '<>', '!=', '&&', ':=', '!<', '!>', '<<', '>>'];
89
+
90
+ const SQL_WORD_RE = /[A-Za-z0-9_$\u0080-\uffff]/;
91
+ const SQL_STRING_PREFIX_RE = /^[ENXBUenxbu]$/;
92
+
93
+ /**
94
+ * SQL を字句へ分ける。空白は捨て、コメント・文字列・引用符付き識別子はそのまま1トークンにする。
95
+ * @param {string} sql
96
+ * @returns {{tokens: object[], unterminatedString: boolean, unterminatedComment: boolean}}
97
+ */
98
+ export function sqlTokenize(sql) {
99
+ const s = String(sql === undefined || sql === null ? '' : sql).replace(/^/, '').replace(/\r\n?/g, '\n');
100
+ const tokens = [];
101
+ let unterminatedString = false;
102
+ let unterminatedComment = false;
103
+ let i = 0;
104
+ const push = (type, value) => {
105
+ tokens.push({ type, value, upper: type === 'word' ? value.toUpperCase() : value, raw: value });
106
+ };
107
+ while (i < s.length) {
108
+ const ch = s[i];
109
+ // 空白
110
+ if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\f' || ch === '\v') { i += 1; continue; }
111
+ // 行コメント
112
+ if ((ch === '-' && s[i + 1] === '-') || ch === '#') {
113
+ let j = s.indexOf('\n', i);
114
+ if (j === -1) j = s.length;
115
+ push('lineComment', s.slice(i, j));
116
+ i = j;
117
+ continue;
118
+ }
119
+ // ブロックコメント
120
+ if (ch === '/' && s[i + 1] === '*') {
121
+ const j = s.indexOf('*/', i + 2);
122
+ if (j === -1) { unterminatedComment = true; push('blockComment', s.slice(i)); i = s.length; continue; }
123
+ push('blockComment', s.slice(i, j + 2));
124
+ i = j + 2;
125
+ continue;
126
+ }
127
+ // 文字列(E'…' / N'…' のような接頭辞も1つにまとめる)
128
+ if (ch === "'" || (SQL_STRING_PREFIX_RE.test(ch) && s[i + 1] === "'")) {
129
+ const start = i;
130
+ if (ch !== "'") i += 1;
131
+ i += 1;
132
+ let closed = false;
133
+ while (i < s.length) {
134
+ if (s[i] === '\\' && (s[i + 1] === "'" || s[i + 1] === '\\')) { i += 2; continue; }
135
+ if (s[i] === "'") {
136
+ if (s[i + 1] === "'") { i += 2; continue; }
137
+ i += 1;
138
+ closed = true;
139
+ break;
140
+ }
141
+ i += 1;
142
+ }
143
+ if (!closed) unterminatedString = true;
144
+ push('string', s.slice(start, i));
145
+ continue;
146
+ }
147
+ // 引用符付き識別子
148
+ if (ch === '"' || ch === '`' || ch === '[') {
149
+ const close = ch === '[' ? ']' : ch;
150
+ const start = i;
151
+ i += 1;
152
+ let closed = false;
153
+ while (i < s.length) {
154
+ if (s[i] === close) {
155
+ if (close !== ']' && s[i + 1] === close) { i += 2; continue; }
156
+ i += 1;
157
+ closed = true;
158
+ break;
159
+ }
160
+ i += 1;
161
+ }
162
+ if (!closed) unterminatedString = true;
163
+ push('quoted', s.slice(start, i));
164
+ continue;
165
+ }
166
+ // ドル引用符($$…$$ / $tag$…$tag$)とプレースホルダ $1
167
+ if (ch === '$') {
168
+ const m = /^\$([A-Za-z_][A-Za-z0-9_]*)?\$/.exec(s.slice(i));
169
+ if (m) {
170
+ const tag = m[0];
171
+ const j = s.indexOf(tag, i + tag.length);
172
+ if (j === -1) { unterminatedString = true; push('string', s.slice(i)); i = s.length; continue; }
173
+ push('string', s.slice(i, j + tag.length));
174
+ i = j + tag.length;
175
+ continue;
176
+ }
177
+ const n = /^\$\d+/.exec(s.slice(i));
178
+ if (n) { push('param', n[0]); i += n[0].length; continue; }
179
+ }
180
+ // プレースホルダ
181
+ if (ch === '?') { push('param', '?'); i += 1; continue; }
182
+ if (ch === ':' && s[i + 1] !== ':' && /[A-Za-z_]/.test(s[i + 1] || '')) {
183
+ const n = /^:[A-Za-z_][A-Za-z0-9_]*/.exec(s.slice(i));
184
+ push('param', n[0]);
185
+ i += n[0].length;
186
+ continue;
187
+ }
188
+ if (ch === '@' && /[A-Za-z_@]/.test(s[i + 1] || '')) {
189
+ const n = /^@@?[A-Za-z_][A-Za-z0-9_$]*/.exec(s.slice(i));
190
+ push('param', n[0]);
191
+ i += n[0].length;
192
+ continue;
193
+ }
194
+ // 数値
195
+ if (/[0-9]/.test(ch) || (ch === '.' && /[0-9]/.test(s[i + 1] || ''))) {
196
+ const n = /^(0[xX][0-9a-fA-F]+|(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?)/.exec(s.slice(i));
197
+ push('number', n[0]);
198
+ i += n[0].length;
199
+ continue;
200
+ }
201
+ // 語
202
+ if (SQL_WORD_RE.test(ch)) {
203
+ let j = i;
204
+ while (j < s.length && SQL_WORD_RE.test(s[j])) j += 1;
205
+ push('word', s.slice(i, j));
206
+ i = j;
207
+ continue;
208
+ }
209
+ // 演算子・区切り
210
+ const rest = s.slice(i, i + 3);
211
+ const op = SQL_OPERATORS.find((o) => rest.startsWith(o));
212
+ if (op) { push('op', op); i += op.length; continue; }
213
+ push(ch === '(' || ch === ')' || ch === ',' || ch === ';' || ch === '.' ? 'punct' : 'op', ch);
214
+ i += 1;
215
+ }
216
+ return { tokens, unterminatedString, unterminatedComment };
217
+ }
218
+
219
+ /** 「GROUP BY」「LEFT OUTER JOIN」のような語の並びを1トークンへまとめる */
220
+ export function sqlMergeKeywords(tokens) {
221
+ const out = [];
222
+ for (let i = 0; i < tokens.length; i += 1) {
223
+ const t = tokens[i];
224
+ let merged = null;
225
+ if (t.type === 'word') {
226
+ for (const words of SQL_MULTI) {
227
+ if (words[0] !== t.upper) continue;
228
+ let ok = true;
229
+ for (let k = 1; k < words.length; k += 1) {
230
+ const n = tokens[i + k];
231
+ if (!n || n.type !== 'word' || n.upper !== words[k]) { ok = false; break; }
232
+ }
233
+ if (!ok) continue;
234
+ const parts = tokens.slice(i, i + words.length);
235
+ merged = {
236
+ type: 'word',
237
+ value: words.join(' '),
238
+ upper: words.join(' '),
239
+ raw: parts.map((p) => p.value).join(' '),
240
+ };
241
+ i += words.length - 1;
242
+ break;
243
+ }
244
+ }
245
+ out.push(merged || t);
246
+ }
247
+ return out;
248
+ }
249
+
250
+ /** 指摘は {code, params} で持ち、表示のときに文言へ変える(MCP側と同じ構造) */
251
+ function sqlNote(code, params) {
252
+ return { code, params: params || {} };
253
+ }
254
+
255
+ /** 予約語か(「GROUP BY」のようにまとめた語は必ず予約語) */
256
+ function sqlIsKeyword(token) {
257
+ return token.type === 'word' && (SQL_KEYWORDS.has(token.upper) || token.upper.indexOf(' ') !== -1);
258
+ }
259
+
260
+ /** 指定された表記へ寄せる(preserve のときは元の綴りを返す) */
261
+ function sqlApplyCase(token, mode) {
262
+ if (mode === 'preserve') return token.raw;
263
+ return mode === 'lower' ? token.value.toLowerCase() : token.value.toUpperCase();
264
+ }
265
+
266
+ /** 既定値を埋めたオプション */
267
+ export function sqlOptions(opts) {
268
+ const o = opts || {};
269
+ const pick = (v, list, def) => (list.indexOf(v) === -1 ? def : v);
270
+ const bool = (v, def) => (v === undefined || v === null ? def : v === true || v === 'true' || v === 1 || v === '1');
271
+ return {
272
+ keywordCase: pick(o.keywordCase, SQL_CASE_MODES, 'upper'),
273
+ functionCase: pick(o.functionCase, SQL_CASE_MODES, 'upper'),
274
+ indent: pick(String(o.indent === undefined ? '4' : o.indent), SQL_INDENT_STYLES, '4'),
275
+ commaStyle: pick(o.commaStyle, SQL_COMMA_STYLES, 'trailing'),
276
+ logicStyle: pick(o.logicStyle, SQL_LOGIC_STYLES, 'leading'),
277
+ breakColumns: bool(o.breakColumns, true),
278
+ breakLogic: bool(o.breakLogic, true),
279
+ breakOn: bool(o.breakOn, true),
280
+ breakCase: bool(o.breakCase, true),
281
+ breakSubquery: bool(o.breakSubquery, true),
282
+ expandClauses: bool(o.expandClauses, false),
283
+ compact: bool(o.compact, false),
284
+ eol: o.eol === 'crlf' ? 'crlf' : 'lf',
285
+ };
286
+ }
287
+
288
+ /** コメントを飛ばして次の実トークンを返す */
289
+ function sqlNextSig(tokens, i) {
290
+ for (let k = i + 1; k < tokens.length; k += 1) {
291
+ const t = tokens[k];
292
+ if (t.type !== 'lineComment' && t.type !== 'blockComment') return t;
293
+ }
294
+ return null;
295
+ }
296
+
297
+ /**
298
+ * SQL を整形する。
299
+ * @param {string} sql
300
+ * @param {object} [options]
301
+ * @returns {{text: string, lines: number, statements: number, depth: number, keywords: number,
302
+ * tokens: number, notes: object[]}}
303
+ */
304
+ export function sqlFormat(sql, options) {
305
+ const o = sqlOptions(options);
306
+ const lex = sqlTokenize(sql);
307
+ const toks = sqlMergeKeywords(lex.tokens);
308
+ const indentText = SQL_INDENT_TEXT[o.indent];
309
+
310
+ const lines = [];
311
+ let buf = '';
312
+ let bufIndent = 0;
313
+ let pending = -1; // 次に出すトークンの前で改行する(値はインデント段数)
314
+ let prev = null; // 直前に出したトークン
315
+ let noSpaceNext = false;
316
+
317
+ const flushLine = () => {
318
+ if (buf !== '') { lines.push(indentText.repeat(bufIndent) + buf); buf = ''; }
319
+ };
320
+ /** 改行を予約する(compact のときは何もしない) */
321
+ const brk = (level) => { if (!o.compact) pending = level < 0 ? 0 : level; };
322
+
323
+ const needSpace = (tok) => {
324
+ if (noSpaceNext) { noSpaceNext = false; return false; }
325
+ if (buf === '' || !prev) return false;
326
+ if (prev.value === '.' || prev.value === '::') return false;
327
+ if (tok.value === '.' || tok.value === '::') return false;
328
+ if (tok.value === ',' || tok.value === ';' || tok.value === ')') return false;
329
+ if (prev.value === '(') return false;
330
+ if (tok.value === '(') {
331
+ // 関数呼び出しの ( は名前に付ける。INSERT INTO t (a, b) のような列の並びだけは空ける
332
+ if (prev.type === 'word') {
333
+ if (SQL_FUNCTIONS.has(prev.upper)) return false;
334
+ if (SQL_KEYWORDS.has(prev.upper) || prev.upper.indexOf(' ') !== -1) return true;
335
+ return SQL_PAREN_AFTER_NAME.has(top().clause);
336
+ }
337
+ if (prev.type === 'quoted') return SQL_PAREN_AFTER_NAME.has(top().clause);
338
+ if (prev.type === 'param') return false;
339
+ return true;
340
+ }
341
+ return true;
342
+ };
343
+
344
+ const emit = (text, tok) => {
345
+ if (pending >= 0) { flushLine(); bufIndent = pending; pending = -1; prev = null; }
346
+ const space = needSpace(tok);
347
+ buf = buf === '' ? text : buf + (space ? ' ' : '') + text;
348
+ prev = tok;
349
+ };
350
+
351
+ /** 語トークンを表記ルールに合わせて出す */
352
+ const emitWord = (t) => {
353
+ if (sqlIsKeyword(t)) emit(sqlApplyCase(t, o.keywordCase), t);
354
+ else if (SQL_FUNCTIONS.has(t.upper)) emit(sqlApplyCase(t, o.functionCase), t);
355
+ else emit(t.raw, t);
356
+ };
357
+
358
+ const newFrame = (kind, base, open) => ({ kind, base, open, clause: '', body: base + 1 });
359
+ let frames = [newFrame('root', 0, 0)];
360
+ const top = () => frames[frames.length - 1];
361
+ const caseStack = [];
362
+ let betweenDepth = 0;
363
+
364
+ const bodyBreak = (clause) => (o.breakColumns && SQL_BODY_BREAK.has(clause)) || (o.expandClauses && SQL_CLAUSES.has(clause));
365
+ const commaBreak = (clause) => bodyBreak(clause) || (o.expandClauses && (clause === 'FROM' || clause === 'GROUP BY' || clause === 'ORDER BY'));
366
+
367
+ /* ---- 集計と指摘のための情報 ---- */
368
+ let keywords = 0;
369
+ let depth = 0;
370
+ let statements = 0;
371
+ let openStatement = false; // 直近の「;」より後に中身があるか
372
+ let openParens = 0;
373
+ let extraClose = 0;
374
+ let selectStar = 0;
375
+ let implicitJoin = 0;
376
+ let params = 0;
377
+ let cased = 0;
378
+ let stmtKind = '';
379
+ let stmtHasWhere = false;
380
+ const noWhere = [];
381
+ const endStatement = () => {
382
+ if (stmtKind && !stmtHasWhere && noWhere.indexOf(stmtKind) === -1) noWhere.push(stmtKind);
383
+ stmtKind = '';
384
+ stmtHasWhere = false;
385
+ };
386
+
387
+ for (let i = 0; i < toks.length; i += 1) {
388
+ const t = toks[i];
389
+ const next = sqlNextSig(toks, i);
390
+ const kw = t.type === 'word' ? t.upper : '';
391
+ if (t.type !== 'lineComment' && t.type !== 'blockComment') {
392
+ if (t.value !== ';') openStatement = true;
393
+ if (t.type === 'param') params += 1;
394
+ if (sqlIsKeyword(t) || SQL_FUNCTIONS.has(kw)) {
395
+ keywords += 1;
396
+ if (t.raw !== sqlApplyCase(t, o.keywordCase)) cased += 1;
397
+ }
398
+ }
399
+
400
+ /* ---- コメント ---- */
401
+ if (t.type === 'lineComment') {
402
+ emit(t.value, t);
403
+ pending = bufIndent; // 行コメントの後は必ず改行する(compact でも同じ)
404
+ continue;
405
+ }
406
+ if (t.type === 'blockComment') {
407
+ emit(t.value.indexOf('\n') === -1 ? t.value : t.value, t);
408
+ continue;
409
+ }
410
+
411
+ /* ---- 句(行頭に置く) ---- */
412
+ if (t.type === 'word' && (SQL_CLAUSES.has(kw) || SQL_SETOPS.has(kw))) {
413
+ const f = top();
414
+ if (kw === 'UPDATE' || kw === 'DELETE FROM') { endStatement(); stmtKind = kw === 'UPDATE' ? 'UPDATE' : 'DELETE'; }
415
+ if (kw === 'WHERE') stmtHasWhere = true;
416
+ // OVER (PARTITION BY … ORDER BY …) のように括弧の中に入った句は折り返さない
417
+ if (f.kind === 'args') { emitWord(t); continue; }
418
+ brk(f.base);
419
+ emitWord(t);
420
+ if (SQL_SETOPS.has(kw)) { f.clause = ''; f.body = f.base + 1; brk(f.base); continue; }
421
+ f.clause = kw;
422
+ f.body = f.base + 1;
423
+ // SELECT DISTINCT / SELECT TOP 10 は SELECT と同じ行に置く
424
+ if (kw === 'SELECT') {
425
+ while (toks[i + 1] && toks[i + 1].type === 'word' && SQL_SELECT_MODIFIERS.has(toks[i + 1].upper)) {
426
+ i += 1;
427
+ emitWord(toks[i]);
428
+ if (toks[i].upper === 'TOP' && toks[i + 1] && toks[i + 1].type === 'number') { i += 1; emit(toks[i].value, toks[i]); }
429
+ }
430
+ // SELECT * だけは1行のままにする(1文字のために2行使わない)
431
+ const star = toks[i + 1];
432
+ const afterStar = toks[i + 2];
433
+ if (star && star.value === '*' && afterStar && afterStar.type === 'word' && afterStar.upper === 'FROM') {
434
+ i += 1;
435
+ emit('*', star);
436
+ selectStar += 1;
437
+ continue;
438
+ }
439
+ }
440
+ if (bodyBreak(kw)) brk(f.body);
441
+ continue;
442
+ }
443
+
444
+ /* ---- JOIN ---- */
445
+ if (t.type === 'word' && SQL_JOINS.has(kw)) {
446
+ const f = top();
447
+ brk(f.base);
448
+ emitWord(t);
449
+ f.clause = 'JOIN';
450
+ f.body = f.base + 1;
451
+ continue;
452
+ }
453
+
454
+ /* ---- 結合条件 ---- */
455
+ if (t.type === 'word' && (kw === 'ON' || kw === 'USING') && top().clause === 'JOIN') {
456
+ const f = top();
457
+ if (o.breakOn) brk(f.base + 1);
458
+ emitWord(t);
459
+ f.clause = 'ON';
460
+ f.body = f.base + 1;
461
+ continue;
462
+ }
463
+
464
+ /* ---- AND / OR ---- */
465
+ if (t.type === 'word' && (kw === 'AND' || kw === 'OR')) {
466
+ if (kw === 'AND' && betweenDepth > 0) { betweenDepth -= 1; emitWord(t); continue; }
467
+ const f = top();
468
+ if (o.breakLogic && SQL_LOGIC_CLAUSES.has(f.clause)) {
469
+ if (o.logicStyle === 'leading') { brk(f.body); emitWord(t); } else { emitWord(t); brk(f.body); }
470
+ } else {
471
+ emitWord(t);
472
+ }
473
+ continue;
474
+ }
475
+ if (kw === 'BETWEEN') { betweenDepth += 1; emitWord(t); continue; }
476
+
477
+ /* ---- CASE 式 ---- */
478
+ if (kw === 'CASE' && o.breakCase) {
479
+ emitWord(t);
480
+ caseStack.push(bufIndent);
481
+ continue;
482
+ }
483
+ if ((kw === 'WHEN' || kw === 'ELSE') && caseStack.length) {
484
+ brk(caseStack[caseStack.length - 1] + 1);
485
+ emitWord(t);
486
+ continue;
487
+ }
488
+ if (kw === 'END' && caseStack.length) {
489
+ brk(caseStack.pop());
490
+ emitWord(t);
491
+ continue;
492
+ }
493
+
494
+ /* ---- 括弧 ---- */
495
+ if (t.value === '(' && t.type === 'punct') {
496
+ emit('(', t);
497
+ const sub = o.breakSubquery && !o.compact && next && next.type === 'word'
498
+ && (next.upper === 'SELECT' || next.upper === 'WITH' || next.upper === 'WITH RECURSIVE' || next.upper === 'VALUES');
499
+ const isSub = next && next.type === 'word'
500
+ && (next.upper === 'SELECT' || next.upper === 'WITH' || next.upper === 'WITH RECURSIVE');
501
+ if (sub) {
502
+ frames.push(newFrame('sub', bufIndent + 1, bufIndent));
503
+ brk(bufIndent + 1);
504
+ } else {
505
+ frames.push(newFrame('args', bufIndent, bufIndent));
506
+ }
507
+ frames[frames.length - 1].subquery = isSub;
508
+ if (isSub) {
509
+ // 深さはサブクエリの入れ子の数で数える(関数の括弧は数えない)
510
+ let n = 0;
511
+ for (const f of frames) if (f.subquery) n += 1;
512
+ if (n > depth) depth = n;
513
+ }
514
+ openParens += 1;
515
+ continue;
516
+ }
517
+ if (t.value === ')' && t.type === 'punct') {
518
+ if (frames.length > 1) {
519
+ const f = frames.pop();
520
+ openParens -= 1;
521
+ if (f.kind === 'sub') brk(f.open);
522
+ } else {
523
+ extraClose += 1;
524
+ }
525
+ emit(')', t);
526
+ continue;
527
+ }
528
+
529
+ /* ---- カンマ ---- */
530
+ if (t.value === ',' && t.type === 'punct') {
531
+ const f = top();
532
+ if (f.clause === 'FROM' && f.kind !== 'args') implicitJoin += 1;
533
+ if (f.kind === 'args' || !commaBreak(f.clause)) { emit(',', t); continue; }
534
+ if (o.commaStyle === 'leading') { brk(f.body); emit(',', t); } else { emit(',', t); brk(f.body); }
535
+ continue;
536
+ }
537
+
538
+ /* ---- 文の区切り ---- */
539
+ if (t.value === ';' && t.type === 'punct') {
540
+ emit(';', t);
541
+ flushLine();
542
+ if (openStatement) statements += 1;
543
+ openStatement = false;
544
+ endStatement();
545
+ frames = [newFrame('root', 0, 0)];
546
+ caseStack.length = 0;
547
+ betweenDepth = 0;
548
+ if (next) lines.push('');
549
+ pending = 0;
550
+ continue;
551
+ }
552
+
553
+ /* ---- そのほか ---- */
554
+ if (t.type === 'word') {
555
+ if (kw === 'INSERT INTO') stmtKind = 'INSERT';
556
+ emitWord(t);
557
+ continue;
558
+ }
559
+ if (t.value === '*' && prev && prev.type === 'word' && prev.upper === 'SELECT') selectStar += 1;
560
+ if ((t.value === '-' || t.value === '+') && (!prev || prev.value === '(' || prev.value === ',' || prev.type === 'op'
561
+ || (prev.type === 'word' && SQL_KEYWORDS.has(prev.upper)))) {
562
+ emit(t.value, t);
563
+ noSpaceNext = true;
564
+ continue;
565
+ }
566
+ emit(t.value, t);
567
+ }
568
+ flushLine();
569
+ if (openStatement) statements += 1;
570
+ endStatement();
571
+
572
+ while (lines.length && lines[lines.length - 1] === '') lines.pop();
573
+ const text = lines.length ? lines.join('\n') + '\n' : '';
574
+
575
+ /* ---- 指摘 ---- */
576
+ const notes = [];
577
+ if (lex.unterminatedString) notes.push(sqlNote('UNTERMINATED_STRING'));
578
+ if (lex.unterminatedComment) notes.push(sqlNote('UNTERMINATED_COMMENT'));
579
+ if (openParens > 0) notes.push(sqlNote('UNBALANCED_OPEN', { count: openParens }));
580
+ if (extraClose > 0) notes.push(sqlNote('UNBALANCED_CLOSE', { count: extraClose }));
581
+ for (const kind of noWhere) notes.push(sqlNote('NO_WHERE', { kind }));
582
+ if (selectStar) notes.push(sqlNote('SELECT_STAR', { count: selectStar }));
583
+ if (implicitJoin) notes.push(sqlNote('IMPLICIT_JOIN', { count: implicitJoin }));
584
+ if (params) notes.push(sqlNote('PLACEHOLDERS', { count: params }));
585
+ if (cased && o.keywordCase !== 'preserve') notes.push(sqlNote('CASED', { count: cased, mode: o.keywordCase }));
586
+
587
+ return {
588
+ text: o.eol === 'crlf' ? text.replace(/\n/g, '\r\n') : text,
589
+ lines: lines.length,
590
+ statements,
591
+ depth,
592
+ keywords,
593
+ tokens: toks.length,
594
+ notes,
595
+ };
596
+ }
597
+
598
+ /* ==================== ここまで整形コア ==================== */
599
+
600
+ export class SqlFormatError extends Error {}
601
+
602
+ // 指摘の文面(site側は同じ code を日英の T テーブルで出し分けている)
603
+ const NOTE_TEXT = {
604
+ UNTERMINATED_STRING: () => '引用符が閉じていません。以降がすべて文字列として読まれているため、結果がずれている可能性があります。',
605
+ UNTERMINATED_COMMENT: () => '/* ブロックコメント */ が閉じていません。以降がすべてコメントとして扱われています。',
606
+ UNBALANCED_OPEN: (p) => `閉じていない「(」が ${p.count} 個あります。そこから先のインデントは推測になっています。`,
607
+ UNBALANCED_CLOSE: (p) => `対応する「(」の無い「)」が ${p.count} 個あります。`,
608
+ NO_WHERE: (p) => `${p.kind} に WHERE がありません。テーブルの全行が対象になります。`,
609
+ SELECT_STAR: (p) => `SELECT * を ${p.count} 箇所で使っています。必要な列を並べて書くと、テーブルの列が増えても結果が変わりません。`,
610
+ IMPLICIT_JOIN: (p) => `FROM 句にテーブルを ${p.count + 1} 個カンマで並べています(暗黙の結合)。INNER JOIN … ON と書くと結合条件が目に見えます。`,
611
+ PLACEHOLDERS: (p) => `プレースホルダを ${p.count} 個見つけました(? / :name / $1)。値を文字列連結せずプレースホルダのまま渡すことがSQLインジェクション対策そのものです。`,
612
+ CASED: (p) => `予約語 ${p.count} 語を${p.mode === 'lower' ? '小' : '大'}文字にしました。`,
613
+ };
614
+
615
+ const noteMessage = (n) => (NOTE_TEXT[n.code] ? NOTE_TEXT[n.code](n.params || {}) : n.code);
616
+
617
+ /**
618
+ * 1行のSQLを読みやすく整形する(site側の /sql-format/ と同一ロジック)。
619
+ *
620
+ * @param {object} opts
621
+ * @param {string} [opts.text] 対象のSQL(path と排他)
622
+ * @param {string} [opts.path] 対象ファイルの絶対パス(UTF-8として読む)
623
+ * @param {string} [opts.outputPath] 結果を書き出す絶対パス(指定すると text は返さない)
624
+ * @param {'upper'|'lower'|'preserve'} [opts.keywordCase='upper'] 予約語の表記
625
+ * @param {'upper'|'lower'|'preserve'} [opts.functionCase='upper'] 関数名の表記
626
+ * @param {'2'|'4'|'8'|'tab'} [opts.indent='4'] インデントの幅
627
+ * @param {'trailing'|'leading'} [opts.commaStyle='trailing'] カンマの位置
628
+ * @param {'leading'|'trailing'} [opts.logicStyle='leading'] AND / OR の位置
629
+ * @param {boolean} [opts.breakColumns=true] SELECT の列などを1行ずつに分けるか
630
+ * @param {boolean} [opts.breakLogic=true] AND / OR で折り返すか
631
+ * @param {boolean} [opts.breakOn=true] JOIN の ON を改行するか
632
+ * @param {boolean} [opts.breakCase=true] CASE 式を展開するか
633
+ * @param {boolean} [opts.breakSubquery=true] サブクエリを字下げして展開するか
634
+ * @param {boolean} [opts.expandClauses=false] 句の中身も次の行から書くか
635
+ * @param {boolean} [opts.compact=false] 改行を畳んで1行にまとめるか
636
+ * @param {'lf'|'crlf'} [opts.eol='lf'] 出力の改行コード
637
+ * @returns {Promise<object>}
638
+ */
639
+ export async function sqlFormatTool(opts = {}) {
640
+ const hasText = typeof opts.text === 'string';
641
+ if (hasText === Boolean(opts.path)) throw new SqlFormatError('text か path のどちらか一方を渡してください');
642
+
643
+ // 画面側(URLパラメータ)は不正値を既定へ落とすが、MCPでは黙って別の設定で返さない
644
+ const check = (name, value, allowed) => {
645
+ if (value === undefined || value === null) return;
646
+ if (allowed.indexOf(String(value)) === -1) {
647
+ throw new SqlFormatError(`${name} は ${allowed.join(' / ')} のいずれかを指定してください(受け取った値: ${value})`);
648
+ }
649
+ };
650
+ check('keywordCase', opts.keywordCase, SQL_CASE_MODES);
651
+ check('functionCase', opts.functionCase, SQL_CASE_MODES);
652
+ check('indent', opts.indent, SQL_INDENT_STYLES);
653
+ check('commaStyle', opts.commaStyle, SQL_COMMA_STYLES);
654
+ check('logicStyle', opts.logicStyle, SQL_LOGIC_STYLES);
655
+ check('eol', opts.eol, ['lf', 'crlf']);
656
+
657
+ const source = hasText ? opts.text : await readFile(opts.path, 'utf8');
658
+ if (String(source).trim() === '') throw new SqlFormatError('整形するSQLが空です');
659
+ const o = sqlOptions(opts);
660
+ const r = sqlFormat(source, o);
661
+
662
+ const result = {
663
+ source: hasText ? { type: 'text' } : { path: opts.path, name: basename(opts.path) },
664
+ text: r.text,
665
+ lines: r.lines,
666
+ statements: r.statements,
667
+ subquery_depth: r.depth,
668
+ keywords: r.keywords,
669
+ tokens: r.tokens,
670
+ options: {
671
+ keyword_case: o.keywordCase,
672
+ function_case: o.functionCase,
673
+ indent: o.indent,
674
+ comma_style: o.commaStyle,
675
+ logic_style: o.logicStyle,
676
+ break_columns: o.breakColumns,
677
+ break_logic: o.breakLogic,
678
+ break_on: o.breakOn,
679
+ break_case: o.breakCase,
680
+ break_subquery: o.breakSubquery,
681
+ expand_clauses: o.expandClauses,
682
+ compact: o.compact,
683
+ eol: o.eol,
684
+ },
685
+ notes: r.notes.map((n) => ({ code: n.code, message: noteMessage(n) })),
686
+ };
687
+ if (opts.outputPath) {
688
+ await writeFile(opts.outputPath, r.text, 'utf8');
689
+ result.output = opts.outputPath;
690
+ // ファイルに書けたなら本文は重複した重い情報でしかない
691
+ delete result.text;
692
+ }
693
+ return result;
694
+ }