feat: add download command for environment variables with JSON output

Author: fuatguzel

docs/build/variable/download.md

@@ -0,0 +1,28 @@
+# `appcircle build variable download`
+
+Download environment variables as JSON
+
+```plaintext
+appcircle build variable download [options]
+```
+
+## Examples
+
+```plaintext
+$ appcircle build variable download --variableGroupId "Variable Group ID"
+
+$ appcircle build variable download --variableGroupId "Variable Group ID" --path "/path/to/save"
+```
+         
+## Options
+
+```plaintext
+      --variableGroupId <uuid>  Variable Groups ID
+      --path <string>           [OPTIONAL] The path for JSON file to be downloaded (Defaults to the current directory)
+```                       
+
+## Options inherited from parent commands
+
+```plaintext
+      --help   Show help for command
+``` 

docs/build/variable/index.md

@@ -17,4 +17,5 @@ appcircle build variable [command] [options]
 - [`group`](group/index.md)
 - [`create`](create.md)
 - [`view`](view.md)
+- [`download`](download.md)
 

src/core/command-runner.ts

@@ -613,6 +613,57 @@ const handleBuildCommand = async (command: ProgramCommand, params:any) => {
       fullCommandName: command.fullCommandName,
       data: responseData,
     });
+  } else if(command.fullCommandName === `${PROGRAM_NAME}-build-variable-download`){
+    const spinner = createOra('Downloading environment variables...').start();
+    try {
+      const variableGroups = await getEnvironmentVariableGroups();
+      const variableGroup = variableGroups.find((group: any) => group.id === params.variableGroupId);
+      
+      if (!variableGroup) {
+        spinner.fail(`Variable group with ID ${params.variableGroupId} not found`);
+        throw new Error(`Variable group not found`);
+      }
+      
+      const responseData = await getEnvironmentVariables(params);
+      
+      let formattedVariables = responseData.map((variable: any) => ({
+        key: variable.key,
+        value: variable.value,
+        isSecret: variable.isSecret,
+        isFile: variable.isFile || false,
+        id: variable.key
+      }));
+      
+      formattedVariables.sort((a: any, b: any) => {
+        const aKey = a.key;
+        const bKey = b.key;
+        return bKey.localeCompare(aKey);
+      });
+      
+      const timestamp = Date.now();
+      const fileName = `${variableGroup.name}_${timestamp}.json`;
+      let filePath = params.path || process.cwd();
+      
+      if (filePath.includes('~')) {
+        filePath = filePath.replace(/~/g, os.homedir());
+      }
+      
+      filePath = path.resolve(filePath);
+
+      if (!fs.existsSync(filePath)) {
+        fs.mkdirSync(filePath, { recursive: true });
+      }
+
+      if (fs.statSync(filePath).isDirectory()) {
+        filePath = path.join(filePath, fileName);
+      }
+      
+      fs.writeFileSync(filePath, JSON.stringify(formattedVariables));
+      spinner.succeed(`Environment variables downloaded successfully to ${filePath}`);
+    } catch (e) {
+      spinner.fail('Failed to download environment variables');
+      throw e;
+    }
   } else if(command.fullCommandName === `${PROGRAM_NAME}-build-variable-create`){
     const spinner = createOra('Creating environment variable').start();
     try {

src/core/commands.ts

@@ -547,6 +547,26 @@ export const Commands: CommandType[] = [
                 valueType: 'uuid',
               },
             ],
+          },
+          {
+            command: "download",
+            description: 'Download environment variables as JSON',
+            params: [
+              {
+                name: 'variableGroupId',
+                description: 'Variable Groups ID',
+                type: CommandParameterTypes.SELECT,
+                valueType: 'uuid',
+              },
+              {
+                name: 'path',
+                description: '[OPTIONAL] The path for JSON file to be downloaded',
+                longDescription:'[OPTIONAL] The path for JSON file to be downloaded (Defaults to the current directory)',
+                type: CommandParameterTypes.STRING,
+                valueType: 'string',
+                required: false,
+              }
+            ],
           }
         ],
         params: []