@devicecloud.dev/dcd 4.1.6 → 4.1.9-beta.0

package/dist/commands/cloud.d.ts

@@ -55,7 +55,6 @@ export default class Cloud extends Command {
         'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'skip-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/commands/cloud.js

@@ -100,10 +100,10 @@ class Cloud extends core_1.Command {
             debugFlag = debug === true;
             jsonFile = flags['json-file'] === 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}`);
+                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;
@@ -146,18 +146,18 @@ class Cloud extends core_1.Command {
             try {
                 compatibilityData = await (0, compatibility_1.fetchCompatibilityData)(apiUrl, apiKey);
                 if (debug) {
-                    this.log('DEBUG: Successfully fetched compatibility data from API');
+                    this.log('[DEBUG] Successfully fetched compatibility data from API');
                 }
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
                 if (debug) {
-                    this.log(`DEBUG: Failed to fetch compatibility data from API: ${errorMessage}`);
+                    this.log(`[DEBUG] Failed to fetch compatibility data from API: ${errorMessage}`);
                 }
                 throw new Error(`Failed to fetch device compatibility data: ${errorMessage}. Please check your API key and connection.`);
             }
             if (debug) {
-                this.log(`DEBUG: API URL: ${apiUrl}`);
+                this.log(`[DEBUG] API URL: ${apiUrl}`);
             }
             // Resolve and validate Maestro version using API data
             const resolvedMaestroVersion = this.versionService.resolveMaestroVersion(maestroVersion, compatibilityData, {
@@ -176,18 +176,18 @@ class Cloud extends core_1.Command {
                 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(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.'));
+                this.log(styling_1.colors.info('ℹ') + '  ' + styling_1.colors.dim('Note: runnerType gpu1 is Android-only (Pixel 7, API Level 34 or 35), available to all users.'));
             }
             const { firstFile, secondFile } = args;
             let finalBinaryId = appBinaryId;
             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] 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'}`);
             }
             if (appBinaryId) {
                 if (secondFile) {
@@ -209,12 +209,12 @@ class Cloud extends core_1.Command {
                 flowFile += '/';
             }
             if (debug) {
-                this.log(`DEBUG: Resolved flow file path: ${flowFile}`);
+                this.log(`[DEBUG] Resolved flow file path: ${flowFile}`);
             }
             let executionPlan;
             try {
                 if (debug) {
-                    this.log('DEBUG: Generating execution plan...');
+                    this.log('[DEBUG] Generating execution plan...');
                 }
                 executionPlan = await (0, execution_plan_service_1.plan)({
                     input: flowFile,
@@ -225,24 +225,24 @@ class Cloud extends core_1.Command {
                     debug,
                 });
                 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}`);
+                    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}`);
+                    this.log(`[DEBUG] Error generating execution plan: ${error}`);
                 }
                 throw error;
             }
             const { allExcludeTags, allIncludeTags, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, } = 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(', ')}`);
+                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,
@@ -257,12 +257,12 @@ class Cloud extends core_1.Command {
                     commonRoot = folderPath;
             }
             if (debug) {
-                this.log(`DEBUG: Common root directory: ${commonRoot}`);
+                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}`);
+                this.log(`[DEBUG] Sequential flows: ${sequentialFlows.join(', ')}`);
+                this.log(`[DEBUG] Continue on failure: ${continueOnFailure}`);
             }
             if (!appBinaryId) {
                 if (!(flowFile && finalAppFile)) {
@@ -273,7 +273,7 @@ class Cloud extends core_1.Command {
                 }
                 if (finalAppFile.endsWith('.zip')) {
                     if (debug) {
-                        this.log(`DEBUG: Verifying iOS app zip file: ${finalAppFile}`);
+                        this.log(`[DEBUG] Verifying iOS app zip file: ${finalAppFile}`);
                     }
                     await (0, methods_1.verifyAppZip)(finalAppFile);
                 }
@@ -337,12 +337,19 @@ class Cloud extends core_1.Command {
                 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}`);
+                    this.log(`[DEBUG] Uploading binary file: ${finalAppFile}`);
                 }
-                const binaryId = await (0, methods_1.uploadBinary)(finalAppFile, apiUrl, apiKey, ignoreShaCheck, !json, debug);
+                const binaryId = await (0, methods_1.uploadBinary)({
+                    apiKey,
+                    apiUrl,
+                    debug,
+                    filePath: finalAppFile,
+                    ignoreShaCheck,
+                    log: !json,
+                });
                 finalBinaryId = binaryId;
                 if (debug) {
-                    this.log(`DEBUG: Binary uploaded with ID: ${binaryId}`);
+                    this.log(`[DEBUG] Binary uploaded with ID: ${binaryId}`);
                 }
             }
             // finalBinaryId should always be defined after validation - fail fast if not
@@ -376,16 +383,15 @@ class Cloud extends core_1.Command {
                 retry,
                 runnerType,
                 showCrosshairs: flags['show-crosshairs'],
-                skipChromeOnboarding: flags['skip-chrome-onboarding'],
             });
             if (debug) {
-                this.log(`DEBUG: Submitting flow upload request to ${apiUrl}/uploads/flow`);
+                this.log(`[DEBUG] Submitting flow upload request to ${apiUrl}/uploads/flow`);
             }
             const { message, results } = await api_gateway_1.ApiGateway.uploadFlow(apiUrl, apiKey, testFormData);
             if (debug) {
-                this.log(`DEBUG: Flow upload response received`);
-                this.log(`DEBUG: Message: ${message}`);
-                this.log(`DEBUG: Results count: ${results?.length || 0}`);
+                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);
@@ -403,7 +409,7 @@ class Cloud extends core_1.Command {
             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`);
+                    this.log(`[DEBUG] Async flag is set, not waiting for results`);
                 }
                 const jsonOutput = {
                     consoleUrl: url,
@@ -517,8 +523,8 @@ 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}`);
+                this.log(`[DEBUG] Error in command execution: ${error.message}`);
+                this.log(`[DEBUG] Error stack: ${error.stack}`);
             }
             if (error instanceof Error && error.message === 'RUN_FAILED') {
                 if (jsonFile) {

package/dist/commands/upload.js

@@ -42,7 +42,14 @@ class Upload extends core_1.Command {
             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);
+            const appBinaryId = await (0, methods_1.uploadBinary)({
+                apiKey,
+                apiUrl,
+                debug,
+                filePath: appFile,
+                ignoreShaCheck,
+                log: !json,
+            });
             if (json) {
                 return { appBinaryId };
             }

package/dist/config/flags/device.flags.d.ts

@@ -10,5 +10,4 @@ export declare const deviceFlags: {
     'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'skip-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
 };

package/dist/config/flags/device.flags.js

@@ -39,8 +39,4 @@ exports.deviceFlags = {
         default: false,
         description: '[Android only] Display crosshairs for screen interactions during test execution',
     }),
-    'skip-chrome-onboarding': core_1.Flags.boolean({
-        default: false,
-        description: '[Android only] Skip Chrome browser onboarding screens when running tests',
-    }),
 };

package/dist/constants.d.ts

@@ -42,7 +42,6 @@ export declare const flags: {
     'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'skip-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

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

@@ -12,13 +12,24 @@ 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<{
-        message: string;
+    finaliseUpload(config: {
+        apiKey: string;
+        backblazeSuccess: boolean;
+        baseUrl: string;
+        id: string;
+        metadata: TAppMetadata;
+        path: string;
+        sha: string;
+        supabaseSuccess: boolean;
+    }): Promise<Record<string, never>>;
+    getBinaryUploadUrl(baseUrl: string, apiKey: string, platform: "android" | "ios", fileSize: number): Promise<{
         path: string;
-        token: string;
+        tempPath: string;
+        finalPath: string;
         id: string;
+        b2?: import("../types/generated/schema.types").components["schemas"]["B2UploadStrategy"];
     }>;
+    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

@@ -29,6 +29,15 @@ exports.ApiGateway = {
                 throw new Error(`Authentication failed. Please check your API key.`);
             }
             case 403: {
+                // For 403, use the server's error message directly as it's now detailed
+                // If the message suggests an API key issue, provide additional guidance
+                if (userMessage.toLowerCase().includes('api key')) {
+                    throw new Error(`${userMessage}\n\nTroubleshooting steps:\n` +
+                        `  1. Verify DEVICE_CLOUD_API_KEY environment variable is set\n` +
+                        `  2. Check you're using the correct API key for this environment\n` +
+                        `  3. Ensure the API key hasn't been deleted or revoked\n` +
+                        `  4. Confirm you're connecting to the correct API URL`);
+                }
                 throw new Error(`Access denied. ${userMessage}`);
             }
             case 404: {
@@ -98,10 +107,17 @@ exports.ApiGateway = {
         const fileStream = createWriteStream(artifactsPath, { flags: 'w' });
         await finished(Readable.fromWeb(res.body).pipe(fileStream));
     },
-    // eslint-disable-next-line max-params
-    async finaliseUpload(baseUrl, apiKey, id, metadata, path, sha) {
+    async finaliseUpload(config) {
+        const { baseUrl, apiKey, id, metadata, path, sha, supabaseSuccess, backblazeSuccess } = config;
         const res = await fetch(`${baseUrl}/uploads/finaliseUpload`, {
-            body: JSON.stringify({ id, metadata, path, sha }),
+            body: JSON.stringify({
+                backblazeSuccess,
+                id,
+                metadata,
+                path, // This is tempPath for TUS uploads
+                sha,
+                supabaseSuccess,
+            }),
             headers: {
                 'content-type': 'application/json',
                 'x-app-api-key': apiKey,
@@ -113,9 +129,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 +143,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,33 @@ export declare class SupabaseGateway {
         SUPABASE_PUBLIC_KEY: string;
         SUPABASE_URL: string;
     };
+    /**
+     * Upload to Supabase using resumable uploads (TUS protocol)
+     * Uploads to staging location (uploads/{id}/) using anon key
+     * File is later moved to final location by API after finalization
+     * @param env - Environment (dev or prod)
+     * @param path - Staging storage path (uploads/{id}/file.ext)
+     * @param file - File to upload
+     * @param debug - Enable debug logging
+     * @param onProgress - Optional callback for upload progress (bytesUploaded, bytesTotal)
+     * @returns Promise that resolves when upload completes
+     */
+    static uploadResumable(env: 'dev' | 'prod', path: string, file: File, debug?: boolean, onProgress?: (bytesUploaded: number, bytesTotal: number) => void): Promise<void>;
     static uploadToSignedUrl(env: 'dev' | 'prod', path: string, token: string, file: File, debug?: boolean): Promise<void>;
+    /**
+     * Logs network error details for debugging
+     * @param error - Error object to analyze for network-related issues
+     * @returns void
+     */
+    private static logNetworkError;
+    /**
+     * Logs upload exception details for debugging
+     * @param error - Exception that occurred during upload
+     * @param env - Environment (dev or prod)
+     * @param supabaseUrl - Supabase URL being used
+     * @param path - Upload path
+     * @param file - File being uploaded
+     * @returns void
+     */
+    private static logUploadException;
 }

package/dist/gateways/supabase-gateway.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SupabaseGateway = void 0;
 const supabase_js_1 = require("@supabase/supabase-js");
+const tus = require("tus-js-client");
 class SupabaseGateway {
     static SB = {
         dev: {
@@ -16,6 +17,108 @@ class SupabaseGateway {
     static getSupabaseKeys(env) {
         return this.SB[env];
     }
+    /**
+     * Upload to Supabase using resumable uploads (TUS protocol)
+     * Uploads to staging location (uploads/{id}/) using anon key
+     * File is later moved to final location by API after finalization
+     * @param env - Environment (dev or prod)
+     * @param path - Staging storage path (uploads/{id}/file.ext)
+     * @param file - File to upload
+     * @param debug - Enable debug logging
+     * @param onProgress - Optional callback for upload progress (bytesUploaded, bytesTotal)
+     * @returns Promise that resolves when upload completes
+     */
+    static async uploadResumable(env, path, file, debug = false, onProgress) {
+        const { SUPABASE_PUBLIC_KEY, SUPABASE_URL } = this.getSupabaseKeys(env);
+        // Extract project ID from Supabase URL for the storage endpoint
+        // Format: https://project-id.supabase.co or https://cloud.devicecloud.dev (custom domain)
+        let projectId;
+        if (SUPABASE_URL.includes('.supabase.co')) {
+            projectId = SUPABASE_URL.replace('https://', '').split('.')[0];
+        }
+        else {
+            // For custom domains like cloud.devicecloud.dev, we need the project ref
+            // This is the dev environment project ref
+            projectId = env === 'dev' ? 'lbmsowehtjwnqlurpemb' : 'pgydnphbimetinsgfkbo';
+        }
+        const storageUrl = `https://${projectId}.storage.supabase.co`;
+        if (debug) {
+            console.log(`[DEBUG] Resumable upload starting...`);
+            console.log(`[DEBUG] Storage URL: ${storageUrl}`);
+            console.log(`[DEBUG] Upload path: ${path}`);
+            console.log(`[DEBUG] File name: ${file.name}`);
+            console.log(`[DEBUG] File size: ${(file.size / 1024 / 1024).toFixed(2)} MB`);
+        }
+        // Convert File to Buffer for Node.js tus-js-client
+        // In Node.js environment, tus-js-client expects Buffer or Readable stream, not File
+        const fileBuffer = Buffer.from(await file.arrayBuffer());
+        if (debug) {
+            console.log(`[DEBUG] Converted File to Buffer (${fileBuffer.length} bytes)`);
+        }
+        return new Promise((resolve, reject) => {
+            const upload = new tus.Upload(fileBuffer, {
+                // TUS endpoint for Supabase Storage
+                endpoint: `${storageUrl}/storage/v1/upload/resumable`,
+                // Retry configuration - will retry 5 times with increasing delays
+                retryDelays: [0, 3000, 5000, 10_000, 20_000],
+                // Authentication and headers
+                // Use anon key for staging uploads to uploads/* folder
+                headers: {
+                    authorization: `Bearer ${SUPABASE_PUBLIC_KEY}`,
+                    'x-upsert': 'true', // Allow overwriting existing files
+                },
+                // Upload metadata
+                metadata: {
+                    bucketName: 'organizations',
+                    objectName: path,
+                    contentType: file.type || 'application/octet-stream',
+                    cacheControl: '3600',
+                },
+                // Chunk size must be 6MB for Supabase
+                chunkSize: 6 * 1024 * 1024,
+                // Remove fingerprint on success to allow re-uploading identical files
+                removeFingerprintOnSuccess: true,
+                // Upload data during creation for better performance
+                uploadDataDuringCreation: true,
+                // Progress callback
+                onProgress(bytesUploaded, bytesTotal) {
+                    if (debug) {
+                        const percentage = ((bytesUploaded / bytesTotal) * 100).toFixed(2);
+                        console.log(`[DEBUG] Upload progress: ${(bytesUploaded / 1024 / 1024).toFixed(2)} MB / ${(bytesTotal / 1024 / 1024).toFixed(2)} MB (${percentage}%)`);
+                    }
+                    // Call user-provided progress callback if available
+                    if (onProgress) {
+                        onProgress(bytesUploaded, bytesTotal);
+                    }
+                },
+                // Error handler
+                onError(error) {
+                    if (debug) {
+                        console.error(`[DEBUG] === RESUMABLE UPLOAD ERROR ===`);
+                        console.error(`[DEBUG] Error:`, error);
+                        console.error(`[DEBUG] Error message: ${error.message}`);
+                        if (error.stack) {
+                            console.error(`[DEBUG] Stack trace:\n${error.stack}`);
+                        }
+                    }
+                    reject(new Error(`Resumable upload failed: ${error.message}`));
+                },
+                // Success handler
+                onSuccess() {
+                    if (debug) {
+                        console.log(`[DEBUG] Resumable upload completed successfully`);
+                        console.log(`[DEBUG] Upload path: ${path}`);
+                    }
+                    resolve();
+                },
+            });
+            // Start the upload
+            if (debug) {
+                console.log(`[DEBUG] Starting TUS upload...`);
+            }
+            upload.start();
+        });
+    }
     static async uploadToSignedUrl(env, path, token, file, debug = false) {
         const { SUPABASE_PUBLIC_KEY, SUPABASE_URL } = this.getSupabaseKeys(env);
         if (debug) {
@@ -48,26 +151,63 @@ class SupabaseGateway {
         }
         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`);
-                    }
-                }
+                this.logUploadException(error, env, SUPABASE_URL, path, file);
             }
-            throw error;
+            // Re-throw with additional context
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            throw new Error(`Supabase upload error: ${errorMsg}`);
+        }
+    }
+    /**
+     * Logs network error details for debugging
+     * @param error - Error object to analyze for network-related issues
+     * @returns void
+     */
+    static logNetworkError(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`);
+        }
+    }
+    /**
+     * Logs upload exception details for debugging
+     * @param error - Exception that occurred during upload
+     * @param env - Environment (dev or prod)
+     * @param supabaseUrl - Supabase URL being used
+     * @param path - Upload path
+     * @param file - File being uploaded
+     * @returns void
+     */
+    static logUploadException(error, env, supabaseUrl, path, file) {
+        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: ${supabaseUrl}`);
+        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) {
+            this.logNetworkError(error);
         }
     }
 }

package/dist/methods.d.ts

@@ -3,7 +3,15 @@ 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, debug?: boolean) => Promise<string>;
+interface UploadBinaryConfig {
+    apiKey: string;
+    apiUrl: string;
+    debug?: boolean;
+    filePath: string;
+    ignoreShaCheck?: boolean;
+    log?: boolean;
+}
+export declare const uploadBinary: (config: UploadBinaryConfig) => Promise<string>;
 /**
  * Writes JSON data to a file with error handling
  * @param filePath - Path to the output JSON file
@@ -21,3 +29,4 @@ export declare const writeJSONFile: (filePath: string, data: unknown, logger: {
  * @returns Formatted duration string (e.g. "2m 30s" or "45s")
  */
 export declare const formatDurationSeconds: (durationSeconds: number) => string;
+export {};