使用React js完成web前端

chusql-web/frontend/bin/lib/args.js

@@ -0,0 +1,54 @@
+// 命令行参数解析：命令、动作、全局选项与取值校验。
+
+const HOST_PATTERN = /^[A-Za-z0-9.:[\]-]+$/;
+
+function valueAfter(argv, index, label) {
+  const value = argv[index + 1];
+  if (!value || value.startsWith('--')) throw new Error(`${label} requires a value.`);
+  return value;
+}
+
+export function parseArgs(argv) {
+  const result = { command: 'help', action: '', operands: [], autoOpenBrowser: undefined };
+  let index = 0;
+  if (argv[index] && !argv[index].startsWith('-')) {
+    result.command = argv[index];
+    index += 1;
+  } else if (argv.length) {
+    result.command = argv[0] === '--version' || argv[0] === '-v' ? 'version' : 'help';
+  }
+  if (result.command === 'config' && argv[index] && !argv[index].startsWith('-')) {
+    result.action = argv[index];
+    index += 1;
+  }
+  while (index < argv.length) {
+    const token = argv[index];
+    if (token === '--help' || token === '-h') result.help = true;
+    else if (token === '--no-open') result.autoOpenBrowser = false;
+    else if (token === '--port') {
+      const raw = valueAfter(argv, index, 'Port');
+      if (!/^\d+$/.test(raw) || Number(raw) < 1 || Number(raw) > 65535) throw new Error('Port must be an integer between 1 and 65535.');
+      result.port = Number(raw);
+      index += 1;
+    } else if (token === '--host') {
+      const host = valueAfter(argv, index, 'Host');
+      if (!HOST_PATTERN.test(host)) throw new Error('Host contains invalid characters.');
+      result.host = host;
+      index += 1;
+    } else if (token === '--adapter') {
+      const adapter = valueAfter(argv, index, 'Adapter');
+      if (adapter !== 'mock' && adapter !== 'rest') throw new Error('Adapter must be mock or rest.');
+      result.adapter = adapter;
+      index += 1;
+    } else if (token === '--config') {
+      result.configPath = valueAfter(argv, index, 'Config');
+      index += 1;
+    } else if (token.startsWith('-')) {
+      throw new Error(`Unknown option: ${token}`);
+    } else {
+      result.operands.push(token);
+    }
+    index += 1;
+  }
+  return result;
+}

chusql-web/frontend/bin/lib/args.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { parseArgs } from './args.js';
+
+// 覆盖 CLI 参数解析与非法取值拒绝。
+
+describe('parseArgs', () => {
+  it('parses command-specific and global options', () => {
+    expect(parseArgs(['web', '--port', '9000', '--no-open', '--adapter', 'rest'])).toMatchObject({
+      command: 'web', port: 9000, autoOpenBrowser: false, adapter: 'rest',
+    });
+  });
+
+  it('rejects unsafe or invalid values', () => {
+    expect(() => parseArgs(['web', '--port', 'nope'])).toThrow('Port must be an integer');
+    expect(() => parseArgs(['web', '--host', 'x & calc'])).toThrow('Host contains invalid characters');
+    expect(() => parseArgs(['web', '--adapter', 'other'])).toThrow('Adapter must be mock or rest');
+  });
+});

