@devicecloud.dev/dcd 4.1.5 → 4.1.7

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) => {
@@ -71,12 +72,11 @@ class Cloud extends core_1.Command {
         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 */
@@ -165,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;
@@ -290,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');
@@ -336,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}`);
@@ -386,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`);
@@ -417,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 and cpu1 are Android-only and require contacting support to enable, otherwise reverts to default.',
+        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

@@ -12,13 +12,29 @@ export declare const ApiGateway: {
         exists: boolean;
     }>;
     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<{
+    finaliseUpload(baseUrl: string, apiKey: string, id: string, metadata: TAppMetadata, path: string, sha: string, supabaseSuccess: boolean, backblazeSuccess: boolean): Promise<Record<string, never>>;
+    getBinaryUploadUrl(baseUrl: string, apiKey: string, platform: "android" | "ios", fileSize: number): Promise<{
         message: string;
         path: string;
         token: string;
         id: string;
+        b2?: {
+            strategy: "simple" | "large";
+            simple?: {
+                uploadUrl: string;
+                authorizationToken: string;
+            };
+            large?: {
+                fileId: string;
+                fileName: string;
+                uploadPartUrls: Array<{
+                    uploadUrl: string;
+                    authorizationToken: string;
+                }>;
+            };
+        };
     }>;
+    finishLargeFile(baseUrl: string, apiKey: string, fileId: string, partSha1Array: string[]): Promise<any>;
     getResultsForUpload(baseUrl: string, apiKey: string, uploadId: string): Promise<{
         statusCode?: number;
         results?: import("../types/generated/schema.types").components["schemas"]["TResultResponse"][];

package/dist/gateways/api-gateway.js

@@ -99,9 +99,9 @@ exports.ApiGateway = {
         await finished(Readable.fromWeb(res.body).pipe(fileStream));
     },
     // eslint-disable-next-line max-params
-    async finaliseUpload(baseUrl, apiKey, id, metadata, path, sha) {
+    async finaliseUpload(baseUrl, apiKey, id, metadata, path, sha, supabaseSuccess, backblazeSuccess) {
         const res = await fetch(`${baseUrl}/uploads/finaliseUpload`, {
-            body: JSON.stringify({ id, metadata, path, sha }),
+            body: JSON.stringify({ id, metadata, path, sha, supabaseSuccess, backblazeSuccess }),
             headers: {
                 'content-type': 'application/json',
                 'x-app-api-key': apiKey,
@@ -113,9 +113,9 @@ exports.ApiGateway = {
         }
         return res.json();
     },
-    async getBinaryUploadUrl(baseUrl, apiKey, platform) {
+    async getBinaryUploadUrl(baseUrl, apiKey, platform, fileSize) {
         const res = await fetch(`${baseUrl}/uploads/getBinaryUploadUrl`, {
-            body: JSON.stringify({ platform }),
+            body: JSON.stringify({ platform, fileSize }),
             headers: {
                 'content-type': 'application/json',
                 'x-app-api-key': apiKey,
@@ -127,6 +127,20 @@ exports.ApiGateway = {
         }
         return res.json();
     },
+    async finishLargeFile(baseUrl, apiKey, fileId, partSha1Array) {
+        const res = await fetch(`${baseUrl}/uploads/finishLargeFile`, {
+            body: JSON.stringify({ fileId, partSha1Array }),
+            headers: {
+                'content-type': 'application/json',
+                'x-app-api-key': apiKey,
+            },
+            method: 'POST',
+        });
+        if (!res.ok) {
+            await this.handleApiError(res, 'Failed to finish large file');
+        }
+        return res.json();
+    },
     async getResultsForUpload(baseUrl, apiKey, uploadId) {
         // TODO: merge with getUploadStatus
         const res = await fetch(`${baseUrl}/results/${uploadId}`, {

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,75 @@ 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 ===`);
+                console.error(`[DEBUG] Exception caught:`, 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)}`);
+                if (error instanceof Error && error.stack) {
+                    console.error(`[DEBUG] Error stack:\n${error.stack}`);
+                }
+                // Log additional context
+                console.error(`[DEBUG] Upload context:`);
+                console.error(`[DEBUG] - Environment: ${env}`);
+                console.error(`[DEBUG] - Supabase URL: ${SUPABASE_URL}`);
+                console.error(`[DEBUG] - Upload path: ${path}`);
+                console.error(`[DEBUG] - File name: ${file.name}`);
+                console.error(`[DEBUG] - File size: ${file.size} bytes`);
+                // Check for common network errors
+                if (error instanceof Error) {
+                    const errorMsg = error.message.toLowerCase();
+                    if (errorMsg.includes('econnrefused') || errorMsg.includes('connection refused')) {
+                        console.error(`[DEBUG] Network error: Connection refused - check internet connectivity`);
+                    }
+                    else if (errorMsg.includes('etimedout') || errorMsg.includes('timeout')) {
+                        console.error(`[DEBUG] Network error: Connection timeout - check internet connectivity or try again`);
+                    }
+                    else if (errorMsg.includes('enotfound') || errorMsg.includes('not found')) {
+                        console.error(`[DEBUG] Network error: DNS lookup failed - check internet connectivity`);
+                    }
+                    else if (errorMsg.includes('econnreset') || errorMsg.includes('connection reset') || errorMsg.includes('connection lost')) {
+                        console.error(`[DEBUG] Network error: Connection reset/lost - network unstable or interrupted`);
+                    }
+                    else if (errorMsg.includes('network')) {
+                        console.error(`[DEBUG] Network-related error detected - check internet connectivity`);
+                    }
+                }
+            }
+            // Re-throw with additional context
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            throw new Error(`Supabase upload error: ${errorMsg}`);
         }
     }
 }

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