@percy/core 1.31.10-beta.1 → 1.31.10-beta.3

package/dist/snapshot.js

@@ -360,6 +360,41 @@ function mergeSnapshotOptions(prev = {}, next) {
   });
 }
 
+// Runs quick doctor diagnostics after a build failure, guarded by PERCY_AUTO_DOCTOR env var.
+// Uses dynamic import so @percy/cli-doctor is not a hard dependency of @percy/core.
+async function runDoctorOnFailure(percy) {
+  // Guard against double-fire: build-creation failure triggers this in the
+  // 'start' catch, and the subsequent 'end' handler (no build id) would fire
+  // it again — each quick-mode run carries up to 8s of network latency.
+  if (percy._doctorRanOnFailure) return;
+  percy._doctorRanOnFailure = true;
+  if (process.env.PERCY_AUTO_DOCTOR !== 'true') {
+    percy.log.warn('Run `percy doctor` to diagnose connectivity and token issues.');
+    return;
+  }
+  percy.log.info('[percy doctor] Running quick diagnostics after build failure...');
+  try {
+    var _report$checks, _report$checks2;
+    // eslint-disable-next-line import/no-extraneous-dependencies
+    const {
+      runDiagnostics
+    } = await import('@percy/cli-doctor');
+    const report = await runDiagnostics({
+      mode: 'quick',
+      timeout: 8000
+    });
+    const failed = (report === null || report === void 0 || (_report$checks = report.checks) === null || _report$checks === void 0 || (_report$checks = _report$checks.connectivity) === null || _report$checks === void 0 ? void 0 : _report$checks.status) === 'fail' || (report === null || report === void 0 || (_report$checks2 = report.checks) === null || _report$checks2 === void 0 || (_report$checks2 = _report$checks2.auth) === null || _report$checks2 === void 0 ? void 0 : _report$checks2.status) === 'fail';
+    if (failed) {
+      percy.log.warn('[percy doctor] Quick check found issues — see above for details.');
+    } else {
+      percy.log.info('[percy doctor] Connectivity and token look healthy — the failure may be server-side.');
+    }
+  } catch {
+    // doctor not installed or import failed — degrade silently
+    percy.log.debug('[percy doctor] Could not run automatic diagnostics (package not available).');
+  }
+}
+
 // Creates a snapshots queue that manages a Percy build and uploads snapshots.
 export function createSnapshotsQueue(percy) {
   let {
@@ -406,6 +441,7 @@ export function createSnapshotsQueue(percy) {
       });
       percy.log.error(build.error);
       percy.log.error(err);
+      await runDoctorOnFailure(percy);
       queue.close(true);
     }
   })
@@ -417,6 +453,7 @@ export function createSnapshotsQueue(percy) {
       percy.log.warn(`Build #${build.number} failed: ${build.url}`, {
         build
       });
+      await runDoctorOnFailure(percy);
     } else if ((_build2 = build) !== null && _build2 !== void 0 && _build2.id) {
       await percy.client.finalizeBuild(build.id);
       percy.log.info(`Finalized build #${build.number}: ${build.url}`, {
@@ -426,6 +463,7 @@ export function createSnapshotsQueue(percy) {
       percy.log.warn('Build not created', {
         build
       });
+      await runDoctorOnFailure(percy);
     }
   })
   // snapshots are unique by name and testCase both

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percy/core",
-  "version": "1.31.10-beta.1",
+  "version": "1.31.10-beta.3",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -43,12 +43,12 @@
     "test:types": "tsd"
   },
   "dependencies": {
-    "@percy/client": "1.31.10-beta.1",
-    "@percy/config": "1.31.10-beta.1",
-    "@percy/dom": "1.31.10-beta.1",
-    "@percy/logger": "1.31.10-beta.1",
-    "@percy/monitoring": "1.31.10-beta.1",
-    "@percy/webdriver-utils": "1.31.10-beta.1",
+    "@percy/client": "1.31.10-beta.3",
+    "@percy/config": "1.31.10-beta.3",
+    "@percy/dom": "1.31.10-beta.3",
+    "@percy/logger": "1.31.10-beta.3",
+    "@percy/monitoring": "1.31.10-beta.3",
+    "@percy/webdriver-utils": "1.31.10-beta.3",
     "content-disposition": "^0.5.4",
     "cross-spawn": "^7.0.3",
     "extract-zip": "^2.0.1",
@@ -61,5 +61,8 @@
     "ws": "^8.17.1",
     "yaml": "^2.4.1"
   },
-  "gitHead": "ae5b74ac851df206e0793a8048f4aeda9784fde1"
+  "optionalDependencies": {
+    "@percy/cli-doctor": "1.31.10-beta.3"
+  },
+  "gitHead": "a6bc2f02f722c7a6a16cdbc1dc3002b1de00f062"
 }