feat(i18n): 收口多语言功能业务代码

frontend/src/utils/sqlErrorSemantics.test.ts

@@ -1,37 +1,114 @@
+import { readFileSync } from 'node:fs';
 import { describe, expect, it } from 'vitest';
 
 import { formatSqlExecutionError } from './sqlErrorSemantics';
 
+const source = readFileSync(new URL('./sqlErrorSemantics.ts', import.meta.url), 'utf8');
+
 describe('formatSqlExecutionError', () => {
-  it('adds Chinese semantic explanation for SQL syntax errors and keeps raw text', () => {
+  it('adds semantic explanation for SQL syntax errors and keeps raw text', () => {
     const formatted = formatSqlExecutionError('pq: syntax error at or near "from"');
 
-    expect(formatted).toContain('中文语义：SQL 语法错误');
-    expect(formatted).toContain('处理建议：');
-    expect(formatted).toContain('原始错误：pq: syntax error at or near "from"');
+    expect(formatted).toContain('Semantic meaning: SQL syntax error');
+    expect(formatted).toContain('Suggestion:');
+    expect(formatted).toContain('Raw error: pq: syntax error at or near "from"');
   });
 
   it('recognizes missing table errors', () => {
     const formatted = formatSqlExecutionError('ERROR: relation "orders" does not exist');
 
-    expect(formatted).toContain('中文语义：表或对象不存在');
-    expect(formatted).toContain('原始错误：ERROR: relation "orders" does not exist');
+    expect(formatted).toContain('Semantic meaning: Table or object does not exist');
+    expect(formatted).toContain('Raw error: ERROR: relation "orders" does not exist');
   });
 
   it('recognizes duplicate key errors with statement prefix', () => {
     const formatted = formatSqlExecutionError('Duplicate entry "1" for key "PRIMARY"', {
-      prefix: '第 2 条语句执行失败：',
+      prefix: 'Statement 2 failed:',
     });
 
-    expect(formatted.startsWith('第 2 条语句执行失败：\n中文语义：唯一约束或主键冲突')).toBe(true);
-    expect(formatted).toContain('原始错误：Duplicate entry "1" for key "PRIMARY"');
+    expect(formatted.startsWith('Statement 2 failed:\nSemantic meaning: Unique constraint or primary key conflict')).toBe(true);
+    expect(formatted).toContain('Raw error: Duplicate entry "1" for key "PRIMARY"');
   });
 
   it('falls back to a generic database execution error', () => {
     const formatted = formatSqlExecutionError('driver returned unexpected status 123');
 
-    expect(formatted).toContain('中文语义：数据库执行错误');
-    expect(formatted).toContain('原始错误：driver returned unexpected status 123');
+    expect(formatted).toContain('Semantic meaning: Database execution error');
+    expect(formatted).toContain('Raw error: driver returned unexpected status 123');
+  });
+
+  it('recognizes localized connection-timeout wrappers as timeout semantics', () => {
+    const translate = (key: string, params?: Record<string, unknown>) => {
+      if (key === 'query_editor.sql_error.wrapper.semantic_line') {
+        return `SEM:${params?.label}|${params?.explanation}`;
+      }
+      if (key === 'query_editor.sql_error.wrapper.suggestion_line') {
+        return `SUG:${params?.suggestion}`;
+      }
+      if (key === 'query_editor.sql_error.wrapper.raw_line') {
+        return `RAW:${params?.error}`;
+      }
+      if (key === 'query_editor.sql_error.rule.timeout_or_canceled.label') {
+        return 'TIMEOUT_LABEL';
+      }
+      if (key === 'query_editor.sql_error.rule.timeout_or_canceled.explanation') {
+        return 'TIMEOUT_EXPLANATION';
+      }
+      if (key === 'query_editor.sql_error.rule.timeout_or_canceled.suggestion') {
+        return 'TIMEOUT_SUGGESTION';
+      }
+      if (key === 'query_editor.sql_error.rule.generic.label') {
+        return 'GENERIC_LABEL';
+      }
+      if (key === 'query_editor.sql_error.rule.generic.explanation') {
+        return 'GENERIC_EXPLANATION';
+      }
+      if (key === 'query_editor.sql_error.rule.generic.suggestion') {
+        return 'GENERIC_SUGGESTION';
+      }
+      return key;
+    };
+
+    const localizedTimeoutMessages = [
+      '\u8cc7\u6599\u5eab\u9023\u7dda\u903e\u6642\uff1amysql 127.0.0.1:3306/main\uff1a\u7db2\u8def\u903e\u6642',
+      '\u30c7\u30fc\u30bf\u30d9\u30fc\u30b9\u63a5\u7d9a\u304c\u30bf\u30a4\u30e0\u30a2\u30a6\u30c8\u3057\u307e\u3057\u305f: mysql 127.0.0.1:3306/main: \u30bf\u30a4\u30e0\u30a2\u30a6\u30c8',
+      'Zeit\u00fcberschreitung bei der Datenbankverbindung: mysql 127.0.0.1:3306/main: netzwerk-timeout',
+      '\u0422\u0430\u0439\u043c-\u0430\u0443\u0442 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u043a \u0431\u0430\u0437\u0435 \u0434\u0430\u043d\u043d\u044b\u0445: mysql 127.0.0.1:3306/main: \u0442\u0430\u0439\u043c-\u0430\u0443\u0442 \u0441\u0435\u0442\u0438',
+    ] as const;
+
+    for (const raw of localizedTimeoutMessages) {
+      const formatted = formatSqlExecutionError(raw, { translate });
+
+      expect(formatted).toContain('SEM:TIMEOUT_LABEL|TIMEOUT_EXPLANATION');
+      expect(formatted).toContain('SUG:TIMEOUT_SUGGESTION');
+      expect(formatted).toContain(`RAW:${raw}`);
+      expect(formatted).not.toContain('SEM:GENERIC_LABEL|GENERIC_EXPLANATION');
+    }
+  });
+
+  it('localizes semantic wrapper copy with a supplied translator without translating raw database errors', () => {
+    const seen: Array<{ key: string; params?: Record<string, unknown> }> = [];
+    const formatted = formatSqlExecutionError('ERROR: relation "orders" does not exist', {
+      translate: (key, params) => {
+        seen.push({ key, params });
+        if (key === 'query_editor.sql_error.wrapper.semantic_line') {
+          return `语义:${params?.label}|${params?.explanation}`;
+        }
+        if (key === 'query_editor.sql_error.wrapper.suggestion_line') {
+          return `建议:${params?.suggestion}`;
+        }
+        if (key === 'query_editor.sql_error.wrapper.raw_line') {
+          return `RAW:${params?.error}`;
+        }
+        return `T:${key}`;
+      },
+    });
+
+    expect(formatted).toContain('语义:T:query_editor.sql_error.rule.object_missing.label|T:query_editor.sql_error.rule.object_missing.explanation');
+    expect(formatted).toContain('建议:T:query_editor.sql_error.rule.object_missing.suggestion');
+    expect(formatted).toContain('RAW:ERROR: relation "orders" does not exist');
+    expect(seen.map((entry) => entry.key)).toContain('query_editor.sql_error.rule.object_missing.label');
+    expect(seen.map((entry) => entry.key)).toContain('query_editor.sql_error.wrapper.raw_line');
   });
 
   it('does not format an already formatted message again', () => {
@@ -43,4 +120,14 @@ describe('formatSqlExecutionError', () => {
 
     expect(formatSqlExecutionError(raw)).toBe(raw);
   });
+
+  it('keeps SQL execution semantic copy out of production Chinese literals', () => {
+    expect(source).toContain('query_editor.sql_error.rule.');
+    expect(source).toContain("key: 'syntax'");
+    expect(source).toContain('query_editor.sql_error.wrapper.semantic_line');
+    expect(source).not.toContain('SQL 语法错误');
+    expect(source).not.toContain('处理建议');
+    expect(source).not.toContain('原始错误');
+    expect(source).not.toContain('数据库执行错误');
+  });
 });