@devicecloud.dev/dcd 4.2.0 → 4.2.2

package/dist/methods.js

@@ -115,7 +115,11 @@ const uploadBinary = async (config) => {
         return uploadId;
     }
     catch (error) {
+        if (log) {
+            core_1.ux.action.stop(styling_1.colors.error('✗ Failed'));
+        }
         if (debug) {
+            console.error('[DEBUG] === BINARY UPLOAD FAILED ===');
             console.error('[DEBUG] Binary upload failed:', 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)}`);
@@ -124,6 +128,14 @@ const uploadBinary = async (config) => {
             }
             console.error(`[DEBUG] Failed after ${Date.now() - startTime}ms`);
         }
+        // Add helpful context for common errors
+        if (error instanceof Error) {
+            if (error.name === 'NetworkError') {
+                throw error; // NetworkError already has detailed troubleshooting info
+            }
+            // Re-throw with original message
+            throw error;
+        }
         throw error;
     }
 };
@@ -144,6 +156,31 @@ async function prepareFileForUpload(filePath, debug, startTime) {
         if (debug) {
             console.log('[DEBUG] Compressing .app folder to zip...');
         }
+        // Validate that the .app directory exists before attempting to compress
+        // Without this check, archiver silently creates an empty 22-byte zip for non-existent paths
+        try {
+            await (0, promises_1.access)(filePath);
+        }
+        catch {
+            // Provide helpful error message for common quoting issues
+            const hasQuotes = filePath.includes("'") || filePath.includes('"');
+            const errorMessage = [
+                `App folder not found: ${filePath}`,
+                '',
+                hasQuotes
+                    ? 'Note: Your path contains quote characters. If the folder name has spaces, ensure quotes wrap the entire path:'
+                    : 'Note: If your folder name contains spaces, wrap the entire path in quotes:',
+                hasQuotes
+                    ? `  ❌ Wrong: --app-file=./path/'My App Name.app'  (quotes become literal characters)`
+                    : `  Example: --app-file="./path/My App Name.app"`,
+                hasQuotes
+                    ? `  ✅ Right: --app-file="./path/My App Name.app"   (quotes processed by shell)`
+                    : '',
+            ]
+                .filter(Boolean)
+                .join('\n');
+            throw new Error(errorMessage);
+        }
         const zippedAppBlob = await (0, exports.compressFolderToBlob)(filePath);
         file = new File([zippedAppBlob], filePath + '.zip');
         if (debug) {
@@ -225,9 +262,18 @@ async function checkExistingUpload(apiUrl, apiKey, sha, debug) {
     }
     catch (error) {
         if (debug) {
-            console.error('[DEBUG] SHA check failed (continuing with upload):', error);
+            console.error('[DEBUG] === SHA CHECK FAILED ===');
+            console.error('[DEBUG] Continuing with upload despite SHA check failure');
             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] Stack trace:\n${error.stack}`);
+            }
+        }
+        else if (error instanceof Error && error.name === 'NetworkError') {
+            // Even without debug, show a warning for network errors
+            console.warn('\nWarning: Failed to check for existing binary upload (network error).');
+            console.warn('Continuing with new upload...\n');
         }
         return { exists: false };
     }
@@ -350,21 +396,37 @@ async function requestUploadPaths(apiUrl, apiKey, filePath, fileSize, debug) {
         console.log(`[DEBUG] Target endpoint: ${apiUrl}/uploads/getBinaryUploadUrl`);
         console.log(`[DEBUG] Platform: ${platform}`);
     }
