@nasl/cli 0.3.3 → 0.3.5

package/README.md

@@ -159,9 +159,13 @@ nasl transform files2json [entry] --output [outputPath]
 # 默认输出到 ./files.json
 ```
 
-### 在 IDE 中直接创建应用（nasl create-app-in-ide）
+### 在 IDE 中创建 / 更新应用
 
-**注意**：目前该命令不支持 useOPENAPI 模式，只在测试环境使用。
+**注意**：`create-app-in-ide` 与 `update-app-in-ide` 只能在测试环境使用。
+
+两个命令都会先按 [入口文件说明](#入口文件说明) 解析本地 NASL（可选 `[entry]`，不传则处理整个 `src`），将源码组合为 fullNaturalTS（含依赖）后调用远程服务。均支持 `--quiet` 跳过确认、`--verbose` 输出依赖分析等详细信息。
+
+#### 在 IDE 中创建应用（nasl create-app-in-ide）
 
 ```bash
 # 会询问确认（默认）
@@ -174,7 +178,24 @@ nasl create-app-in-ide [entry] --quiet
 nasl create-app-in-ide [entry] --verbose
 ```
 
-此命令会将当前项目的 NASL 代码上传到远程服务，在 IDE 中创建新的应用。默认会询问用户确认，使用 `--quiet` 选项可以跳过确认。
+执行前会展示即将使用的**应用名称**、**包名**、IDE 版本与租户。应用名与包名由项目目录推导：若存在 `specs/` 目录，则取其中**第一个子文件夹名**作为基础名；否则使用**项目根目录名**。基础名经清洗（仅保留字母数字、去掉开头数字、最长 12 字符）后，再拼接时间后缀生成最终名称。
+
+#### 在 IDE 中更新已有应用（nasl update-app-in-ide）
+
+第一个参数为远程应用的 **appId**（必填），其余与创建命令一致。
+
+```bash
+# 会询问确认（默认）
+nasl update-app-in-ide <appId> [entry]
+
+# 跳过确认
+nasl update-app-in-ide <appId> [entry] --quiet
+
+# 显示详细信息
+nasl update-app-in-ide <appId> [entry] --verbose
+```
+
+将当前本地 NASL 同步到指定应用，用于在 IDE 中更新已有应用而非新建。
 
 ## 环境变量配置
 

package/dist/bin/nasl.mjs

@@ -29227,41 +29227,33 @@ async function checkApi(fullNaturalTS, options) {
 }
 
 /**
- * 创建应用同步
+ * 创建应用（POST /nasl/app/create）
  */
-async function createAppSyncApi(fullNaturalTS, options) {
-    const url = new URL(options.serverBaseURL);
-    const origin = url.origin + '/app-ai-creator';
-    const axios = await createAxios({ serverBaseURL: origin, ideVersion: options.ideVersion });
-    try {
-        const res = await axios.post('/api/createAppSync', {
-            fullNaturalTS,
-            packageName: options.packageName,
-            appName: options.appName,
-            hostname: url.hostname,
-            enableAuthTemplate: false,
-            ideVersion: options.ideVersion,
-            fullVersion: `${options.ideVersion}.0`,
-        });
-        if (res.data.success) {
-            return {
-                success: true,
-                appId: res.data.data?.appId,
-                appURL: res.data.data?.appURL,
-                message: res.data.data?.message,
-            };
-        }
-        else {
-            return {
-                success: false,
-                error: res.data.message || '应用创建失败',
-            };
-        }
-    }
-    catch (error) {
-        console.log(error);
-        throw error;
-    }
+async function createApp(fullNaturalTS, options, appName, packageName) {
+    const axiosInstance = await createAxios(options);
+    const res = await axiosInstance.post('/app/create', {
+        fullNaturalTS,
+        packageName,
+        appName,
+        ideVersion: options.ideVersion,
+    }, {
+        headers: { ...buildNaslHeaders(options), 'Content-Type': 'application/json' },
+    });
+    return res.data.result;
+}
+/**
+ * 更新应用（POST /nasl/app/update）
+ */
+async function updateApp(fullNaturalTS, options, appId) {
+    const axiosInstance = await createAxios(options);
+    const res = await axiosInstance.post('/app/update', {
+        fullNaturalTS,
+        appId,
+        ideVersion: options.ideVersion,
+    }, {
+        headers: { ...buildNaslHeaders(options), 'Content-Type': 'application/json' },
+    });
+    return res.data.result;
 }
 
 async function installDependenciesApi(dependenciesJSON, options) {
@@ -29276,7 +29268,18 @@ async function installDependenciesApi(dependenciesJSON, options) {
 }
 
 function createSorter() {
-    const priorityOrder = ['app.dataSources', 'app.enums', 'app.structures', 'app.logics', 'app.frontendTypes'];
+    const priorityOrder = [
+        'extensions',
+        'apis',
+        'connectors',
+        'app.backend.variables',
+        'app.roles',
+        'app.enums',
+        'app.dataSources',
+        'app.structures',
+        'app.logics',
+        'app.frontendTypes',
+    ];
     // 获取优先级索引
     const getPriority = (str) => {
         const prefixIndex = priorityOrder.findIndex((p) => str.startsWith(p));
@@ -29290,13 +29293,11 @@ function createSorter() {
             return aPriority - bPriority;
         }
         // 如果是frontendTypes，按字母顺序排序
-        if (aPriority === 4) {
+        if (a.startsWith('app.frontendTypes') && b.startsWith('app.frontendTypes')) {
             return a.localeCompare(b);
         }
-        else {
-            // 其他情况保持原顺序
-            return 0;
-        }
+        // 其他情况保持原顺序
+        return 0;
     };
 }
 const sorter = createSorter();
@@ -29364,11 +29365,15 @@ function composeToString(files, options) {
         const isVariablesFile = nameFromPath === 'variables';
         const isExtensionsFile = arr[0] === 'extensions';
         const isThemeCss = ext === 'css' && nameFromPath === 'theme';
-        const isSpecialFile = isVariablesFile || isExtensionsFile || isThemeCss;
+        const isRolesJson = file.path === 'app.roles.json';
+        const isSpecialFile = isVariablesFile || isExtensionsFile || isThemeCss || isRolesJson;
         // 特殊文件的 namespace ${包含文件名，普通文件不包含
         const namespace = isSpecialFile ? [...arr, nameFromPath].join('.') : arr.join('.');
         let content = file.content;
-        if (['ts', 'tsx'].includes(ext)) {
+        if (isRolesJson) {
+            content = `  $roles(${content});`;
+        }
+        else if (['ts', 'tsx'].includes(ext)) {
             if (isVariablesFile) {
                 validateVariablesFile(file, errors);
             }
@@ -37935,6 +37940,13 @@ var globby = /*@__PURE__*/getDefaultExportFromCjs(globbyExports);
  * NASL 支持的所有文件类型配置
  */
 const NASL_FILE_TYPES = [
+    {
+        name: 'roles',
+        description: '角色',
+        fileNamePattern: 'app\\.roles\\.json',
+        codeRefPattern: '',
+        extension: 'json',
+    },
     {
         name: 'theme-css',
         description: '主题样式',
@@ -38031,7 +38043,7 @@ const fileNamePatterns = getFileNamePatterns();
  * 获取用于提取代码引用的正则表达式数组
  */
 function getCodeRefPatterns() {
-    return NASL_FILE_TYPES.map((type) => new RegExp(type.codeRefPattern, 'g'));
+    return NASL_FILE_TYPES.filter((type) => type.codeRefPattern).map((type) => new RegExp(type.codeRefPattern, 'g'));
 }
 const codeRefPatterns = getCodeRefPatterns();
 /**
@@ -38066,7 +38078,7 @@ function shouldSkipDependencyTraversal(depPath) {
 async function scanNASLFiles(srcDir, representation, logger) {
     try {
         const pattern = representation === 'NaturalTS' ? '**/*.{ts,tsx}' : '**/*.nasl';
-        const files = await globby([pattern, '**/app.frontendTypes.pc.frontends.pc.theme.css'], {
+        const files = await globby([pattern, 'app.frontendTypes.pc.frontends.pc.theme.css', 'app.roles.json'], {
             cwd: srcDir,
             onlyFiles: true,
             absolute: false,
@@ -38300,9 +38312,9 @@ function buildExternalDependencies(refs, mergedDeps, logger) {
 function replaceViewAsSignature(content, hasSubViews = false) {
     if (hasSubViews) {
         // 如果有子页面，替换为返回 ElRouterView 的函数
-        return content.replace(/export function ((\w+)\([^)]*\)) \{[\s\S]+$/, 'export function $1 {\n    return <ElRouterView />\n}');
+        return content.replace(/export function ((\w+)\([\s\S]*?\)) \{[\s\S]+$/, 'export function $1 {\n    return <ElRouterView />\n}');
     }
-    return content.replace(/export function ((\w+)\([^)]*\)) \{[\s\S]+$/, 'export declare function $1;');
+    return content.replace(/export function ((\w+)\([\s\S]*?\)) \{[\s\S]+$/, 'export declare function $1;');
 }
 /**
  * 处理单个文件的依赖
@@ -38344,8 +38356,10 @@ function processFileDeps(pathRelativeToSrc, srcDir, matchedFileSet, processedFil
     processedFileMap.set(pathRelativeToSrc, fileInfo);
     // 提取依赖
     // extensions/connectors/apis/uilibs 作为叶子节点，不再向下递归查找依赖
+    // JSON 文件（如 app.roles.json）无代码引用，跳过依赖分析
     const isExternalDep = shouldSkipDependencyTraversal(pathRelativeToSrc);
-    const deps = isExternalDep ? [] : extractDeps(fileInfo.content);
+    const isRolesJson = pathRelativeToSrc === 'app.roles.json';
+    const deps = isExternalDep || isRolesJson ? [] : extractDeps(fileInfo.content);
     // 查找依赖文件
     if (isView) {
         const pathArr = pathRelativeToSrc.split('.');
@@ -38471,7 +38485,7 @@ async function resolveNASLFiles(entry, logger, depMode, verbose) {
     }
     let externalRefs = null;
     if (!entry && depMode)
-        entry = 'src/**/app.*.{ts,tsx,css}';
+        entry = ['src/**/app.*.{ts,tsx,css}', 'src/app.roles.json'];
     if (entry) {
         // 检查入口路径是否在源代码目录外面
         // if (entry.startsWith('..')) throw new Error('入口路径不能在源代码目录外面');
@@ -38935,78 +38949,94 @@ async function build(entry, options) {
 }
 
 /**
- * 获取 specs 下第1个文件夹的名字
+ * 从 specs/ 目录取第一个子文件夹名；若无则退回项目根目录名
  */
-function getFirstSpecFolderName(projectRoot) {
-    const dirname = path$1.basename(projectRoot);
+function getSpecBaseName(projectRoot) {
     const specsDir = path$1.join(projectRoot, 'specs');
-    if (!libExports.existsSync(specsDir))
-        return dirname;
-    const entries = libExports.readdirSync(specsDir, { withFileTypes: true });
-    const folders = entries
-        .filter(entry => entry.isDirectory())
-        .map(entry => entry.name);
-    if (folders.length === 0)
-        return dirname;
-    return folders[0];
+    if (libExports.existsSync(specsDir)) {
+        const folders = libExports.readdirSync(specsDir, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+        if (folders.length > 0)
+            return folders[0];
+    }
+    return path$1.basename(projectRoot);
 }
 /**
- * 创建应用在 IDE 中
+ * 从项目目录推导出合法的应用名称和包名
  */
+function deriveAppNames(projectRoot) {
+    const baseName = getSpecBaseName(projectRoot);
+    const suffix = dayjs().format('MMDDHHmmss');
+    let cleaned = baseName.replace(/[^a-zA-Z0-9]/g, '').replace(/^\d+/, '').slice(0, 12);
+    if (!cleaned)
+        cleaned = 'app';
+    return {
+        appName: `${cleaned}_${suffix}`,
+        packageName: `${cleaned}${suffix}`,
+    };
+}
+
+/**
+ * 使用 readline 询问用户确认
+ */
+function askForConfirmation(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            const a = answer.trim().toLowerCase();
+            resolve(!a || a === 'y' || a === 'yes' || a === '是');
+        });
+    });
+}
+
 async function createAppInIde(entry, options) {
     const logger = options?.logger || defaultLogger;
-    logger.info('开始创建应用在 IDE 中...');
-    // 收集需要处理的文件
-    const { collectedFiles, config } = await resolveNASLFiles(entry, logger, false, options?.verbose);
-    if (config.useOPENAPI) {
-        logger.error('create-app-in-ide 暂不支持 useOPENAPI 模式');
-        logger.exit(1);
+    // ── 扫描 ─────────────────────────────────────────────
+    const { collectedFiles, config, mergedDependencies } = await resolveNASLFiles(entry, logger, false, options?.verbose);
+    // ── 展示参数 ──────────────────────────────────────────
+    const { appName, packageName } = deriveAppNames(getProjectRoot());
+    logger.newLine();
+    logger.info(`应用名称: ${appName}`);
+    logger.info(`包名: ${packageName}`);
+    logger.info(`IDE 版本: ${config.ideVersion}`);
+    logger.info(`租户名称: ${config.tenantName || 'defaulttenant'}`);
+    // ── 确认 ──────────────────────────────────────────────
+    if (!options?.quiet) {
+        logger.newLine();
+        const confirmed = await askForConfirmation('即将在 IDE 中创建新的应用，请确认是否继续？(Y/n): ');
+        if (!confirmed) {
+            logger.info('已取消操作');
+            process.exit(0);
+        }
     }
-    // 生成 fullNaturalTS
+    // ── 执行 ──────────────────────────────────────────────
     logger.newLine();
     logger.info('正在生成 NaturalTS 代码...');
-    let fullNaturalTS = '';
+    let fullNaturalTS;
     try {
         fullNaturalTS = composeToString(collectedFiles);
+        fullNaturalTS = prependDependencies(fullNaturalTS, mergedDependencies);
     }
     catch (error) {
         logger.error(`生成 NaturalTS 代码失败: ${error.message}`);
         throw error;
     }
-    // 获取 specs 下第1个文件夹
-    const projectRoot = getProjectRoot();
-    const firstSpecFolderName = getFirstSpecFolderName(projectRoot);
-    const suffix = dayjs().format('MMDDHHmmss');
-    let cleaned = firstSpecFolderName.replace(/[^a-zA-Z0-9]/g, '').replace(/^\d+/, '').slice(0, 12);
-    if (!cleaned)
-        cleaned = 'app';
-    const appName = `${cleaned}_${suffix}`;
-    const packageName = `${cleaned}${suffix}`;
-    logger.info(`应用名称: ${appName}`);
-    logger.info(`包名: ${packageName}`);
-    logger.info(`IDE 版本: ${config.ideVersion}`);
-    logger.info(`完整版本: ${config.ideVersion}.0`);
-    // 调用创建应用 API
-    logger.newLine();
     logger.info('正在调用创建应用服务...');
     try {
-        const result = await createAppSyncApi(fullNaturalTS, {
-            packageName: packageName,
-            appName: appName,
-            serverBaseURL: config.serverBaseURL,
-            ideVersion: config.ideVersion,
-        });
+        const result = await createApp(fullNaturalTS, config, appName, packageName);
         if (result.success) {
             logger.success('应用创建成功！');
-            if (result.appURL) {
+            if (result.appURL)
                 logger.info(`应用 URL: ${result.appURL}`);
-            }
-            if (result.appId) {
+            if (result.appId)
                 logger.info(`应用 ID: ${result.appId}`);
-            }
-            if (result.message) {
+            if (result.message)
                 logger.info(result.message);
-            }
         }
         else {
             logger.error(`应用创建失败: ${result.error || '未知错误'}`);
@@ -39019,6 +39049,57 @@ async function createAppInIde(entry, options) {
     }
 }
 
+async function updateAppInIde(appId, entry, options) {
+    const logger = options?.logger || defaultLogger;
+    // ── 扫描 ─────────────────────────────────────────────
+    const { collectedFiles, config, mergedDependencies } = await resolveNASLFiles(entry, logger, false, options?.verbose);
+    // ── 展示参数 ──────────────────────────────────────────
+    logger.newLine();
+    logger.info(`应用 ID: ${appId}`);
+    logger.info(`IDE 版本: ${config.ideVersion}`);
+    logger.info(`租户名称: ${config.tenantName || 'defaulttenant'}`);
+    // ── 确认 ──────────────────────────────────────────────
+    if (!options?.quiet) {
+        logger.newLine();
+        const confirmed = await askForConfirmation(`即将更新应用 ${appId}，请确认是否继续？(Y/n): `);
+        if (!confirmed) {
+            logger.info('已取消操作');
+            process.exit(0);
+        }
+    }
+    // ── 执行 ──────────────────────────────────────────────
+    logger.newLine();
+    logger.info('正在生成 NaturalTS 代码...');
+    let fullNaturalTS;
+    try {
+        fullNaturalTS = composeToString(collectedFiles);
+        fullNaturalTS = prependDependencies(fullNaturalTS, mergedDependencies);
+    }
+    catch (error) {
+        logger.error(`生成 NaturalTS 代码失败: ${error.message}`);
+        throw error;
+    }
+    logger.info('正在调用更新应用服务...');
+    try {
+        const result = await updateApp(fullNaturalTS, config, appId);
+        if (result.success) {
+            logger.success('应用更新成功！');
+            if (result.appURL)
+                logger.info(`应用 URL: ${result.appURL}`);
+            if (result.message)
+                logger.info(result.message);
+        }
+        else {
+            logger.error(`应用更新失败: ${result.error || '未知错误'}`);
+            throw new Error(result.error || '应用更新失败');
+        }
+    }
+    catch (error) {
+        logger.error(`调用更新应用服务失败: ${error.message}`);
+        throw error;
+    }
+}
+
 /**
  * 编译 NASL 代码
  * TODO: 实现具体的 API 调用逻辑
@@ -39384,27 +39465,11 @@ async function installByJSON(json, options) {
     logger.success(`成功写入 ${writtenCount} 个依赖文件到 ${config.srcDir} 目录`);
 }
 
-var version = "0.3.3";
+var version = "0.3.5";
 var pkg = {
 	version: version};
 
 const program = new Command();
-/**
- * 使用 readline 询问用户确认
- */
-function askForConfirmation(question) {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    return new Promise((resolve) => {
-        rl.question(question, (answer) => {
-            rl.close();
-            const normalizedAnswer = answer.trim().toLowerCase();
-            resolve(!normalizedAnswer || normalizedAnswer === 'y' || normalizedAnswer === 'yes' || normalizedAnswer === '是');
-        });
-    });
-}
 const entryDescription = `是相对于项目根目录的路径，支持 glob 模式（注意要用引号包裹），例如：
   - src/app.enums.Status.ts 支持具体文件
   - "src/app.enums.*.ts" 表示所有枚举
