@lambdatest/smartui-cli 4.1.28 → 4.1.30

package/dist/index.cjs

@@ -904,6 +904,12 @@ var SnapshotSchema = {
               items: { type: "string", minLength: 1 },
               uniqueItems: true,
               errorMessage: "Invalid snapshot options; ignoreDOM xpath array must have unique and non-empty items"
+            },
+            coordinates: {
+              type: "array",
+              items: { type: "string", minLength: 1 },
+              uniqueItems: true,
+              errorMessage: "Invalid snapshot options; ignoreDOM coordinates array must have unique and non-empty items"
             }
           }
         },
@@ -933,6 +939,12 @@ var SnapshotSchema = {
               items: { type: "string", minLength: 1 },
               uniqueItems: true,
               errorMessage: "Invalid snapshot options; selectDOM xpath array must have unique and non-empty items"
+            },
+            coordinates: {
+              type: "array",
+              items: { type: "string", minLength: 1 },
+              uniqueItems: true,
+              errorMessage: "Invalid snapshot options; selectDOM coordinates array must have unique and non-empty items"
             }
           }
         },
@@ -1716,6 +1728,180 @@ function calculateVariantCountFromSnapshot(snapshot, globalConfig) {
   }
   return variantCount;
 }
+function startPdfPolling(ctx) {
+  console.log(chalk__default.default.yellow("\nFetching PDF test results..."));
+  ctx.log.debug(`Starting fetching results for build: ${ctx.build.id || ctx.build.name}`);
+  if (!ctx.build.id && !ctx.build.name) {
+    ctx.log.error(chalk__default.default.red("Error: Build information not found for fetching results"));
+    return;
+  }
+  if (!ctx.env.LT_USERNAME || !ctx.env.LT_ACCESS_KEY) {
+    console.log(chalk__default.default.red("Error: LT_USERNAME and LT_ACCESS_KEY environment variables are required for fetching results"));
+    return;
+  }
+  let attempts = 0;
+  const maxAttempts = 60;
+  console.log(chalk__default.default.yellow("Waiting for results..."));
+  const interval = setInterval(() => __async(this, null, function* () {
+    attempts++;
+    try {
+      const response = yield ctx.client.fetchPdfResults(ctx);
+      if (response.screenshots) {
+        clearInterval(interval);
+        const pdfGroups = groupScreenshotsByPdf(response.screenshots);
+        const pdfsWithMismatches = countPdfsWithMismatches(pdfGroups);
+        const pagesWithMismatches = countPagesWithMismatches(response.screenshots);
+        console.log(chalk__default.default.green("\n\u2713 PDF Test Results:"));
+        console.log(chalk__default.default.green(`Build Name: ${response.build.name}`));
+        console.log(chalk__default.default.green(`Project Name: ${response.project.name}`));
+        console.log(chalk__default.default.green(`Total PDFs: ${Object.keys(pdfGroups).length}`));
+        console.log(chalk__default.default.green(`Total Pages: ${response.screenshots.length}`));
+        if (pdfsWithMismatches > 0 || pagesWithMismatches > 0) {
+          console.log(chalk__default.default.yellow(`${pdfsWithMismatches} PDFs and ${pagesWithMismatches} Pages in build ${response.build.name} have changes present.`));
+        } else {
+          console.log(chalk__default.default.green("All PDFs match the baseline."));
+        }
+        Object.entries(pdfGroups).forEach(([pdfName, pages]) => {
+          const hasMismatch = pages.some((page) => page.mismatch_percentage > 0);
+          const statusColor = hasMismatch ? chalk__default.default.yellow : chalk__default.default.green;
+          console.log(statusColor(`
+\u{1F4C4} ${pdfName} (${pages.length} pages)`));
+          pages.forEach((page) => {
+            const pageStatusColor = page.mismatch_percentage > 0 ? chalk__default.default.yellow : chalk__default.default.green;
+            console.log(pageStatusColor(`  - Page ${getPageNumber(page.screenshot_name)}: ${page.status} (Mismatch: ${page.mismatch_percentage}%)`));
+          });
+        });
+        const formattedResults = {
+          status: "success",
+          data: {
+            buildId: response.build.id,
+            buildName: response.build.name,
+            projectName: response.project.name,
+            buildStatus: response.build.build_satus,
+            pdfs: formatPdfsForOutput(pdfGroups)
+          }
+        };
+        if (ctx.options.fetchResults && ctx.options.fetchResultsFileName) {
+          const filename = ctx.options.fetchResultsFileName !== "" ? ctx.options.fetchResultsFileName : "pdf-results.json";
+          fs5__default.default.writeFileSync(filename, JSON.stringify(formattedResults, null, 2));
+          console.log(chalk__default.default.green(`
+Results saved to ${filename}`));
+        }
+        return;
+      }
+      if (attempts >= maxAttempts) {
+        clearInterval(interval);
+        console.log(chalk__default.default.red("\nTimeout: Could not fetch PDF results after 5 minutes"));
+        return;
+      }
+    } catch (error) {
+      ctx.log.debug(`Error during polling: ${error.message}`);
+      if (attempts >= maxAttempts) {
+        clearInterval(interval);
+        console.log(chalk__default.default.red("\nTimeout: Could not fetch PDF results after 5 minutes"));
+        if (error.response && error.response.data) {
+          console.log(chalk__default.default.red(`Error details: ${JSON.stringify(error.response.data)}`));
+        } else {
+          console.log(chalk__default.default.red(`Error details: ${error.message}`));
+        }
+        return;
+      }
+      process.stdout.write(chalk__default.default.yellow("."));
+    }
+  }), 1e4);
+}
+function groupScreenshotsByPdf(screenshots) {
+  const pdfGroups = {};
+  screenshots.forEach((screenshot) => {
+    const pdfName = screenshot.screenshot_name.split("#")[0];
+    if (!pdfGroups[pdfName]) {
+      pdfGroups[pdfName] = [];
+    }
+    pdfGroups[pdfName].push(screenshot);
+  });
+  return pdfGroups;
+}
+function countPdfsWithMismatches(pdfGroups) {
+  let count = 0;
+  Object.values(pdfGroups).forEach((pages) => {
+    if (pages.some((page) => page.mismatch_percentage > 0)) {
+      count++;
+    }
+  });
+  return count;
+}
+function countPagesWithMismatches(screenshots) {
+  return screenshots.filter((screenshot) => screenshot.mismatch_percentage > 0).length;
+}
+function formatPdfsForOutput(pdfGroups) {
+  return Object.entries(pdfGroups).map(([pdfName, pages]) => {
+    return {
+      pdfName,
+      pageCount: pages.length,
+      pages: pages.map((page) => ({
+        pageNumber: getPageNumber(page.screenshot_name),
+        screenshotId: page.captured_image_id,
+        mismatchPercentage: page.mismatch_percentage,
+        status: page.status,
+        screenshotUrl: page.shareable_link
+      }))
+    };
+  });
+}
+function getPageNumber(screenshotName) {
+  const parts = screenshotName.split("#");
+  return parts.length > 1 ? parts[1] : "1";
+}
+function validateCoordinates(coordString, pageHeight, pageWidth, snapshotName) {
+  const coords = coordString.split(",").map(Number);
+  if (coords.length !== 4) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, invalid coordinates format: ${coordString}. Expected: top,bottom,left,right`
+    };
+  }
+  const [top, bottom, left, right] = coords;
+  if (coords.some(isNaN)) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, invalid coordinate values: ${coordString}. All values must be numbers`
+    };
+  }
+  if (top < 0 || left < 0 || bottom < 0 || right < 0) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, invalid coordinate bounds: ${coordString}. top,left,bottom,right must be >= 0`
+    };
+  }
+  if (top >= bottom) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, invalid coordinate bounds: ${coordString}. top must be < bottom`
+    };
+  }
+  if (left >= right) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, invalid coordinate bounds: ${coordString}. left must be < right`
+    };
+  }
+  if (bottom > pageHeight) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, coordinates exceed viewport bounds: ${coordString}. bottom (${bottom}) exceeds viewport height (${pageHeight})`
+    };
+  }
+  if (right > pageWidth) {
+    return {
+      valid: false,
+      error: `for snapshot ${snapshotName}, coordinates exceed viewport bounds: ${coordString}. right (${right}) exceeds viewport width (${pageWidth})`
+    };
+  }
+  return {
+    valid: true,
+    coords: { top, bottom, left, right }
+  };
+}
 
 // src/lib/server.ts
 var uploadDomToS3ViaEnv = process.env.USE_LAMBDA_INTERNAL || false;
