@adobe/spacecat-shared-tokowaka-client 1.4.2 → 1.4.4

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-tokowaka-client-v1.4.4](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-tokowaka-client-v1.4.3...@adobe/spacecat-shared-tokowaka-client-v1.4.4) (2026-01-05)
+
+
+### Bug Fixes
+
+* allow replaceWith and appendChild in tokowaka generic patch ([#1245](https://github.com/adobe/spacecat-shared/issues/1245)) ([dcb1beb](https://github.com/adobe/spacecat-shared/commit/dcb1beb8e9b7b176406cfebbc5ae6a53ea0f17f4))
+
+# [@adobe/spacecat-shared-tokowaka-client-v1.4.3](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-tokowaka-client-v1.4.2...@adobe/spacecat-shared-tokowaka-client-v1.4.3) (2025-12-12)
+
+
+### Bug Fixes
+
+* revert using preview key in Edge Preview API ([#1244](https://github.com/adobe/spacecat-shared/issues/1244)) ([8ac3ff6](https://github.com/adobe/spacecat-shared/commit/8ac3ff6b397a2235f1df4fffa6918f6fe6dc107d)), closes [adobe/spacecat-shared#1228](https://github.com/adobe/spacecat-shared/issues/1228)
+
 # [@adobe/spacecat-shared-tokowaka-client-v1.4.2](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-tokowaka-client-v1.4.1...@adobe/spacecat-shared-tokowaka-client-v1.4.2) (2025-12-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-tokowaka-client",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "Tokowaka Client for SpaceCat - Edge optimization config management",
   "type": "module",
   "engines": {

package/src/index.js

@@ -700,11 +700,11 @@ class TokowakaClient {
    */
   async previewSuggestions(site, opportunity, suggestions, options = {}) {
     // Get site's forwarded host for preview
-    const { forwardedHost } = site.getConfig()?.getTokowakaConfig() || {};
+    const { forwardedHost, apiKey } = site.getConfig()?.getTokowakaConfig() || {};
 
-    if (!hasText(forwardedHost)) {
+    if (!hasText(forwardedHost) || !hasText(apiKey)) {
       throw this.#createError(
-        'Site does not have a Tokowaka forwarded host configured. '
+        'Site does not have a Tokowaka API key or forwarded host configured. '
         + 'Please onboard the site to Tokowaka first.',
         HTTP_BAD_REQUEST,
       );
@@ -720,15 +720,6 @@ class TokowakaClient {
       );
     }
 
-    // TOKOWAKA_PREVIEW_API_KEY is mandatory for preview
-    const tokowakaPreviewApiKey = this.env.TOKOWAKA_PREVIEW_API_KEY;
-    if (!hasText(tokowakaPreviewApiKey)) {
-      throw this.#createError(
-        'TOKOWAKA_PREVIEW_API_KEY is required for preview functionality',
-        HTTP_INTERNAL_SERVER_ERROR,
-      );
-    }
-
     // TOKOWAKA_EDGE_URL is mandatory for preview
     const tokowakaEdgeUrl = this.env.TOKOWAKA_EDGE_URL;
     if (!hasText(tokowakaEdgeUrl)) {
@@ -826,7 +817,7 @@ class TokowakaClient {
       // Fetch original HTML (without preview)
       originalHtml = await fetchHtmlWithWarmup(
         previewUrl,
-        tokowakaPreviewApiKey,
+        apiKey,
         forwardedHost,
         tokowakaEdgeUrl,
         this.log,
@@ -836,7 +827,7 @@ class TokowakaClient {
       // Then fetch optimized HTML (with preview)
       optimizedHtml = await fetchHtmlWithWarmup(
         previewUrl,
-        tokowakaPreviewApiKey,
+        apiKey,
         forwardedHost,
         tokowakaEdgeUrl,
         this.log,

package/src/mappers/generic-mapper.js

@@ -104,7 +104,7 @@ export default class GenericMapper extends BaseOpportunityMapper {
     }
 
     // Validate action value
-    const validOperations = ['insertBefore', 'insertAfter', 'replace'];
+    const validOperations = ['insertBefore', 'insertAfter', 'replace', 'replaceWith', 'appendChild'];
     if (!validOperations.includes(data.transformRules.action)) {
       return {
         eligible: false,

package/src/utils/custom-html-utils.js

@@ -89,7 +89,7 @@ async function fetchWithRetry(url, options, maxRetries, retryDelayMs, log, fetch
  * Fetches HTML content from Tokowaka edge with warmup call and retry logic
  * Makes an initial warmup call, waits, then makes the actual call with retries
  * @param {string} url - Full URL to fetch
- * @param {string} previewApiKey - Tokowaka preview API key (internal)
+ * @param {string} apiKey - Tokowaka API key
  * @param {string} forwardedHost - Host to forward in x-forwarded-host header
  * @param {string} tokowakaEdgeUrl - Tokowaka edge URL
  * @param {boolean} isOptimized - Whether to fetch optimized HTML (with preview param)
@@ -103,7 +103,7 @@ async function fetchWithRetry(url, options, maxRetries, retryDelayMs, log, fetch
  */
 export async function fetchHtmlWithWarmup(
   url,
-  previewApiKey,
+  apiKey,
   forwardedHost,
   tokowakaEdgeUrl,
   log,
@@ -115,8 +115,8 @@ export async function fetchHtmlWithWarmup(
     throw new Error('URL is required for fetching HTML');
   }
 
-  if (!hasText(previewApiKey)) {
-    throw new Error('Tokowaka preview API key is required for fetching HTML');
+  if (!hasText(apiKey)) {
+    throw new Error('Tokowaka API key is required for fetching HTML');
   }
 
   if (!hasText(forwardedHost)) {
@@ -143,7 +143,7 @@ export async function fetchHtmlWithWarmup(
 
   const headers = {
     'x-forwarded-host': forwardedHost,
-    'x-tokowaka-preview-api-key': previewApiKey,
+    'x-tokowaka-api-key': apiKey,
     'x-tokowaka-url': urlPath,
   };
 

package/test/index.test.js

@@ -64,7 +64,8 @@ describe('TokowakaClient', () => {
       getBaseURL: () => 'https://example.com',
       getConfig: () => ({
         getTokowakaConfig: () => ({
-          forwardedHost: 'www.example.com',
+          forwardedHost: 'example.com',
+          apiKey: 'test-api-key',
         }),
       }),
     };
@@ -1697,16 +1698,14 @@ describe('TokowakaClient', () => {
       // Stub fetchConfig to return null by default (no existing config)
       sinon.stub(client, 'fetchConfig').resolves(null);
 
-      // Add TOKOWAKA_EDGE_URL and TOKOWAKA_PREVIEW_API_KEY to env
+      // Add TOKOWAKA_EDGE_URL to env
       client.env.TOKOWAKA_EDGE_URL = 'https://edge-dev.tokowaka.now';
-      client.env.TOKOWAKA_PREVIEW_API_KEY = 'internal-preview-key-123';
     });
 
     afterEach(() => {
       // fetchStub will be restored by global afterEach sinon.restore()
       // Just clean up env changes
       delete client.env.TOKOWAKA_EDGE_URL;
-      delete client.env.TOKOWAKA_PREVIEW_API_KEY;
     });
 
     it('should preview suggestions successfully with HTML', async () => {
@@ -1735,18 +1734,6 @@ describe('TokowakaClient', () => {
       expect(s3Client.send).to.have.been.calledOnce;
     });
 
-    it('should throw error if TOKOWAKA_PREVIEW_API_KEY is not configured', async () => {
-      delete client.env.TOKOWAKA_PREVIEW_API_KEY;
-
-      try {
-        await client.previewSuggestions(mockSite, mockOpportunity, mockSuggestions);
-        expect.fail('Should have thrown error');
-      } catch (error) {
-        expect(error.message).to.include('TOKOWAKA_PREVIEW_API_KEY is required for preview');
-        expect(error.status).to.equal(500);
-      }
-    });
-
     it('should preview prerender-only suggestions with no patches', async () => {
       // Update fetchConfig to return existing config with deployed patches
       client.fetchConfig.resolves({
@@ -1826,7 +1813,7 @@ describe('TokowakaClient', () => {
         await client.previewSuggestions(mockSite, mockOpportunity, mockSuggestions);
         expect.fail('Should have thrown error');
       } catch (error) {
-        expect(error.message).to.include('Site does not have a Tokowaka forwarded host configured');
+        expect(error.message).to.include('Site does not have a Tokowaka API key or forwarded host configured');
         expect(error.status).to.equal(400);
       }
     });
@@ -1840,7 +1827,7 @@ describe('TokowakaClient', () => {
         await client.previewSuggestions(mockSite, mockOpportunity, mockSuggestions);
         expect.fail('Should have thrown error');
       } catch (error) {
-        expect(error.message).to.include('Site does not have a Tokowaka forwarded host configured');
+        expect(error.message).to.include('Site does not have a Tokowaka API key or forwarded host configured');
         expect(error.status).to.equal(400);
       }
     });

package/test/mappers/generic-mapper.test.js

@@ -248,7 +248,7 @@ describe('GenericMapper', () => {
 
       expect(result).to.deep.equal({
         eligible: false,
-        reason: 'transformRules.action must be one of: insertBefore, insertAfter, replace. Got: invalidOperation',
+        reason: 'transformRules.action must be one of: insertBefore, insertAfter, replace, replaceWith, appendChild. Got: invalidOperation',
       });
     });
 

package/test/utils/html-utils.test.js

@@ -54,7 +54,7 @@ describe('HTML Utils', () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
-          'preview-api-key',
+          'api-key',
           '',
           'edge-url',
           log,
@@ -70,7 +70,7 @@ describe('HTML Utils', () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
-          'preview-api-key',
+          'api-key',
           'host',
           '',
           log,
@@ -82,7 +82,7 @@ describe('HTML Utils', () => {
       }
     });
 
-    it('should throw error when preview API key is missing', async () => {
+    it('should throw error when apiKey is missing', async () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
@@ -94,7 +94,7 @@ describe('HTML Utils', () => {
         );
         expect.fail('Should have thrown error');
       } catch (error) {
-        expect(error.message).to.equal('Tokowaka preview API key is required for fetching HTML');
+        expect(error.message).to.equal('Tokowaka API key is required for fetching HTML');
       }
     });
 
@@ -111,7 +111,7 @@ describe('HTML Utils', () => {
 
       const html = await fetchHtmlWithWarmup(
         'https://example.com/page',
-        'preview-api-key',
+        'api-key',
         'host',
         'https://edge.example.com',
         log,
@@ -136,7 +136,7 @@ describe('HTML Utils', () => {
 
       const html = await fetchHtmlWithWarmup(
         'https://example.com/page?param=value',
-        'preview-api-key',
+        'api-key',
         'host',
         'https://edge.example.com',
         log,
@@ -178,7 +178,7 @@ describe('HTML Utils', () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
-          'preview-api-key',
+          'api-key',
           'host',
           'https://edge.example.com',
           log,
@@ -208,7 +208,7 @@ describe('HTML Utils', () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
-          'preview-api-key',
+          'api-key',
           'host',
           'https://edge.example.com',
           log,
@@ -239,7 +239,7 @@ describe('HTML Utils', () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
-          'preview-api-key',
+          'api-key',
           'host',
           'https://edge.example.com',
           log,
@@ -319,7 +319,7 @@ describe('HTML Utils', () => {
 
       const html = await fetchHtmlWithWarmup(
         'https://example.com/page',
-        'preview-api-key',
+        'api-key',
         'host',
         'https://edge.example.com',
         log,
@@ -375,7 +375,7 @@ describe('HTML Utils', () => {
       try {
         await fetchHtmlWithWarmup(
           'https://example.com/page',
-          'preview-api-key',
+          'api-key',
           'host',
           'https://edge.example.com',
           log,
@@ -416,7 +416,7 @@ describe('HTML Utils', () => {
 
       const html = await fetchHtmlWithWarmup(
         'https://example.com/page',
-        'preview-api-key',
+        'api-key',
         'host',
         'https://edge.example.com',
         log,