@percy/client 1.32.6 → 1.32.7-beta.0

package/dist/client.js

@@ -401,10 +401,45 @@ export class PercyClient {
 
   // Retrieves snapshot/comparison data by id. Requires a read access token.
   async getStatus(type, ids) {
-    if (!['snapshot', 'comparison'].includes(type)) throw new Error('Invalid type passed');
+    if (!['snapshot', 'comparison', 'intelli_story_graph'].includes(type)) throw new Error('Invalid type passed');
     this.log.debug(`Getting ${type} status for ids ${ids}`);
     return this.get(`job_status?sync=true&type=${type}&id=${ids.join()}`);
   }
+  async getIntelliStorySnapshotNameToCommit(buildId) {
+    var _this$env$git, _this$env$target, _this$env$git2, _this$env$target2;
+    this.log.debug('IntelliStory: looking up baselines...');
+    const qs = new URLSearchParams();
+    if (buildId) qs.append('build_id', buildId);
+    if ((_this$env$git = this.env.git) !== null && _this$env$git !== void 0 && _this$env$git.branch) qs.append('branch', this.env.git.branch);
+    if ((_this$env$target = this.env.target) !== null && _this$env$target !== void 0 && _this$env$target.branch) qs.append('target_branch', this.env.target.branch);
+    if ((_this$env$git2 = this.env.git) !== null && _this$env$git2 !== void 0 && _this$env$git2.sha) qs.append('commit_sha', this.env.git.sha);
+    if ((_this$env$target2 = this.env.target) !== null && _this$env$target2 !== void 0 && _this$env$target2.commit) qs.append('target_commit_sha', this.env.target.commit);
+    if (this.env.pullRequest != null) qs.append('pull_request_number', String(this.env.pullRequest));
+    if (this.env.partial) qs.append('partial', 'true');
+    const query = qs.toString();
+    return this.get(query ? `intelli_story/snapshot-name-to-commit?${query}` : 'intelli_story/snapshot-name-to-commit', {
+      identifier: 'intelli_story.snapshot_name_to_commit'
+    });
+  }
+  async generateIntelliStoryGraph(buildId, {
+    files,
+    modules,
+    storybookPaths,
+    affectedNodes,
+    affectedFileLocations
+  } = {}) {
+    this.log.debug(`IntelliStory: enqueueing graph build for build ${buildId}...`);
+    return this.post('intelli_story/generate-graph', {
+      build_id: buildId,
+      files,
+      modules,
+      storybook_paths: storybookPaths,
+      affected_nodes: affectedNodes,
+      affected_file_locations: affectedFileLocations
+    }, {
+      identifier: 'intelli_story.generate_graph'
+    });
+  }
 
   // Returns device details enabled on project associated with given token
   async getDeviceDetails(buildId) {
@@ -571,6 +606,8 @@ export class PercyClient {
     regions,
     algorithm,
     algorithmConfiguration,
+    intelliStory,
+    storybookPath,
     resources = [],
     meta
   } = {}) {
@@ -604,7 +641,11 @@ export class PercyClient {
           'enable-javascript': enableJavaScript || null,
           'enable-layout': enableLayout || false,
           'th-test-case-execution-id': thTestCaseExecutionId || null,
-          browsers: normalizeBrowsers(browsers) || null
+          browsers: normalizeBrowsers(browsers) || null,
+          // IntelliStory: when enabled, the API selects affected snapshots
+          // server-side using the story's source path.
+          'intelli-story': intelliStory || null,
+          'storybook-path': storybookPath || null
         },
         relationships: {
           resources: {
@@ -640,23 +681,38 @@ export class PercyClient {
   // Convenience method for creating a snapshot for the active build, uploading
   // missing resources for the snapshot, and finalizing the snapshot.
   async sendSnapshot(buildId, options) {
-    var _snapshot$data$relati;
+    var _snapshot$data, _snapshot$data$relati;
     let {
       meta = {}
     } = options;
     let snapshot = await this.createSnapshot(buildId, options);
+
+    // The API always creates the snapshot record now; when server-side SmartSnap
+    // selection skips it, the response carries `skipped-via-smartsnap: true` and
+    // there are no resources to upload. Tally kept vs skipped so the storybook
+    // flow can print an IntelliStory summary.
+    let skipped = !!(snapshot !== null && snapshot !== void 0 && (_snapshot$data = snapshot.data) !== null && _snapshot$data !== void 0 && (_snapshot$data = _snapshot$data.attributes) !== null && _snapshot$data !== void 0 && _snapshot$data['skipped-via-smartsnap']);
+    if (typeof options.intelliStory === 'boolean') {
+      this.intelliStoryStats ?? (this.intelliStoryStats = {
+        kept: 0,
+        skipped: 0
+      });
+      this.intelliStoryStats[skipped ? 'skipped' : 'kept'] += 1;
+    }
     meta.snapshotId = snapshot.data.id;
     let missing = (_snapshot$data$relati = snapshot.data.relationships) === null || _snapshot$data$relati === void 0 || (_snapshot$data$relati = _snapshot$data$relati['missing-resources']) === null || _snapshot$data$relati === void 0 ? void 0 : _snapshot$data$relati.data;
     this.log.debug(`${(missing === null || missing === void 0 ? void 0 : missing.length) || 0} Missing resources: ${options.name}...`, meta);
-    if (missing !== null && missing !== void 0 && missing.length) {
+    if (skipped) {
+      this.log.debug('skipping resource upload because this is a intellistory skip build', meta);
+    } else if (missing !== null && missing !== void 0 && missing.length) {
       let resources = options.resources.reduce((acc, r) => Object.assign(acc, {
         [r.sha]: r
       }), {});
       await this.uploadResources(buildId, missing.map(({
         id
       }) => resources[id]), meta);
+      this.log.debug(`Resources uploaded: ${options.name}...`, meta);
     }
-    this.log.debug(`Resources uploaded: ${options.name}...`, meta);
     await this.finalizeSnapshot(snapshot.data.id, meta);
     this.log.debug(`Finalized snapshot: ${options.name}...`, meta);
     return snapshot;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percy/client",
-  "version": "1.32.6",
+  "version": "1.32.7-beta.0",
   "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.6",
-    "@percy/env": "1.32.6",
-    "@percy/logger": "1.32.6",
+    "@percy/config": "1.32.7-beta.0",
+    "@percy/env": "1.32.7-beta.0",
+    "@percy/logger": "1.32.7-beta.0",
     "pac-proxy-agent": "^7.0.2",
     "pako": "^2.1.0"
   },
-  "gitHead": "e7dd935acf71273fd045ccceda6d1a37db8e4600"
+  "gitHead": "f86a18de3e04d3cfa9d14ce5d186ad66c3f8e020"
 }