@@ -1764,7 +1950,6 @@ var server_default = (ctx) => __async(void 0, null, function* () {
             }
           } catch (error) {
             ctx.log.debug(`Failed to fetch capabilities for sessionId ${sessionId}: ${error.message}`);
-            console.log(`Failed to fetch capabilities for sessionId ${sessionId}: ${error.message}`);
           }
         }
         if (capsBuildId && capsBuildId !== "") {
@@ -1813,19 +1998,39 @@ var server_default = (ctx) => __async(void 0, null, function* () {
           }
         }, 1e3);
       });
-      yield ctx.client.finalizeBuild(ctx.build.id, ctx.totalSnapshots, ctx.log);
-      yield (_b = ctx.browser) == null ? void 0 : _b.close();
+      for (const [sessionId, capabilities] of ctx.sessionCapabilitiesMap.entries()) {
+        try {
+          const buildId = (capabilities == null ? void 0 : capabilities.buildId) || "";
+          const projectToken = (capabilities == null ? void 0 : capabilities.projectToken) || "";
+          const totalSnapshots = (capabilities == null ? void 0 : capabilities.snapshotCount) || 0;
+          const sessionBuildUrl = (capabilities == null ? void 0 : capabilities.buildURL) || "";
+          const testId = (capabilities == null ? void 0 : capabilities.id) || "";
+          if (buildId && projectToken) {
+            yield ctx.client.finalizeBuildForCapsWithToken(buildId, totalSnapshots, projectToken, ctx.log);
+          }
+          if (testId && buildId) {
+            buildUrls += `TestId ${testId}: ${sessionBuildUrl}
+`;
+          }
+        } catch (error) {
+          ctx.log.debug(`Error finalizing build for session ${sessionId}: ${error.message}`);
+        }
+      }
+      if (ctx.build && ctx.build.id) {
+        yield ctx.client.finalizeBuild(ctx.build.id, ctx.totalSnapshots, ctx.log);
+        let uploadCLILogsToS3 = ((_b = ctx == null ? void 0 : ctx.config) == null ? void 0 : _b.useLambdaInternal) || uploadDomToS3ViaEnv;
+        if (!uploadCLILogsToS3) {
+          ctx.log.debug(`Log file to be uploaded`);
+          let resp = yield ctx.client.getS3PreSignedURL(ctx);
+          yield ctx.client.uploadLogs(ctx, resp.data.url);
+        } else {
+          ctx.log.debug(`Skipping upload of CLI logs as useLambdaInternal is set`);
+        }
+      }
+      yield (_c = ctx.browser) == null ? void 0 : _c.close();
       if (ctx.server) {
         ctx.server.close();
       }
