@adobe/spacecat-shared-tokowaka-client 1.7.7 → 1.8.0

package/.releaserc.cjs

@@ -1,8 +1,12 @@
 module.exports = {
   extends: "semantic-release-monorepo",
   plugins: [
-    "@semantic-release/commit-analyzer",
-    "@semantic-release/release-notes-generator",
+    ["@semantic-release/commit-analyzer", {
+      "preset": "conventionalcommits",
+    }],
+    ["@semantic-release/release-notes-generator", {
+      "preset": "conventionalcommits",
+    }],
     ["@semantic-release/changelog", {
       "changelogFile": "CHANGELOG.md",
     }],

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [@adobe/spacecat-shared-tokowaka-client-v1.8.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-tokowaka-client-v1.7.8...@adobe/spacecat-shared-tokowaka-client-v1.8.0) (2026-02-18)
+
+### Features
+
+* **tokowaka-client:** add semantic-value-visibility mapper ([#1348](https://github.com/adobe/spacecat-shared/issues/1348)) ([373f920](https://github.com/adobe/spacecat-shared/commit/373f920dfa9d5da8f2e15e0533d1347a23f45044))
+
+# [@adobe/spacecat-shared-tokowaka-client-v1.7.8](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-tokowaka-client-v1.7.7...@adobe/spacecat-shared-tokowaka-client-v1.7.8) (2026-02-16)
+
+
+### Bug Fixes
+
+* timeout added for edge optimize status ([#1329](https://github.com/adobe/spacecat-shared/issues/1329)) ([93ef065](https://github.com/adobe/spacecat-shared/commit/93ef0653840929e9c76b14d370dbfa6db03cb97e))
+
 # [@adobe/spacecat-shared-tokowaka-client-v1.7.7](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-tokowaka-client-v1.7.6...@adobe/spacecat-shared-tokowaka-client-v1.7.7) (2026-02-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-tokowaka-client",
-  "version": "1.7.7",
+  "version": "1.8.0",
   "description": "Tokowaka Client for SpaceCat - Edge optimization config management",
   "type": "module",
   "engines": {
@@ -37,6 +37,7 @@
     "@adobe/spacecat-shared-utils": "1.81.1",
     "@aws-sdk/client-cloudfront": "3.940.0",
     "@aws-sdk/client-s3": "3.940.0",
+    "hast-util-from-html": "2.0.3",
     "mdast-util-from-markdown": "2.0.2",
     "mdast-util-to-hast": "13.2.1",
     "uuid": "11.0.5"
@@ -46,6 +47,7 @@
     "c8": "^10.1.3",
     "chai": "^6.0.1",
     "eslint": "^9.36.0",
+    "esmock": "^2.7.3",
     "mocha": "^11.7.2",
     "nock": "^14.0.10",
     "sinon": "^21.0.0",

package/src/index.js

@@ -12,7 +12,7 @@
 
 import crypto from 'crypto';
 import { GetObjectCommand, PutObjectCommand } from '@aws-sdk/client-s3';
-import { hasText, isNonEmptyObject } from '@adobe/spacecat-shared-utils';
+import { hasText, isNonEmptyObject, tracingFetch } from '@adobe/spacecat-shared-utils';
 import { v4 as uuidv4 } from 'uuid';
 import MapperRegistry from './mappers/mapper-registry.js';
 import CdnClientRegistry from './cdn/cdn-client-registry.js';
@@ -1072,17 +1072,20 @@ class TokowakaClient {
     const maxRetries = 3;
     let attempt = 0;
 
+    const REQUEST_TIMEOUT_MS = 5000;
+
     while (attempt <= maxRetries) {
       try {
         this.log.debug(`Attempt ${attempt + 1}/${maxRetries + 1}: Checking edge optimize status for ${targetUrl}`);
 
         // eslint-disable-next-line no-await-in-loop
-        const response = await fetch(targetUrl, {
+        const response = await tracingFetch(targetUrl, {
           method: 'GET',
           headers: {
             'User-Agent': 'Tokowaka-AI Tokowaka/1.0 AdobeEdgeOptimize-AI AdobeEdgeOptimize/1.0',
             'fastly-debug': '1',
           },
+          timeout: REQUEST_TIMEOUT_MS,
         });
 
         this.log.debug(`Response status: ${response.status}`);
@@ -1096,6 +1099,13 @@ class TokowakaClient {
           edgeOptimizeEnabled,
         };
       } catch (error) {
+        const isTimeout = error?.code === 'ETIMEOUT';
+
+        if (isTimeout) {
+          this.log.warn(`Request timed out after ${REQUEST_TIMEOUT_MS}ms for ${targetUrl}, returning edgeOptimizeEnabled: false`);
+          return { edgeOptimizeEnabled: false };
+        }
+
         attempt += 1;
 
         if (attempt > maxRetries) {

package/src/mappers/mapper-registry.js

@@ -17,6 +17,7 @@ import ReadabilityMapper from './readability-mapper.js';
 import TocMapper from './toc-mapper.js';
 import GenericMapper from './generic-mapper.js';
 import PrerenderMapper from './prerender-mapper.js';
+import SemanticValueVisibilityMapper from './semantic-value-visibility-mapper.js';
 
 /**
  * Registry for opportunity mappers
@@ -42,7 +43,7 @@ export default class MapperRegistry {
       TocMapper,
       GenericMapper,
       PrerenderMapper,
-      // more mappers here
+      SemanticValueVisibilityMapper,
     ];
 
     defaultMappers.forEach((MapperClass) => {

package/src/mappers/semantic-value-visibility-mapper.js

@@ -0,0 +1,103 @@
+/*
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { hasText } from '@adobe/spacecat-shared-utils';
+import { TARGET_USER_AGENTS_CATEGORIES } from '../constants.js';
+import BaseOpportunityMapper from './base-mapper.js';
+import { htmlToHast } from '../utils/html-utils.js';
+
+/**
+ * Mapper for semantic-value-visibility opportunity
+ * Handles conversion of image semantic HTML suggestions to Tokowaka patches
+ */
+export default class SemanticValueVisibilityMapper extends BaseOpportunityMapper {
+  constructor(log) {
+    super(log);
+    this.opportunityType = 'semantic-value-visibility';
+    this.prerenderRequired = true;
+    this.validActions = ['insertAfter', 'insertBefore', 'appendChild'];
+  }
+
+  getOpportunityType() {
+    return this.opportunityType;
+  }
+
+  requiresPrerender() {
+    return this.prerenderRequired;
+  }
+
+  /**
+   * Converts suggestions to Tokowaka patches
+   * @param {string} urlPath - URL path for the suggestions
+   * @param {Array} suggestions - Array of suggestion entities for the same URL
+   * @param {string} opportunityId - Opportunity ID
+   * @returns {Array} - Array of Tokowaka patch objects
+   */
+  suggestionsToPatches(urlPath, suggestions, opportunityId) {
+    const patches = [];
+
+    suggestions.forEach((suggestion) => {
+      const eligibility = this.canDeploy(suggestion);
+      if (!eligibility.eligible) {
+        this.log.warn(`Semantic-value-visibility suggestion ${suggestion.getId()} cannot be deployed: ${eligibility.reason}`);
+        return;
+      }
+
+      const data = suggestion.getData();
+      const { semanticHtml, transformRules } = data;
+
+      // Convert HTML to HAST
+      const hastValue = htmlToHast(semanticHtml);
+
+      const patch = {
+        ...this.createBasePatch(suggestion, opportunityId),
+        op: transformRules.action,
+        selector: transformRules.selector,
+        value: hastValue,
+        valueFormat: 'hast',
+        target: TARGET_USER_AGENTS_CATEGORIES.AI_BOTS,
+      };
+
+      patches.push(patch);
+    });
+
+    return patches;
+  }
+
+  /**
+   * Checks if a semantic-value-visibility suggestion can be deployed
+   * @param {Object} suggestion - Suggestion object
+   * @returns {Object} { eligible: boolean, reason?: string }
+   */
+  canDeploy(suggestion) {
+    const data = suggestion.getData();
+
+    // Validate required fields
+    if (!hasText(data?.semanticHtml)) {
+      return { eligible: false, reason: 'semanticHtml is required' };
+    }
+
+    if (!data.transformRules) {
+      return { eligible: false, reason: 'transformRules is required' };
+    }
+
+    if (!hasText(data.transformRules.selector)) {
+      return { eligible: false, reason: 'transformRules.selector is required' };
+    }
+
+    if (!this.validActions.includes(data.transformRules.action)) {
+      return { eligible: false, reason: `transformRules.action must be one of: ${this.validActions.join(', ')}` };
+    }
+
+    return { eligible: true };
+  }
+}

package/src/utils/html-utils.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { fromHtml } from 'hast-util-from-html';
+
+/**
+ * Converts HTML string to HAST (Hypertext Abstract Syntax Tree) format
+ * @param {string} html - HTML string
+ * @returns {Object} - HAST object
+ */
+export function htmlToHast(html) {
+  return fromHtml(html, { fragment: true });
+}

package/test/fixtures/semantic-value-visibility/Carahsoft.json

@@ -0,0 +1,202 @@
+{
+  "url": "https://carahsoft.com/",
+  "opportunityType": "semantic-value-visibility",
+  "suggestions": [
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/6617/6522/3539/WEST-2026_Homepage-Banner-Updated.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/6617/6522/3539/WEST-2026_Homepage-Banner-Updated.jpg\">\n  <span>carahsoft</span>\n  <h2>Carahsoft and Partners at WEST 2026</h2>\n  <span>February 10 - 12, 2026 \u2022 San Diego, CA</span>\n  <button>Learn More</button>\n</section>",
+        "detectedText": [
+          "carahsoft ",
+          "Carahsoft and Partners",
+          "at WEST 2026",
+          "February 10",
+          "12, 2026",
+          "San Diego, CA",
+          "Learn More "
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/6617/6522/3539/WEST-2026_Homepage-Banner-Updated.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/2317/6979/1365/Carahsoft_GovExec_GovExperience_Summit_2026_1140x325.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/2317/6979/1365/Carahsoft_GovExec_GovExperience_Summit_2026_1140x325.jpg\">\n  <span>carahsoft</span>\n  <span>GovExec</span>\n  <h2>GovExperience SUMMIT</h2>\n  <p>Advancing Government Service Delivery &amp; CX</p>\n  <button>Register Now</button>\n  <span>June 2, 2026</span>\n  <span>Reston, VA</span>\n</section>",
+        "detectedText": [
+          "carahsoft",
+          "powered by",
+          "GovExec",
+          "Gov Experience",
+          "SUMMIT",
+          "Advancing Government",
+          "Service Delivery & CX",
+          "Register Now",
+          "June 2,2026",
+          "Reston; VA"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/2317/6979/1365/Carahsoft_GovExec_GovExperience_Summit_2026_1140x325.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/1417/7022/0984/OneGov-Graphics-2026-Homepage-Banner.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/1417/7022/0984/OneGov-Graphics-2026-Homepage-Banner.jpg\">\n  <span>OneGov Offerings Available Now</span>\n  <h2>Cost-Saving Technology Solutions for Government</h2>\n  <button>View Special Offers</button>\n  <span>carahsoft</span>\n</section>",
+        "detectedText": [
+          "OneGov",
+          "Offerings Available Now",
+          "Cost-Saving Technology",
+          "Solutions for Government",
+          "View Special Offers",
+          "carahsoft"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/1417/7022/0984/OneGov-Graphics-2026-Homepage-Banner.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/6017/3990/9507/SGT-Home-page-Banner.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/6017/3990/9507/SGT-Home-page-Banner.jpg\">\n  <span>carahsoft.</span>\n  <h2>Explore all our Self-Guided Tours for Government</h2>\n  <button>Tour Our Solutions</button>\n</section>",
+        "detectedText": [
+          "carahsoft",
+          "Explore all our Self-Guided",
+          "Tours for Government",
+          "Tour Our Solutions"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/6017/3990/9507/SGT-Home-page-Banner.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/1517/4076/7653/Buyers-Guide-Hub-Banners_Homepage-Banner.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/1517/4076/7653/Buyers-Guide-Hub-Banners_Homepage-Banner.jpg\">\n  <span>carahsoft</span>\n  <h2>Explore Carahsoft\u2019s Buyer\u2019s Guides for Government</h2>\n  <button>View our Buyer\u2019s Guides</button>\n</section>",
+        "detectedText": [
+          "carahsoft",
+          "40",
+          "Explore Carahsoft'$ Buyer's Guides",
+          "for Government",
+          "View our Buyer's Guides",
+          "Govet",
+          "OSINT"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/1517/4076/7653/Buyers-Guide-Hub-Banners_Homepage-Banner.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/6117/6997/1583/SF-AppExchange-Self-Guided-Tour--home-page.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/6117/6997/1583/SF-AppExchange-Self-Guided-Tour--home-page.jpg\">\n  <span>carahsoft</span>\n  <h2>Explore Our Salesforce AppExchange Self-Guided Tours</h2>\n  <button>Discover Public Sector Solutions</button>\n</section>",
+        "detectedText": [
+          "carahsoft",
+          "Explore Our Salesforce",
+          "AppExchange Self-Guided Tours",
+          "Discover Public Sector Solutions"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/6117/6997/1583/SF-AppExchange-Self-Guided-Tour--home-page.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/1617/6997/1435/Carahsoft-Public-Sector-Partners.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/1617/6997/1435/Carahsoft-Public-Sector-Partners.jpg\">\n  <span>carahsoft</span>\n  <h2>Explore Our Salesforce Partner Program Self-Guided Tours</h2>\n  <button>Discover Public Sector Solutions</button>\n</section>",
+        "detectedText": [
+          "carahsoft",
+          "Explore Our Salesforce",
+          "Partner Program Self-Guided Tours",
+          "Discover Public Sector Solutions"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/1617/6997/1435/Carahsoft-Public-Sector-Partners.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/6317/4480/9746/NextGovFCW_IIG_Report_April_The_Essential_Elements_of_IT_Modernization_homepage.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/6317/4480/9746/NextGovFCW_IIG_Report_April_The_Essential_Elements_of_IT_Modernization_homepage.jpg\">\n  <span>Innovation in Government</span>\n  <span>carahsoft</span>\n  <h2>The Essential Elements of</h2>\n  <span>IN PARTNERSHIP WITH:</span>\n  <span>Dell Technologies</span>\n  <button>READ THE REPORT HERE</button>\n</section>",
+        "detectedText": [
+          "Innovation",
+          "in Government",
+          "carahsoft",
+          "The Essential Elements of",
+          "IN PARTNERSHIP WITH:",
+          "DALTechnologies",
+          "READ THE REPORT HERE"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/6317/4480/9746/NextGovFCW_IIG_Report_April_The_Essential_Elements_of_IT_Modernization_homepage.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/4217/4481/0167/FCW_Sept_Oct_homepage.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/4217/4481/0167/FCW_Sept_Oct_homepage.jpg\">\n  <span>INNOVATION IN GOVERNMENT</span>\n  <span>NEXTGOV FCW</span>\n  <h2>Delving Deeper into Open-Source Intelligence</h2>\n  <button>READ THE REPORT HERE</button>\n</section>",
+        "detectedText": [
+          "INNOVATION IN GOVERNMENT",
+          "NEXTCOVI",
+          "FCW",
+          "Delving Deeper into",
+          "Open-Source Intelligence",
+          "READ THE REPORT HERE"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/4217/4481/0167/FCW_Sept_Oct_homepage.jpg\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://static.carahsoft.com/concrete/files/7017/4481/0098/FCW_AI_homepage.jpg",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://static.carahsoft.com/concrete/files/7017/4481/0098/FCW_AI_homepage.jpg\">\n  <span>Innovation in Government</span>\n  <span>IN PARTNERSHIP WITH: carahsoft</span>\n  <h2>COLLABORATING FOR</h2>\n  <h2>Responsible AI in National Security</h2>\n  <button>READ THE REPORT HERE</button>\n</section>",
+        "detectedText": [
+          "Innovation",
+          "IN PARTNERSHIP WITH: carahsoft",
+          "in Government\"",
+          "Responsible AI in",
+          "National Security",
+          "READ THE REPORT HERE"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://static.carahsoft.com/concrete/files/7017/4481/0098/FCW_AI_homepage.jpg\"]"
+        }
+      }
+    }
+  ],
+  "stats": {
+    "totalImages": 10,
+    "successfulSuggestions": 10,
+    "noGuidanceNeeded": 0
+  }
+}

package/test/fixtures/semantic-value-visibility/Koffievoordeel.json

@@ -0,0 +1,112 @@
+{
+  "url": "https://koffievoordeel.nl/",
+  "opportunityType": "semantic-value-visibility",
+  "suggestions": [
+    {
+      "data": {
+        "imageUrl": "https://www.koffievoordeel.nl/media/wysiwyg/gmi_sample_doos_7-99_kvdnl_kvd_web_hero_desk.jpg?quality=85&fit=bounds",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://www.koffievoordeel.nl/media/wysiwyg/gmi_sample_doos_7-99_kvdnl_kvd_web_hero_desk.jpg?quality=85&fit=bounds\">\n  <span>Gran Maestro Italiano</span>\n  <h2>Probeerpakket</h2>\n  <span>Nu slechts 7,99</span>\n</section>",
+        "detectedText": [
+          "Gran Maestro Italiano",
+          "Probeerpakket",
+          "Nu slechts",
+          "99",
+          "GRAN",
+          "MAESTRO",
+          "tatiano"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://www.koffievoordeel.nl/media/wysiwyg/gmi_sample_doos_7-99_kvdnl_kvd_web_hero_desk.jpg?quality=85&fit=bounds\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://www.koffievoordeel.nl/media/wysiwyg/D6417_abonnementen_resfresh_web_hero_desk.jpg?quality=85&fit=bounds",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://www.koffievoordeel.nl/media/wysiwyg/D6417_abonnementen_resfresh_web_hero_desk.jpg?quality=85&fit=bounds\">\n  <h2>Koffie abonnementen</h2>\n  <span>Tot 20% extra korting + gratis bezorging</span>\n  <span>L\u2019OR</span>\n</section>",
+        "detectedText": [
+          "Koffie",
+          "abonnementen",
+          "DORO",
+          "ORC",
+          "gratis bezorging",
+          "illy"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://www.koffievoordeel.nl/media/wysiwyg/D6417_abonnementen_resfresh_web_hero_desk.jpg?quality=85&fit=bounds\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://www.koffievoordeel.nl/media/wysiwyg/D6360_voordeelpakketen_gmi_web_hero_desk_kvdnl_2.jpg?quality=85&fit=bounds",
+        "urlAttribute": "src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://www.koffievoordeel.nl/media/wysiwyg/D6360_voordeelpakketen_gmi_web_hero_desk_kvdnl_2.jpg?quality=85&fit=bounds\">\n  <h2>Voordeelpakketten:</h2>\n  <span>Nu n\u00f3g voordeliger!</span>\n  <button>Extra voordeel</button>\n</section>",
+        "detectedText": [
+          "Voordeelpakketten:",
+          "Nu nog voordeliger!",
+          "voordeel",
+          "tatiano",
+          "aliano",
+          "00"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[src=\"https://www.koffievoordeel.nl/media/wysiwyg/D6360_voordeelpakketen_gmi_web_hero_desk_kvdnl_2.jpg?quality=85&fit=bounds\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://www.koffievoordeel.nl/media/wysiwyg/D6927_coffee_finder_winter_web_hero_desk_kvdxx_1.png?quality=85&fit=bounds",
+        "urlAttribute": "data-src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://www.koffievoordeel.nl/media/wysiwyg/D6927_coffee_finder_winter_web_hero_desk_kvdxx_1.png?quality=85&fit=bounds\">\n  <h2>Coffee Finder</h2>\n  <p>Voor hetzelfde geld betere koffie?</p>\n  <button>Doe de test \u2192</button>\n</section>",
+        "detectedText": [
+          "Coffee",
+          "Finder",
+          "Voor hetzelfde geld",
+          "betere koffie?",
+          "Doe de test"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[data-src=\"https://www.koffievoordeel.nl/media/wysiwyg/D6927_coffee_finder_winter_web_hero_desk_kvdxx_1.png?quality=85&fit=bounds\"]"
+        }
+      }
+    },
+    {
+      "data": {
+        "imageUrl": "https://www.koffievoordeel.nl/media/wysiwyg/kk_Algemeen_EB_KVDNL_kvd_web_hero_desk_7.jpg?quality=85&fit=bounds",
+        "urlAttribute": "data-src",
+        "semanticHtml": "<section data-llm-context=\"image\" data-llm-shadow=\"image-text\" data-image-id=\"https://www.koffievoordeel.nl/media/wysiwyg/kk_Algemeen_EB_KVDNL_kvd_web_hero_desk_7.jpg?quality=85&fit=bounds\">\n  <h2>Deze week: \u20ac10 koffie</h2>\n  <span>GRAN MAESTRO</span>\n  <span>SLOW ROAST</span>\n  <span>cadeaul</span>\n  <span>ESPRESSO</span>\n  <span>ORIGINALE</span>\n  <span>DOKO</span>\n  <span>Bean?</span>\n  <span>CELESTE</span>\n</section>",
+        "detectedText": [
+          "Deze week:",
+          "\u20ac10 koffie",
+          "GRAN",
+          "MAESTRO",
+          "SLOW",
+          "ROAST",
+          "cadeaul",
+          "ESPRESSO",
+          "ORIGINALE",
+          "DOKO",
+          "Bean?",
+          "CELESTE"
+        ],
+        "transformRules": {
+          "action": "insertAfter",
+          "selector": "img[data-src=\"https://www.koffievoordeel.nl/media/wysiwyg/kk_Algemeen_EB_KVDNL_kvd_web_hero_desk_7.jpg?quality=85&fit=bounds\"]"
+        }
+      }
+    }
+  ],
+  "stats": {
+    "totalImages": 5,
+    "successfulSuggestions": 5,
+    "noGuidanceNeeded": 0
+  }
+}