-    const urlRequestStartTime = Date.now();
-    const { id, tempPath, finalPath, b2 } = await api_gateway_1.ApiGateway.getBinaryUploadUrl(apiUrl, apiKey, platform, fileSize);
-    if (debug) {
-        const hasStrategy = b2 && typeof b2 === 'object' && 'strategy' in b2;
-        console.log(`[DEBUG] Upload URL request completed in ${Date.now() - urlRequestStartTime}ms`);
-        console.log(`[DEBUG] Upload ID: ${id}`);
-        console.log(`[DEBUG] Temp path (TUS upload): ${tempPath}`);
-        console.log(`[DEBUG] Final path (after finalize): ${finalPath}`);
-        console.log(`[DEBUG] Backblaze upload URL provided: ${Boolean(b2)}`);
-        if (hasStrategy)
-            console.log(`[DEBUG] Backblaze strategy: ${b2.strategy}`);
-    }
-    if (!tempPath)
-        throw new Error('No upload path provided by API');
-    return { b2, finalPath, id, tempPath };
+    try {
+        const urlRequestStartTime = Date.now();
+        const { id, tempPath, finalPath, b2 } = await api_gateway_1.ApiGateway.getBinaryUploadUrl(apiUrl, apiKey, platform, fileSize);
+        if (debug) {
+            const hasStrategy = b2 && typeof b2 === 'object' && 'strategy' in b2;
+            console.log(`[DEBUG] Upload URL request completed in ${Date.now() - urlRequestStartTime}ms`);
+            console.log(`[DEBUG] Upload ID: ${id}`);
+            console.log(`[DEBUG] Temp path (TUS upload): ${tempPath}`);
+            console.log(`[DEBUG] Final path (after finalize): ${finalPath}`);
+            console.log(`[DEBUG] Backblaze upload URL provided: ${Boolean(b2)}`);
+            if (hasStrategy)
+                console.log(`[DEBUG] Backblaze strategy: ${b2.strategy}`);
+        }
+        if (!tempPath)
+            throw new Error('No upload path provided by API');
+        return { b2, finalPath, id, tempPath };
+    }
+    catch (error) {
+        if (debug) {
+            console.error('[DEBUG] === FAILED TO GET UPLOAD URL ===');
+            console.error(`[DEBUG] Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Add context to the error
+        if (error instanceof Error) {
+            if (error.name === 'NetworkError') {
+                throw new Error(`Failed to request upload URL from API.\n\n${error.message}`);
+            }
+            throw new Error(`Failed to request upload URL: ${error.message}`);
+        }
+        throw error;
+    }
 }
 /**
  * Extracts metadata from the binary file
@@ -529,10 +591,25 @@ async function uploadToBackblaze(uploadUrl, authorizationToken, fileName, file,
     }
     catch (error) {
         if (debug) {
+            console.error('[DEBUG] === BACKBLAZE UPLOAD EXCEPTION ===');
             console.error('[DEBUG] Backblaze 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)}`);
+            if (error instanceof Error && error.stack) {
+                console.error(`[DEBUG] Stack trace:\n${error.stack}`);
+            }
+        }
+        // Provide more specific error messages for common network errors
+        if (error instanceof TypeError && error.message === 'fetch failed') {
+            if (debug) {
+                console.error('[DEBUG] Network error detected - could be DNS, connection, or SSL issue');
+            }
+            console.warn('Warning: Backblaze upload failed due to network error');
+        }
+        else {
+            // Don't throw - we don't want Backblaze failures to block the primary upload
+            console.warn(`Warning: Backblaze upload failed: ${error instanceof Error ? error.message : String(error)}`);
         }
-        // Don't throw - we don't want Backblaze failures to block the primary upload
-        console.warn(`Warning: Backblaze upload failed: ${error instanceof Error ? error.message : String(error)}`);
         return false;
     }
 }
