gitlab-ai-review 4.2.4 → 6.3.9

package/lib/export-analyzer.js

@@ -0,0 +1,384 @@
+/**
+ * 导出分析器 - 使用 TypeScript Compiler API 分析文件的 export
+ * 用于检测哪些导出函数/变量被修改，以便分析调用链影响
+ */
+
+import ts from 'typescript';
+
+/**
+ * 检查节点是否有 export 修饰符
+ */
+function hasExportModifier(node) {
+  const modifiers = ts.getModifiers(node);
+  return modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword) || false;
+}
+
+/**
+ * 获取节点所在行号
+ */
+function getLineNumber(sourceFile, node) {
+  return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
+}
+
+/**
+ * 计算代码内容的简单哈希（用于对比是否修改）
+ */
+function simpleHash(str) {
+  if (!str) return '';
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = ((hash << 5) - hash) + char;
+    hash = hash & hash;
+  }
+  return hash.toString(16);
+}
+
+/**
+ * 提取文件中所有的 export 符号
+ * @param {string} code - 文件内容
+ * @param {string} fileName - 文件名（用于确定语言类型）
+ * @returns {Array} 导出列表
+ */
+export function extractExports(code, fileName = 'temp.ts') {
+  if (!code) return [];
+  
+  const exports = [];
+  
+  try {
+    const sourceFile = ts.createSourceFile(
+      fileName,
+      code,
+      ts.ScriptTarget.Latest,
+      true
+    );
+
+    function visit(node) {
+      // 1. export function funcName() {}
+      if (ts.isFunctionDeclaration(node) && node.name) {
+        if (hasExportModifier(node)) {
+          const bodyText = node.body ? node.body.getText(sourceFile) : '';
+          exports.push({
+            name: node.name.getText(sourceFile),
+            type: 'function',
+            bodyHash: simpleHash(bodyText),
+            startLine: getLineNumber(sourceFile, node),
+            // 提取函数签名（参数）
+            signature: node.parameters ? 
+              node.parameters.map(p => p.getText(sourceFile)).join(', ') : '',
+          });
+        }
+      }
+
+      // 2. export const/let/var varName = ...
+      if (ts.isVariableStatement(node)) {
+        if (hasExportModifier(node)) {
+          node.declarationList.declarations.forEach(decl => {
+            if (ts.isIdentifier(decl.name)) {
+              const initText = decl.initializer ? decl.initializer.getText(sourceFile) : '';
+              exports.push({
+                name: decl.name.getText(sourceFile),
+                type: 'variable',
+                bodyHash: simpleHash(initText),
+                startLine: getLineNumber(sourceFile, decl),
+                // 如果是箭头函数，也提取签名
+                signature: decl.initializer && ts.isArrowFunction(decl.initializer) ?
+                  decl.initializer.parameters.map(p => p.getText(sourceFile)).join(', ') : '',
+              });
+            }
+          });
+        }
+      }
+
+      // 3. export class ClassName {}
+      if (ts.isClassDeclaration(node) && node.name) {
+        if (hasExportModifier(node)) {
+          const bodyText = node.members ? 
+            node.members.map(m => m.getText(sourceFile)).join('\n') : '';
+          exports.push({
+            name: node.name.getText(sourceFile),
+            type: 'class',
+            bodyHash: simpleHash(bodyText),
+            startLine: getLineNumber(sourceFile, node),
+            signature: '',
+          });
+        }
+      }
+
+      // 4. export interface InterfaceName {} (TypeScript)
+      if (ts.isInterfaceDeclaration(node) && node.name) {
+        if (hasExportModifier(node)) {
+          const bodyText = node.members ? 
+            node.members.map(m => m.getText(sourceFile)).join('\n') : '';
+          exports.push({
+            name: node.name.getText(sourceFile),
+            type: 'interface',
+            bodyHash: simpleHash(bodyText),
+            startLine: getLineNumber(sourceFile, node),
+            signature: '',
+          });
+        }
+      }
+
+      // 5. export type TypeName = ... (TypeScript)
+      if (ts.isTypeAliasDeclaration(node) && node.name) {
+        if (hasExportModifier(node)) {
+          const typeText = node.type ? node.type.getText(sourceFile) : '';
+          exports.push({
+            name: node.name.getText(sourceFile),
+            type: 'type',
+            bodyHash: simpleHash(typeText),
+            startLine: getLineNumber(sourceFile, node),
+            signature: '',
+          });
+        }
+      }
+
+      // 6. export default function/class
+      if (ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node)) {
+        const modifiers = ts.getModifiers(node);
+        const hasDefault = modifiers?.some(m => m.kind === ts.SyntaxKind.DefaultKeyword);
+        const hasExport = modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword);
+        if (hasDefault && hasExport) {
+          const name = node.name ? node.name.getText(sourceFile) : 'default';
+          const bodyText = ts.isFunctionDeclaration(node) && node.body ? 
+            node.body.getText(sourceFile) : '';
+          exports.push({
+            name,
+            type: 'default',
+            bodyHash: simpleHash(bodyText),
+            startLine: getLineNumber(sourceFile, node),
+            signature: '',
+          });
+        }
+      }
+
+      // 7. export { name1, name2 } 命名导出
+      if (ts.isExportDeclaration(node) && node.exportClause) {
+        if (ts.isNamedExports(node.exportClause)) {
+          node.exportClause.elements.forEach(element => {
+            exports.push({
+              name: element.name.getText(sourceFile),
+              type: 'named-export',
+              bodyHash: '',  // 命名导出没有 body
+              startLine: getLineNumber(sourceFile, element),
+              signature: '',
+            });
+          });
+        }
+      }
+
+      ts.forEachChild(node, visit);
+    }
+
+    visit(sourceFile);
+  } catch (error) {
+    console.warn(`⚠️ 解析文件 ${fileName} 失败:`, error.message);
+  }
+
+  return exports;
+}
+
+/**
+ * 对比两个版本的 exports，找出变更的符号
+ * @param {Array} oldExports - 旧版本的导出
+ * @param {Array} newExports - 新版本的导出
+ * @returns {Object} { added, removed, modified }
+ */
+export function findChangedExports(oldExports, newExports) {
+  const changes = {
+    added: [],    // 新增的导出
+    removed: [],  // 删除的导出
+    modified: [], // 修改的导出（内容变了）
+  };
+
+  const oldMap = new Map(oldExports.map(e => [e.name, e]));
+  const newMap = new Map(newExports.map(e => [e.name, e]));
+
+  // 找出新增和修改的
+  for (const [name, newExp] of newMap) {
+    const oldExp = oldMap.get(name);
+    if (!oldExp) {
+      // 新增
+      changes.added.push(newExp);
+    } else if (oldExp.bodyHash !== newExp.bodyHash || oldExp.signature !== newExp.signature) {
+      // 修改（内容或签名变了）
+      changes.modified.push({
+        ...newExp,
+        oldSignature: oldExp.signature,
+        newSignature: newExp.signature,
+        changeType: oldExp.signature !== newExp.signature ? 'signature' : 'body',
+      });
+    }
+  }
+
+  // 找出删除的
+  for (const [name, oldExp] of oldMap) {
+    if (!newMap.has(name)) {
+      changes.removed.push(oldExp);
+    }
+  }
+
+  return changes;
+}
+
+/**
+ * 提取文件中的 import 语句
+ * @param {string} code - 文件内容
+ * @param {string} fileName - 文件名
+ * @returns {Array} import 列表
+ */
+export function extractImports(code, fileName = 'temp.ts') {
+  if (!code) return [];
+  
+  const imports = [];
+  
+  try {
+    const sourceFile = ts.createSourceFile(
+      fileName,
+      code,
+      ts.ScriptTarget.Latest,
+      true
+    );
+
+    function visit(node) {
+      if (ts.isImportDeclaration(node)) {
+        const modulePath = node.moduleSpecifier.getText(sourceFile).replace(/['"]/g, '');
+        const importInfo = {
+          from: modulePath,
+          symbols: [],
+          defaultImport: null,
+          namespaceImport: null,
+          line: getLineNumber(sourceFile, node),
+          fullText: node.getText(sourceFile),
+        };
+
+        if (node.importClause) {
+          // 默认导入
+          if (node.importClause.name) {
+            importInfo.defaultImport = node.importClause.name.getText(sourceFile);
+          }
+
+          if (node.importClause.namedBindings) {
+            // 命名导入
+            if (ts.isNamedImports(node.importClause.namedBindings)) {
+              node.importClause.namedBindings.elements.forEach(element => {
+                importInfo.symbols.push(element.name.getText(sourceFile));
+              });
+            }
+            // 命名空间导入
+            if (ts.isNamespaceImport(node.importClause.namedBindings)) {
+              importInfo.namespaceImport = node.importClause.namedBindings.name.getText(sourceFile);
+            }
+          }
+        }
+
+        imports.push(importInfo);
+      }
+
+      ts.forEachChild(node, visit);
+    }
+
+    visit(sourceFile);
+  } catch (error) {
+    console.warn(`⚠️ 解析 imports 失败:`, error.message);
+  }
+
+  return imports;
+}
+
+/**
+ * 在代码中查找符号的使用位置
+ * @param {string} code - 文件内容
+ * @param {string} symbolName - 要查找的符号名
+ * @returns {Array} 使用位置列表
+ */
+export function findSymbolUsages(code, symbolName) {
+  if (!code || !symbolName) return [];
+  
+  const usages = [];
+  const lines = code.split('\n');
+  
+  // 正则匹配符号使用（不在注释中）
+  const symbolRegex = new RegExp(`\\b${symbolName}\\b`, 'g');
+  
+  lines.forEach((line, index) => {
+    const trimmed = line.trim();
+    // 跳过注释行
+    if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) {
+      return;
+    }
+    
+    if (symbolRegex.test(line)) {
+      usages.push({
+        line: index + 1,
+        content: line,
+      });
+      // 重置正则的 lastIndex
+      symbolRegex.lastIndex = 0;
+    }
+  });
+  
+  return usages;
+}
+
+/**
+ * 提取符号使用的上下文代码
+ * @param {string} code - 文件内容
+ * @param {string} symbolName - 符号名
+ * @param {number} contextLines - 上下文行数
+ * @returns {string} 上下文代码
+ */
+export function extractUsageContext(code, symbolName, contextLines = 2) {
+  if (!code || !symbolName) return '';
+  
+  const lines = code.split('\n');
+  const usages = findSymbolUsages(code, symbolName);
+  
+  if (usages.length === 0) return '';
+  
+  const contextParts = [];
+  
+  // 首先找 import 语句
+  const imports = extractImports(code);
+  const relevantImport = imports.find(imp => 
+    imp.symbols.includes(symbolName) || 
+    imp.defaultImport === symbolName ||
+    imp.namespaceImport
+  );
+  
+  if (relevantImport) {
+    contextParts.push(`${relevantImport.line}| ${relevantImport.fullText}`);
+  }
+  
+  // 添加使用处的上下文（最多3处）
+  const usagesToShow = usages.slice(0, 3);
+  usagesToShow.forEach((usage, i) => {
+    if (contextParts.length > 0) {
+      contextParts.push('\n// ...\n');
+    }
+    
+    const start = Math.max(0, usage.line - 1 - contextLines);
+    const end = Math.min(lines.length, usage.line + contextLines);
+    
+    for (let j = start; j < end; j++) {
+      const marker = j === usage.line - 1 ? '>' : ' ';
+      contextParts.push(`${marker} ${j + 1}| ${lines[j]}`);
+    }
+  });
+  
+  if (usages.length > 3) {
+    contextParts.push(`\n// ... 还有 ${usages.length - 3} 处使用`);
+  }
+  
+  return contextParts.join('\n');
+}
+
+export default {
+  extractExports,
+  findChangedExports,
+  extractImports,
+  findSymbolUsages,
+  extractUsageContext,
+};
+