-      let uploadCLILogsToS3 = ((_c = ctx == null ? void 0 : ctx.config) == null ? void 0 : _c.useLambdaInternal) || uploadDomToS3ViaEnv;
-      if (!uploadCLILogsToS3) {
-        ctx.log.debug(`Log file to be uploaded`);
-        let resp = yield ctx.client.getS3PreSignedURL(ctx);
-        yield ctx.client.uploadLogs(ctx, resp.data.url);
-      } else {
-        ctx.log.debug(`Skipping upload of CLI logs as useLambdaInternal is set`);
-      }
       if (pingIntervalId !== null) {
         clearInterval(pingIntervalId);
         ctx.log.debug("Ping polling stopped immediately.");
@@ -1942,6 +2147,7 @@ var env_default = () => {
   const {
     PROJECT_TOKEN = "",
     SMARTUI_CLIENT_API_URL = "https://api.lambdatest.com/visualui/1.0",
+    SMARTUI_UPLOAD_URL = "https://api.lambdatest.com",
     SMARTUI_GIT_INFO_FILEPATH,
     SMARTUI_DO_NOT_USE_CAPTURED_COOKIES,
     HTTP_PROXY,
@@ -1964,6 +2170,7 @@ var env_default = () => {
   return {
     PROJECT_TOKEN,
     SMARTUI_CLIENT_API_URL,
+    SMARTUI_UPLOAD_URL,
     SMARTUI_GIT_INFO_FILEPATH,
     HTTP_PROXY,
     HTTPS_PROXY,
@@ -2076,7 +2283,7 @@ var authExec_default = (ctx) => {
 };
 
 // package.json
-var version = "4.1.28";
+var version = "4.1.30";
 var package_default = {
   name: "@lambdatest/smartui-cli",
   version,
@@ -2133,6 +2340,18 @@ var package_default = {
   }
 };
 var httpClient = class {
+  handleHttpError(error, log2) {
+    var _a;
+    if (error && error.response) {
+      log2.debug(`http response error: ${JSON.stringify({
+        status: error.response.status,
+        body: error.response.data
+      })}`);
+      throw new Error(((_a = error.response.data) == null ? void 0 : _a.message) || error.response.data || `HTTP ${error.response.status} error`);
+    }
+    log2.debug(`http request failed: ${error.message}`);
+    throw new Error(error.message);
+  }
   constructor({ SMARTUI_CLIENT_API_URL, PROJECT_TOKEN, PROJECT_NAME, LT_USERNAME, LT_ACCESS_KEY, SMARTUI_API_PROXY, SMARTUI_API_SKIP_CERTIFICATES }) {
     this.projectToken = PROJECT_TOKEN || "";
     this.projectName = PROJECT_NAME || "";
@@ -2189,6 +2408,8 @@ var httpClient = class {
             return this.axiosInstance(config);
           }
           return Promise.reject(error);
+        } else {
+          return Promise.reject(error);
         }
       })
     );
@@ -2715,6 +2936,61 @@ var httpClient = class {
       }
     }, ctx.log);
   }