@@ -39526,17 +39591,6 @@ program
     .option('-q, --quiet', '不询问问题')
     .action(async (entry, options) => {
     try {
-        // 如果不是 quiet 模式，询问用户确认
-        if (!options?.quiet) {
-            defaultLogger.newLine();
-            defaultLogger.info('即将在 IDE 中创建新的应用，此操作将调用远程接口。');
-            const confirmed = await askForConfirmation('请确认是否继续？(Y/n): ');
-            if (!confirmed) {
-                defaultLogger.info('已取消操作');
-                process.exit(0);
-            }
-            defaultLogger.newLine();
-        }
         await createAppInIde(entry, options);
     }
     catch (error) {
@@ -39544,6 +39598,20 @@ program
         process.exit(1);
     }
 });
+program
+    .command('update-app-in-ide <appId> [entry]')
+    .description('在 IDE 中更新已有应用')
+    .option('-v, --verbose', '显示详细信息，如依赖分析树')
+    .option('-q, --quiet', '不询问问题')
+    .action(async (appId, entry, options) => {
+    try {
+        await updateAppInIde(appId, entry, options);
+    }
+    catch (error) {
+        defaultLogger.error(`更新应用过程发生错误：${error.message}`);
+        process.exit(1);
+    }
+});
 program
     .command('transform <transformType> [entry]')
     .description('转换文件格式\n  transformType: files2full (将 src 文件组合成 fullNaturalTS), json2files (将 JSON 转换为文件), files2json (将 src 文件转换为 JSON), doc2full (将 plan markdown 文档组合成 fullNaturalTS)')