@applitools/visual-grid-cli-utils 1.21.44 → 1.21.45

package/README.md

@@ -13,3 +13,20 @@ npm install -g @applitools/visual-grid-cli-utils
 ## Using it
 
 * To get all the options, do `visual-grid-cli-utils --help`
+
+### `view-rendering <render-id> --raw`
+
+* Instead of printing the view-rendering URL, `--raw` fetches a time-limited **signed URL to the
+  render's raw (unparsed) root-DOM CDT** and prints it together with its expiration.
+* It calls the rendering-api-app `/render` endpoint with the `rawCdtOnly` option; the server
+  enforces ownership (you must own the render, or be an admin).
+* Only renders created on or after **2026-06-26** are supported — the raw root-DOM CDT path
+  (`rdvsMetadata.rootDomRawResourcePath`) started being recorded with AD-14694. The feature is
+  not supported for renders created before then; the command prints a `404` hint explaining this.
+
+```sh
+vg-cli view-rendering <render-id> --raw
+# Raw root-DOM CDT URL:
+# https://storage.googleapis.com/rg-raw-.../<accountId>/<resourceId>?X-Goog-Signature=...
+# Expires at: 2026-06-28T12:00:00.000Z (TTL 900s)
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/visual-grid-cli-utils",
-  "version": "1.21.44",
+  "version": "1.21.45",
   "description": "",
   "main": "src/visual-grid-cli-utils.js",
   "engines": {

package/src/commons/fetch-raw-cdt-url.js

@@ -0,0 +1,34 @@
+'use strict'
+const {fetch: defaultFetch} = require('@applitools/http-commons')
+
+// Fetch a time-limited signed URL for a render's raw (unparsed) root-DOM CDT by calling the
+// rendering-api-app `/render` endpoint with the `rawCdtOnly` flag (AD-14682). The endpoint
+// returns `{ url, expiresAt, ttlSeconds }` and enforces ownership server-side. `fetch` is
+// injectable for testing; it defaults to the shared http-commons fetch.
+async function fetchRawCdtUrl({vgUrl, renderId, authToken, agentId, fetch = defaultFetch}) {
+  const renderUrl = new URL('./render', vgUrl)
+  const response = await fetch(renderUrl, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-Auth-Token': authToken,
+    },
+    body: JSON.stringify({
+      reRenderId: renderId,
+      rawCdtOnly: true,
+      agentId,
+      options: {
+        rawCdtOnly: true,
+      },
+    }),
+  })
+
+  if (!response.ok) {
+    const errorBody = await response.text()
+    throw new Error(`Failed to fetch raw CDT URL - HTTP ${response.status}: ${errorBody}`)
+  }
+
+  return response.json()
+}
+
+module.exports = fetchRawCdtUrl

package/src/view-rendering.js

@@ -3,6 +3,7 @@ const {exec} = require('child_process')
 const retry = require('p-retry')
 const createSession = require('./commons/create-session')
 const calculateViewRenderingUrl = require('./commons/view-rendering-url')
+const fetchRawCdtUrl = require('./commons/fetch-raw-cdt-url')
 const {fetch, throwErrorFromBadStatus} = require('@applitools/http-commons')
 const fs = require('fs')
 
@@ -52,7 +53,9 @@ async function waitForParsedStatus(vgUrl, renderId, authToken, waitTimeout = 5 *
   )
 }
 
-async function tryNewViewRenderingEndpoint(vgUrl, renderId, authToken, apiKey, serverUrl) {
+// `_authToken` is unused — this path mints its own session below; the `_` prefix satisfies the
+// no-unused-vars rule (was a pre-existing lint error on this line before the --raw change).
+async function tryNewViewRenderingEndpoint(vgUrl, renderId, _authToken, apiKey, serverUrl) {
   try {
     console.log(`[1/3] Starting resource parsing for render: ${renderId}`)
     // Step 1: Call rerender API with parseResourcesOnly flag
@@ -121,6 +124,7 @@ async function main({
   serverUrl,
   accountOverride,
   downloadVhsFolder,
+  raw,
 }) {
   if (!apiKey) {
     throw new Error(
@@ -134,6 +138,43 @@ async function main({
 
   const vgUrl = process.env.VG_URL || 'https://render-wus.applitools.com'
 
+  // --raw: fetch a signed URL to the render's raw root-DOM CDT (via the rawCdtOnly /render
+  // option, AD-14682) and print it + its expiration, instead of the view-rendering URL.
+  if (raw) {
+    const agentId = `visual-grid-cli-utils/${require('../package.json').version}`
+    let rawCdt
+    try {
+      rawCdt = await fetchRawCdtUrl({
+        vgUrl,
+        renderId,
+        authToken: finalAuthToken,
+        agentId,
+      })
+    } catch (err) {
+      // A 404 most commonly means the render has no stored raw root-DOM CDT path. That path
+      // (rdvsMetadata.rootDomRawResourcePath) only started being recorded with AD-14694, so
+      // the feature isn't supported for renders created before then — surface a gentle hint.
+      if (String(err.message).includes('HTTP 404')) {
+        console.log('\n⚠ No raw root-DOM CDT URL is available for this render (404).')
+        console.log(
+          '  This feature supports renders created on or after 2026-06-26; it is not supported',
+        )
+        console.log('  for renders created before then.')
+        console.log(`\n  Server response: ${err.message}`)
+        return
+      }
+      throw err
+    }
+
+    const {url, expiresAt, ttlSeconds} = rawCdt
+    console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+    console.log('Raw root-DOM CDT URL:')
+    console.log(url)
+    console.log(`Expires at: ${expiresAt} (TTL ${ttlSeconds}s)`)
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+    return
+  }
+
   // Try new view-rendering endpoint with rerender API
   const result = await tryNewViewRenderingEndpoint(
     vgUrl,

package/src/visual-grid-cli-utils.js

@@ -40,6 +40,12 @@ async function main(argv, {shouldExitOnError = false} = {}) {
         .option('download-vhs-folder', {
           describe: 'Specify a folder to which download the vhs file (in case of VHS snapshot)',
           type: 'string',
+        })
+        .option('raw', {
+          describe:
+            "fetch a signed URL to the render's raw root-DOM CDT (and its expiration) instead of the view-rendering url",
+          default: false,
+          type: 'boolean',
         }),
     )
     .command('view-resource <hash>', 'view resource url', (yargs) =>