@nasl/cli 0.1.18 → 0.1.19

package/dist/index.mjs

@@ -61,6 +61,56 @@ function createSorter() {
     };
 }
 const sorter = createSorter();
+/**
+ * 验证 variables 文件
+ */
+function validateVariablesFile(file, errors) {
+    const matchArr = Array.from(file.content.matchAll(/^(export\s+)(declare\s+)?(const|let)\s+(\w+)/gm));
+    if (matchArr.length === 0) {
+        errors.push(`${file.path} (variables文件) 必须包含至少一个 export const 或 export let 声明`);
+    }
+    for (const match of matchArr) {
+        const [, isExport] = match;
+        if (!isExport)
+            errors.push(`${file.path} 所有声明必须使用 export，错误代码：${match[0]}`);
+    }
+}
+/**
+ * 验证 extensions 文件
+ */
+function validateExtensionsFile(file, errors) {
+    const matchArr = Array.from(file.content.matchAll(/^(export\s+)(namespace)\s+(\w+)/gm));
+    if (matchArr.length === 0) {
+        errors.push(`${file.path} (extensions文件) 必须包含至少一个 export namespace 声明`);
+    }
+    for (const match of matchArr) {
+        const [, isExport] = match;
+        if (!isExport)
+            errors.push(`${file.path} 所有 namespace 必须使用 export，错误代码：${match[0]}`);
+    }
+}
+/**
+ * 验证普通文件（枚举、实体、数据结构、逻辑、页面）
+ */
+function validateNormalFile(file, nameFromPath, namespace, errors) {
+    const matchArr = Array.from(file.content.matchAll(/^(export\s+)?(declare\s+)?(function|class|interface)\s+(\w+)/gm));
+    if (matchArr.length === 0)
+        errors.push(`${file.path} 必须有一个函数或类，错误代码：${file.content}`);
+    else if (matchArr.length > 1)
+        errors.push(`${file.path} 只能有一个函数或类，错误代码：${matchArr.map((match) => match[0]).join('\n')}
+你可以将该文件中所有函数合并，或者将其他函数拆到多个文件中。`);
+    for (const match of matchArr) {
+        const [, isExport, isDeclare, type, name] = match;
+        if (!isExport)
+            errors.push(`${file.path} 必须使用 export，错误代码：${match[0]}`);
+        if (name !== nameFromPath)
+            errors.push(`${file.path} 的函数或类名必须与文件名一致，错误代码：${match[0]}`);
+        if (/\.(entities|enums|structures)/.test(namespace) && type !== 'class')
+            errors.push(`${file.path} 实体、数据结构和枚举只能使用 class 定义，错误代码：${match[0]}`);
+        if (/\.(logics|views)/.test(namespace) && type !== 'function')
+            errors.push(`${file.path} 逻辑和页面只能使用 function 定义，错误代码：${match[0]}`);
+    }
+}
 function composeToString(files) {
     files.sort((a, b) => sorter(a.path, b.path));
     const errors = [];
@@ -68,28 +118,26 @@ function composeToString(files) {
         const arr = file.path.split('.');
         const ext = arr.pop();
         const nameFromPath = arr.pop();
-        const namespace = arr.join('.');
+        // 判断是否是特殊文件类型（variables 或 extensions）
+        const isVariablesFile = nameFromPath === 'variables';
+        const isExtensionsFile = arr[0] === 'extensions';
+        const isSpecialFile = isVariablesFile || isExtensionsFile;
+        // 特殊文件的 namespace 包含文件名，普通文件不包含
+        const namespace = isSpecialFile ? [...arr, nameFromPath].join('.') : arr.join('.');
         if (['ts', 'tsx'].includes(ext)) {
-            const matchArr = Array.from(file.content.matchAll(/^(export\s+)?(declare\s+)?(function|class|interface)\s+(\w+)/gm));
-            if (matchArr.length === 0)
-                errors.push(`${file.path} 必须有一个函数或类，错误代码：${file.content}`);
-            else if (matchArr.length > 1)
-                errors.push(`${file.path} 只能有一个函数或类，错误代码：${matchArr.map((match) => match[0]).join('\n')}
-你可以将该文件中所有函数合并，或者将其他函数拆到多个文件中。`);
-            for (const match of matchArr) {
-                const [, isExport, isDeclare, type, name] = match;
-                if (!isExport)
-                    errors.push(`${file.path} 必须使用 export，错误代码：${match[0]}`);
-                if (name !== nameFromPath)
-                    errors.push(`${file.path} 的函数或类名必须与文件名一致，错误代码：${match[0]}`);
-                if (/\.(entities|enums|structures)/.test(namespace) && type !== 'class')
-                    errors.push(`${file.path} 实体、数据结构和枚举只能使用 class 定义，错误代码：${match[0]}`);
-                if (/\.(logics|views)/.test(namespace) && type !== 'function')
-                    errors.push(`${file.path} 逻辑和页面只能使用 function 定义，错误代码：${match[0]}`);
+            if (isVariablesFile) {
+                validateVariablesFile(file, errors);
+            }
+            else if (isExtensionsFile) {
+                validateExtensionsFile(file, errors);
+            }
+            else {
+                validateNormalFile(file, nameFromPath, namespace, errors);
             }
         }
         return `namespace ${namespace} {\n${file.content}\n}\n`;
-    }).join('\n');
+    })
+        .join('\n');
     if (errors.length > 0) {
         throw new Error(errors.join('\n============\n'));
     }
