custom-menu-cli 2.0.0 → 3.0.0

package/README-pt.md

@@ -88,14 +88,41 @@ async function iniciarMeuMenuCustomizado() {
 iniciarMeuMenuCustomizado();
 ```
 
+### 4. Geração de Menu Baseada em Pastas
+
+O `custom-menu-cli` agora suporta a geração de menus a partir de uma pasta estruturada contendo arquivos JSON. Isso permite uma melhor organização e modularidade das suas definições de menu.
+
+**Estrutura de Exemplo (`test_menus/`):**
+```
+test_menus/
+├── 1-project-a/
+│   ├── 1.1-down-service.json
+│   ├── 1.2-up-service.json
+│   └── 1.3-restart-project-a.json
+├── 2-restart-all.json
+└── 3-restart-project-a-nested.json
+```
+
+Cada arquivo `.json` dentro da pasta (e suas subpastas) representa uma opção de menu. Os diretórios são automaticamente convertidos em opções do tipo `navigation`.
+
+**Como usar:**
+
+Basta passar o caminho para a sua pasta de menu como argumento:
+
+```bash
+custom-menu-cli ./caminho/para/sua/pasta_de_menu
+```
+
+O CLI irá automaticamente descobrir e combinar todos os arquivos JSON válidos em uma única estrutura de menu.
+
 ## Estrutura do JSON
 
 O arquivo JSON que define o menu tem a seguinte estrutura:
 
 ```json
 {
-  "name": "Deploy Menu",
-  "description": "Menu de navegação para deploys",
+  "name": "custom-menu-cli",
+  "description": "JSON-based terminal menu",
   "options": [
     {
       "id": "1",
@@ -114,6 +141,13 @@ O arquivo JSON que define o menu tem a seguinte estrutura:
           "name": "Up Service",
           "type": "action",
           "command": "echo 'Up A'"
+        },
+        {
+          "id": "1.3",
+          "name": "Restart Project A (from inside)",
+          "type": "custom-action",
+          "idList": ["1.1", "1.2"],
+          "confirm": true
         }
       ]
     },
@@ -123,6 +157,13 @@ O arquivo JSON que define o menu tem a seguinte estrutura:
       "type": "custom-action",
       "idList": ["1.1", "1.2"],
       "confirm": true
+    },
+    {
+      "id": "3",
+      "name": "Restart Project A (Nested)",
+      "type": "custom-action",
+      "idList": ["1.3"],
+      "confirm": true
     }
   ]
 }

package/README.md

@@ -89,14 +89,41 @@ async function startMyCustomMenu() {
 startMyCustomMenu();
 ```
 
+### 4. Folder-based Menu Generation
+
+The `custom-menu-cli` now supports generating menus from a structured folder containing JSON files. This allows for better organization and modularity of your menu definitions.
+
+**Example Structure (`test_menus/`):**
+```
+test_menus/
+├── 1-project-a/
+│   ├── 1.1-down-service.json
+│   ├── 1.2-up-service.json
+│   └── 1.3-restart-project-a.json
+├── 2-restart-all.json
+└── 3-restart-project-a-nested.json
+```
+
+Each `.json` file within the folder (and its subfolders) represents a menu option. Directories are automatically converted into `navigation` type options.
+
+**How to use:**
+
+Simply pass the path to your menu folder as an argument:
+
+```bash
+custom-menu-cli ./path/to/your/menu_folder
+```
+
+The CLI will automatically discover and combine all valid JSON files into a single menu structure.
+
 ## JSON Structure
 
 The JSON file that defines the menu has the following structure:
 
 ```json
 {
-  "name": "Deploy Menu",
-  "description": "Menu de navegação para deploys",
+  "name": "custom-menu-cli",
+  "description": "JSON-based terminal menu",
   "options": [
     {
       "id": "1",
@@ -115,6 +142,13 @@ The JSON file that defines the menu has the following structure:
           "name": "Up Service",
           "type": "action",
           "command": "echo 'Up A'"
+        },
+        {
+          "id": "1.3",
+          "name": "Restart Project A (from inside)",
+          "type": "custom-action",
+          "idList": ["1.1", "1.2"],
+          "confirm": true
         }
       ]
     },
@@ -124,6 +158,13 @@ The JSON file that defines the menu has the following structure:
       "type": "custom-action",
       "idList": ["1.1", "1.2"],
       "confirm": true
+    },
+    {
+      "id": "3",
+      "name": "Restart Project A (Nested)",
+      "type": "custom-action",
+      "idList": ["1.3"],
+      "confirm": true
     }
   ]
 }

