@devicecloud.dev/dcd 3.6.4 → 3.6.6

package/dist/commands/cloud.d.ts

@@ -44,6 +44,7 @@ export default class Cloud extends Command {
         'device-locale': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'download-artifacts': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'artifacts-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'exclude-flows': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
         'exclude-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -66,6 +67,13 @@ export default class Cloud extends Command {
     };
     static enableJsonFlag: boolean;
     private versionCheck;
+    /**
+     * Generate the JSON output file path based on name or upload ID
+     * @param name - Optional custom name for the file
+     * @param uploadId - Upload ID to use if name is not provided
+     * @returns Path to the JSON output file
+     */
+    private getJsonOutputPath;
     run(): Promise<{
         uploadId: string;
         consoleUrl: string;

package/dist/commands/cloud.js

@@ -6,7 +6,6 @@ const core_1 = require("@oclif/core");
 const cli_ux_1 = require("@oclif/core/lib/cli-ux");
 const errors_1 = require("@oclif/core/lib/errors");
 const path = require("node:path");
-const fs = require("node:fs");
 const constants_1 = require("../constants");
 const methods_1 = require("../methods");
 const plan_1 = require("../plan");
@@ -81,29 +80,34 @@ class Cloud extends core_1.Command {
   `);
         }
     };
+    /**
+     * Generate the JSON output file path based on name or upload ID
+     * @param name - Optional custom name for the file
+     * @param uploadId - Upload ID to use if name is not provided
+     * @returns Path to the JSON output file
+     */
+    getJsonOutputPath(name, uploadId) {
+        return name ? `${name}_dcd.json` : `${uploadId}_dcd.json`;
+    }
     async run() {
         let output = null;
+        // Store debug flag outside try/catch to access it in catch block
+        let debugFlag = false;
         try {
             const { args, flags, raw } = await this.parse(Cloud);
-            // // Log the full command that was run
-            // const commandParts = ['dcd cloud'];
-            // if (args.firstFile) commandParts.push(escapeShellValue(args.firstFile));
-            // if (args.secondFile) commandParts.push(escapeShellValue(args.secondFile));
-            // for (const [key, value] of Object.entries(flags)) {
-            //   if (value && value.toString().length > 0) {
-            //     if (typeof value === 'boolean') {
-            //       commandParts.push(`--${key}`);
-            //     } else if (Array.isArray(value)) {
-            //       commandParts.push(
-            //         `--${key}=${value.map((v) => escapeShellValue(v)).join(',')}`,
-            //       );
-            //     } else {
-            //       commandParts.push(`--${key}=${escapeShellValue(value.toString())}`);
-            //     }
-            //   }
-            // }
-            // this.log(`\nCommand ran: ${commandParts.join(' ')}\n`);
-            let { 'additional-app-binary-ids': nonFlatAdditionalAppBinaryIds, 'additional-app-files': nonFlatAdditionalAppFiles, 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, async, config: configFile, 'device-locale': deviceLocale, 'download-artifacts': downloadArtifacts, env, 'exclude-flows': excludeFlows, 'exclude-tags': excludeTags, flows, 'google-play': googlePlay, 'include-tags': includeTags, 'ignore-sha-check': ignoreShaCheck, 'ios-device': iOSDevice, 'ios-version': iOSVersion, 'maestro-version': maestroVersion, name, orientation, quiet, retry, report, 'runner-type': runnerType, 'x86-arch': x86Arch, json, ...rest } = flags;
+            let { 'additional-app-binary-ids': nonFlatAdditionalAppBinaryIds, 'additional-app-files': nonFlatAdditionalAppFiles, 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, async, config: configFile, debug, 'device-locale': deviceLocale, 'download-artifacts': downloadArtifacts, env, 'exclude-flows': excludeFlows, 'exclude-tags': excludeTags, flows, 'google-play': googlePlay, 'include-tags': includeTags, 'ignore-sha-check': ignoreShaCheck, 'ios-device': iOSDevice, 'ios-version': iOSVersion, 'maestro-version': maestroVersion, name, orientation, quiet, retry, report, 'runner-type': runnerType, 'x86-arch': x86Arch, json, ...rest } = flags;
+            // Store debug flag for use in catch block
+            debugFlag = debug === true;
+            if (debug) {
+                this.log('DEBUG: Starting command execution with debug logging enabled');
+                this.log(`DEBUG: CLI Version: ${this.config.version}`);
+                this.log(`DEBUG: Node version: ${process.versions.node}`);
+                this.log(`DEBUG: OS: ${process.platform} ${process.arch}`);
+            }
+            if (flags['json-file']) {
+                quiet = true;
+                this.log('--json-file is true: JSON output will be written to file, forcing --quiet flag for better CI output');
+            }
             if (json) {
                 const originalStdoutWrite = process.stdout.write;
                 process.stdout.write = function (chunk, encodingOrCallback, cb) {
@@ -122,6 +126,10 @@ class Cloud extends core_1.Command {
             const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
             if (!apiKey)
                 throw new Error('You must provide an API key via --api-key flag or DEVICE_CLOUD_API_KEY environment variable');
+            if (debug) {
+                this.log(`DEBUG: API URL: ${apiUrl}`);
+                this.log(`DEBUG: API Key provided: ${apiKey ? 'Yes' : 'No'}`);
+            }
             const [maestroMajorString, maestroMinorString] = maestroVersion.split('.');
             if (report === 'html' &&
                 maestroMajorString === '1' &&
@@ -134,24 +142,10 @@ class Cloud extends core_1.Command {
                 retry = 2;
             }
             if (runnerType === 'm4') {
-                this.log('Note: runnerType m4 is experimental and currently supports iOS only.');
-                // todo - better platform checking
-                if (androidApiLevel || androidDevice) {
-                    throw new Error('runnerType m4 only supports iOS');
-                }
+                this.log('Note: runnerType m4 is experimental and currently supports iOS only, Android will revert to default.');
             }
             if (runnerType === 'm1') {
-                this.log('Note: Runner Type m1 is experimental and currently supports Android only, iOS will revert to default.');
-                // todo - better platform checking
-                if (iOSDevice || iOSVersion) {
-                    this.log('runnerType m1 only supports Android, reverting to default');
-                    runnerType = 'default';
-                }
-                if (androidApiLevel || androidDevice) {
-                    this.log('Runner Type m1 only supports API Level 34 and Pixel 7, unsetting your android options.');
-                    androidApiLevel = undefined;
-                    androidDevice = undefined;
-                }
+                this.log('Note: runnerType m1 is experimental and currently supports Android (Pixel 7, API Level 34) only.');
             }
             const additionalAppBinaryIds = nonFlatAdditionalAppBinaryIds?.flat();
             const additionalAppFiles = nonFlatAdditionalAppFiles?.flat();
@@ -160,6 +154,15 @@ class Cloud extends core_1.Command {
             let finalAdditionalBinaryIds = additionalAppBinaryIds;
             const finalAppFile = appFile ?? firstFile;
             let flowFile = flows ?? secondFile;
+            if (debug) {
+                this.log(`DEBUG: First file argument: ${firstFile || 'not provided'}`);
+                this.log(`DEBUG: Second file argument: ${secondFile || 'not provided'}`);
+                this.log(`DEBUG: App binary ID: ${appBinaryId || 'not provided'}`);
+                this.log(`DEBUG: App file: ${finalAppFile || 'not provided'}`);
+                this.log(`DEBUG: Flow file: ${flowFile || 'not provided'}`);
+                this.log(`DEBUG: Additional app binary IDs: ${additionalAppBinaryIds?.join(', ') || 'none'}`);
+                this.log(`DEBUG: Additional app files: ${additionalAppFiles?.join(', ') || 'none'}`);
+            }
             if (appBinaryId) {
                 if (secondFile) {
                     throw new Error('You cannot provide both an appBinaryId and a binary file');
@@ -176,6 +179,11 @@ class Cloud extends core_1.Command {
                 if (!supportediOSVersions.includes(version)) {
                     throw new Error(`${iOSDeviceID} only supports these iOS versions: ${supportediOSVersions.join(', ')}`);
                 }
+                if (debug) {
+                    this.log(`DEBUG: iOS device: ${iOSDeviceID}`);
+                    this.log(`DEBUG: iOS version: ${version}`);
+                    this.log(`DEBUG: Supported iOS versions: ${supportediOSVersions.join(', ')}`);
+                }
             }
             if (androidApiLevel || androidDevice) {
                 const androidDeviceID = androidDevice || 'pixel-7';
@@ -190,6 +198,12 @@ class Cloud extends core_1.Command {
                 if (!supportedAndroidVersions.includes(version)) {
                     throw new Error(`${androidDeviceID} ${googlePlay ? '(Play Store) ' : ''}only supports these Android API levels: ${supportedAndroidVersions.join(', ')}`);
                 }
+                if (debug) {
+                    this.log(`DEBUG: Android device: ${androidDeviceID}`);
+                    this.log(`DEBUG: Android API level: ${version}`);
+                    this.log(`DEBUG: Google Play enabled: ${googlePlay}`);
+                    this.log(`DEBUG: Supported Android versions: ${supportedAndroidVersions.join(', ')}`);
+                }
             }
             flowFile = path.resolve(flowFile);
             if (!flowFile?.endsWith('.yaml') &&
@@ -197,14 +211,35 @@ class Cloud extends core_1.Command {
                 !flowFile?.endsWith('/')) {
                 flowFile += '/';
             }
+            if (debug) {
+                this.log(`DEBUG: Resolved flow file path: ${flowFile}`);
+            }
             let executionPlan;
             try {
+                if (debug) {
+                    this.log('DEBUG: Generating execution plan...');
+                }
                 executionPlan = await (0, plan_1.plan)(flowFile, includeTags.flat(), excludeTags.flat(), excludeFlows.flat(), configFile);
+                if (debug) {
+                    this.log(`DEBUG: Execution plan generated`);
+                    this.log(`DEBUG: Total flow files: ${executionPlan.totalFlowFiles}`);
+                    this.log(`DEBUG: Flows to run: ${executionPlan.flowsToRun.length}`);
+                    this.log(`DEBUG: Referenced files: ${executionPlan.referencedFiles.length}`);
+                    this.log(`DEBUG: Sequential flows: ${executionPlan.sequence?.flows.length || 0}`);
+                }
             }
             catch (error) {
+                if (debug) {
+                    this.log(`DEBUG: Error generating execution plan: ${error}`);
+                }
                 throw error;
             }
             const { allExcludeTags, allIncludeTags, flowsToRun: testFileNames, referencedFiles, sequence, workspaceConfig, } = executionPlan;
+            if (debug) {
+                this.log(`DEBUG: All include tags: ${allIncludeTags?.join(', ') || 'none'}`);
+                this.log(`DEBUG: All exclude tags: ${allExcludeTags?.join(', ') || 'none'}`);
+                this.log(`DEBUG: Test file names: ${testFileNames.join(', ')}`);
+            }
             const pathsShortestToLongest = [
                 ...testFileNames,
                 ...referencedFiles,
@@ -217,7 +252,14 @@ class Cloud extends core_1.Command {
                 if (isRoot)
                     commonRoot = folderPath;
             }
+            if (debug) {
+                this.log(`DEBUG: Common root directory: ${commonRoot}`);
+            }
             const { continueOnFailure = true, flows: sequentialFlows = [] } = sequence ?? {};
+            if (debug && sequentialFlows.length > 0) {
+                this.log(`DEBUG: Sequential flows: ${sequentialFlows.join(', ')}`);
+                this.log(`DEBUG: Continue on failure: ${continueOnFailure}`);
+            }
             if (!appBinaryId) {
                 if (!(flowFile && finalAppFile)) {
                     throw new Error('You must provide a flow file and an app binary id');
@@ -226,9 +268,15 @@ class Cloud extends core_1.Command {
                     throw new Error('App file must be a .apk for android or .app/.zip file for iOS');
                 }
                 if (finalAppFile.endsWith('.zip')) {
+                    if (debug) {
+                        this.log(`DEBUG: Verifying iOS app zip file: ${finalAppFile}`);
+                    }
                     await (0, methods_1.verifyAppZip)(finalAppFile);
                 }
             }
+            if (debug && additionalAppFiles?.length) {
+                this.log(`DEBUG: Verifying additional app files: ${additionalAppFiles.join(', ')}`);
+            }
             await (0, methods_1.verifyAdditionalAppFiles)(additionalAppFiles);
             const flagLogs = [];
             for (const [k, v] of Object.entries(flags)) {
@@ -253,16 +301,29 @@ class Cloud extends core_1.Command {
             if (!finalBinaryId) {
                 if (!finalAppFile)
                     throw new Error('You must provide either an app binary id or an app file');
+                if (debug) {
+                    this.log(`DEBUG: Uploading binary file: ${finalAppFile}`);
+                }
                 const binaryId = await (0, methods_1.uploadBinary)(finalAppFile, apiUrl, apiKey, ignoreShaCheck, !json);
                 finalBinaryId = binaryId;
+                if (debug) {
+                    this.log(`DEBUG: Binary uploaded with ID: ${binaryId}`);
+                }
             }
             let uploadedBinaryIds = [];
             if (additionalAppFiles?.length) {
+                if (debug) {
+                    this.log(`DEBUG: Uploading additional binary files: ${additionalAppFiles.join(', ')}`);
+                }
                 uploadedBinaryIds = await (0, methods_1.uploadBinaries)(additionalAppFiles, apiUrl, apiKey, ignoreShaCheck, !json);
                 finalAdditionalBinaryIds = [
                     ...finalAdditionalBinaryIds,
                     ...uploadedBinaryIds,
                 ];
+                if (debug) {
+                    this.log(`DEBUG: Additional binaries uploaded with IDs: ${uploadedBinaryIds.join(', ')}`);
+                    this.log(`DEBUG: Final additional binary IDs: ${finalAdditionalBinaryIds.join(', ')}`);
+                }
             }
             const testFormData = new FormData();
             // eslint-disable-next-line unicorn/no-array-reduce
@@ -272,6 +333,12 @@ class Cloud extends core_1.Command {
                 acc[key] = value.join('=');
                 return acc;
             }, {});
+            if (debug && Object.keys(envObject).length > 0) {
+                this.log(`DEBUG: Environment variables: ${JSON.stringify(envObject)}`);
+            }
+            if (debug) {
+                this.log(`DEBUG: Compressing files from path: ${flowFile}`);
+            }
             const buffer = await (0, methods_1.compressFilesFromRelativePath)(flowFile?.endsWith('.yaml') || flowFile?.endsWith('.yml')
                 ? path.dirname(flowFile)
                 : flowFile, [
@@ -281,6 +348,9 @@ class Cloud extends core_1.Command {
                     ...sequentialFlows,
                 ]),
             ], commonRoot);
+            if (debug) {
+                this.log(`DEBUG: Compressed file size: ${buffer.length} bytes`);
+            }
             const blob = new Blob([buffer], {
                 type: exports.mimeTypeLookupByExtension.zip,
             });
@@ -331,13 +401,22 @@ class Cloud extends core_1.Command {
                     testFormData.set(key, value);
                 }
             }
+            if (debug) {
+                this.log(`DEBUG: Submitting flow upload request to ${apiUrl}/uploads/flow`);
+            }
             const options = {
                 body: testFormData,
                 headers: { 'x-app-api-key': apiKey },
             };
             const { message, results } = await (0, methods_1.typeSafePost)(apiUrl, '/uploads/flow', options);
+            if (debug) {
+                this.log(`DEBUG: Flow upload response received`);
+                this.log(`DEBUG: Message: ${message}`);
+                this.log(`DEBUG: Results count: ${results?.length || 0}`);
+            }
             if (!results?.length)
                 (0, errors_1.error)('No tests created: ' + message);
+            this.log(message);
             this.log(`\nCreated ${results.length} tests: ${results
                 .map((r) => r.test_file_name)
                 .sort((a, b) => a.localeCompare(b))
@@ -349,6 +428,9 @@ class Cloud extends core_1.Command {
             this.log(`Your upload ID is: ${results[0].test_upload_id}`);
             this.log(`Poll upload status using: dcd status --api-key ... --upload-id ${results[0].test_upload_id}`);
             if (async) {
+                if (debug) {
+                    this.log(`DEBUG: Async flag is set, not waiting for results`);
+                }
                 const jsonOutput = {
                     uploadId: results[0].test_upload_id,
                     consoleUrl: url,
@@ -359,11 +441,8 @@ class Cloud extends core_1.Command {
                     })),
                 };
                 if (flags['json-file']) {
-                    const jsonFilePath = name
-                        ? `${name}_dcd.json`
-                        : `${results[0].test_upload_id}_dcd.json`;
-                    fs.writeFileSync(jsonFilePath, JSON.stringify(jsonOutput, null, 2));
-                    this.log(`JSON output written to: ${path.resolve(jsonFilePath)}`);
+                    const jsonFilePath = this.getJsonOutputPath(name, results[0].test_upload_id);
+                    (0, methods_1.writeJSONFile)(jsonFilePath, jsonOutput, this);
                 }
                 if (json) {
                     return jsonOutput;
@@ -379,15 +458,27 @@ class Cloud extends core_1.Command {
                 this.log('\nYou can safely close this terminal and the tests will continue\n');
             }
             let sequentialPollFaillures = 0;
+            if (debug) {
+                this.log(`DEBUG: Starting polling loop for results`);
+            }
             await new Promise((resolve, reject) => {
                 const intervalId = setInterval(async () => {
                     try {
+                        if (debug) {
+                            this.log(`DEBUG: Polling for results: ${results[0].test_upload_id}`);
+                        }
                         const { results: updatedResults } = await (0, methods_1.typeSafeGet)(apiUrl, `/results/${results[0].test_upload_id}`, {
                             headers: { 'x-app-api-key': apiKey },
                         });
                         if (!updatedResults) {
                             throw new Error('no results');
                         }
+                        if (debug) {
+                            this.log(`DEBUG: Poll received ${updatedResults.length} results`);
+                            for (const result of updatedResults) {
+                                this.log(`DEBUG: Result status: ${result.test_file_name} - ${result.status}`);
+                            }
+                        }
                         if (!quiet && !json) {
                             core_1.ux.action.status =
                                 '\nStatus      Test\n─────────── ───────────────';
@@ -396,6 +487,9 @@ class Cloud extends core_1.Command {
                             }
                         }
                         if (updatedResults.every((result) => !['PENDING', 'RUNNING'].includes(result.status))) {
+                            if (debug) {
+                                this.log(`DEBUG: All tests completed, stopping poll`);
+                            }
                             if (!json) {
                                 core_1.ux.action.stop('completed');
                                 this.log('\n');
@@ -413,6 +507,9 @@ class Cloud extends core_1.Command {
                             clearInterval(intervalId);
                             if (downloadArtifacts) {
                                 try {
+                                    if (debug) {
+                                        this.log(`DEBUG: Downloading artifacts: ${downloadArtifacts}`);
+                                    }
                                     await (0, methods_1.typeSafePostDownload)(apiUrl, `/results/${results[0].test_upload_id}/download`, {
                                         body: JSON.stringify({ results: downloadArtifacts }),
                                         headers: {
@@ -423,7 +520,10 @@ class Cloud extends core_1.Command {
                                     this.log('\n');
                                     this.log(`Test artifacts have been downloaded to ${artifactsPath || './artifacts.zip'}`);
                                 }
-                                catch {
+                                catch (error) {
+                                    if (debug) {
+                                        this.log(`DEBUG: Error downloading artifacts: ${error}`);
+                                    }
                                     this.warn('Failed to download artifacts');
                                 }
                             }
@@ -433,6 +533,9 @@ class Cloud extends core_1.Command {
                                 return result.id === Math.max(...tries.map((t) => t.id));
                             });
                             if (resultsWithoutEarlierTries.some((result) => result.status === 'FAILED')) {
+                                if (debug) {
+                                    this.log(`DEBUG: Some tests failed, returning failed status`);
+                                }
                                 const jsonOutput = {
                                     uploadId: results[0].test_upload_id,
                                     consoleUrl: url,
@@ -443,11 +546,8 @@ class Cloud extends core_1.Command {
                                     })),
                                 };
                                 if (flags['json-file']) {
-                                    const jsonFilePath = name
-                                        ? `${name}_dcd.json`
-                                        : `${results[0].test_upload_id}_dcd.json`;
-                                    fs.writeFileSync(jsonFilePath, JSON.stringify(jsonOutput, null, 2));
-                                    this.log(`JSON output written to: ${path.resolve(jsonFilePath)}`);
+                                    const jsonFilePath = this.getJsonOutputPath(name, results[0].test_upload_id);
+                                    (0, methods_1.writeJSONFile)(jsonFilePath, jsonOutput, this);
                                 }
                                 if (json) {
                                     output = jsonOutput;
@@ -455,6 +555,9 @@ class Cloud extends core_1.Command {
                                 reject(new Error('RUN_FAILED'));
                             }
                             else {
+                                if (debug) {
+                                    this.log(`DEBUG: All tests passed, returning success status`);
+                                }
                                 const jsonOutput = {
                                     uploadId: results[0].test_upload_id,
                                     consoleUrl: url,
@@ -465,11 +568,8 @@ class Cloud extends core_1.Command {
                                     })),
                                 };
                                 if (flags['json-file']) {
-                                    const jsonFilePath = name
-                                        ? `${name}_dcd.json`
-                                        : `${results[0].test_upload_id}_dcd.json`;
-                                    fs.writeFileSync(jsonFilePath, JSON.stringify(jsonOutput, null, 2));
-                                    this.log(`JSON output written to: ${path.resolve(jsonFilePath)}`);
+                                    const jsonFilePath = this.getJsonOutputPath(name, results[0].test_upload_id);
+                                    (0, methods_1.writeJSONFile)(jsonFilePath, jsonOutput, this);
                                 }
                                 if (json) {
                                     output = jsonOutput;
@@ -481,10 +581,14 @@ class Cloud extends core_1.Command {
                     }
                     catch (error) {
                         sequentialPollFaillures++;
-                        if (sequentialPollFaillures > 5) {
+                        if (debug) {
+                            this.log(`DEBUG: Error polling for results: ${error}`);
+                            this.log(`DEBUG: Sequential poll failures: ${sequentialPollFaillures}`);
+                        }
+                        if (sequentialPollFaillures > 10) {
                             // dropped poll requests shouldn't err user CI
                             clearInterval(intervalId);
-                            throw new Error('unable to fetch results after 5 attempts');
+                            throw new Error('unable to fetch results after 10 attempts');
                         }
                         this.log('unable to fetch results, trying again...');
                     }
@@ -492,10 +596,16 @@ class Cloud extends core_1.Command {
             });
         }
         catch (error) {
+            if (debugFlag && error instanceof Error) {
+                this.log(`DEBUG: Error in command execution: ${error.message}`);
+                this.log(`DEBUG: Error stack: ${error.stack}`);
+            }
             if (error instanceof Error && error.message === 'RUN_FAILED') {
                 this.exit(2);
             }
-            this.error(error, { exit: 1 });
+            else {
+                this.error(error, { exit: 1 });
+            }
         }
         finally {
             if (output) {

package/dist/constants.d.ts

@@ -14,6 +14,7 @@ export declare const flags: {
     'device-locale': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     'download-artifacts': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     'artifacts-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     env: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     'exclude-flows': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
     'exclude-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/constants.js

@@ -70,6 +70,10 @@ exports.flags = {
         description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip)',
         dependsOn: ['download-artifacts'],
     }),
+    debug: core_1.Flags.boolean({
+        description: 'Enable detailed debug logging for troubleshooting issues',
+        default: false,
+    }),
     env: core_1.Flags.file({
         char: 'e',
         description: 'One or more environment variables to inject into your flows',

package/dist/methods.d.ts

@@ -34,3 +34,14 @@ export declare const getUploadStatus: (apiUrl: string, apiKey: string, options:
         status: "PASSED" | "FAILED" | "CANCELLED" | "PENDING";
     }>;
 }>;
+/**
+ * Writes JSON data to a file with error handling
+ * @param filePath - Path to the output JSON file
+ * @param data - Data to be serialized to JSON
+ * @param logger - Logger object with log and warn methods
+ * @returns true if successful, false if an error occurred
+ */
+export declare const writeJSONFile: (filePath: string, data: any, logger: {
+    log: (message: string) => void;
+    warn: (message: string) => void;
+}) => void;

package/dist/methods.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUploadStatus = exports.verifyAdditionalAppFiles = exports.uploadBinaries = exports.uploadBinary = exports.extractAppMetadataIos = exports.extractAppMetadataIosZip = exports.extractAppMetadataAndroid = exports.verifyAppZip = exports.compressFilesFromRelativePath = exports.compressFolderToBlob = exports.compressDir = exports.toBuffer = exports.typeSafeGet = exports.typeSafePostDownload = exports.typeSafePost = void 0;
+exports.writeJSONFile = exports.getUploadStatus = exports.verifyAdditionalAppFiles = exports.uploadBinaries = exports.uploadBinary = exports.extractAppMetadataIos = exports.extractAppMetadataIosZip = exports.extractAppMetadataAndroid = exports.verifyAppZip = exports.compressFilesFromRelativePath = exports.compressFolderToBlob = exports.compressDir = exports.toBuffer = exports.typeSafeGet = exports.typeSafePostDownload = exports.typeSafePost = void 0;
 const core_1 = require("@oclif/core");
 const supabase_js_1 = require("@supabase/supabase-js");
 // required polyfill for node 18
@@ -370,3 +370,22 @@ const getUploadStatus = async (apiUrl, apiKey, options) => {
     return response.json();
 };
 exports.getUploadStatus = getUploadStatus;
+/**
+ * Writes JSON data to a file with error handling
+ * @param filePath - Path to the output JSON file
+ * @param data - Data to be serialized to JSON
+ * @param logger - Logger object with log and warn methods
+ * @returns true if successful, false if an error occurred
+ */
+const writeJSONFile = (filePath, data, logger) => {
+    try {
+        (0, node_fs_1.writeFileSync)(filePath, JSON.stringify(data, null, 2));
+        logger.log(`JSON output written to: ${path.resolve(filePath)}`);
+    }
+    catch (error) {
+        logger.warn(`Failed to write JSON output to file: ${filePath}`);
+        // Use console.debug instead of logger.debug since debug is protected in Command
+        logger.warn(`Error details: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+exports.writeJSONFile = writeJSONFile;

package/oclif.manifest.json

@@ -161,6 +161,12 @@
           "multiple": false,
           "type": "option"
         },
+        "debug": {
+          "description": "Enable detailed debug logging for troubleshooting issues",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "char": "e",
           "description": "One or more environment variables to inject into your flows",
@@ -514,5 +520,5 @@
       ]
     }
   },
-  "version": "3.6.4"
+  "version": "3.6.6"
 }

package/package.json

@@ -71,7 +71,7 @@
   "scripts": {
     "dcd": "./bin/dev.js",
     "prod": "./bin/run.js",
-    "build": "shx rm -rf dist && tsc -b", 
+    "build": "shx rm -rf dist && tsc -b",
     "lint": "eslint . --ext .ts",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "yarn lint",
@@ -79,7 +79,7 @@
     "prepare": "yarn build",
     "version": "oclif readme && git add README.md"
   },
-  "version": "3.6.4",
+  "version": "3.6.6",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },
@@ -93,4 +93,4 @@
   ],
   "types": "dist/index.d.ts",
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
-}
+}