@@ -13586,26 +13634,29 @@ function loadConfig(configDir) {
             defaultLogger.error('配置文件格式不正确，缺少必需的 srcDir 或 outDir 字段');
             return defaultLogger.exit(1);
         }
+        // 环境变量优先级高于配置文件
+        // ideVersion: 环境变量优先，如果都没有则报错
+        if (process.env.NASL_IDE_VERSION)
+            config.ideVersion = process.env.NASL_IDE_VERSION;
         if (!config.ideVersion) {
-            config.ideVersion = process.env.NASL_IDE_VERSION || '';
-            if (!config.ideVersion) {
-                defaultLogger.error('缺少配置 ideVersion，请在配置文件中添加，或在环境变量中配置 NASL_IDE_VERSION');
-                return defaultLogger.exit(1);
-            }
+            defaultLogger.error('缺少配置 ideVersion，请在配置文件中添加，或在环境变量中配置 NASL_IDE_VERSION');
+            return defaultLogger.exit(1);
         }
+        // serverBaseURL: 环境变量优先，如果都没有则报错
+        if (process.env.NASL_SERVER_BASE_URL)
+            config.serverBaseURL = process.env.NASL_SERVER_BASE_URL;
         if (!config.serverBaseURL) {
-            config.serverBaseURL = process.env.NASL_SERVER_BASE_URL || '';
-            if (!config.serverBaseURL) {
-                defaultLogger.error('缺少配置 serverBaseURL，请在配置文件中添加，或在环境变量中配置 NASL_SERVER_BASE_URL');
-                return defaultLogger.exit(1);
-            }
+            defaultLogger.error('缺少配置 serverBaseURL，请在配置文件中添加，或在环境变量中配置 NASL_SERVER_BASE_URL');
+            return defaultLogger.exit(1);
         }
-        if (!config.useOPENAPI)
+        // 环境变量优先
+        if (process.env.USE_LCAP_OPENAPI !== undefined)
             config.useOPENAPI = process.env.USE_LCAP_OPENAPI === 'true';
-        if (!config.OPENAPI_AK)
+        if (process.env.LCAP_OPENAPI_AK)
             config.OPENAPI_AK = process.env.LCAP_OPENAPI_AK;
-        if (!config.OPENAPI_SK)
+        if (process.env.LCAP_OPENAPI_SK)
             config.OPENAPI_SK = process.env.LCAP_OPENAPI_SK;