package/index.js

@@ -5,7 +5,7 @@ const { showMenu, buildIdMap } = require('./src/menu.js');
 const { displayHeader } = require('./src/header.js');
 
 async function runCli(menuPath = null) {
-    const data = loadMenuConfig(menuPath);
+    const data = await loadMenuConfig(menuPath);
     if (data.options) {
         buildIdMap(data.options);
     }
@@ -18,7 +18,9 @@ async function runCli(menuPath = null) {
 }
 
 if (require.main === module) {
-    runCli();
+    (async () => {
+        await runCli();
+    })();
 }
 
 module.exports = { runCli };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "custom-menu-cli",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Menu interativo baseado em JSON para execução de comandos no terminal",
   "main": "index.js",
   "bin": "index.js",

package/src/configLoader.js

@@ -1,5 +1,7 @@
-const fs = require('fs');
+const fs = require('fs').promises;
+const path = require('path');
 const chalk = require('chalk');
+const { validateMenuOption } = require('./menuValidator.js'); // Importar o validador
 
 const defaultMenu = {
     "name": "Example Menu",
@@ -15,7 +17,40 @@ const defaultMenu = {
     ]
 };
 
-function loadMenuConfig(menuPath = null) {
+async function buildMenuOptions(dir) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const options = [];
+
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            const subOptions = await buildMenuOptions(fullPath);
+            options.push({
+                id: entry.name,
+                name: `=> ${entry.name.toUpperCase()}`,
+                type: 'navigation',
+                options: subOptions
+            });
+        } else if (entry.isFile() && entry.name.endsWith('.json')) {
+            const fileContent = await fs.readFile(fullPath, 'utf-8');
+            let option;
+            try {
+                option = JSON.parse(fileContent);
+            } catch (parseError) {
+                console.error(chalk.red(`Erro: Arquivo JSON malformado em: ${fullPath}`));
+                console.error(chalk.red(`Detalhes: ${parseError.message}`));
+                process.exit(1);
+            }
+
+            validateMenuOption(option, fullPath); // Chamar o validador
+
+            options.push(option);
+        }
+    }
+    return options;
+}
+
+async function loadMenuConfig(menuPath = null) {
     let data;
     let finalPath = menuPath;
 
@@ -25,27 +60,35 @@ function loadMenuConfig(menuPath = null) {
         finalPath = args[0];
     }
 
-    if (finalPath && fs.existsSync(finalPath)) {
+    if (finalPath) {
         try {
-            data = JSON.parse(fs.readFileSync(finalPath, 'utf-8'));
+            const stats = await fs.stat(finalPath);
+            if (stats.isDirectory()) {
+                data = {
+                    name: "Dynamic Menu",
+                    description: `Menu generated from folder: ${finalPath}`,
+                    options: await buildMenuOptions(finalPath)
+                };
+            } else { // It's a file
+                data = JSON.parse(await fs.readFile(finalPath, 'utf-8'));
+                validateMenuOption(data, finalPath); // Validar menu de arquivo único também
+            }
         } catch (error) {
-            console.log(chalk.red(`Error parsing JSON file: ${finalPath}`));
+            console.log(chalk.red(`Erro ao processar o caminho: ${finalPath}`));
             console.error(error);
             process.exit(1);
         }
-    } else if (finalPath) {
-        console.log(chalk.red(`File not found: ${finalPath}`));
-        process.exit(1);
-    } else if (fs.existsSync('./menu.json')) {
+    } else if (fs.existsSync('./menu.json')) { // This part remains sync for now
         try {
             data = JSON.parse(fs.readFileSync('./menu.json', 'utf-8'));
+            validateMenuOption(data, './menu.json'); // Validar menu.json padrão
         } catch (error) {
-            console.log(chalk.red(`Error parsing JSON file: ./menu.json`));
+            console.log(chalk.red(`Erro ao analisar o arquivo JSON: ./menu.json`));
             console.error(error);
             process.exit(1);
         }
     } else {
-        console.log(chalk.yellow("No 'menu.json' found. Loading example menu."));
+        console.log(chalk.yellow("Nenhum 'menu.json' encontrado. Carregando menu de exemplo."));
         data = defaultMenu;
     }
 

package/src/menuValidator.js

@@ -0,0 +1,44 @@
+const chalk = require('chalk');
+
+function validateMenuOption(option, filePath) {
+    // --- Validation Logic ---
+    if (!option.id || typeof option.id !== 'string') {
+        console.error(chalk.red(`
+Validation Error: 'id' missing or invalid in: ${filePath}`));
+        process.exit(1);
+    }
+    if (!option.name || typeof option.name !== 'string') {
+        console.error(chalk.red(`
+Validation Error: 'name' missing or invalid in: ${filePath}`));
+        process.exit(1);
+    }
+    const validTypes = ['action', 'navigation', 'custom-action'];
+    if (!option.type || typeof option.type !== 'string' || !validTypes.includes(option.type)) {
+        console.error(chalk.red(`
+Validation Error: 'type' missing or invalid (expected ${validTypes.join(', ')}) in: ${filePath}`));
+        process.exit(1);
+    }
+
+    if (option.type === 'action') {
+        if (!option.command || typeof option.command !== 'string') {
+            console.error(chalk.red(`
+Validation Error: 'command' missing or invalid for type 'action' in: ${filePath}`));
+            process.exit(1);
+        }
+    } else if (option.type === 'custom-action') {
+        if (!Array.isArray(option.idList) || option.idList.length === 0) {
+            console.error(chalk.red(`
+Validation Error: 'idList' missing or empty for type 'custom-action' in: ${filePath}`));
+            process.exit(1);
+        }
+    } else if (option.type === 'navigation') {
+        if (!Array.isArray(option.options) || option.options.length === 0) {
+            console.error(chalk.red(`
+Validation Error: 'options' missing or empty for type 'navigation' in: ${filePath}. Navigation must come from directories or have sub-options.`));
+            process.exit(1);
+        }
+    }
+    // --- End Validation Logic ---
+}
+
+module.exports = { validateMenuOption };

package/test_menus/1-project-a/1.1-down-service.json

@@ -0,0 +1,7 @@
+{
+  "id": "1.1",
+  "name": "Down Service",
+  "type": "action",
+  "command": "echo 'Down A'",
+  "confirm": true
+}

package/test_menus/1-project-a/1.2-up-service.json

@@ -0,0 +1,6 @@
+{
+  "id": "1.2",
+  "name": "Up Service",
+  "type": "action",
+  "command": "echo 'Up A'"
+}

package/test_menus/1-project-a/1.3-restart-project-a.json

@@ -0,0 +1,7 @@
+{
+  "id": "1.3",
+  "name": "Restart Project A (from inside)",
+  "type": "custom-action",
+  "idList": ["1.1", "1.2"],
+  "confirm": true
+}

package/test_menus/2-restart-all.json

@@ -0,0 +1,7 @@
+{
+  "id": "2",
+  "name": "Restart All",
+  "type": "custom-action",
+  "idList": ["1.1", "1.2"],
+  "confirm": true
+}

package/test_menus/3-restart-project-a-nested.json

@@ -0,0 +1,7 @@
+{
+  "id": "3",
+  "name": "Restart Project A (Nested)",
+  "type": "custom-action",
+  "idList": ["1.3"],
+  "confirm": true
+}