@@ -608,30 +685,50 @@ async function uploadLargeFileToBackblaze(config) {
             if (debug) {
                 console.log(`[DEBUG] Uploading part ${partNumber}/${uploadPartUrls.length} (${(partLength / 1024 / 1024).toFixed(2)} MB, SHA1: ${sha1Hex})`);
             }
-            const response = await fetch(uploadPartUrls[i].uploadUrl, {
-                body: new Uint8Array(partBuffer),
-                headers: {
-                    Authorization: uploadPartUrls[i].authorizationToken,
-                    'Content-Length': partLength.toString(),
-                    'X-Bz-Content-Sha1': sha1Hex,
-                    'X-Bz-Part-Number': partNumber.toString(),
-                },
-                method: 'POST',
-            });
-            if (!response.ok) {
-                const errorText = await response.text();
-                if (debug) {
-                    console.error(`[DEBUG] Part ${partNumber} upload failed with status ${response.status}: ${errorText}`);
+            try {
+                const response = await fetch(uploadPartUrls[i].uploadUrl, {
+                    body: new Uint8Array(partBuffer),
+                    headers: {
+                        Authorization: uploadPartUrls[i].authorizationToken,
+                        'Content-Length': partLength.toString(),
+                        'X-Bz-Content-Sha1': sha1Hex,
+                        'X-Bz-Part-Number': partNumber.toString(),
+                    },
+                    method: 'POST',
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    if (debug) {
+                        console.error(`[DEBUG] Part ${partNumber} upload failed with status ${response.status}: ${errorText}`);
+                    }
+                    throw new Error(`Part ${partNumber} upload failed with status ${response.status}`);
+                }
+            }
+            catch (error) {
+                if (error instanceof TypeError && error.message === 'fetch failed') {
+                    if (debug) {
+                        console.error(`[DEBUG] Network error uploading part ${partNumber} - could be DNS, connection, or SSL issue`);
+                    }
+                    throw new Error(`Part ${partNumber} upload failed due to network error`);
                 }
-                throw new Error(`Part ${partNumber} upload failed with status ${response.status}`);
+                throw error;
             }
             if (debug) {
                 console.log(`[DEBUG] Part ${partNumber}/${uploadPartUrls.length} uploaded successfully`);
             }
         }
+        // Validate all parts were uploaded
+        if (partSha1Array.length !== uploadPartUrls.length) {
+            const errorMsg = `Part count mismatch: uploaded ${partSha1Array.length} parts but expected ${uploadPartUrls.length}`;
+            if (debug) {
+                console.error(`[DEBUG] ${errorMsg}`);
+            }
+            throw new Error(errorMsg);
+        }
         // Finish the large file upload
         if (debug) {
             console.log('[DEBUG] Finishing large file upload...');
+            console.log(`[DEBUG] Finalizing ${partSha1Array.length} parts with fileId: ${fileId}`);
         }
         await api_gateway_1.ApiGateway.finishLargeFile(apiUrl, apiKey, fileId, partSha1Array);
         if (debug) {
@@ -641,10 +738,22 @@ async function uploadLargeFileToBackblaze(config) {
     }
     catch (error) {
         if (debug) {
+            console.error('[DEBUG] === BACKBLAZE LARGE FILE UPLOAD EXCEPTION ===');
             console.error('[DEBUG] Large file 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)}`);
+            if (error instanceof Error && error.stack) {
+                console.error(`[DEBUG] Stack trace:\n${error.stack}`);
+            }
+        }
+        // Provide more specific error messages
+        if (error instanceof Error && error.message.includes('network error')) {
+            console.warn('Warning: Backblaze large file upload failed due to network error');
+        }
+        else {
+            // Don't throw - we don't want Backblaze failures to block the primary upload
+            console.warn(`Warning: Backblaze large file upload failed: ${error instanceof Error ? error.message : String(error)}`);
         }
-        // Don't throw - we don't want Backblaze failures to block the primary upload
-        console.warn(`Warning: Backblaze large file upload failed: ${error instanceof Error ? error.message : String(error)}`);
         return false;
     }
 }

package/dist/services/execution-plan.service.js

@@ -255,6 +255,15 @@ async function plan(options) {
     if (debug) {
         console.log(`[DEBUG] Sequential flows resolved: ${flowsToRunInSequence.length} flow(s)`);
     }
+    // Validate that all specified flows were found
+    if (workspaceConfig.executionOrder?.flowsOrder &&
+        workspaceConfig.executionOrder.flowsOrder.length > 0 &&
+        flowsToRunInSequence.length === 0) {
+        throw new Error(`executionOrder specified ${workspaceConfig.executionOrder.flowsOrder.length} flow(s) but none were found.\n\n` +
+            `Expected flows: ${workspaceConfig.executionOrder.flowsOrder.join(', ')}\n` +
+            `Available flow names: ${Object.keys(pathsByName).join(', ')}\n\n` +
+            `Hint: Flow names come from either the 'name' field in the flow config or the filename without extension.`);
+    }
     const normalFlows = allFlows
         .filter((flow) => !flowsToRunInSequence.includes(flow))
         .sort((a, b) => a.localeCompare(b));

package/dist/services/execution-plan.utils.js

@@ -27,10 +27,8 @@ function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
     }
     if (namesInOrder.length === 0) {
         const notFound = [...orderSet].filter((item) => !availableNames.includes(item));
-        if (debug) {
-            console.log(`[DEBUG] getFlowsToRunInSequence: No flows matched, not found: [${notFound.join(', ')}]`);
-        }
-        return [];
+        throw new Error(`Could not find flows specified in executionOrder.flowsOrder: ${notFound.join(', ')}\n\n` +
+            `Available flow names:\n${availableNames.join('\n')}`);
     }
     const result = [...orderSet].filter((item) => namesInOrder.includes(item));
     if (result.length === 0) {
@@ -47,12 +45,10 @@ function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
         return resolvedPaths;
     }
     else {
-        if (debug) {
-            console.log('[DEBUG] getFlowsToRunInSequence: Order does not match, returning []');
-            console.log(`[DEBUG] Expected order: [${flowOrder.slice(0, result.length).join(', ')}]`);
-            console.log(`[DEBUG] Actual result: [${result.join(', ')}]`);
-        }
-        return [];
+        throw new Error(`Flow order mismatch in executionOrder.flowsOrder.\n\n` +
+            `Expected order: [${flowOrder.slice(0, result.length).join(', ')}]\n` +
+            `Actual order: [${result.join(', ')}]\n\n` +
+            `Please ensure flows are specified in the correct order.`);
     }
 }
 function isFlowFile(filePath) {

package/dist/services/test-submission.service.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestSubmissionService = void 0;
+const node_crypto_1 = require("node:crypto");
 const path = require("node:path");
 const methods_1 = require("../methods");
 const mimeTypeLookupByExtension = {
@@ -50,10 +51,14 @@ class TestSubmissionService {
             ]),
         ], commonRoot);
         this.logDebug(debug, logger, `[DEBUG] Compressed file size: ${buffer.length} bytes`);
+        // Calculate SHA-256 hash of the flow ZIP
+        const sha = (0, node_crypto_1.createHash)('sha256').update(buffer).digest('hex');
+        this.logDebug(debug, logger, `[DEBUG] Flow ZIP SHA-256: ${sha}`);
         const blob = new Blob([buffer], {
             type: mimeTypeLookupByExtension.zip,
         });
         testFormData.set('file', blob, 'flowFile.zip');
+        testFormData.set('sha', sha);
         testFormData.set('appBinaryId', appBinaryId);
         testFormData.set('testFileNames', JSON.stringify(this.normalizePaths(testFileNames, commonRoot)));
         testFormData.set('flowMetadata', JSON.stringify(this.normalizePathMap(flowMetadata, commonRoot)));

package/dist/types/domain/device.types.d.ts

@@ -31,6 +31,7 @@ export declare enum EAndroidApiLevels {
     'thirtyFive' = "35",
     'thirtyFour' = "34",
     'thirtyOne' = "31",
+    'thirtySix' = "36",
     'thirtyThree' = "33",
     'thirtyTwo' = "32",
     'twentyNine' = "29"

package/dist/types/domain/device.types.js

@@ -38,6 +38,7 @@ var EAndroidApiLevels;
     EAndroidApiLevels["thirtyFive"] = "35";
     EAndroidApiLevels["thirtyFour"] = "34";
     EAndroidApiLevels["thirtyOne"] = "31";
+    EAndroidApiLevels["thirtySix"] = "36";
     EAndroidApiLevels["thirtyThree"] = "33";
     EAndroidApiLevels["thirtyTwo"] = "32";
     EAndroidApiLevels["twentyNine"] = "29";

package/dist/types/generated/schema.types.d.ts

@@ -538,7 +538,7 @@ export interface components {
              */
             file: string;
             /** @enum {string} */
-            androidApiLevel?: "29" | "30" | "31" | "32" | "33" | "34" | "35";
+            androidApiLevel?: "29" | "30" | "31" | "32" | "33" | "34" | "35" | "36";
             /** @enum {string} */
             androidDevice?: "pixel-6" | "pixel-6-pro" | "pixel-7" | "pixel-7-pro" | "generic-tablet";
             apiKey?: string;