@devicecloud.dev/dcd 4.1.4 → 4.1.6

package/dist/commands/cloud.d.ts

@@ -1,4 +1,16 @@
 import { Command } from '@oclif/core';
+/**
+ * Primary CLI command for executing tests on DeviceCloud.
+ * Orchestrates the complete test workflow:
+ * - Binary upload with SHA deduplication
+ * - Flow file analysis and dependency resolution
+ * - Device compatibility validation
+ * - Test submission with parallel execution
+ * - Real-time result polling with 5-second intervals
+ * - Artifact download (reports, videos, logs)
+ *
+ * Replaces `maestro cloud` with DeviceCloud-specific functionality.
+ */
 export default class Cloud extends Command {
     static args: {
         firstFile: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
@@ -50,12 +62,30 @@ export default class Cloud extends Command {
         apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
+    /** Service for device/OS compatibility validation */
     private deviceValidationService;
+    /** Service for Moropo test framework integration */
     private moropoService;
+    /** Service for downloading test reports and artifacts */
     private reportDownloadService;
+    /** Service for polling test results with 5-second intervals */
     private resultsPollingService;
+    /** Service for submitting tests to the API */
     private testSubmissionService;
+    /**
+     * Check for CLI updates and notify user if outdated
+     * Compares current version with latest npm release
+     * @returns Promise that resolves when version check is complete
+     */
     private versionCheck;
+    /** Service for CLI version checking */
     private versionService;
+    /**
+     * Main command execution entry point
+     * Orchestrates the complete test submission and monitoring workflow
+     * @returns Promise that resolves when command execution is complete
+     * @throws RunFailedError if tests fail
+     * @throws Error for infrastructure or configuration errors
+     */
     run(): Promise<any>;
 }

package/dist/commands/cloud.js

@@ -15,6 +15,7 @@ const results_polling_service_1 = require("../services/results-polling.service")
 const test_submission_service_1 = require("../services/test-submission.service");
 const version_service_1 = require("../services/version.service");
 const compatibility_1 = require("../utils/compatibility");
+const styling_1 = require("../utils/styling");
 // Suppress punycode deprecation warning (caused by whatwg, supabase dependancy)
 process.removeAllListeners('warning');
 process.on('warning', (warning) => {
@@ -23,6 +24,18 @@ process.on('warning', (warning) => {
         // Ignore punycode deprecation warnings
     }
 });
+/**
+ * Primary CLI command for executing tests on DeviceCloud.
+ * Orchestrates the complete test workflow:
+ * - Binary upload with SHA deduplication
+ * - Flow file analysis and dependency resolution
+ * - Device compatibility validation
+ * - Test submission with parallel execution
+ * - Real-time result polling with 5-second intervals
+ * - Artifact download (reports, videos, logs)
+ *
+ * Replaces `maestro cloud` with DeviceCloud-specific functionality.
+ */
 class Cloud extends core_1.Command {
     static args = {
         firstFile: core_1.Args.string({
@@ -40,24 +53,41 @@ class Cloud extends core_1.Command {
     static enableJsonFlag = true;
     static examples = ['<%= config.bin %> <%= command.id %>'];
     static flags = constants_1.flags;
+    /** Service for device/OS compatibility validation */
     deviceValidationService = new device_validation_service_1.DeviceValidationService();
+    /** Service for Moropo test framework integration */
     moropoService = new moropo_service_1.MoropoService();
+    /** Service for downloading test reports and artifacts */
     reportDownloadService = new report_download_service_1.ReportDownloadService();
+    /** Service for polling test results with 5-second intervals */
     resultsPollingService = new results_polling_service_1.ResultsPollingService();
+    /** Service for submitting tests to the API */
     testSubmissionService = new test_submission_service_1.TestSubmissionService();
+    /**
+     * Check for CLI updates and notify user if outdated
+     * Compares current version with latest npm release
+     * @returns Promise that resolves when version check is complete
+     */
     versionCheck = async () => {
         const latestVersion = await this.versionService.checkLatestCliVersion();
         if (latestVersion &&
             this.versionService.isOutdated(this.config.version, latestVersion)) {
-            this.log(`
-  -------------------
-  A new version of the devicecloud.dev CLI is available: ${latestVersion}
-  Run 'npm install -g @devicecloud.dev/dcd@latest' to update to the latest version
-  -------------------
-  `);
+            this.log(`\n${styling_1.dividers.light}\n` +
+                `${styling_1.colors.warning('⚠')}  ${styling_1.colors.bold('Update Available')}\n` +
+                styling_1.colors.dim(`   A new version of the DeviceCloud CLI is available: `) + styling_1.colors.highlight(latestVersion) + `\n` +
+                styling_1.colors.dim(`   Run: `) + styling_1.colors.info(`npm install -g @devicecloud.dev/dcd@latest`) + `\n` +
+                `${styling_1.dividers.light}\n`);
         }
     };
+    /** Service for CLI version checking */
     versionService = new version_service_1.VersionService();
+    /**
+     * Main command execution entry point
+     * Orchestrates the complete test submission and monitoring workflow
+     * @returns Promise that resolves when command execution is complete
+     * @throws RunFailedError if tests fail
+     * @throws Error for infrastructure or configuration errors
+     */
     async run() {
         let output = null;
         // Store debug flag outside try/catch to access it in catch block
@@ -135,18 +165,18 @@ class Cloud extends core_1.Command {
                 logger: this.log.bind(this),
             });
             if (retry && retry > 2) {
-                this.log("Retries are now free of charge but limited to 2. If you're test is still failing after 2 retries, please ask for help on Discord.");
+                this.log(styling_1.colors.warning('⚠') + '  ' + styling_1.colors.dim("Retries are now free of charge but limited to 2. If your test is still failing after 2 retries, please ask for help on Discord."));
                 flags.retry = 2;
                 retry = 2;
             }
             if (runnerType === 'm4') {
-                this.log('Note: runnerType m4 is experimental and currently supports iOS only, Android will revert to default.');
+                this.log(styling_1.colors.info('ℹ') + '  ' + styling_1.colors.dim('Note: runnerType m4 is experimental and currently supports iOS only, Android will revert to default.'));
             }
             if (runnerType === 'm1') {
-                this.log('Note: runnerType m1 is experimental and currently supports Android (Pixel 7, API Level 34) only.');
+                this.log(styling_1.colors.info('ℹ') + '  ' + styling_1.colors.dim('Note: runnerType m1 is experimental and currently supports Android (Pixel 7, API Level 34) only.'));
             }
             if (runnerType === 'gpu1') {
-                this.log('Note: runnerType gpu1 is Android-only and requires contacting support to enable. Without support enablement, your runner type will revert to default.');
+                this.log(styling_1.colors.info('ℹ') + '  ' + styling_1.colors.dim('Note: runnerType gpu1 is Android-only and requires contacting support to enable. Without support enablement, your runner type will revert to default.'));
             }
             const { firstFile, secondFile } = args;
             let finalBinaryId = appBinaryId;
@@ -260,41 +290,44 @@ class Cloud extends core_1.Command {
             const hasOverrides = overridesEntries.some(([, overrides]) => Object.keys(overrides).length > 0);
             let overridesLog = '';
             if (hasOverrides) {
-                overridesLog = '\n        With overrides';
+                overridesLog = '\n\n   ' + styling_1.colors.bold('With overrides');
                 for (const [flowPath, overrides] of overridesEntries) {
                     if (Object.keys(overrides).length > 0) {
                         const relativePath = flowPath.replace(process.cwd(), '.');
-                        overridesLog += `\n      → ${relativePath}:`;
+                        overridesLog += `\n   ${styling_1.colors.dim('→')} ${relativePath}:`;
                         for (const [key, value] of Object.entries(overrides)) {
-                            overridesLog += `\n        ${key}: ${value}`;
+                            overridesLog += `\n     ${styling_1.colors.dim(key + ':')} ${styling_1.colors.highlight(value)}`;
                         }
                     }
                 }
-                overridesLog += '\n';
-            }
-            this.log(`
-
-        Submitting new job
-      → Flow(s): ${flowFile}
-      → App: ${appBinaryId || finalAppFile}
-
-        With options
-      → ${flagLogs.join(`
-      → `)}${overridesLog}
-
-      `);
+            }
+            this.log(`\n${(0, styling_1.sectionHeader)('Submitting new job')}`);
+            this.log(`   ${styling_1.colors.dim('→ Flow(s):')} ${styling_1.colors.highlight(flowFile)}`);
+            this.log(`   ${styling_1.colors.dim('→ App:')} ${styling_1.colors.highlight(appBinaryId || finalAppFile)}`);
+            if (flagLogs.length > 0) {
+                this.log(`\n   ${styling_1.colors.bold('With options')}`);
+                for (const flagLog of flagLogs) {
+                    const [key, ...valueParts] = flagLog.split(': ');
+                    const value = valueParts.join(': ');
+                    this.log(`   ${styling_1.colors.dim('→ ' + key + ':')} ${styling_1.colors.highlight(value)}`);
+                }
+            }
+            if (hasOverrides) {
+                this.log(overridesLog);
+            }
+            this.log('');
             if (dryRun) {
-                this.log('\nDry run mode - no tests were actually triggered\n');
-                this.log('The following tests would have been run:');
-                this.log('─────────────────────────────────────────');
+                this.log(`\n${styling_1.colors.warning('⚠')}  ${styling_1.colors.bold('Dry run mode')} ${styling_1.colors.dim('- no tests were actually triggered')}\n`);
+                this.log(styling_1.colors.bold('The following tests would have been run:'));
+                this.log(styling_1.dividers.light);
                 for (const test of testFileNames) {
-                    this.log(`• ${test}`);
+                    this.log((0, styling_1.listItem)(test));
                 }
                 if (sequentialFlows.length > 0) {
-                    this.log('\nSequential flows:');
-                    this.log('────────────────');
+                    this.log(`\n${styling_1.colors.bold('Sequential flows:')}`);
+                    this.log(styling_1.dividers.short);
                     for (const flow of sequentialFlows) {
-                        this.log(`• ${flow}`);
+                        this.log((0, styling_1.listItem)(flow));
                     }
                 }
                 this.log('\n');
@@ -306,7 +339,7 @@ class Cloud extends core_1.Command {
                 if (debug) {
                     this.log(`DEBUG: Uploading binary file: ${finalAppFile}`);
                 }
-                const binaryId = await (0, methods_1.uploadBinary)(finalAppFile, apiUrl, apiKey, ignoreShaCheck, !json);
+                const binaryId = await (0, methods_1.uploadBinary)(finalAppFile, apiUrl, apiKey, ignoreShaCheck, !json, debug);
                 finalBinaryId = binaryId;
                 if (debug) {
                     this.log(`DEBUG: Binary uploaded with ID: ${binaryId}`);
@@ -356,17 +389,18 @@ class Cloud extends core_1.Command {
             }
             if (!results?.length)
                 (0, errors_1.error)('No tests created: ' + message);
-            this.log(message);
-            this.log(`\nCreated ${results.length} tests: ${results
+            this.log(styling_1.colors.success('✓') + '  ' + styling_1.colors.dim(message));
+            const testNames = results
                 .map((r) => r.test_file_name)
                 .sort((a, b) => a.localeCompare(b))
-                .join(', ')}\n`);
-            this.log('Run triggered, you can access the results at:');
-            const url = `https://console.devicecloud.dev/results?upload=${results[0].test_upload_id}&result=${results[0].id}`;
-            this.log(url);
-            this.log(`\n`);
-            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}`);
+                .join(styling_1.colors.dim(', '));
+            this.log(`\n${styling_1.colors.bold(`Created ${results.length} test${results.length === 1 ? '' : 's'}:`)} ${testNames}\n`);
+            const url = (0, styling_1.getConsoleUrl)(apiUrl, results[0].test_upload_id, results[0].id);
+            this.log(styling_1.colors.bold('Run triggered') + styling_1.colors.dim(', you can access the results at:'));
+            this.log((0, styling_1.formatUrl)(url));
+            this.log(``);
+            this.log(styling_1.colors.dim('Your upload ID is: ') + (0, styling_1.formatId)(results[0].test_upload_id));
+            this.log(styling_1.colors.dim('Poll upload status using: ') + styling_1.colors.info(`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`);
@@ -387,7 +421,7 @@ class Cloud extends core_1.Command {
                 if (json) {
                     return jsonOutput;
                 }
-                this.log('Not waiting for results as async flag is set to true');
+                this.log(`\n${styling_1.colors.info('ℹ')}  ${styling_1.colors.dim('Not waiting for results as async flag is set to true')}\n`);
                 return;
             }
             // Poll for results until completion

package/dist/commands/status.d.ts

@@ -31,6 +31,5 @@ export default class Status extends Command {
         'upload-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<StatusResponse | void>;
-    private getStatusSymbol;
 }
 export {};

package/dist/commands/status.js

@@ -5,6 +5,7 @@ const constants_1 = require("../constants");
 const api_gateway_1 = require("../gateways/api-gateway");
 const methods_1 = require("../methods");
 const connectivity_1 = require("../utils/connectivity");
+const styling_1 = require("../utils/styling");
 class Status extends core_1.Command {
     static description = 'Get the status of an upload by name or upload ID';
     static enableJsonFlag = true;
@@ -98,32 +99,27 @@ class Status extends core_1.Command {
             if (json) {
                 return status;
             }
-            this.log('\n📊 Upload Status');
-            this.log('═'.repeat(80));
+            this.log((0, styling_1.sectionHeader)('Upload Status'));
             // Display overall status
-            const overallSymbol = this.getStatusSymbol(status.status);
-            this.log(`${overallSymbol}  Status:      ${status.status}`);
+            this.log(`   ${(0, styling_1.formatStatus)(status.status)}`);
             if (status.uploadId) {
-                this.log(`🆔 Upload ID:   ${status.uploadId}`);
+                this.log(`   ${styling_1.colors.dim('Upload ID:')} ${(0, styling_1.formatId)(status.uploadId)}`);
             }
             if (status.appBinaryId) {
-                this.log(`📱 Binary ID:   ${status.appBinaryId}`);
+                this.log(`   ${styling_1.colors.dim('Binary ID:')} ${(0, styling_1.formatId)(status.appBinaryId)}`);
             }
             if (status.consoleUrl) {
-                this.log(`🔗 Console:     ${status.consoleUrl}`);
+                this.log(`   ${styling_1.colors.dim('Console:')} ${(0, styling_1.formatUrl)(status.consoleUrl)}`);
             }
             if (status.tests.length > 0) {
-                this.log('\n📋 Test Results');
-                this.log('─'.repeat(80));
+                this.log((0, styling_1.sectionHeader)('Test Results'));
                 for (const item of status.tests) {
-                    const symbol = this.getStatusSymbol(item.status);
-                    this.log(`${symbol} ${item.name}`);
-                    this.log(`   Status: ${item.status}`);
+                    this.log(`   ${(0, styling_1.formatStatus)(item.status)} ${styling_1.colors.bold(item.name)}`);
                     if (item.status === 'FAILED' && item.failReason) {
-                        this.log(`   Fail reason: ${item.failReason}`);
+                        this.log(`      ${styling_1.colors.error('Fail reason:')} ${item.failReason}`);
                     }
                     if (item.durationSeconds) {
-                        this.log(`   Duration: ${(0, methods_1.formatDurationSeconds)(item.durationSeconds)}`);
+                        this.log(`      ${styling_1.colors.dim('Duration:')} ${(0, methods_1.formatDurationSeconds)(item.durationSeconds)}`);
                     }
                     this.log('');
                 }
@@ -133,24 +129,5 @@ class Status extends core_1.Command {
             this.error(`Failed to get status: ${error.message}`);
         }
     }
-    getStatusSymbol(status) {
-        switch (status) {
-            case 'PASSED': {
-                return '✓';
-            }
-            case 'FAILED': {
-                return '✗';
-            }
-            case 'CANCELLED': {
-                return '⊘';
-            }
-            case 'PENDING': {
-                return '⋯';
-            }
-            default: {
-                return '?';
-            }
-        }
-    }
 }
 exports.default = Status;

package/dist/commands/upload.d.ts

@@ -9,6 +9,7 @@ export default class Upload extends Command {
     static flags: {
         apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<{

package/dist/commands/upload.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const constants_1 = require("../constants");
 const methods_1 = require("../methods");
+const styling_1 = require("../utils/styling");
 class Upload extends core_1.Command {
     static args = {
         appFile: core_1.Args.string({
@@ -20,13 +21,14 @@ class Upload extends core_1.Command {
     static flags = {
         apiKey: constants_1.flags.apiKey,
         apiUrl: constants_1.flags.apiUrl,
+        debug: constants_1.flags.debug,
         'ignore-sha-check': constants_1.flags['ignore-sha-check'],
     };
     async run() {
         try {
             const { args, flags } = await this.parse(Upload);
             const { appFile } = args;
-            const { apiKey: apiKeyFlag, apiUrl, 'ignore-sha-check': ignoreShaCheck, json, } = flags;
+            const { apiKey: apiKeyFlag, apiUrl, debug, 'ignore-sha-check': ignoreShaCheck, json, } = flags;
             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');
@@ -37,17 +39,17 @@ class Upload extends core_1.Command {
             if (appFile.endsWith('.zip')) {
                 await (0, methods_1.verifyAppZip)(appFile);
             }
-            this.log(`
-        Uploading app binary
-      → File: ${appFile}
-      `);
-            const appBinaryId = await (0, methods_1.uploadBinary)(appFile, apiUrl, apiKey, ignoreShaCheck, !json);
+            this.log((0, styling_1.sectionHeader)('Uploading app binary'));
+            this.log(`   ${styling_1.colors.dim('→ File:')} ${styling_1.colors.highlight(appFile)}`);
+            this.log('');
+            const appBinaryId = await (0, methods_1.uploadBinary)(appFile, apiUrl, apiKey, ignoreShaCheck, !json, debug);
             if (json) {
                 return { appBinaryId };
             }
-            this.log(`\nUpload complete. Binary ID: ${appBinaryId}\n`);
-            this.log(`You can use this Binary ID in subsequent test runs with:`);
-            this.log(`dcd cloud --app-binary-id ${appBinaryId} path/to/flow.yaml\n`);
+            this.log(`\n${styling_1.colors.success('✓')}  ${styling_1.colors.bold('Upload complete')}`);
+            this.log(`   ${styling_1.colors.dim('Binary ID:')} ${(0, styling_1.formatId)(appBinaryId)}\n`);
+            this.log(styling_1.colors.dim('You can use this Binary ID in subsequent test runs with:'));
+            this.log(styling_1.colors.info(`dcd cloud --app-binary-id ${appBinaryId} path/to/flow.yaml\n`));
         }
         catch (error) {
             this.error(error, { exit: 1 });

package/dist/config/flags/execution.flags.js

@@ -44,7 +44,7 @@ exports.executionFlags = {
     }),
     'runner-type': core_1.Flags.string({
         default: 'default',
-        description: '[experimental] The type of runner to use - note: anything other than default will incur premium pricing tiers, see https://docs.devicecloud.dev/reference/runner-type for more information. gpu1 is Android-only and requires contacting support to enable, otherwise reverts to default.',
-        options: ['default', 'm4', 'm1', 'gpu1'],
+        description: '[experimental] The type of runner to use - note: anything other than default or cpu1 will incur premium pricing tiers, see https://docs.devicecloud.dev/reference/runner-type for more information.',
+        options: ['default', 'm4', 'm1', 'gpu1', 'cpu1'],
     }),
 };

package/dist/gateways/api-gateway.d.ts

@@ -14,14 +14,14 @@ export declare const ApiGateway: {
     downloadArtifactsZip(baseUrl: string, apiKey: string, uploadId: string, results: "ALL" | "FAILED", artifactsPath?: string): Promise<void>;
     finaliseUpload(baseUrl: string, apiKey: string, id: string, metadata: TAppMetadata, path: string, sha: string): Promise<Record<string, never>>;
     getBinaryUploadUrl(baseUrl: string, apiKey: string, platform: "android" | "ios"): Promise<{
-        id: string;
         message: string;
         path: string;
         token: string;
+        id: string;
     }>;
     getResultsForUpload(baseUrl: string, apiKey: string, uploadId: string): Promise<{
-        results?: import("../types/generated/schema.types").components["schemas"]["TResultResponse"][];
         statusCode?: number;
+        results?: import("../types/generated/schema.types").components["schemas"]["TResultResponse"][];
     }>;
     getUploadStatus(baseUrl: string, apiKey: string, options: {
         name?: string;

package/dist/gateways/supabase-gateway.d.ts

@@ -7,5 +7,5 @@ export declare class SupabaseGateway {
         SUPABASE_PUBLIC_KEY: string;
         SUPABASE_URL: string;
     };
-    static uploadToSignedUrl(env: 'dev' | 'prod', path: string, token: string, file: File): Promise<void>;
+    static uploadToSignedUrl(env: 'dev' | 'prod', path: string, token: string, file: File, debug?: boolean): Promise<void>;
 }

package/dist/gateways/supabase-gateway.js

@@ -16,16 +16,58 @@ class SupabaseGateway {
     static getSupabaseKeys(env) {
         return this.SB[env];
     }
-    static async uploadToSignedUrl(env, path, token, file) {
+    static async uploadToSignedUrl(env, path, token, file, debug = false) {
         const { SUPABASE_PUBLIC_KEY, SUPABASE_URL } = this.getSupabaseKeys(env);
-        const supabase = (0, supabase_js_1.createClient)(SUPABASE_URL, SUPABASE_PUBLIC_KEY);
-        const uploadToUrl = await supabase.storage
-            .from('organizations')
-            .uploadToSignedUrl(path, token, file);
-        if (uploadToUrl.error) {
-            const error = uploadToUrl.error;
-            const errorMessage = typeof error === 'string' ? error : error?.message || 'Upload failed';
-            throw new Error(errorMessage);
+        if (debug) {
+            console.log(`[DEBUG] Supabase upload starting...`);
+            console.log(`[DEBUG] Supabase URL: ${SUPABASE_URL}`);
+            console.log(`[DEBUG] Upload path: ${path}`);
+            console.log(`[DEBUG] File name: ${file.name}`);
+            console.log(`[DEBUG] File type: ${file.type}`);
+        }
+        try {
+            const supabase = (0, supabase_js_1.createClient)(SUPABASE_URL, SUPABASE_PUBLIC_KEY);
+            const uploadToUrl = await supabase.storage
+                .from('organizations')
+                .uploadToSignedUrl(path, token, file);
+            if (uploadToUrl.error) {
+                const error = uploadToUrl.error;
+                const errorMessage = typeof error === 'string' ? error : error?.message || 'Upload failed';
+                if (debug) {
+                    console.error(`[DEBUG] Supabase upload error:`, error);
+                    if (typeof error === 'object' && 'statusCode' in error) {
+                        console.error(`[DEBUG] HTTP Status Code: ${error.statusCode}`);
+                    }
+                }
+                throw new Error(errorMessage);
+            }
+            if (debug) {
+                console.log(`[DEBUG] Supabase upload successful`);
+                console.log(`[DEBUG] Upload result path: ${uploadToUrl.data?.path || 'N/A'}`);
+            }
+        }
+        catch (error) {
+            if (debug) {
+                console.error(`[DEBUG] Supabase upload exception:`, error);
+                console.error(`[DEBUG] Error type: ${error instanceof Error ? error.name : typeof error}`);
+                console.error(`[DEBUG] Error message: ${error instanceof Error ? error.message : String(error)}`);
+                // Check for common network errors
+                if (error instanceof Error) {
+                    if (error.message.includes('ECONNREFUSED')) {
+                        console.error(`[DEBUG] Network error: Connection refused - check internet connectivity`);
+                    }
+                    else if (error.message.includes('ETIMEDOUT')) {
+                        console.error(`[DEBUG] Network error: Connection timeout - check internet connectivity or try again`);
+                    }
+                    else if (error.message.includes('ENOTFOUND')) {
+                        console.error(`[DEBUG] Network error: DNS lookup failed - check internet connectivity`);
+                    }
+                    else if (error.message.includes('ECONNRESET')) {
+                        console.error(`[DEBUG] Network error: Connection reset - network unstable or interrupted`);
+                    }
+                }
+            }
+            throw error;
         }
     }
 }

package/dist/methods.d.ts

@@ -3,7 +3,7 @@ export declare const toBuffer: (archive: archiver.Archiver) => Promise<Buffer<Ar
 export declare const compressFolderToBlob: (sourceDir: string) => Promise<Blob>;
 export declare const compressFilesFromRelativePath: (basePath: string, files: string[], commonRoot: string) => Promise<Buffer<ArrayBuffer>>;
 export declare const verifyAppZip: (zipPath: string) => Promise<void>;
-export declare const uploadBinary: (filePath: string, apiUrl: string, apiKey: string, ignoreShaCheck?: boolean, log?: boolean) => Promise<string>;
+export declare const uploadBinary: (filePath: string, apiUrl: string, apiKey: string, ignoreShaCheck?: boolean, log?: boolean, debug?: boolean) => Promise<string>;
 /**
  * Writes JSON data to a file with error handling
  * @param filePath - Path to the output JSON file