+  uploadPdf(ctx, form, buildName) {
+    return __async(this, null, function* () {
+      form.append("projectToken", this.projectToken);
+      if (ctx.build.name !== void 0 && ctx.build.name !== "") {
+        form.append("buildName", buildName);
+      }
+      try {
+        const response = yield this.axiosInstance.request({
+          url: ctx.env.SMARTUI_UPLOAD_URL + "/pdf/upload",
+          method: "POST",
+          headers: form.getHeaders(),
+          data: form
+        });
+        ctx.log.debug(`http response: ${JSON.stringify({
+          status: response.status,
+          headers: response.headers,
+          body: response.data
+        })}`);
+        return response.data;
+      } catch (error) {
+        this.handleHttpError(error, ctx.log);
+      }
+    });
+  }
+  fetchPdfResults(ctx) {
+    return __async(this, null, function* () {
+      const params = {};
+      if (ctx.build.projectId) {
+        params.project_id = ctx.build.projectId;
+      } else {
+        throw new Error("Project ID not found to fetch PDF results");
+      }
+      params.build_id = ctx.build.id;
+      const auth = Buffer.from(`${this.username}:${this.accessKey}`).toString("base64");
+      try {
+        const response = yield axios__default.default.request({
+          url: ctx.env.SMARTUI_UPLOAD_URL + "/smartui/2.0/build/screenshots",
+          method: "GET",
+          params,
+          headers: {
+            "accept": "application/json",
+            "Authorization": `Basic ${auth}`
+          }
+        });
+        ctx.log.debug(`http response: ${JSON.stringify({
+          status: response.status,
+          headers: response.headers,
+          body: response.data
+        })}`);
+        return response.data;
+      } catch (error) {
+        this.handleHttpError(error, ctx.log);
+      }
+    });
+  }
 };
 var ctx_default = (options) => {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
@@ -2889,10 +3165,10 @@ var ctx_default = (options) => {
     mergeByBuild: false
   };
 };