+        // 如果启用了 OpenAPI，验证必需的 AK 和 SK
         if (config.useOPENAPI) {
             if (!config.OPENAPI_AK || !config.OPENAPI_SK) {
                 defaultLogger.error(`配置了 useOPENAPI，但缺少配置 OPENAPI_AK 和 OPENAPI_SK:
@@ -13660,6 +13711,23 @@ function writeFileWithLog(filePath, content, logger) {
         throw error;
     }
 }
+/**
+ * 判断文件路径是否为已知的 NASL 文件类型
+ * 支持的类型：
+ * - 枚举 (enums)
+ * - 实体 (entities)
+ * - 数据结构 (structures)
+ * - 逻辑 (logics)
+ * - 页面 (views)
+ * - 前端/服务端全局变量 (variables)
+ * - 依赖库 (extensions)
+ */
+function isKnownFileType(filePath) {
+    return (/\.(enums|entities|structures|logics|views)\.\w+\.(ts|tsx)$/.test(filePath) || // 枚举、实体、数据结构、逻辑、页面
+        /^app\..*\.variables\.ts$/.test(filePath) || // 前端/服务端全局变量 (以app开头，以variables.ts结尾)
+        /^extensions\.\w+\.(ts|tsx)$/.test(filePath) // 依赖库
+    );
+}
 
 /**
  * 扫描目录下的所有 NASL 文件
@@ -13701,11 +13769,13 @@ async function scanEntryFiles(projectRoot, patterns, logger) {
  */
 function extractDeps(content) {
     const deps = new Set();
-    // 预处理：移除注释，避免注释影响依赖分析
+    // 预处理：移除注释和字符串字面量，避免它们影响依赖分析
     let processedContent = content
         .replace(/\/\/.*$/gm, '') // 移除单行注释 // ...
-        .replace(/\/\*[\s\S]*?\*\//g, ''); // 移除多行注释 /* ... */
-    const allMatches = processedContent.matchAll(/app\.\w+\.[\w.]+/g); // 起码要2个点
+        .replace(/\/\*[\s\S]*?\*\//g, '') // 移除多行注释 /* ... */
+        .replace(/'(?:[^'\\]|\\.)*'/g, '') // 移除单引号字符串 'xxx'
+        .replace(/"(?:[^"\\]|\\.)*"/g, ''); // 移除双引号字符串 "xxx"
+    const allMatches = processedContent.matchAll(/(app|extensions)\.\w+\.[\w.]+/g); // 起码要2个点，支持 app.* 和 extensions.*
     for (const match of allMatches) {
         let dep = match[0];
         if (/Entity$|Entity\./.test(dep)) {
@@ -13714,6 +13784,14 @@ function extractDeps(content) {
         else if (/\.enums\.(\w+)\.(\w+)/.test(dep)) {
             dep = dep.replace(/\.enums\.(\w+).+$/, '.enums.$1');
         }
+        else if (/\.variables\.(\w+)/.test(dep)) {
+            // 处理 variables 依赖：app.backend.variables.xxx -> app.backend.variables
+            dep = dep.replace(/\.variables\..+$/, '.variables');
+        }
+        else if (/^extensions\.\w+\.\w+/.test(dep)) {
+            // 处理 extensions 依赖：extensions.lcap_auth.xxx -> extensions.lcap_auth
+            dep = dep.replace(/^(extensions\.\w+)\..+$/, '$1');
+        }
         else if (/app\.dataSources\.\w+\.entities\.\w+\.\w+$/.test(dep)) {
             continue; // 应该是写法有问题，跳过让后面的 checker 做检查
         }
@@ -13835,7 +13913,12 @@ async function collectDeps(patterns, projectRoot, srcDir, logger, verbose) {
     while (filesToProcess.length > 0) {
         const pathRelativeToSrc = filesToProcess.shift();
         if (processedFileMap.has(pathRelativeToSrc))
-            continue; // 跳过已处理的文件        
+            continue; // 跳过已处理的文件
+        // 检查文件类型是否支持
+        if (!isKnownFileType(pathRelativeToSrc)) {
+            logger.warn(`跳过不支持的文件类型: ${pathRelativeToSrc}`);
+            continue;
+        }
         try {
             const { fileInfo, newDeps } = processFileDeps(pathRelativeToSrc, srcDir, matchedFileSet, processedFileMap, depNotFoundList, logger, verbose);
             result.push(fileInfo);
@@ -13915,8 +13998,18 @@ async function resolveNASLFiles(entry, logger, depMode, verbose) {
         }
         logger.info(`找到 ${collectedFiles.length} 个 NASL 文件`);
     }
+    // 统一过滤掉不支持的文件类型
+    const filteredFiles = [];
+    collectedFiles.forEach((file) => {
+        if (isKnownFileType(file.path)) {
+            filteredFiles.push(file);
+        }
+        else {
+            logger.warn(`跳过不支持的文件类型: ${file.path}`);
+        }
+    });
     return {
-        collectedFiles,
+        collectedFiles: filteredFiles,
         config,
         projectRoot,
         srcDir,