chusql-web/frontend/bin/lib/config.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+// CLI 配置文件读写：默认值、点号路径访问与类型解析。
+
+export const DEFAULT_CONFIG = Object.freeze({
+  port: 5173,
+  host: '127.0.0.1',
+  autoOpenBrowser: true,
+  adapter: 'mock',
+});
+
+export function defaultConfigPath() {
+  return path.join(os.homedir(), '.chusql', 'config.json');
+}
+
+export function readConfig(file = defaultConfigPath()) {
+  if (!fs.existsSync(file)) {
+    writeConfig(file, DEFAULT_CONFIG);
+    return { ...DEFAULT_CONFIG };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    throw new Error(`Configuration file is not valid JSON: ${file}`);
+  }
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) throw new Error(`Configuration must be a JSON object: ${file}`);
+  return { ...DEFAULT_CONFIG, ...parsed };
+}
+
+export function writeConfig(file, value) {
+  fs.mkdirSync(path.dirname(path.resolve(file)), { recursive: true });
+  fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+
+export function parseConfigValue(raw) {
+  if (/^-?\d+(?:\.\d+)?$/.test(raw)) return Number(raw);
+  if (raw === 'true') return true;
+  if (raw === 'false') return false;
+  return raw;
+}
+
+const FORBIDDEN_PATH_PARTS = new Set(['__proto__', 'prototype', 'constructor']);
+
+function configPathParts(dottedPath) {
+  const parts = dottedPath.split('.').filter(Boolean);
+  if (!parts.length) throw new Error('Configuration key must not be empty.');
+  if (parts.some((part) => FORBIDDEN_PATH_PARTS.has(part))) throw new Error('Configuration key contains a forbidden path segment.');
+  return parts;
+}
+
+export function getAtPath(value, dottedPath) {
+  return configPathParts(dottedPath).reduce((current, part) => current && typeof current === 'object' ? current[part] : undefined, value);
+}
+
+export function setAtPath(value, dottedPath, nextValue) {
+  const parts = configPathParts(dottedPath);
+  let cursor = value;
+  for (const part of parts.slice(0, -1)) {
+    if (!cursor[part] || typeof cursor[part] !== 'object' || Array.isArray(cursor[part])) cursor[part] = {};
+    cursor = cursor[part];
+  }
+  cursor[parts.at(-1)] = nextValue;
+}
+
+export function unsetAtPath(value, dottedPath) {
+  const parts = configPathParts(dottedPath);
+  let cursor = value;
+  for (const part of parts.slice(0, -1)) {
+    if (!cursor[part] || typeof cursor[part] !== 'object') return false;
+    cursor = cursor[part];
+  }
+  return parts.length ? delete cursor[parts.at(-1)] : false;
+}

chusql-web/frontend/bin/lib/config.test.js

@@ -0,0 +1,49 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { DEFAULT_CONFIG, getAtPath, parseConfigValue, readConfig, setAtPath, unsetAtPath, writeConfig } from './config.js';
+
+// 覆盖 CLI 配置读写、取值解析与路径安全。
+
+const temporaryDirectories = [];
+
+afterEach(() => {
+  for (const directory of temporaryDirectories.splice(0)) fs.rmSync(directory, { recursive: true, force: true });
+});
+
+function temporaryConfig() {
+  const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'chusql-cli-'));
+  temporaryDirectories.push(directory);
+  return path.join(directory, 'nested', 'config.json');
+}
+
+describe('CLI configuration', () => {
+  it('creates the formatted default configuration on first read', () => {
+    const file = temporaryConfig();
+    expect(readConfig(file)).toEqual(DEFAULT_CONFIG);
+    expect(fs.readFileSync(file, 'utf8')).toBe(`${JSON.stringify(DEFAULT_CONFIG, null, 2)}\n`);
+  });
+
+  it('persists dotted paths and can remove them', () => {
+    const file = temporaryConfig();
+    const config = readConfig(file);
+    setAtPath(config, 'db.host', 'localhost');
+    writeConfig(file, config);
+    expect(getAtPath(readConfig(file), 'db.host')).toBe('localhost');
+    expect(unsetAtPath(config, 'db.host')).toBe(true);
+    expect(getAtPath(config, 'db.host')).toBeUndefined();
+  });
+
+  it('parses numbers and booleans without changing ordinary text', () => {
+    expect(parseConfigValue('5173')).toBe(5173);
+    expect(parseConfigValue('true')).toBe(true);
+    expect(parseConfigValue('rest')).toBe('rest');
+  });
+
+  it('rejects prototype-polluting configuration paths', () => {
+    const config = {};
+    expect(() => setAtPath(config, '__proto__.polluted', true)).toThrow('forbidden path segment');
+    expect({}.polluted).toBeUndefined();
+  });
+});

chusql-web/frontend/bin/lib/open.js

@@ -0,0 +1,11 @@
+import { spawn } from 'node:child_process';
+
+// 用系统默认浏览器打开本地地址，并校验 URL 合法性。
+
+export function openBrowser(url) {
+  if (!/^http:\/\/[A-Za-z0-9.:[\]-]+:\d+\/$/.test(url)) throw new Error('Refusing to open an invalid local URL.');
+  const command = process.platform === 'win32' ? 'cmd.exe' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+  const args = process.platform === 'win32' ? ['/d', '/s', '/c', 'start', '', url] : [url];
+  const child = spawn(command, args, { detached: true, stdio: 'ignore', windowsHide: true });
+  child.unref();
+}