-function executeCommand(command10) {
+function executeCommand(command11) {
   let dst = process.cwd();
   try {
-    return child_process.execSync(command10, {
+    return child_process.execSync(command11, {
       cwd: dst,
       stdio: ["ignore"],
       encoding: "utf-8"
@@ -2901,11 +3177,12 @@ function executeCommand(command10) {
     throw new Error(error.message);
   }
 }
-function isGitRepo() {
+function isGitRepo(ctx) {
   try {
     executeCommand("git status");
     return true;
   } catch (error) {
+    setNonGitInfo(ctx);
     return false;
   }
 }
@@ -2937,8 +3214,8 @@ var git_default = (ctx) => {
   } else {
     const splitCharacter = "<##>";
     const prettyFormat = ["%h", "%H", "%s", "%f", "%b", "%at", "%ct", "%an", "%ae", "%cn", "%ce", "%N", ""];
-    const command10 = 'git log -1 --pretty=format:"' + prettyFormat.join(splitCharacter) + '" && git rev-parse --abbrev-ref HEAD && git tag --contains HEAD';
-    let res = executeCommand(command10).split(splitCharacter);
+    const command11 = 'git log -1 --pretty=format:"' + prettyFormat.join(splitCharacter) + '" && git rev-parse --abbrev-ref HEAD && git tag --contains HEAD';
+    let res = executeCommand(command11).split(splitCharacter);
     var branchAndTags = res[res.length - 1].split("\n").filter((n) => n);
     var branch = ctx.env.CURRENT_BRANCH || branchAndTags[0];
     branchAndTags.slice(1);
@@ -2956,11 +3233,30 @@ var git_default = (ctx) => {
     };
   }
 };
+function setNonGitInfo(ctx) {
+  let branch = ctx.env.CURRENT_BRANCH || "unknown-branch";
+  if (ctx.options.markBaseline) {
+    ctx.env.BASELINE_BRANCH = branch;
+    ctx.env.SMART_GIT = false;
+  }
+  let githubURL;
+  if (ctx.options.githubURL && ctx.options.githubURL.startsWith("https://")) {
+    githubURL = ctx.options.githubURL;
+  }
+  ctx.git = {
+    branch,
+    commitId: "-",
+    commitAuthor: "-",
+    commitMessage: "-",
+    githubURL: githubURL ? githubURL : "",
+    baselineBranch: ctx.options.baselineBranch || ctx.env.BASELINE_BRANCH || ""
+  };
+}
 var getGitInfo_default = (ctx) => {
   return {
     title: `Fetching git repo details`,
     skip: (ctx2) => {
-      return !isGitRepo() && !ctx2.env.SMARTUI_GIT_INFO_FILEPATH ? "[SKIPPED] Fetching git repo details; not a git repo" : "";
+      return !isGitRepo(ctx2) && !ctx2.env.SMARTUI_GIT_INFO_FILEPATH ? "[SKIPPED] Fetching git repo details; not a git repo" : "";
     },
     task: (ctx2, task) => __async(void 0, null, function* () {
       if (ctx2.env.CURRENT_BRANCH && ctx2.env.CURRENT_BRANCH.trim() === "") {
@@ -3168,7 +3464,7 @@ var finalizeBuild_default = (ctx) => {
         task.output = chalk__default.default.gray(error.message);
         throw new Error("Finalize build failed");
       }
-      let buildUrls = `build url: ${ctx2.build.url}
+      let buildUrls2 = `build url: ${ctx2.build.url}
 `;
       if (pingIntervalId !== null) {
         clearInterval(pingIntervalId);
@@ -3198,14 +3494,14 @@ var finalizeBuild_default = (ctx) => {
             yield ctx2.client.finalizeBuildForCapsWithToken(buildId, totalSnapshots, projectToken, ctx2.log);
           }
           if (testId && buildId) {
-            buildUrls += `TestId ${testId}: ${sessionBuildUrl}
+            buildUrls2 += `TestId ${testId}: ${sessionBuildUrl}
 `;
           }
         } catch (error) {
           ctx2.log.debug(`Error finalizing build for session ${sessionId}: ${error.message}`);
         }
       }
-      task.output = chalk__default.default.gray(buildUrls);
+      task.output = chalk__default.default.gray(buildUrls2);
       task.title = "Finalized build";
       try {
         yield (_a = ctx2.browser) == null ? void 0 : _a.close();
@@ -3344,6 +3640,9 @@ function prepareSnapshot(snapshot, ctx) {
             case "cssSelector":
               selectors.push(...value);
               break;
+            case "coordinates":
+              selectors.push(...value.map((e) => `coordinates=${e}`));
+              break;
           }
         }
       }
@@ -3686,6 +3985,9 @@ function processSnapshot(snapshot, ctx) {
             case "cssSelector":
               selectors.push(...value);
               break;
+            case "coordinates":
+              selectors.push(...value.map((e) => `coordinates=${e}`));
+              break;
           }
         }
       }
@@ -3823,6 +4125,31 @@ function processSnapshot(snapshot, ctx) {
         if (!Array.isArray(processedOptions[ignoreOrSelectBoxes][viewportString]))
           processedOptions[ignoreOrSelectBoxes][viewportString] = [];
         for (const selector of selectors) {
+          if (selector.startsWith("coordinates=")) {
+            const coordString = selector.replace("coordinates=", "");
+            let pageHeight = height;
+            if (viewport.height) {
+              pageHeight = viewport.height;
+            }
+            const validation = validateCoordinates(
+              coordString,
+              pageHeight,
+              viewport.width,
+              snapshot.name
+            );
+            if (!validation.valid) {
+              optionWarnings.add(validation.error);
+              continue;
+            }
+            if (renderViewports.length > 1) {
+              optionWarnings.add(`for snapshot ${snapshot.name} viewport ${viewportString}, coordinates may not be accurate for multiple viewports`);
+            }
+            const coordinateElement = __spreadValues({
+              type: "coordinates"
+            }, validation.coords);
+            locators.push(coordinateElement);
+            continue;
+          }
           let l = yield page.locator(selector).all();
           if (l.length === 0) {
             optionWarnings.add(`for snapshot ${snapshot.name} viewport ${viewportString}, no element found for selector ${selector}`);
@@ -3831,6 +4158,17 @@ function processSnapshot(snapshot, ctx) {
           locators.push(...l);
         }
         for (const locator of locators) {
+          if (locator && typeof locator === "object" && locator.hasOwnProperty("type") && locator.type === "coordinates") {
+            const coordLocator = locator;
+            const { top, bottom, left, right } = coordLocator;
+            processedOptions[ignoreOrSelectBoxes][viewportString].push({
+              left,
+              top,
+              right,
+              bottom
+            });
+            continue;
+          }
           let bb = yield locator.boundingBox();
           if (bb) {
             const top = bb.y;
@@ -4124,7 +4462,7 @@ var Queue = class {
         try {
           this.processingSnapshot = snapshot == null ? void 0 : snapshot.name;
           let drop = false;
-          if (this.ctx.isStartExec && !this.ctx.config.tunnel) {
+          if (this.ctx.isStartExec) {
             this.ctx.log.info(`Processing Snapshot: ${snapshot == null ? void 0 : snapshot.name}`);
           }
           if (!this.ctx.config.delayedUpload && snapshot && snapshot.name && this.snapshotNames.includes(snapshot.name) && !this.ctx.config.allowDuplicateSnapshotNames) {
@@ -4319,15 +4657,15 @@ var startTunnel_default = (ctx) => {
 
 // src/commander/exec.ts
 var command = new commander.Command();
-command.name("exec").description("Run test commands around SmartUI").argument("<command...>", "Command supplied for running tests").option("-P, --port <number>", "Port number for the server").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").option("--scheduled <string>", "Specify the schedule ID").option("--userName <string>", "Specify the LT username").option("--accessKey <string>", "Specify the LT accesskey").action(function(execCommand, _, command10) {
+command.name("exec").description("Run test commands around SmartUI").argument("<command...>", "Command supplied for running tests").option("-P, --port <number>", "Port number for the server").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").option("--scheduled <string>", "Specify the schedule ID").option("--userName <string>", "Specify the LT username").option("--accessKey <string>", "Specify the LT accesskey").action(function(execCommand, _, command11) {
   return __async(this, null, function* () {
     var _a;
-    const options = command10.optsWithGlobals();
+    const options = command11.optsWithGlobals();
     if (options.buildName === "") {
       console.log(`Error: The '--buildName' option cannot be an empty string.`);
       process.exit(1);
     }
-    let ctx = ctx_default(command10.optsWithGlobals());
+    let ctx = ctx_default(command11.optsWithGlobals());
     if (!which__default.default.sync(execCommand[0], { nothrow: true })) {
       ctx.log.error(`Error: Command not found "${execCommand[0]}"`);
       return;
@@ -4943,15 +5281,15 @@ var captureScreenshots_default = (ctx) => {
 
 // src/commander/capture.ts
 var command2 = new commander.Command();
-command2.name("capture").description("Capture screenshots of static sites").argument("<file>", "Web static config file").option("-C, --parallel [number]", "Specify the number of instances per browser", parseInt).option("-F, --force", "forcefully apply the specified parallel instances per browser").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").option("--scheduled <string>", "Specify the schedule ID").option("--userName <string>", "Specify the LT username").option("--accessKey <string>", "Specify the LT accesskey").action(function(file, _, command10) {
+command2.name("capture").description("Capture screenshots of static sites").argument("<file>", "Web static config file").option("-C, --parallel [number]", "Specify the number of instances per browser", parseInt).option("-F, --force", "forcefully apply the specified parallel instances per browser").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").option("--scheduled <string>", "Specify the schedule ID").option("--userName <string>", "Specify the LT username").option("--accessKey <string>", "Specify the LT accesskey").action(function(file, _, command11) {
   return __async(this, null, function* () {
     var _a, _b;
-    const options = command10.optsWithGlobals();
+    const options = command11.optsWithGlobals();
     if (options.buildName === "") {
       console.log(`Error: The '--buildName' option cannot be an empty string.`);
       process.exit(1);
     }
-    let ctx = ctx_default(command10.optsWithGlobals());
+    let ctx = ctx_default(command11.optsWithGlobals());
     ctx.isSnapshotCaptured = true;
     if (!fs5__default.default.existsSync(file)) {
       ctx.log.error(`Web Static Config file ${file} not found.`);
@@ -5039,14 +5377,14 @@ command3.name("upload").description("Upload screenshots from given directory").a
   return val.split(",").map((ext) => ext.trim().toLowerCase());
 }).option("-E, --removeExtensions", "Strips file extensions from snapshot names").option("-i, --ignoreDir <patterns>", "Comma-separated list of directories to ignore", (val) => {
   return val.split(",").map((pattern) => pattern.trim());
-}).option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").option("--userName <string>", "Specify the LT username").option("--accessKey <string>", "Specify the LT accesskey").action(function(directory, _, command10) {
+}).option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").option("--userName <string>", "Specify the LT username").option("--accessKey <string>", "Specify the LT accesskey").action(function(directory, _, command11) {
   return __async(this, null, function* () {
-    const options = command10.optsWithGlobals();
+    const options = command11.optsWithGlobals();
     if (options.buildName === "") {
       console.log(`Error: The '--buildName' option cannot be an empty string.`);
       process.exit(1);
     }
-    let ctx = ctx_default(command10.optsWithGlobals());
+    let ctx = ctx_default(command11.optsWithGlobals());
     ctx.isSnapshotCaptured = true;
     if (!fs5__default.default.existsSync(directory)) {
       console.log(`Error: The provided directory ${directory} not found.`);
@@ -5324,10 +5662,10 @@ var uploadAppFigma_default2 = (ctx) => {
 var uploadFigma = new commander.Command();
 var uploadWebFigmaCommand = new commander.Command();
 var uploadAppFigmaCommand = new commander.Command();
-uploadFigma.name("upload-figma").description("Capture screenshots of static sites").argument("<file>", "figma design config file").option("--markBaseline", "Mark the uploaded images as baseline").option("--buildName <buildName>", "Name of the build").action(function(file, _, command10) {
+uploadFigma.name("upload-figma").description("Capture screenshots of static sites").argument("<file>", "figma design config file").option("--markBaseline", "Mark the uploaded images as baseline").option("--buildName <buildName>", "Name of the build").action(function(file, _, command11) {
   return __async(this, null, function* () {
     var _a, _b;
-    let ctx = ctx_default(command10.optsWithGlobals());
+    let ctx = ctx_default(command11.optsWithGlobals());
     ctx.isSnapshotCaptured = true;
     if (!fs5__default.default.existsSync(file)) {
       console.log(`Error: Figma Config file ${file} not found.`);
@@ -5366,10 +5704,10 @@ uploadFigma.name("upload-figma").description("Capture screenshots of static site
     }
   });
 });
-uploadWebFigmaCommand.name("upload-figma-web").description("Capture figma screenshots into CLI build").argument("<file>", "figma config config file").option("--markBaseline", "Mark the uploaded images as baseline").option("--buildName <buildName>", "Name of the build").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").action(function(file, _, command10) {
+uploadWebFigmaCommand.name("upload-figma-web").description("Capture figma screenshots into CLI build").argument("<file>", "figma config config file").option("--markBaseline", "Mark the uploaded images as baseline").option("--buildName <buildName>", "Name of the build").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").action(function(file, _, command11) {
   return __async(this, null, function* () {
     var _a;
-    let ctx = ctx_default(command10.optsWithGlobals());
+    let ctx = ctx_default(command11.optsWithGlobals());
     if (!fs5__default.default.existsSync(file)) {
       console.log(`Error: figma-web config file ${file} not found.`);
       return;
@@ -5419,10 +5757,10 @@ uploadWebFigmaCommand.name("upload-figma-web").description("Capture figma screen
     }
   });
 });
-uploadAppFigmaCommand.name("upload-figma-app").description("Capture figma screenshots into App Build").argument("<file>", "figma config config file").option("--markBaseline", "Mark the uploaded images as baseline").option("--buildName <buildName>", "Name of the build").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").action(function(file, _, command10) {
+uploadAppFigmaCommand.name("upload-figma-app").description("Capture figma screenshots into App Build").argument("<file>", "figma config config file").option("--markBaseline", "Mark the uploaded images as baseline").option("--buildName <buildName>", "Name of the build").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").action(function(file, _, command11) {
   return __async(this, null, function* () {
     var _a;
-    let ctx = ctx_default(command10.optsWithGlobals());
+    let ctx = ctx_default(command11.optsWithGlobals());
     if (!fs5__default.default.existsSync(file)) {
       console.log(`Error: figma-app config file ${file} not found.`);
       return;
@@ -5486,10 +5824,10 @@ command4.name("exec:start").description("Start SmartUI server").option("-P, --po
     ctx.isStartExec = true;
     let tasks = new listr2.Listr(
       [
-        auth_default(),
+        authExec_default(),
         startServer_default(),
         getGitInfo_default(),
-        createBuild_default()
+        createBuildExec_default()
       ],
       {
         rendererOptions: {
@@ -5504,8 +5842,10 @@ command4.name("exec:start").description("Start SmartUI server").option("-P, --po
     );
     try {
       yield tasks.run(ctx);
-      startPingPolling(ctx);
-      if (ctx.options.fetchResults) {
+      if (ctx.build && ctx.build.id) {
+        startPingPolling(ctx);
+      }
+      if (ctx.options.fetchResults && ctx.build && ctx.build.id) {
         startPolling(ctx, "", false, "");
       }
     } catch (error) {
@@ -5866,10 +6206,104 @@ command9.name("exec:pingTest").description("Ping the SmartUI server to check if
   });
 });
 var pingTest_default = command9;
+var uploadPdfs_default = (ctx) => {
+  return {
+    title: "Uploading PDFs",
+    task: (ctx2, task) => __async(void 0, null, function* () {
+      try {
+        ctx2.task = task;
+        updateLogContext({ task: "upload-pdf" });
+        yield uploadPdfs(ctx2, ctx2.uploadFilePath);
+        task.title = "PDFs uploaded successfully";
+      } catch (error) {
+        ctx2.log.debug(error);
+        task.output = chalk__default.default.red(`${error.message}`);
+        throw new Error("PDF upload failed");
+      }
+    }),
+    rendererOptions: { persistentOutput: true },
+    exitOnError: false
+  };
+};
+function uploadPdfs(ctx, pdfPath) {
+  return __async(this, null, function* () {
+    const formData = new FormData__default.default();
+    if (pdfPath.endsWith(".pdf")) {
+      formData.append("pathToFiles", fs5__default.default.createReadStream(pdfPath));
+    } else {
+      const files = fs5__default.default.readdirSync(pdfPath);
+      const pdfFiles = files.filter((file) => file.endsWith(".pdf"));
+      pdfFiles.forEach((pdf) => {
+        const filePath = path2__default.default.join(pdfPath, pdf);
+        formData.append("pathToFiles", fs5__default.default.createReadStream(filePath));
+      });
+    }
+    const buildName = ctx.options.buildName;
+    if (buildName) {
+      ctx.build.name = buildName;
+    }
+    try {
+      const response = yield ctx.client.uploadPdf(ctx, formData, buildName);
+      if (response && response.buildId) {
+        ctx.build.id = response.buildId;
+        ctx.log.debug(`PDF upload successful. Build ID: ${ctx.build.id}`);
+      }
+      if (response && response.projectId) {
+        ctx.build.projectId = response.projectId;
+      }
+    } catch (error) {
+      throw new Error(error.message);
+    }
+  });
+}
+
+// src/commander/uploadPdf.ts
+var command10 = new commander.Command();
+command10.name("upload-pdf").description("Upload PDFs for visual comparison").argument("<directory>", "Path of the directory containing PDFs").option("--fetch-results [filename]", "Fetch results and optionally specify an output file, e.g., <filename>.json").option("--buildName <string>", "Specify the build name").action(function(directory, _, command11) {
+  return __async(this, null, function* () {
+    const options = command11.optsWithGlobals();
+    if (options.buildName === "") {
+      console.log(`Error: The '--buildName' option cannot be an empty string.`);
+      process.exit(1);
+    }
+    let ctx = ctx_default(command11.optsWithGlobals());
+    if (!fs5__default.default.existsSync(directory)) {
+      console.log(`Error: The provided directory ${directory} not found.`);
+      process.exit(1);
+    }
+    ctx.uploadFilePath = directory;
+    let tasks = new listr2.Listr(
+      [
+        auth_default(),
+        uploadPdfs_default()
+      ],
+      {
+        rendererOptions: {
+          icon: {
+            [listr2.ListrDefaultRendererLogLevels.OUTPUT]: `\u2192`
+          },
+          color: {
+            [listr2.ListrDefaultRendererLogLevels.OUTPUT]: listr2.color.gray
+          }
+        }
+      }
+    );
+    try {
+      yield tasks.run(ctx);
+      if (ctx.options.fetchResults) {
+        startPdfPolling(ctx);
+      }
+    } catch (error) {
+      console.log("\nRefer docs: https://www.lambdatest.com/support/docs/smart-visual-regression-testing/");
+      process.exit(1);
+    }
+  });
+});
+var uploadPdf_default = command10;
 
 // src/commander/commander.ts
 var program2 = new commander.Command();
-program2.name("smartui").description("CLI to help you run your SmartUI tests on LambdaTest platform").version(`v${version}`).option("-c --config <filepath>", "Config file path").option("--markBaseline", "Mark this build baseline").option("--baselineBranch <string>", "Mark this build baseline").option("--baselineBuild <string>", "Mark this build baseline").option("--githubURL <string>", "GitHub URL including commitId").addCommand(exec_default2).addCommand(capture_default).addCommand(configWeb).addCommand(configStatic).addCommand(upload_default).addCommand(server_default2).addCommand(stopServer_default).addCommand(merge_default).addCommand(ping_default).addCommand(configFigma).addCommand(uploadFigma).addCommand(configWebFigma).addCommand(configAppFigma).addCommand(uploadWebFigmaCommand).addCommand(uploadAppFigmaCommand).addCommand(pingTest_default);
+program2.name("smartui").description("CLI to help you run your SmartUI tests on LambdaTest platform").version(`v${version}`).option("-c --config <filepath>", "Config file path").option("--markBaseline", "Mark this build baseline").option("--baselineBranch <string>", "Mark this build baseline").option("--baselineBuild <string>", "Mark this build baseline").option("--githubURL <string>", "GitHub URL including commitId").addCommand(exec_default2).addCommand(capture_default).addCommand(configWeb).addCommand(configStatic).addCommand(upload_default).addCommand(server_default2).addCommand(stopServer_default).addCommand(merge_default).addCommand(ping_default).addCommand(configFigma).addCommand(uploadFigma).addCommand(configWebFigma).addCommand(configAppFigma).addCommand(uploadWebFigmaCommand).addCommand(uploadAppFigmaCommand).addCommand(pingTest_default).addCommand(uploadPdf_default);
 var commander_default = program2;
 (function() {
   return __async(this, null, function* () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdatest/smartui-cli",
-  "version": "4.1.28",
+  "version": "4.1.30",
   "description": "A command line interface (CLI) to run SmartUI tests on LambdaTest",
   "files": [
     "dist/**/*"