@percy/client 1.32.5 → 1.32.6-beta.1

package/dist/client.js

@@ -12,6 +12,10 @@ const {
 let pkg = getPackageJSON(import.meta.url);
 // minimum polling interval milliseconds
 const MIN_POLLING_INTERVAL = 1_000;
+// Allow-listed drop-in build sources. The API keys drop-in behavior (baseline auto-approval,
+// telemetry) on these; anything else keeps the computed default so a stray env var can't
+// inject an arbitrary source.
+export const DROPIN_BUILD_SOURCES = ['playwright-dropin', 'playwright-dropin-baseline'];
 const INVALID_TOKEN_ERROR_MESSAGE = 'Unable to retrieve snapshot details with write access token. Kindly use a full access token for retrieving snapshot details with Synchronous CLI.';
 
 // Validate ID arguments
@@ -258,10 +262,20 @@ export class PercyClient {
   // Creates a build with optional build resources. Only one build can be
   // created at a time per instance so snapshots and build finalization can be
   // done more seamlessly without manually tracking build ids
+  //
+  // Drop-in baseline options (Playwright drop-in):
+  //   source — override the build source with an allow-listed drop-in value.
+  //   dropinBaselineCandidate — ask the API to treat the build as the project's baseline IF it is
+  //     the project's first build (the server decides; a no-op on established projects).
+  //   dropinBaselineSetup — explicit `percy playwright:setup-baseline`: the build IS the baseline
+  //     regardless of build number (deliberate user-triggered re-baseline).
   async createBuild({
     resources = [],
     projectType,
-    cliStartTime = null
+    cliStartTime = null,
+    source: sourceOverride,
+    dropinBaselineCandidate,
+    dropinBaselineSetup
   } = {}) {
     var _this$config$percy2;
     this.log.debug('Creating a new build...');
@@ -271,7 +285,14 @@ export class PercyClient {
       source = 'bstack_sdk_created';
     } else if (process.env.PERCY_AUTO_ENABLED_GROUP_BUILD === 'true') {
       source = 'auto_enabled_group';
+    } else if (DROPIN_BUILD_SOURCES.includes(process.env.PERCY_BUILD_SOURCE)) {
+      source = process.env.PERCY_BUILD_SOURCE;
     }
+
+    // Allow-listed explicit override (used by the baseline seeding flows).
+    if (DROPIN_BUILD_SOURCES.includes(sourceOverride)) source = sourceOverride;
+    dropinBaselineCandidate ?? (dropinBaselineCandidate = process.env.PERCY_DROPIN_BASELINE_CANDIDATE === 'true');
+    dropinBaselineSetup ?? (dropinBaselineSetup = process.env.PERCY_DROPIN_BASELINE_SETUP === 'true');
     let tagsArr = tagsList(this.labels);
 
     // PER-9724: internal-only priority request. Set by internal product
@@ -304,6 +325,12 @@ export class PercyClient {
           'skip-base-build': (_this$config$percy2 = this.config.percy) === null || _this$config$percy2 === void 0 ? void 0 : _this$config$percy2.skipBaseBuild,
           'testhub-build-uuid': this.env.testhubBuildUuid,
           'testhub-build-run-id': this.env.testhubBuildRunId,
+          ...(dropinBaselineCandidate ? {
+            'dropin-baseline-candidate': true
+          } : {}),
+          ...(dropinBaselineSetup ? {
+            'dropin-baseline-setup': true
+          } : {}),
           ...(visualConfig ? {
             'visual-config': visualConfig
           } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percy/client",
-  "version": "1.32.5",
+  "version": "1.32.6-beta.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "tag": "latest"
+    "tag": "beta"
   },
   "engines": {
     "node": ">=14"
@@ -33,11 +33,11 @@
     "test:coverage": "yarn test --coverage"
   },
   "dependencies": {
-    "@percy/config": "1.32.5",
-    "@percy/env": "1.32.5",
-    "@percy/logger": "1.32.5",
+    "@percy/config": "1.32.6-beta.1",
+    "@percy/env": "1.32.6-beta.1",
+    "@percy/logger": "1.32.6-beta.1",
     "pac-proxy-agent": "^7.0.2",
     "pako": "^2.1.0"
   },
-  "gitHead": "1c83908c5913e3fab1cdd7207db49a2e0c27a3e9"
+  "gitHead": "ec8718b71355d501057197c9f5172c99fefc9f03"
 }