From 60ce24f4c53467294a9b52307337d670a404eec9 Mon Sep 17 00:00:00 2001
From: Aravind Kumar <aravind.kumar@contentstack.com>
Date: Tue, 15 Sep 2026 10:29:58 +0530
Subject: [PATCH 01/16] Update npm-publish.yml

---
 .github/workflows/npm-publish.yml | 43 +++++++++++++++++--------------
 1 file changed, 23 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml
index 5451d01b..dac97090 100644
--- a/.github/workflows/npm-publish.yml
+++ b/.github/workflows/npm-publish.yml
@@ -1,22 +1,25 @@
-name: Publish Package to npmjs
+name: Publish package to npmjs registry
 on:
-    release:
-        types: [created]
+  release:
+    types: [published]
 jobs:
-    build:
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        steps:
-            - uses: actions/checkout@v4
-            # Setup .npmrc file to publish to npm
-            - uses: actions/setup-node@v4
-              with:
-                  node-version: "18"
-                  registry-url: "https://registry.npmjs.org"
-            - run: npm ci
-            - run: npm run build
-            - run: npm publish --provenance --access public
-              env:
-                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+  publish-npm:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          persist-credentials: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org/
+          cache: 'npm'
+      - run: npm ci
+      - name: Update npm
+        run: npm install -g npm@latest
+      - name: Release
+        run: npm publish --provenance --access public

From 89811da4bf36528c30d2efc14c5d01594234a501 Mon Sep 17 00:00:00 2001
From: Aravind Kumar <aravind.kumar@contentstack.com>
Date: Tue, 15 Sep 2026 10:33:36 +0530
Subject: [PATCH 02/16] Update npm-publish.yml

---
 .github/workflows/npm-publish.yml | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml
index dac97090..a2d93536 100644
--- a/.github/workflows/npm-publish.yml
+++ b/.github/workflows/npm-publish.yml
@@ -3,8 +3,30 @@ on:
   release:
     types: [published]
 jobs:
-  publish-npm:
+  publish:
     runs-on: ubuntu-latest
+    if: ${{ !endsWith(github.event.release.name, '-alpha')  }}
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          persist-credentials: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org/
+          cache: 'npm'
+      - run: npm ci
+      - name: Update npm
+        run: npm install -g npm@latest
+      - name: Release
+        run: npm publish --provenance --access public
+  publish-alpha:
+    runs-on: ubuntu-latest
+    if: ${{ endsWith(github.event.release.name, '-alpha')  }}
     permissions:
       contents: read
       id-token: write

From 71a26ad7dc3a9534c2513858a0fa574fd8940be4 Mon Sep 17 00:00:00 2001
From: Aravind Kumar <aravind.kumar@contentstack.com>
Date: Tue, 15 Sep 2026 10:33:48 +0530
Subject: [PATCH 03/16] Delete .github/workflows/npm-alpha-publish.yml

---
 .github/workflows/npm-alpha-publish.yml | 31 -------------------------
 1 file changed, 31 deletions(-)
 delete mode 100644 .github/workflows/npm-alpha-publish.yml

diff --git a/.github/workflows/npm-alpha-publish.yml b/.github/workflows/npm-alpha-publish.yml
deleted file mode 100644
index 68541cff..00000000
--- a/.github/workflows/npm-alpha-publish.yml
+++ /dev/null
@@ -1,31 +0,0 @@
-name: Publish Alpha Package to npmjs
-on:
-    push:
-        branches:
-            - "alpha/*"
-        tags:
-            - "v*.*.*-alpha.*"
-
-jobs:
-    build:
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        steps:
-            - uses: actions/checkout@v4
-
-            # Setup Node.js and npm registry
-            - uses: actions/setup-node@v4
-              with:
-                  node-version: "18"
-                  registry-url: "https://registry.npmjs.org"
-                  always-auth: true
-
-            - run: npm ci
-            - run: npm run build
-
-            # Publish package to npm under the "alpha" tag
-            - run: npm publish --tag alpha --provenance
-              env:
-                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

From 76e6a9dc6748f15d459320ced52da95e403bb9bf Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Wed, 16 Sep 2026 10:38:37 +0530
Subject: [PATCH 04/16] fix(release): build on prepack so dist ships in the
 published package

v4.5.1 was published with only package.json, README.md and LICENSE. The
package has no JS in it, so every consumer build fails on import while
main, module, types and exports all point into dist/.

The publish workflow dropped its `npm run build` step when it was
rewritten on 15 Sept. Nothing else builds before publish: there is no
prepack or prepublishOnly script, and with no `files` field npm falls
back to .gitignore, which excludes dist. No build means an empty package.

Hooking the build to prepack fixes it for every publish path rather than
just the one workflow, so a later workflow edit cannot silently drop it
again. A failing build now fails the publish instead of shipping nothing.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 package.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/package.json b/package.json
index 350bee73..a4ea26f6 100644
--- a/package.json
+++ b/package.json
@@ -31,6 +31,7 @@
         "test:coverage": "vitest --coverage",
         "dev": "NODE_OPTIONS='--max-old-space-size=16384' tsup --watch --config tsup.config.dev.js",
         "prepare": "husky",
+        "prepack": "npm run build",
         "lint": "eslint src",
         "lint:fix": "eslint --fix",
         "prettier": "prettier src --check",

From 86f5187abd0a861bdd8a328f9cab04df926f5c0c Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Wed, 16 Sep 2026 10:58:44 +0530
Subject: [PATCH 05/16] fix(release): publish prereleases under the alpha
 dist-tag

When npm-alpha-publish.yml was folded into this workflow the publish-alpha
job came out identical to publish, losing the `--tag alpha` the old
workflow had. An alpha release would move the `latest` dist-tag to the
prerelease and hand it to every consumer on a caret range.

This also restores the alpha channel as a rehearsal for a real publish:
cut a prerelease, install it, confirm it resolves, then cut the release,
all without touching `latest`.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .github/workflows/npm-publish.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml
index a2d93536..7921a333 100644
--- a/.github/workflows/npm-publish.yml
+++ b/.github/workflows/npm-publish.yml
@@ -44,4 +44,5 @@ jobs:
       - name: Update npm
         run: npm install -g npm@latest
       - name: Release
-        run: npm publish --provenance --access public
+        # Without --tag alpha npm moves the latest tag to the prerelease
+        run: npm publish --tag alpha --provenance --access public

From fd8e6af5a8b4b5c8cdd512955180b943616c0c26 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Wed, 16 Sep 2026 11:43:08 +0530
Subject: [PATCH 06/16] chore(ci): pin vitest-coverage-report-action to a
 commit sha

A version tag is mutable, so the action owner or anyone who compromises
that account can change what runs in CI without the ref changing here.
Pinning to the commit sha behind v2.13.0 keeps the same code and removes
that path.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .github/workflows/unit-test.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/unit-test.yml b/.github/workflows/unit-test.yml
index 9ec05a51..38fd9e69 100644
--- a/.github/workflows/unit-test.yml
+++ b/.github/workflows/unit-test.yml
@@ -26,4 +26,4 @@ jobs:
               # Set if: always() to also generate the report if tests are failing
               # Only works if you set `reportOnFailure: true` in your vite config as specified above
               if: always()
-              uses: davelosert/vitest-coverage-report-action@v2
+              uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0

From f3af40c257ededa9ffca3fff8dc4ab79b06ba5ee Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Wed, 16 Sep 2026 12:01:52 +0530
Subject: [PATCH 07/16] 4.5.2

---
 CHANGELOG.md      | 33 ++++++++++++++++++++++++++++++++-
 package-lock.json |  4 ++--
 package.json      |  2 +-
 3 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e7a59903..efcfb33f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,25 @@
 # Changelog
 
+## [v4.5.2](https://github.com/contentstack/live-preview-sdk/compare/v4.5.1...v4.5.2)
+
+> 16 September 2026
+
+### Fixes
+
+- fix(release): restore build before publish and the alpha dist-tag (Kirtesh Suthar - [#650](https://github.com/contentstack/live-preview-sdk/pull/650))
+
+### Fixes
+
+- fix(release): publish prereleases under the alpha dist-tag (Kirtesh Suthar - [86f5187](https://github.com/contentstack/live-preview-sdk/commit/86f5187abd0a861bdd8a328f9cab04df926f5c0c))
+- fix(release): build on prepack so dist ships in the published package (Kirtesh Suthar - [76e6a9d](https://github.com/contentstack/live-preview-sdk/commit/76e6a9dc6748f15d459320ced52da95e403bb9bf))
+
+### Chores And Housekeeping
+
+- chore(ci): pin vitest-coverage-report-action to a commit sha (Kirtesh Suthar - [fd8e6af](https://github.com/contentstack/live-preview-sdk/commit/fd8e6af5a8b4b5c8cdd512955180b943616c0c26))
+
 ## [v4.5.1](https://github.com/contentstack/live-preview-sdk/compare/v4.5.0...v4.5.1)
 
-> 10 September 2026
+> 15 September 2026
 
 ### Fixes
 
@@ -11,15 +28,22 @@
 
 ### Chores And Housekeeping
 
+- chore(release): v4.5.1 (Kirtesh Suthar - [#646](https://github.com/contentstack/live-preview-sdk/pull/646))
 - chore: sync develop_v4 with stage_v4 (Kirtesh Suthar - [#645](https://github.com/contentstack/live-preview-sdk/pull/645))
 - chore(tests): standardize api key placeholder values in specs (Hitesh Shetty - [#639](https://github.com/contentstack/live-preview-sdk/pull/639))
 
 ### General Changes
 
+- release: v4.5.1 (Kirtesh Suthar - [#647](https://github.com/contentstack/live-preview-sdk/pull/647))
 - Develop v4 (Kirtesh Suthar - [#640](https://github.com/contentstack/live-preview-sdk/pull/640))
 
+### Fixes
+
+- fix: update CDN version to 4.5.1 in README (Kirtesh Suthar - [e93cc36](https://github.com/contentstack/live-preview-sdk/commit/e93cc36a182d084fed01b3ee5b3262a51fb159fd))
+
 ### Chores And Housekeeping
 
+- chore: merge main into stage_v4 release branch (Kirtesh Suthar - [3d2e823](https://github.com/contentstack/live-preview-sdk/commit/3d2e8231f7e6cf21a8648d6435499f3773367510))
 - chore: merge stage_v4 into develop_v4 (Kirtesh Suthar - [e1dee0f](https://github.com/contentstack/live-preview-sdk/commit/e1dee0f33c15fbbeb9d7842ad70aba7610801524))
 - chore(deps): apply npm audit fix (hitesh-shetty-cstk - [ec144b9](https://github.com/contentstack/live-preview-sdk/commit/ec144b934935185f40efccfdcd09d4ac153222c8))
 
@@ -27,6 +51,13 @@
 
 - refactor(utils): one list for live preview's own query params (Kirtesh Suthar - [c179114](https://github.com/contentstack/live-preview-sdk/commit/c1791141dd7f22430f4f96d8070f4354dc9b641e))
 
+### General Changes
+
+- Update npm-publish.yml (Aravind Kumar - [60ce24f](https://github.com/contentstack/live-preview-sdk/commit/60ce24f4c53467294a9b52307337d670a404eec9))
+- Delete .github/workflows/npm-alpha-publish.yml (Aravind Kumar - [71a26ad](https://github.com/contentstack/live-preview-sdk/commit/71a26ad7dc3a9534c2513858a0fa574fd8940be4))
+- Update npm-publish.yml (Aravind Kumar - [89811da](https://github.com/contentstack/live-preview-sdk/commit/89811da4bf36528c30d2efc14c5d01594234a501))
+- Updated codeowners (Aravind Kumar - [4183387](https://github.com/contentstack/live-preview-sdk/commit/41833878124126b1cf74d92d8501f1d1eda1c06f))
+
 ## [v4.5.0](https://github.com/contentstack/live-preview-sdk/compare/v4.4.5...v4.5.0)
 
 > 11 August 2026
diff --git a/package-lock.json b/package-lock.json
index 15b27b0c..c4d7d09e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
     "name": "@contentstack/live-preview-utils",
-    "version": "4.5.1",
+    "version": "4.5.2",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "@contentstack/live-preview-utils",
-            "version": "4.5.1",
+            "version": "4.5.2",
             "license": "MIT",
             "dependencies": {
                 "@floating-ui/dom": "^1.7.2",
diff --git a/package.json b/package.json
index a4ea26f6..9c7b86b2 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@contentstack/live-preview-utils",
-    "version": "4.5.1",
+    "version": "4.5.2",
     "description": "Contentstack provides the Live Preview SDK to establish a communication channel between the various Contentstack SDKs and your website, transmitting  live changes to the preview pane.",
     "type": "module",
     "types": "dist/legacy/index.d.ts",

From 514013d8cf6cb2e6c65c0da11be39df1476a7444 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Wed, 16 Sep 2026 12:02:09 +0530
Subject: [PATCH 08/16] fix: update CDN version to 4.5.2 in README

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a136de21..64eb53b6 100644
--- a/README.md
+++ b/README.md
@@ -29,11 +29,11 @@ npm install @contentstack/live-preview-utils
 
 ### Load from a CDN (advanced)
 
-Pin the version to match your app (update `4.5.1` when you upgrade):
+Pin the version to match your app (update `4.5.2` when you upgrade):
 
 ```html
 <script type="module" crossorigin="anonymous">
-  import ContentstackLivePreview from "https://esm.sh/@contentstack/live-preview-utils@4.5.1";
+  import ContentstackLivePreview from "https://esm.sh/@contentstack/live-preview-utils@4.5.2";
 
   ContentstackLivePreview.init({
     stackDetails: {

From eb3a86ddf1c9b8c2382d345c0d3c17f61c1d6a01 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Thu, 17 Sep 2026 12:06:43 +0530
Subject: [PATCH 09/16] fix(visual-builder): handle rejection when discussion
 highlights has no listener

The visual builder registers the request-discussion-highlights listener
inside DiscussionPage, which Venus only mounts while the Discussions panel
is open. With the panel closed, which is the default, the send rejects with
NO_REQUEST_LISTENER_FOUND and nothing handles it. Next.js dev registers a
global unhandledrejection handler and renders the plain {code, message}
rejection as a runtime error overlay titled "[object Object]".

Handle the rejection at both send sites, since an absent receiver is the
expected state for this event rather than a failure.

Both branches of the isSSR check sent the same event, so the send is hoisted
out of the branch instead of being duplicated.

The spec mocked send as vi.fn(), which returns undefined rather than a
promise. Tests only passed because two later tests set mockResolvedValue and
vi.clearAllMocks does not reset implementations, so every test after them
inherited a promise. The base mock now matches the real contract.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../useVariantsPostMessageEvent.spec.ts       | 38 ++++++++++++++++++-
 .../useRecalculateVariantDataCSLPValues.ts    |  9 +++--
 .../useVariantsPostMessageEvent.ts            | 18 +++++----
 3 files changed, 53 insertions(+), 12 deletions(-)

diff --git a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
index 0ccd3941..22c3b5fb 100644
--- a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
+++ b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
@@ -48,7 +48,9 @@ vi.mock("../../../visualBuilder/utils/visualBuilderPostMessage", () => {
     return {
         default: {
             on: vi.fn(),
-            send: vi.fn(),
+            // send always returns a promise; tests that assert on rejection
+            // handling need the mock to match that contract.
+            send: vi.fn().mockResolvedValue(undefined),
         },
     };
 });
@@ -728,4 +730,38 @@ describe("useVariantFieldsPostMessageEvent SSR handling", () => {
         );
         expect(updateVariantClasses).toHaveBeenCalled();
     });
+
+    // The visual builder registers this listener only while the
+    // Discussions panel is open, so the send rejects on most page loads. Left
+    // unhandled it reaches Next.js's unhandledrejection hook and renders a
+    // "[object Object]" runtime error overlay in dev.
+    it("attaches a rejection handler to the send", async () => {
+        useVariantFieldsPostMessageEvent({ isSSR: true });
+        const call = mockVisualBuilderPostMessage.on.mock.calls.find(
+            (call: any[]) =>
+                call[0] === VisualBuilderPostMessageEvents.GET_VARIANT_ID
+        );
+        const handler = call ? call[1] : null;
+
+        const rejection = Promise.reject({
+            code: "NO_REQUEST_LISTENER_FOUND",
+            message:
+                'No request listener found for event "request-discussion-highlights"',
+        });
+        const catchSpy = vi.spyOn(rejection, "catch");
+        (mockVisualBuilderPostMessage.send as any).mockReturnValue(rejection);
+
+        try {
+            handler!({ data: { variant: "variant-123" } });
+            expect(catchSpy).toHaveBeenCalled();
+            await expect(rejection).rejects.toMatchObject({
+                code: "NO_REQUEST_LISTENER_FOUND",
+            });
+        } finally {
+            catchSpy.mockRestore();
+            (mockVisualBuilderPostMessage.send as any).mockResolvedValue(
+                undefined
+            );
+        }
+    });
 });
diff --git a/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts b/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts
index d44dd5ed..2827b041 100644
--- a/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts
+++ b/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts
@@ -14,9 +14,12 @@ const VARIANT_UPDATE_DELAY_MS: Readonly<number> = 8000;
 // Coalesce a burst of data-cslp mutations into a single request to the
 // visual editor.
 const requestDiscussionHighlights = debounce(() => {
-    visualBuilderPostMessage?.send(
-        VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
-    );
+    // Receiver is optional: the visual builder only listens while the
+    // Discussions panel is open, so a missing listener is expected and its
+    // rejection must not surface as an unhandled one.
+    visualBuilderPostMessage
+        ?.send(VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS)
+        .catch(() => {});
 }, 200);
 
 type OnAudienceModeVariantPatchUpdate = {
diff --git a/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts b/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts
index 33f98443..75a81112 100644
--- a/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts
+++ b/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts
@@ -167,17 +167,19 @@ export function useVariantFieldsPostMessageEvent({ isSSR }: { isSSR: boolean }):
                 if (selectedVariant) {
                     addVariantFieldClass(selectedVariant);
                 }
-                // SSR DOM is final; observer never fires, request directly.
-                visualBuilderPostMessage?.send(
-                    VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
-                );
             } else {
-                // CSR: observer in updateVariantClasses requests on settle.
+                // CSR: observer in updateVariantClasses also requests on settle.
                 updateVariantClasses();
-                visualBuilderPostMessage?.send(
-                    VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
-                );
             }
+            // Sent in both modes: SSR has no observer to fire it later. The
+            // receiver is optional — VB listens only while the Discussions
+            // panel is open — so the rejection must be handled here or it
+            // surfaces as an unhandled one.
+            visualBuilderPostMessage
+                ?.send(
+                    VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
+                )
+                .catch(() => {});
         }
     );
     visualBuilderPostMessage?.on(

From 19f80f9a69bd53ded3bf579d96ec6e36ad162904 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Thu, 17 Sep 2026 17:03:40 +0530
Subject: [PATCH 10/16] refactor(visual-builder): warn on real send failures,
 stay silent on a missing listener

Swallowing every rejection hid genuine problems. NO_ACK_RECEIVED,
WINDOW_CLOSED and CODE_RETURNED_ERROR would have been discarded as quietly
as the expected missing listener.

ignoreMissingListener returns silently only for NO_REQUEST_LISTENER_FOUND,
which is the normal state while the Discussions panel is closed, and warns
through PublicLogger for anything else. PublicLogger is already used across
the SDK and is silent under NODE_ENV=test, so this adds no console noise in
the common case.

The helper lives in its own module because the spec mocks the
visualBuilderPostMessage module wholesale; keeping it separate means tests
exercise the real function rather than a mock.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../useRecalculateVariantDataCSLPValues.ts    | 12 ++++--
 .../useVariantsPostMessageEvent.ts            | 12 ++++--
 .../utils/__test__/postMessageErrors.test.ts  | 43 +++++++++++++++++++
 src/visualBuilder/utils/postMessageErrors.ts  | 23 ++++++++++
 4 files changed, 82 insertions(+), 8 deletions(-)
 create mode 100644 src/visualBuilder/utils/__test__/postMessageErrors.test.ts
 create mode 100644 src/visualBuilder/utils/postMessageErrors.ts

diff --git a/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts b/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts
index 2827b041..c8810df0 100644
--- a/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts
+++ b/src/visualBuilder/eventManager/useRecalculateVariantDataCSLPValues.ts
@@ -6,6 +6,7 @@ import { visualBuilderStyles } from "../visualBuilder.style";
 import { isValidCslp } from "../../cslp/cslpdata";
 import { setHighlightVariantFields } from "./useVariantsPostMessageEvent";
 import visualBuilderPostMessage from "../utils/visualBuilderPostMessage";
+import { ignoreMissingListener } from "../utils/postMessageErrors";
 import { VisualBuilderPostMessageEvents } from "../utils/types/postMessage.types";
 import { debounce } from "lodash-es";
 
@@ -14,12 +15,15 @@ const VARIANT_UPDATE_DELAY_MS: Readonly<number> = 8000;
 // Coalesce a burst of data-cslp mutations into a single request to the
 // visual editor.
 const requestDiscussionHighlights = debounce(() => {
-    // Receiver is optional: the visual builder only listens while the
-    // Discussions panel is open, so a missing listener is expected and its
-    // rejection must not surface as an unhandled one.
+    // The visual builder listens only while the Discussions panel is open, so
+    // an absent receiver is expected here rather than a failure.
     visualBuilderPostMessage
         ?.send(VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS)
-        .catch(() => {});
+        .catch(
+            ignoreMissingListener(
+                VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
+            )
+        );
 }, 200);
 
 type OnAudienceModeVariantPatchUpdate = {
diff --git a/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts b/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts
index 75a81112..75d7f19e 100644
--- a/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts
+++ b/src/visualBuilder/eventManager/useVariantsPostMessageEvent.ts
@@ -1,6 +1,7 @@
 import { VisualBuilder } from "..";
 import { visualBuilderStyles } from "../visualBuilder.style";
 import visualBuilderPostMessage from "../utils/visualBuilderPostMessage";
+import { ignoreMissingListener } from "../utils/postMessageErrors";
 import { VisualBuilderPostMessageEvents } from "../utils/types/postMessage.types";
 import { FieldSchemaMap } from "../utils/fieldSchemaMap";
 import { updateVariantClasses } from "./useRecalculateVariantDataCSLPValues";
@@ -172,14 +173,17 @@ export function useVariantFieldsPostMessageEvent({ isSSR }: { isSSR: boolean }):
                 updateVariantClasses();
             }
             // Sent in both modes: SSR has no observer to fire it later. The
-            // receiver is optional — VB listens only while the Discussions
-            // panel is open — so the rejection must be handled here or it
-            // surfaces as an unhandled one.
+            // visual builder listens only while the Discussions panel is open,
+            // so an absent receiver is expected here rather than a failure.
             visualBuilderPostMessage
                 ?.send(
                     VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
                 )
-                .catch(() => {});
+                .catch(
+                    ignoreMissingListener(
+                        VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
+                    )
+                );
         }
     );
     visualBuilderPostMessage?.on(
diff --git a/src/visualBuilder/utils/__test__/postMessageErrors.test.ts b/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
new file mode 100644
index 00000000..dbaa2dbc
--- /dev/null
+++ b/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
@@ -0,0 +1,43 @@
+import { vi, describe, it, expect, beforeEach } from "vitest";
+import { ignoreMissingListener } from "../postMessageErrors";
+import { PublicLogger } from "../../../logger/logger";
+
+describe("ignoreMissingListener", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+
+    it("stays silent when the receiver is simply not mounted", () => {
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
+
+        ignoreMissingListener("request-discussion-highlights")({
+            code: "NO_REQUEST_LISTENER_FOUND",
+            message: 'No request listener found for event "x"',
+        });
+
+        expect(warn).not.toHaveBeenCalled();
+    });
+
+    it.each([
+        "NO_ACK_RECEIVED",
+        "WINDOW_CLOSED",
+        "CODE_RETURNED_ERROR",
+    ])("warns on %s so a real failure is still visible", (code) => {
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
+
+        ignoreMissingListener("request-discussion-highlights")({ code });
+
+        expect(warn).toHaveBeenCalledOnce();
+        expect(warn.mock.calls[0][0]).toContain(
+            "request-discussion-highlights"
+        );
+    });
+
+    it("warns when the rejection is not a coded object", () => {
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
+
+        ignoreMissingListener("some-event")(new Error("boom"));
+
+        expect(warn).toHaveBeenCalledOnce();
+    });
+});
diff --git a/src/visualBuilder/utils/postMessageErrors.ts b/src/visualBuilder/utils/postMessageErrors.ts
new file mode 100644
index 00000000..3c864e8a
--- /dev/null
+++ b/src/visualBuilder/utils/postMessageErrors.ts
@@ -0,0 +1,23 @@
+import { PublicLogger } from "../../logger/logger";
+
+// adv-post-message does not export ERROR_CODES from its entry point, so the
+// wire value is matched directly.
+const NO_REQUEST_LISTENER_FOUND = "NO_REQUEST_LISTENER_FOUND";
+
+/**
+ * Rejection handler for sends whose receiver is only mounted some of the time.
+ * A missing listener is the expected state and stays silent; every other
+ * failure (no ack, closed window, a throwing receiver) is warned about so a
+ * real breakage stays visible.
+ */
+export function ignoreMissingListener(event: string): (error: unknown) => void {
+    return (error: unknown) => {
+        if ((error as { code?: string })?.code === NO_REQUEST_LISTENER_FOUND) {
+            return;
+        }
+        PublicLogger.warn(
+            `Failed to send "${event}" to the visual builder`,
+            error
+        );
+    };
+}

From b78d2662f563f2261b02eea9a6b7088fc2485ee5 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Mon, 21 Sep 2026 11:39:27 +0530
Subject: [PATCH 11/16] fix(visual-builder): correct the documented rejection
 contract and cover the observer send

Review found that the helper's doc comment and its tests described rejection
shapes the library does not produce. Verified against
@contentstack/advanced-post-message 0.0.5: only the missing-listener reply
carries a code. The closed-window path rejects with an uncoded Error, the
no-ack timeout rejects with a bare string, and CODE_RETURNED_ERROR is logged
on the receiving side and never sent back, so the sender never sees it.

The handler already did the right thing for all of these, since an uncoded
rejection warns. Only the doc comment and the tests were wrong, so the code
check stays as the single rule and the comment now says so. Matching the
no-ack case too would mean matching on a message string, and a receiver that
never acks is worth a warning anyway.

Also from review:
- type the event parameter as VisualBuilderPostMessageEvents instead of string
- restate the send mock contract in beforeEach so the spec no longer depends
  on implementations leaking between tests, and drop the hand-restore
- add a spec for the debounced observer send, which had no coverage. The
  suite stubs MutationObserver globally in vitest.setup.ts, so the spec
  captures the observer callback and drives it directly.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 ...seRecalculateVariantDataCSLPValues.spec.ts | 97 +++++++++++++++++++
 .../useVariantsPostMessageEvent.spec.ts       | 30 +++---
 .../utils/__test__/postMessageErrors.test.ts  | 34 ++++---
 src/visualBuilder/utils/postMessageErrors.ts  | 13 ++-
 4 files changed, 144 insertions(+), 30 deletions(-)
 create mode 100644 src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts

diff --git a/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts b/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
new file mode 100644
index 00000000..9ac7a9e9
--- /dev/null
+++ b/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
@@ -0,0 +1,97 @@
+import { vi, describe, it, expect, beforeEach, afterEach } from "vitest";
+
+// Identity debounce so the observer's request fires within the test.
+vi.mock("lodash-es", async (importOriginal) => {
+    const actual = await importOriginal<typeof import("lodash-es")>();
+    return { ...actual, debounce: vi.fn((fn: any) => fn) };
+});
+
+vi.mock("../../../visualBuilder/utils/visualBuilderPostMessage", () => ({
+    default: { on: vi.fn(), send: vi.fn().mockResolvedValue(undefined) },
+}));
+
+vi.mock("../../../visualBuilder", () => ({
+    VisualBuilder: {
+        VisualBuilderGlobalState: {
+            value: { variant: null, highlightVariantFields: false },
+        },
+    },
+}));
+
+import { updateVariantClasses } from "../useRecalculateVariantDataCSLPValues";
+import { VisualBuilderPostMessageEvents } from "../../utils/types/postMessage.types";
+import visualBuilderPostMessage from "../../../visualBuilder/utils/visualBuilderPostMessage";
+import * as cslpdata from "../../../cslp/cslpdata";
+
+const send = (visualBuilderPostMessage as any).send;
+
+// vitest.setup.ts swaps MutationObserver for a stub that drops the callback, so
+// the real observer never fires here. Capture the callback and drive it instead.
+let observerCallbacks: MutationCallback[] = [];
+const realMutationObserver = global.MutationObserver;
+
+class CapturingMutationObserver {
+    observe = vi.fn();
+    disconnect = vi.fn();
+    takeRecords = vi.fn((): MutationRecord[] => []);
+    constructor(callback: MutationCallback) {
+        observerCallbacks.push(callback);
+    }
+}
+
+const attributeMutation = {
+    type: "attributes",
+    attributeName: "data-cslp",
+    addedNodes: [] as unknown as NodeList,
+} as unknown as MutationRecord;
+
+describe("requestDiscussionHighlights via the CSLP mutation observer", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        observerCallbacks = [];
+        global.MutationObserver =
+            CapturingMutationObserver as unknown as typeof MutationObserver;
+        send.mockResolvedValue(undefined);
+        vi.spyOn(cslpdata, "isValidCslp").mockReturnValue(true);
+        document.body.innerHTML = `<p data-cslp="v2:ct.entry.en-us.title">hi</p>`;
+    });
+
+    afterEach(() => {
+        global.MutationObserver = realMutationObserver;
+        document.body.innerHTML = "";
+        vi.restoreAllMocks();
+    });
+
+    function fireMutation() {
+        updateVariantClasses();
+        expect(observerCallbacks).toHaveLength(1);
+        observerCallbacks[0]([attributeMutation], {} as MutationObserver);
+    }
+
+    it("requests discussion highlights when a data-cslp attribute changes", () => {
+        fireMutation();
+
+        expect(send).toHaveBeenCalledWith(
+            VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
+        );
+    });
+
+    // The bug this guards: the Discussions panel is closed on most CSR page
+    // loads, so this send rejects nearly every time. Left unhandled it reaches
+    // the Next.js dev overlay.
+    it("attaches a rejection handler to that send", async () => {
+        const rejection = Promise.reject({
+            code: "NO_REQUEST_LISTENER_FOUND",
+            message: 'No request listener found for event "x"',
+        });
+        const catchSpy = vi.spyOn(rejection, "catch");
+        send.mockReturnValue(rejection);
+
+        fireMutation();
+
+        expect(catchSpy).toHaveBeenCalled();
+        await expect(rejection).rejects.toMatchObject({
+            code: "NO_REQUEST_LISTENER_FOUND",
+        });
+    });
+});
diff --git a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
index 22c3b5fb..3e55452b 100644
--- a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
+++ b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
@@ -155,7 +155,8 @@ describe("useVariantFieldsPostMessageEvent", () => {
 
         // Reset mocks
         vi.clearAllMocks();
-        
+        (mockVisualBuilderPostMessage.send as any).mockResolvedValue(undefined);
+
         // Mock isValidCslp to return true for test data (after clearAllMocks)
         vi.spyOn(cslpdata, "isValidCslp").mockReturnValue(true);
     });
@@ -615,6 +616,9 @@ describe("useVariantFieldsPostMessageEvent SSR handling", () => {
     beforeEach(() => {
         document.querySelectorAll = mockQuerySelectorAll;
         vi.clearAllMocks();
+        // Restate the contract rather than inherit it: send always returns a
+        // promise, and a test below swaps in a rejecting one.
+        (mockVisualBuilderPostMessage.send as any).mockResolvedValue(undefined);
     });
 
     afterEach(() => {
@@ -748,20 +752,20 @@ describe("useVariantFieldsPostMessageEvent SSR handling", () => {
             message:
                 'No request listener found for event "request-discussion-highlights"',
         });
+        // Deliberately coupled to the `.catch` shape. Asserting "no unhandled
+        // rejection escapes" would survive a refactor to try/catch, but neither
+        // a process `unhandledRejection` listener nor the jsdom window event
+        // fires reliably under vitest here: the same assertion passes with the
+        // fix removed, so it proves nothing. Rewriting this to catch a
+        // try/catch refactor means fixing that detection first.
         const catchSpy = vi.spyOn(rejection, "catch");
         (mockVisualBuilderPostMessage.send as any).mockReturnValue(rejection);
 
-        try {
-            handler!({ data: { variant: "variant-123" } });
-            expect(catchSpy).toHaveBeenCalled();
-            await expect(rejection).rejects.toMatchObject({
-                code: "NO_REQUEST_LISTENER_FOUND",
-            });
-        } finally {
-            catchSpy.mockRestore();
-            (mockVisualBuilderPostMessage.send as any).mockResolvedValue(
-                undefined
-            );
-        }
+        handler!({ data: { variant: "variant-123" } });
+
+        expect(catchSpy).toHaveBeenCalled();
+        await expect(rejection).rejects.toMatchObject({
+            code: "NO_REQUEST_LISTENER_FOUND",
+        });
     });
 });
diff --git a/src/visualBuilder/utils/__test__/postMessageErrors.test.ts b/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
index dbaa2dbc..87850fbc 100644
--- a/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
+++ b/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
@@ -1,42 +1,50 @@
 import { vi, describe, it, expect, beforeEach } from "vitest";
 import { ignoreMissingListener } from "../postMessageErrors";
+import { VisualBuilderPostMessageEvents } from "../types/postMessage.types";
 import { PublicLogger } from "../../../logger/logger";
 
+const EVENT = VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS;
+
 describe("ignoreMissingListener", () => {
     beforeEach(() => {
         vi.restoreAllMocks();
     });
 
-    it("stays silent when the receiver is simply not mounted", () => {
+    // The only rejection adv-post-message sends back with a code: the receiver
+    // acked, looked for a listener and found none.
+    it("stays silent when the receiver answers that nobody is listening", () => {
         const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
 
-        ignoreMissingListener("request-discussion-highlights")({
+        ignoreMissingListener(EVENT)({
             code: "NO_REQUEST_LISTENER_FOUND",
-            message: 'No request listener found for event "x"',
+            message:
+                'No request listener found for event "request-discussion-highlights"',
         });
 
         expect(warn).not.toHaveBeenCalled();
     });
 
+    // The shapes the library's own timeout paths reject with. Neither carries a
+    // code, so both must fall through to the warning.
     it.each([
-        "NO_ACK_RECEIVED",
-        "WINDOW_CLOSED",
-        "CODE_RETURNED_ERROR",
-    ])("warns on %s so a real failure is still visible", (code) => {
+        ["an Error, as the closed-window path rejects", new Error("closed")],
+        [
+            "a bare string, as the no-ack timeout rejects",
+            "contentstack-adv-post-message: The ACK was not received",
+        ],
+    ])("warns on %s so a real failure stays visible", (_shape, error) => {
         const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
 
-        ignoreMissingListener("request-discussion-highlights")({ code });
+        ignoreMissingListener(EVENT)(error);
 
         expect(warn).toHaveBeenCalledOnce();
-        expect(warn.mock.calls[0][0]).toContain(
-            "request-discussion-highlights"
-        );
+        expect(warn.mock.calls[0][0]).toContain(EVENT);
     });
 
-    it("warns when the rejection is not a coded object", () => {
+    it("warns on a coded rejection that is not the missing listener", () => {
         const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
 
-        ignoreMissingListener("some-event")(new Error("boom"));
+        ignoreMissingListener(EVENT)({ code: "SOMETHING_ELSE" });
 
         expect(warn).toHaveBeenCalledOnce();
     });
diff --git a/src/visualBuilder/utils/postMessageErrors.ts b/src/visualBuilder/utils/postMessageErrors.ts
index 3c864e8a..6c10b5cd 100644
--- a/src/visualBuilder/utils/postMessageErrors.ts
+++ b/src/visualBuilder/utils/postMessageErrors.ts
@@ -1,4 +1,5 @@
 import { PublicLogger } from "../../logger/logger";
+import { VisualBuilderPostMessageEvents } from "./types/postMessage.types";
 
 // adv-post-message does not export ERROR_CODES from its entry point, so the
 // wire value is matched directly.
@@ -6,11 +7,15 @@ const NO_REQUEST_LISTENER_FOUND = "NO_REQUEST_LISTENER_FOUND";
 
 /**
  * Rejection handler for sends whose receiver is only mounted some of the time.
- * A missing listener is the expected state and stays silent; every other
- * failure (no ack, closed window, a throwing receiver) is warned about so a
- * real breakage stays visible.
+ *
+ * Only the missing-listener reply carries a `code`; the library's other
+ * rejections are an uncoded `Error` (closed window) or a bare string (no ack),
+ * so they fall through to the warning. That is deliberate: a receiver that
+ * never acks is not the same as one that answered "nobody is listening".
  */
-export function ignoreMissingListener(event: string): (error: unknown) => void {
+export function ignoreMissingListener(
+    event: VisualBuilderPostMessageEvents
+): (error: unknown) => void {
     return (error: unknown) => {
         if ((error as { code?: string })?.code === NO_REQUEST_LISTENER_FOUND) {
             return;

From dc4d8bf3f2c102ca30479773435d95584a881e56 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Mon, 21 Sep 2026 11:58:44 +0530
Subject: [PATCH 12/16] test(visual-builder): bind both send sites to the
 discriminating handler

Review pointed out that asserting `.catch` was called proves a handler was
attached, not which one: swapping ignoreMissingListener for `() => {}` kept
the tests green.

Asserting PublicLogger.warn stays silent on the missing-listener code does
not close that gap either, since a no-op catch is also silent. Verified by
mutation: with `() => {}` at both call sites, the silent-case assertions
still pass. What fails is a rejection the helper is supposed to warn about,
so each spec now has that case, using the uncoded string the library's
no-ack timeout actually rejects with.

Also from review: import VisualBuilderPostMessageEvents as a type in
postMessageErrors.ts, since it is only used in a type position.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 ...seRecalculateVariantDataCSLPValues.spec.ts | 27 +++++++++++++--
 .../useVariantsPostMessageEvent.spec.ts       | 34 +++++++++++++++++--
 src/visualBuilder/utils/postMessageErrors.ts  |  2 +-
 3 files changed, 58 insertions(+), 5 deletions(-)

diff --git a/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts b/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
index 9ac7a9e9..67436578 100644
--- a/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
+++ b/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
@@ -22,6 +22,7 @@ import { updateVariantClasses } from "../useRecalculateVariantDataCSLPValues";
 import { VisualBuilderPostMessageEvents } from "../../utils/types/postMessage.types";
 import visualBuilderPostMessage from "../../../visualBuilder/utils/visualBuilderPostMessage";
 import * as cslpdata from "../../../cslp/cslpdata";
+import { PublicLogger } from "../../../logger/logger";
 
 const send = (visualBuilderPostMessage as any).send;
 
@@ -85,13 +86,35 @@ describe("requestDiscussionHighlights via the CSLP mutation observer", () => {
             message: 'No request listener found for event "x"',
         });
         const catchSpy = vi.spyOn(rejection, "catch");
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
         send.mockReturnValue(rejection);
 
         fireMutation();
-
-        expect(catchSpy).toHaveBeenCalled();
         await expect(rejection).rejects.toMatchObject({
             code: "NO_REQUEST_LISTENER_FOUND",
         });
+
+        expect(catchSpy).toHaveBeenCalled();
+        expect(warn).not.toHaveBeenCalled();
+    });
+
+    // postMessageErrors is not mocked here, so the real helper runs. This is
+    // the case that ties the call site to it: a bare `.catch(() => {})` would
+    // pass every assertion above but fail this one.
+    it("warns through the helper when the send fails for another reason", async () => {
+        // The shape the library's no-ack timeout rejects with: no code.
+        const rejection = Promise.reject(
+            "contentstack-adv-post-message: The ACK was not received"
+        );
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
+        send.mockReturnValue(rejection);
+
+        fireMutation();
+        await expect(rejection).rejects.toBeTruthy();
+
+        expect(warn).toHaveBeenCalledOnce();
+        expect(warn.mock.calls[0][0]).toContain(
+            VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
+        );
     });
 });
diff --git a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
index 3e55452b..eef0dd2d 100644
--- a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
+++ b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
@@ -39,6 +39,7 @@ import visualBuilderPostMessage from "../../../visualBuilder/utils/visualBuilder
 import { EventManager } from "@contentstack/advanced-post-message";
 import { updateVariantClasses } from "../../../visualBuilder/eventManager/useRecalculateVariantDataCSLPValues";
 import * as cslpdata from "../../../cslp/cslpdata";
+import { PublicLogger } from "../../../logger/logger";
 
 const mockVisualBuilderPostMessage =
     visualBuilderPostMessage as MockedObject<EventManager>;
@@ -759,13 +760,42 @@ describe("useVariantFieldsPostMessageEvent SSR handling", () => {
         // fix removed, so it proves nothing. Rewriting this to catch a
         // try/catch refactor means fixing that detection first.
         const catchSpy = vi.spyOn(rejection, "catch");
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
         (mockVisualBuilderPostMessage.send as any).mockReturnValue(rejection);
 
         handler!({ data: { variant: "variant-123" } });
-
-        expect(catchSpy).toHaveBeenCalled();
         await expect(rejection).rejects.toMatchObject({
             code: "NO_REQUEST_LISTENER_FOUND",
         });
+
+        expect(catchSpy).toHaveBeenCalled();
+        expect(warn).not.toHaveBeenCalled();
+    });
+
+    // postMessageErrors is not mocked here, so the real helper runs. This is
+    // the case that ties the call site to it: a bare `.catch(() => {})` would
+    // pass every assertion above but fail this one.
+    it("warns through the helper when the send fails for another reason", async () => {
+        useVariantFieldsPostMessageEvent({ isSSR: true });
+        const call = mockVisualBuilderPostMessage.on.mock.calls.find(
+            (call: any[]) =>
+                call[0] === VisualBuilderPostMessageEvents.GET_VARIANT_ID
+        );
+        const handler = call ? call[1] : null;
+
+        // The shape the library's no-ack timeout rejects with: no code.
+        const rejection = Promise.reject(
+            "contentstack-adv-post-message: The ACK was not received"
+        );
+        const warn = vi.spyOn(PublicLogger, "warn").mockImplementation(() => {});
+        (mockVisualBuilderPostMessage.send as any).mockReturnValue(rejection);
+
+        handler!({ data: { variant: "variant-123" } });
+        await expect(rejection).rejects.toBeTruthy();
+
+        expect(warn).toHaveBeenCalledOnce();
+        expect(warn.mock.calls[0][0]).toContain(
+            VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
+        );
     });
 });
diff --git a/src/visualBuilder/utils/postMessageErrors.ts b/src/visualBuilder/utils/postMessageErrors.ts
index 6c10b5cd..bf141ab5 100644
--- a/src/visualBuilder/utils/postMessageErrors.ts
+++ b/src/visualBuilder/utils/postMessageErrors.ts
@@ -1,5 +1,5 @@
 import { PublicLogger } from "../../logger/logger";
-import { VisualBuilderPostMessageEvents } from "./types/postMessage.types";
+import type { VisualBuilderPostMessageEvents } from "./types/postMessage.types";
 
 // adv-post-message does not export ERROR_CODES from its entry point, so the
 // wire value is matched directly.

From de91b09de7d3f8d47252f9aa5fcfe1c6ada7b278 Mon Sep 17 00:00:00 2001
From: Kirtesh Suthar <kirtesh.suthar@contentstack.com>
Date: Mon, 21 Sep 2026 12:14:20 +0530
Subject: [PATCH 13/16] test(visual-builder): pin the rejection value in the
 warning, and tidy spy lifecycles

Review found that every warn-branch assertion read only the message the
helper builds from the event name, so dropping the error argument from
PublicLogger.warn kept all of them green while the warning lost the part
that says what failed. All four sites now assert the second argument.
Verified by mutation: removing that argument fails all four.

Also from review:
- capture MutationObserver in beforeEach rather than at module scope. The
  setup file installs its stub in beforeAll, so the module-level read took
  jsdom's native implementation and afterEach restored the wrong one.
- restore spies in the SSR block's afterEach. clearAllMocks leaves the
  implementation in place, so PublicLogger.warn stayed stubbed for the rest
  of the file once these tests had run.
- assert the rejected value instead of toBeTruthy, which held regardless of
  what the code did.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../useRecalculateVariantDataCSLPValues.spec.ts   | 15 ++++++++++++---
 .../__test__/useVariantsPostMessageEvent.spec.ts  |  8 +++++++-
 .../utils/__test__/postMessageErrors.test.ts      |  3 +++
 3 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts b/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
index 67436578..8364f7c3 100644
--- a/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
+++ b/src/visualBuilder/eventManager/__test__/useRecalculateVariantDataCSLPValues.spec.ts
@@ -29,7 +29,10 @@ const send = (visualBuilderPostMessage as any).send;
 // vitest.setup.ts swaps MutationObserver for a stub that drops the callback, so
 // the real observer never fires here. Capture the callback and drive it instead.
 let observerCallbacks: MutationCallback[] = [];
-const realMutationObserver = global.MutationObserver;
+// Captured in beforeEach, not at module scope: vitest.setup.ts installs its
+// stub in beforeAll, so a module-level read would grab jsdom's native one and
+// afterEach would restore the wrong implementation.
+let installedMutationObserver: typeof MutationObserver;
 
 class CapturingMutationObserver {
     observe = vi.fn();
@@ -50,6 +53,7 @@ describe("requestDiscussionHighlights via the CSLP mutation observer", () => {
     beforeEach(() => {
         vi.clearAllMocks();
         observerCallbacks = [];
+        installedMutationObserver = global.MutationObserver;
         global.MutationObserver =
             CapturingMutationObserver as unknown as typeof MutationObserver;
         send.mockResolvedValue(undefined);
@@ -58,7 +62,7 @@ describe("requestDiscussionHighlights via the CSLP mutation observer", () => {
     });
 
     afterEach(() => {
-        global.MutationObserver = realMutationObserver;
+        global.MutationObserver = installedMutationObserver;
         document.body.innerHTML = "";
         vi.restoreAllMocks();
     });
@@ -110,11 +114,16 @@ describe("requestDiscussionHighlights via the CSLP mutation observer", () => {
         send.mockReturnValue(rejection);
 
         fireMutation();
-        await expect(rejection).rejects.toBeTruthy();
+        await expect(rejection).rejects.toBe(
+            "contentstack-adv-post-message: The ACK was not received"
+        );
 
         expect(warn).toHaveBeenCalledOnce();
         expect(warn.mock.calls[0][0]).toContain(
             VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
         );
+        expect(warn.mock.calls[0][1]).toBe(
+            "contentstack-adv-post-message: The ACK was not received"
+        );
     });
 });
diff --git a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
index eef0dd2d..efba4531 100644
--- a/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
+++ b/src/visualBuilder/eventManager/__test__/useVariantsPostMessageEvent.spec.ts
@@ -624,6 +624,7 @@ describe("useVariantFieldsPostMessageEvent SSR handling", () => {
 
     afterEach(() => {
         document.querySelectorAll = originalQuerySelectorAll;
+        vi.restoreAllMocks();
     });
 
     it("should call addVariantFieldClass directly when isSSR is true and variant is provided", () => {
@@ -791,11 +792,16 @@ describe("useVariantFieldsPostMessageEvent SSR handling", () => {
         (mockVisualBuilderPostMessage.send as any).mockReturnValue(rejection);
 
         handler!({ data: { variant: "variant-123" } });
-        await expect(rejection).rejects.toBeTruthy();
+        await expect(rejection).rejects.toBe(
+            "contentstack-adv-post-message: The ACK was not received"
+        );
 
         expect(warn).toHaveBeenCalledOnce();
         expect(warn.mock.calls[0][0]).toContain(
             VisualBuilderPostMessageEvents.REQUEST_DISCUSSION_HIGHLIGHTS
         );
+        expect(warn.mock.calls[0][1]).toBe(
+            "contentstack-adv-post-message: The ACK was not received"
+        );
     });
 });
diff --git a/src/visualBuilder/utils/__test__/postMessageErrors.test.ts b/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
index 87850fbc..fc1291a3 100644
--- a/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
+++ b/src/visualBuilder/utils/__test__/postMessageErrors.test.ts
@@ -39,6 +39,9 @@ describe("ignoreMissingListener", () => {
 
         expect(warn).toHaveBeenCalledOnce();
         expect(warn.mock.calls[0][0]).toContain(EVENT);
+        // The rejection itself is the reason this branch exists; without this
+        // the warn call could drop it and every assertion here would hold.
+        expect(warn.mock.calls[0][1]).toBe(error);
     });
 
     it("warns on a coded rejection that is not the missing listener", () => {

From ae3a87856305ecdb82e2e9b4d93757b190f5533f Mon Sep 17 00:00:00 2001
From: Karan Gandhi <karan.gandhi@contentstack.com>
Date: Mon, 28 Sep 2026 22:24:18 +0530
Subject: [PATCH 14/16] 4.5.2

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CHANGELOG.md      | 70 +++++++++++++++++++++++++++++++++++++++++++++--
 package-lock.json |  4 +--
 package.json      |  2 +-
 3 files changed, 70 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e7a59903..088449a2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,51 @@
 # Changelog
 
+## [v4.5.2](https://github.com/contentstack/live-preview-sdk/compare/v4.5.2...v4.5.2)
+
+> 28 September 2026
+
+### Fixes
+
+- fix(visual-builder): handle rejection when discussion highlights has no listener (Kirtesh Suthar - [#652](https://github.com/contentstack/live-preview-sdk/pull/652))
+
+### Fixes
+
+- fix(visual-builder): correct the documented rejection contract and cover the observer send (Kirtesh Suthar - [b78d266](https://github.com/contentstack/live-preview-sdk/commit/b78d2662f563f2261b02eea9a6b7088fc2485ee5))
+
+### Refactoring and Updates
+
+- refactor(visual-builder): warn on real send failures, stay silent on a missing listener (Kirtesh Suthar - [19f80f9](https://github.com/contentstack/live-preview-sdk/commit/19f80f9a69bd53ded3bf579d96ec6e36ad162904))
+
+### Changes to Test Assests
+
+- test(visual-builder): bind both send sites to the discriminating handler (Kirtesh Suthar - [dc4d8bf](https://github.com/contentstack/live-preview-sdk/commit/dc4d8bf3f2c102ca30479773435d95584a881e56))
+- test(visual-builder): pin the rejection value in the warning, and tidy spy lifecycles (Kirtesh Suthar - [de91b09](https://github.com/contentstack/live-preview-sdk/commit/de91b09de7d3f8d47252f9aa5fcfe1c6ada7b278))
+
+## [v4.5.2](https://github.com/contentstack/live-preview-sdk/compare/v4.5.1...v4.5.2)
+
+> 16 September 2026
+
+### Fixes
+
+- fix(release): restore build before publish and the alpha dist-tag (Kirtesh Suthar - [#650](https://github.com/contentstack/live-preview-sdk/pull/650))
+
+### General Changes
+
+- release: v4.5.2 (Kirtesh Suthar - [#651](https://github.com/contentstack/live-preview-sdk/pull/651))
+
+### Fixes
+
+- fix: update CDN version to 4.5.2 in README (Kirtesh Suthar - [514013d](https://github.com/contentstack/live-preview-sdk/commit/514013d8cf6cb2e6c65c0da11be39df1476a7444))
+- fix(release): publish prereleases under the alpha dist-tag (Kirtesh Suthar - [86f5187](https://github.com/contentstack/live-preview-sdk/commit/86f5187abd0a861bdd8a328f9cab04df926f5c0c))
+- fix(release): build on prepack so dist ships in the published package (Kirtesh Suthar - [76e6a9d](https://github.com/contentstack/live-preview-sdk/commit/76e6a9dc6748f15d459320ced52da95e403bb9bf))
+
+### Chores And Housekeeping
+
+- chore(ci): pin vitest-coverage-report-action to a commit sha (Kirtesh Suthar - [fd8e6af](https://github.com/contentstack/live-preview-sdk/commit/fd8e6af5a8b4b5c8cdd512955180b943616c0c26))
+
 ## [v4.5.1](https://github.com/contentstack/live-preview-sdk/compare/v4.5.0...v4.5.1)
 
-> 10 September 2026
+> 15 September 2026
 
 ### Fixes
 
@@ -11,15 +54,22 @@
 
 ### Chores And Housekeeping
 
+- chore(release): v4.5.1 (Kirtesh Suthar - [#646](https://github.com/contentstack/live-preview-sdk/pull/646))
 - chore: sync develop_v4 with stage_v4 (Kirtesh Suthar - [#645](https://github.com/contentstack/live-preview-sdk/pull/645))
 - chore(tests): standardize api key placeholder values in specs (Hitesh Shetty - [#639](https://github.com/contentstack/live-preview-sdk/pull/639))
 
 ### General Changes
 
+- release: v4.5.1 (Kirtesh Suthar - [#647](https://github.com/contentstack/live-preview-sdk/pull/647))
 - Develop v4 (Kirtesh Suthar - [#640](https://github.com/contentstack/live-preview-sdk/pull/640))
 
+### Fixes
+
+- fix: update CDN version to 4.5.1 in README (Kirtesh Suthar - [e93cc36](https://github.com/contentstack/live-preview-sdk/commit/e93cc36a182d084fed01b3ee5b3262a51fb159fd))
+
 ### Chores And Housekeeping
 
+- chore: merge main into stage_v4 release branch (Kirtesh Suthar - [3d2e823](https://github.com/contentstack/live-preview-sdk/commit/3d2e8231f7e6cf21a8648d6435499f3773367510))
 - chore: merge stage_v4 into develop_v4 (Kirtesh Suthar - [e1dee0f](https://github.com/contentstack/live-preview-sdk/commit/e1dee0f33c15fbbeb9d7842ad70aba7610801524))
 - chore(deps): apply npm audit fix (hitesh-shetty-cstk - [ec144b9](https://github.com/contentstack/live-preview-sdk/commit/ec144b934935185f40efccfdcd09d4ac153222c8))
 
@@ -27,6 +77,13 @@
 
 - refactor(utils): one list for live preview's own query params (Kirtesh Suthar - [c179114](https://github.com/contentstack/live-preview-sdk/commit/c1791141dd7f22430f4f96d8070f4354dc9b641e))
 
+### General Changes
+
+- Update npm-publish.yml (Aravind Kumar - [60ce24f](https://github.com/contentstack/live-preview-sdk/commit/60ce24f4c53467294a9b52307337d670a404eec9))
+- Delete .github/workflows/npm-alpha-publish.yml (Aravind Kumar - [71a26ad](https://github.com/contentstack/live-preview-sdk/commit/71a26ad7dc3a9534c2513858a0fa574fd8940be4))
+- Update npm-publish.yml (Aravind Kumar - [89811da](https://github.com/contentstack/live-preview-sdk/commit/89811da4bf36528c30d2efc14c5d01594234a501))
+- Updated codeowners (Aravind Kumar - [4183387](https://github.com/contentstack/live-preview-sdk/commit/41833878124126b1cf74d92d8501f1d1eda1c06f))
+
 ## [v4.5.0](https://github.com/contentstack/live-preview-sdk/compare/v4.4.5...v4.5.0)
 
 > 11 August 2026
@@ -271,10 +328,18 @@
 - Merge origin/stage_v4 into stage_v4 — resolve version conflicts (4.3.0 → 4.4.0) (hitesh-shetty-cstk - [be798e3](https://github.com/contentstack/live-preview-sdk/commit/be798e30c2c82f57488407477482cd3e5273751f))
 - Merge pull request #565 from contentstack/develop_v4 (Karan Bhavesh Gandhi - [c8fc00d](https://github.com/contentstack/live-preview-sdk/commit/c8fc00ddf53681e2bd5c08ad6d61799b236728ca))
 
-## [v4.4.0](https://github.com/contentstack/live-preview-sdk/compare/v4.3.0...v4.4.0)
+## [v4.4.0](https://github.com/contentstack/live-preview-sdk/compare/v4.3.1...v4.4.0)
 
 > 6 April 2026
 
+### General Changes
+
+- Merge pull request #578 from contentstack/stage_v4 (Karan Bhavesh Gandhi - [7dbe992](https://github.com/contentstack/live-preview-sdk/commit/7dbe99233ad3920834147de9f67d63c8bd2895fc))
+
+## [v4.3.1](https://github.com/contentstack/live-preview-sdk/compare/v4.3.0...v4.3.1)
+
+> 2 April 2026
+
 ### New Features
 
 - feat(visual-editor): request edit access workflow tooltips and canvas integration (Hitesh Shetty - [#572](https://github.com/contentstack/live-preview-sdk/pull/572))
@@ -318,7 +383,6 @@
 
 ### General Changes
 
-- Merge pull request #578 from contentstack/stage_v4 (Karan Bhavesh Gandhi - [7dbe992](https://github.com/contentstack/live-preview-sdk/commit/7dbe99233ad3920834147de9f67d63c8bd2895fc))
 - Merge pull request #576 from contentstack/develop_v4 (Karan Bhavesh Gandhi - [2501855](https://github.com/contentstack/live-preview-sdk/commit/25018553092688922b523e70ac60a6a0363cec15))
 - Merge pull request #577 from contentstack/VP-1133/purge-flag-4 (Karan Bhavesh Gandhi - [a621121](https://github.com/contentstack/live-preview-sdk/commit/a621121d15a2b518d75e39dbba996ba585439003))
 
diff --git a/package-lock.json b/package-lock.json
index 15b27b0c..c4d7d09e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
     "name": "@contentstack/live-preview-utils",
-    "version": "4.5.1",
+    "version": "4.5.2",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "@contentstack/live-preview-utils",
-            "version": "4.5.1",
+            "version": "4.5.2",
             "license": "MIT",
             "dependencies": {
                 "@floating-ui/dom": "^1.7.2",
diff --git a/package.json b/package.json
index 350bee73..f5ba468b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@contentstack/live-preview-utils",
-    "version": "4.5.1",
+    "version": "4.5.2",
     "description": "Contentstack provides the Live Preview SDK to establish a communication channel between the various Contentstack SDKs and your website, transmitting  live changes to the preview pane.",
     "type": "module",
     "types": "dist/legacy/index.d.ts",

From 95b048e12c93b6307aa78a7006ed1b1ba025e80b Mon Sep 17 00:00:00 2001
From: Karan Gandhi <karan.gandhi@contentstack.com>
Date: Tue, 29 Sep 2026 10:55:57 +0530
Subject: [PATCH 15/16] 4.5.3

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CHANGELOG.md      | 67 ++++++++++++++++++++++++++++++++---------------
 package-lock.json |  4 +--
 package.json      |  2 +-
 3 files changed, 49 insertions(+), 24 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ebe7c274..a2769467 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,30 @@
 # Changelog
 
+## [v4.5.3](https://github.com/contentstack/live-preview-sdk/compare/v4.5.2...v4.5.3)
+
+> 29 September 2026
+
+### Fixes
+
+- fix(visual-builder): handle rejection when discussion highlights has no listener (Kirtesh Suthar - [#652](https://github.com/contentstack/live-preview-sdk/pull/652))
+
+### General Changes
+
+- Updated codeowners (Karan Bhavesh Gandhi - [#657](https://github.com/contentstack/live-preview-sdk/pull/657))
+
+### Fixes
+
+- fix(visual-builder): correct the documented rejection contract and cover the observer send (Kirtesh Suthar - [b78d266](https://github.com/contentstack/live-preview-sdk/commit/b78d2662f563f2261b02eea9a6b7088fc2485ee5))
+
+### Refactoring and Updates
+
+- refactor(visual-builder): warn on real send failures, stay silent on a missing listener (Kirtesh Suthar - [19f80f9](https://github.com/contentstack/live-preview-sdk/commit/19f80f9a69bd53ded3bf579d96ec6e36ad162904))
+
+### Changes to Test Assests
+
+- test(visual-builder): bind both send sites to the discriminating handler (Kirtesh Suthar - [dc4d8bf](https://github.com/contentstack/live-preview-sdk/commit/dc4d8bf3f2c102ca30479773435d95584a881e56))
+- test(visual-builder): pin the rejection value in the warning, and tidy spy lifecycles (Kirtesh Suthar - [de91b09](https://github.com/contentstack/live-preview-sdk/commit/de91b09de7d3f8d47252f9aa5fcfe1c6ada7b278))
+
 ## [v4.5.2](https://github.com/contentstack/live-preview-sdk/compare/v4.5.1...v4.5.2)
 
 > 16 September 2026
@@ -267,7 +292,7 @@
 - Fix 20 april snyk fixes 2 develop v4 sync (Aditya Pachauri - [#585](https://github.com/contentstack/live-preview-sdk/pull/585))
 - Vp 1721 fix known issues (Kirtesh Suthar - [#581](https://github.com/contentstack/live-preview-sdk/pull/581))
 - Vp 444 stag sync 2 (Aditya Pachauri - [#562](https://github.com/contentstack/live-preview-sdk/pull/562))
-- Optimize Development Build Performance (Hitesh Shetty - [#548](https://github.com/contentstack/live-preview-sdk/pull/548))
+-  Optimize Development Build Performance (Hitesh Shetty - [#548](https://github.com/contentstack/live-preview-sdk/pull/548))
 - Add support for Variant highlights (Hitesh Shetty - [#533](https://github.com/contentstack/live-preview-sdk/pull/533))
 
 ### New Features
@@ -589,7 +614,7 @@
 ### General Changes
 
 - 2nd Oct Release (Mridul Sharma - [#512](https://github.com/contentstack/live-preview-sdk/pull/512))
-- 2nd October release (Mridul Sharma - [#511](https://github.com/contentstack/live-preview-sdk/pull/511))
+- 2nd October release  (Mridul Sharma - [#511](https://github.com/contentstack/live-preview-sdk/pull/511))
 - 1st oct 2025 to develop v4 (Aditya Pachauri - [#510](https://github.com/contentstack/live-preview-sdk/pull/510))
 - [Feat/VB-442] Indicator for variant fields (Ayush Dubey - [#508](https://github.com/contentstack/live-preview-sdk/pull/508))
 
@@ -630,7 +655,7 @@
 - 18th sept 2025 release (Kirtesh Suthar - [#505](https://github.com/contentstack/live-preview-sdk/pull/505))
 - Live preview new tab ssr issue (Mridul Sharma - [#502](https://github.com/contentstack/live-preview-sdk/pull/502))
 - VB-248 fixed the cursor moving to the start with a explicitly adding pseudo element on second time a field is visited (Sahil Chalke - [#497](https://github.com/contentstack/live-preview-sdk/pull/497))
-- VE-6918 : warning message improved (Aditya Pachauri - [#475](https://github.com/contentstack/live-preview-sdk/pull/475))
+- VE-6918 : warning message improved  (Aditya Pachauri - [#475](https://github.com/contentstack/live-preview-sdk/pull/475))
 - HoverToolbar: Requested Changes (Ayush Dubey - [#464](https://github.com/contentstack/live-preview-sdk/pull/464))
 - Ve 5474 field modifier support for canvas in visual builder (Sahil Chalke - [#460](https://github.com/contentstack/live-preview-sdk/pull/460))
 - [Feature] HoverToolbar (Ayush Dubey - [#455](https://github.com/contentstack/live-preview-sdk/pull/455))
@@ -717,13 +742,13 @@
 
 ### New Features
 
-- feat(VB-132 | VE-7062): disable editing when workflow stage rules restrict the same (Faraaz Biyabani - [#494](https://github.com/contentstack/live-preview-sdk/pull/494))
+- feat(VB-132 | VE-7062): disable editing when workflow stage rules restrict the same  (Faraaz Biyabani - [#494](https://github.com/contentstack/live-preview-sdk/pull/494))
 - feat: live preview: added outside iframe code (Mridul Sharma - [#477](https://github.com/contentstack/live-preview-sdk/pull/477))
 - feat: live preview: added outside iframe code (Mridul Sharma - [#468](https://github.com/contentstack/live-preview-sdk/pull/468))
 
 ### General Changes
 
-- 21st august 2025 release (Sahil Chalke - [#495](https://github.com/contentstack/live-preview-sdk/pull/495))
+- 21st august 2025 release  (Sahil Chalke - [#495](https://github.com/contentstack/live-preview-sdk/pull/495))
 - Live preview outside iframe (Mridul Sharma - [#492](https://github.com/contentstack/live-preview-sdk/pull/492))
 
 ### New Features
@@ -772,7 +797,7 @@
 
 ### General Changes
 
-- VE-6918 (Faraaz Biyabani - [#487](https://github.com/contentstack/live-preview-sdk/pull/487))
+- VE-6918  (Faraaz Biyabani - [#487](https://github.com/contentstack/live-preview-sdk/pull/487))
 - Hover Toolbar Click-ability Missed Commit (Faraaz Biyabani - [#482](https://github.com/contentstack/live-preview-sdk/pull/482))
 - Ve 5474 clean (Faraaz Biyabani - [#481](https://github.com/contentstack/live-preview-sdk/pull/481))
 
@@ -1098,7 +1123,7 @@
 
 ### Fixes
 
-- fix(VE-5643): Replace button is visible for parent wrapper for Multiple file field (Hitesh Shetty - [#410](https://github.com/contentstack/live-preview-sdk/pull/410))
+- fix(VE-5643): Replace button is visible for parent wrapper for Multiple file field  (Hitesh Shetty - [#410](https://github.com/contentstack/live-preview-sdk/pull/410))
 - fix: enhance loading state for form field focus (Hitesh Shetty - [#409](https://github.com/contentstack/live-preview-sdk/pull/409))
 - fix(VE-5555): add instance button loading state (Faraaz Biyabani - [#406](https://github.com/contentstack/live-preview-sdk/pull/406))
 - fix: call onChangeCallback when live_preview parameter is present in URL (Faraaz Biyabani - [#363](https://github.com/contentstack/live-preview-sdk/pull/363))
@@ -1146,7 +1171,7 @@
 
 - feat: v3.1.2 (Faraaz Biyabani - [#381](https://github.com/contentstack/live-preview-sdk/pull/381))
 - feat: improve edit button rendering (Faraaz Biyabani - [#371](https://github.com/contentstack/live-preview-sdk/pull/371))
-- feat(VE-5170): add plus button configuration (Sairaj - [#349](https://github.com/contentstack/live-preview-sdk/pull/349))
+- feat(VE-5170): add plus button configuration  (Sairaj - [#349](https://github.com/contentstack/live-preview-sdk/pull/349))
 - feat: allow click on elements with studio-ui attribute (Faraaz Biyabani - [#355](https://github.com/contentstack/live-preview-sdk/pull/355))
 - feat(VE-4043): add start editing button configuration for builder mode (Sairaj - [#346](https://github.com/contentstack/live-preview-sdk/pull/346))
 
@@ -1256,7 +1281,7 @@
 ### Fixes
 
 - fix(VE-4805): back button appears in quickform on clicking canvas (srinad007 - [#320](https://github.com/contentstack/live-preview-sdk/pull/320))
-- fix: issue with variant revert dropdown in canvas (srinad007 - [#317](https://github.com/contentstack/live-preview-sdk/pull/317))
+- fix: issue with variant revert dropdown in canvas  (srinad007 - [#317](https://github.com/contentstack/live-preview-sdk/pull/317))
 
 ### Chores And Housekeeping
 
@@ -1305,7 +1330,7 @@
 - fix: clean up event listeners in FieldToolbar and update query selector (Hitesh Shetty - [#311](https://github.com/contentstack/live-preview-sdk/pull/311))
 - fix(VE-4530): exclude properties doesn't check for frame status on `outsideLivePreviewPortal` (Hitesh Shetty - [#310](https://github.com/contentstack/live-preview-sdk/pull/310))
 - fix: add video tag in the void elements list (Kirtesh Suthar - [#307](https://github.com/contentstack/live-preview-sdk/pull/307))
-- fix: error when selecting a non text HTML element with the cslp of a text field (Faraaz Biyabani - [#299](https://github.com/contentstack/live-preview-sdk/pull/299))
+- fix: error when selecting a non text HTML element with the cslp of a text field  (Faraaz Biyabani - [#299](https://github.com/contentstack/live-preview-sdk/pull/299))
 
 ### General Changes
 
@@ -1351,7 +1376,7 @@
 
 ### Fixes
 
-- fix: psuedo editable re-positioning logic (Faraaz Biyabani - [#294](https://github.com/contentstack/live-preview-sdk/pull/294))
+- fix: psuedo editable re-positioning logic  (Faraaz Biyabani - [#294](https://github.com/contentstack/live-preview-sdk/pull/294))
 
 ### General Changes
 
@@ -1380,12 +1405,12 @@
 
 - feat: hide edit tags when website is in timeline preview (Kirtesh Suthar - [#285](https://github.com/contentstack/live-preview-sdk/pull/285))
 - feat: add support to live sync form on inline editing (Hitesh Shetty - [#279](https://github.com/contentstack/live-preview-sdk/pull/279))
-- feat: created seperate class for permenant tooltip (Venkatesh B - [#263](https://github.com/contentstack/live-preview-sdk/pull/263))
+- feat:  created seperate class for permenant tooltip (Venkatesh B - [#263](https://github.com/contentstack/live-preview-sdk/pull/263))
 - feat: UI Text and Error message changes (Venkatesh B - [#262](https://github.com/contentstack/live-preview-sdk/pull/262))
 - feat: include href in init call (Hitesh Shetty - [#255](https://github.com/contentstack/live-preview-sdk/pull/255))
 - feat: discussionId to discussion payload changes(Imapct of resolve API) (Venkatesh B - [#248](https://github.com/contentstack/live-preview-sdk/pull/248))
 - feat: add mouse click event handling and post message support (Hitesh Shetty - [#253](https://github.com/contentstack/live-preview-sdk/pull/253))
-- feat: Handle Comment modal should open on click event in highlighed … (Hitesh Shetty - [#242](https://github.com/contentstack/live-preview-sdk/pull/242))
+- feat: Handle Comment modal should open on click event in  highlighed … (Hitesh Shetty - [#242](https://github.com/contentstack/live-preview-sdk/pull/242))
 - feat: update comment highlighting to append icons within visual build… (Hitesh Shetty - [#232](https://github.com/contentstack/live-preview-sdk/pull/232))
 - feat: add support for base field editing (Hitesh Shetty - [#231](https://github.com/contentstack/live-preview-sdk/pull/231))
 - feat: Highlight active discussion (Venkatesh B - [#230](https://github.com/contentstack/live-preview-sdk/pull/230))
@@ -1400,7 +1425,7 @@
 - feat: disabled state for hover outline and field focus outline (Faraaz Biyabani - [#158](https://github.com/contentstack/live-preview-sdk/pull/158))
 - feat: toolbar edit icons for modal editable fields (Faraaz Biyabani - [#156](https://github.com/contentstack/live-preview-sdk/pull/156))
 - feat: field edit modal for JSON RTE and link fields (Faraaz Biyabani - [#150](https://github.com/contentstack/live-preview-sdk/pull/150))
-- feat: hide/show custom cursor on canvas mouseleave/mouseenter (Hitesh Shetty - [#146](https://github.com/contentstack/live-preview-sdk/pull/146))
+- feat: hide/show custom cursor on canvas mouseleave/mouseenter  (Hitesh Shetty - [#146](https://github.com/contentstack/live-preview-sdk/pull/146))
 - feat: Refactor getLiveEditorRedirectionUrl to use URLSearchParams (Hitesh Shetty - [#144](https://github.com/contentstack/live-preview-sdk/pull/144))
 - feat: handling date fields (Faraaz Biyabani - [#140](https://github.com/contentstack/live-preview-sdk/pull/140))
 - feat: handling number fields (Faraaz Biyabani - [#139](https://github.com/contentstack/live-preview-sdk/pull/139))
@@ -1438,7 +1463,7 @@
 - fix: adding curser pointer to the component (Venkatesh B - [#245](https://github.com/contentstack/live-preview-sdk/pull/245))
 - fix: handle cursor collapse on empty element (Faraaz Biyabani - [#241](https://github.com/contentstack/live-preview-sdk/pull/241))
 - fix: bug fixing on taxanomy and link field multiple (Venkatesh B - [#223](https://github.com/contentstack/live-preview-sdk/pull/223))
-- fix:hide comment icon when not needed (Hitesh Shetty - [#222](https://github.com/contentstack/live-preview-sdk/pull/222))
+- fix:hide comment  icon when not needed (Hitesh Shetty - [#222](https://github.com/contentstack/live-preview-sdk/pull/222))
 - fix: hide contenteditable outline (Faraaz Biyabani - [#220](https://github.com/contentstack/live-preview-sdk/pull/220))
 - fix: visual builder icon class name changes (Venkatesh B - [#215](https://github.com/contentstack/live-preview-sdk/pull/215))
 - fix: incorrect focus on blocks field instead of new block (Hitesh Shetty - [#197](https://github.com/contentstack/live-preview-sdk/pull/197))
@@ -1496,7 +1521,7 @@
 - implement highlight variant fields in audience when checked (srinad007 - [#257](https://github.com/contentstack/live-preview-sdk/pull/257))
 - Ve 3355 iframe variant revert (Hitesh Shetty - [#252](https://github.com/contentstack/live-preview-sdk/pull/252))
 - Exported VB_EmptyBlockParentClass (Ayush Dubey - [#251](https://github.com/contentstack/live-preview-sdk/pull/251))
-- Typescript Delivery SDK support (Ayush Dubey - [#244](https://github.com/contentstack/live-preview-sdk/pull/244))
+-  Typescript Delivery SDK support (Ayush Dubey - [#244](https://github.com/contentstack/live-preview-sdk/pull/244))
 - Custom mouse pointer z-index fix (Ayush Dubey - [#239](https://github.com/contentstack/live-preview-sdk/pull/239))
 - Ve 3038 add support to highlight comments in canvas on discussion tab open (Venkatesh B - [#237](https://github.com/contentstack/live-preview-sdk/pull/237))
 - multiple toolbar fix (Ayush Dubey - [#236](https://github.com/contentstack/live-preview-sdk/pull/236))
@@ -1507,7 +1532,7 @@
 - Ve 72 render comment icon in the focus editing view (Venkatesh B - [#214](https://github.com/contentstack/live-preview-sdk/pull/214))
 - Ve 2866 (srinad007 - [#208](https://github.com/contentstack/live-preview-sdk/pull/208))
 - VE-2647-merge-v2-v3 (Deepak Kharah - [#207](https://github.com/contentstack/live-preview-sdk/pull/207))
-- Multiline Field Support (Ayush Dubey - [#204](https://github.com/contentstack/live-preview-sdk/pull/204))
+-  Multiline Field Support (Ayush Dubey - [#204](https://github.com/contentstack/live-preview-sdk/pull/204))
 - Taxonomy Icon on custom cursor (Ayush Dubey - [#203](https://github.com/contentstack/live-preview-sdk/pull/203))
 - Multiple Reference Instances' toolbar buttons (Ayush Dubey - [#202](https://github.com/contentstack/live-preview-sdk/pull/202))
 - Canvas URL field editing and mouse event blocking (Ayush Dubey - [#199](https://github.com/contentstack/live-preview-sdk/pull/199))
@@ -1515,7 +1540,7 @@
 - VE-2354 Fix: Overflow & Cutoff on Right Edge (Amey Shrivastava - [#192](https://github.com/contentstack/live-preview-sdk/pull/192))
 - Consistent Toolbar Position (Amey Shrivastava - [#189](https://github.com/contentstack/live-preview-sdk/pull/189))
 - MouseHover fix (Ayush Dubey - [#188](https://github.com/contentstack/live-preview-sdk/pull/188))
-- Fix: Hover on editable element (Ayush Dubey - [#187](https://github.com/contentstack/live-preview-sdk/pull/187))
+-  Fix: Hover on editable element (Ayush Dubey - [#187](https://github.com/contentstack/live-preview-sdk/pull/187))
 - Adjust toolbar position to prevent overlap when space is limited (Amey Shrivastava - [#185](https://github.com/contentstack/live-preview-sdk/pull/185))
 - highlight draft fields (srinad007 - [#183](https://github.com/contentstack/live-preview-sdk/pull/183))
 - VE-2376 Handle changes in element positions due to sidebar toggling or window resizing (Amey Shrivastava - [#182](https://github.com/contentstack/live-preview-sdk/pull/182))
@@ -1538,7 +1563,7 @@
 - Fix for website shaking due to overlay (Ayush Dubey - [#125](https://github.com/contentstack/live-preview-sdk/pull/125))
 - Plus button to only appear on mouse click (Ayush Dubey - [#124](https://github.com/contentstack/live-preview-sdk/pull/124))
 - Added outline to hovered elements (Ayush Dubey - [#123](https://github.com/contentstack/live-preview-sdk/pull/123))
-- Introduced `EmptyBlocks` for handling empty block entries (Ayush Dubey - [#122](https://github.com/contentstack/live-preview-sdk/pull/122))
+-  Introduced `EmptyBlocks` for handling empty block entries  (Ayush Dubey - [#122](https://github.com/contentstack/live-preview-sdk/pull/122))
 - Introduced Instance's `fieldPathWithIndex` in post-message payloads (Ayush Dubey - [#119](https://github.com/contentstack/live-preview-sdk/pull/119))
 - EB-1566: Few fields like links groups etc are not highlighted properly (Vishvam S - [#118](https://github.com/contentstack/live-preview-sdk/pull/118))
 - EB-1565: Sidebar sometimes load and sometimes doesn't (Vishvam S - [#117](https://github.com/contentstack/live-preview-sdk/pull/117))
@@ -1560,7 +1585,7 @@
 - feat: increase z-index for Field Label dropdown items (hiteshshetty-dev - [b5a95d3](https://github.com/contentstack/live-preview-sdk/commit/b5a95d3033ea5dc1894e51fc6d765d3cdc7d789d))
 - feat: code cleaning (Venkat - [a018d0f](https://github.com/contentstack/live-preview-sdk/commit/a018d0f4c79c52ac84dba09844bc9412c14bfd59))
 - feat: render commment icon and integrate with visual-builder modal (Venkat - [a3b2262](https://github.com/contentstack/live-preview-sdk/commit/a3b2262ffe4675faaa01da7d4ae34bada3084524))
-- feat: Handle Comment modal should open on click event in highlighed icon (Venkat - [959e6b7](https://github.com/contentstack/live-preview-sdk/commit/959e6b7ff322b3e28639bdcc787d68e870423acd))
+- feat: Handle Comment modal should open on click event in  highlighed icon (Venkat - [959e6b7](https://github.com/contentstack/live-preview-sdk/commit/959e6b7ff322b3e28639bdcc787d68e870423acd))
 - feat: update comment icon for Highlight (hiteshshetty-dev - [246853d](https://github.com/contentstack/live-preview-sdk/commit/246853d04fc9f68cf40e5464b373d32bc647b106))
 - feat: fix psuedo editable element positioning (hiteshshetty-dev - [06449bd](https://github.com/contentstack/live-preview-sdk/commit/06449bdc2cafed991585eb7c9da470cf82262369))
 - feat: handle scroll to field (Venkat - [763ae74](https://github.com/contentstack/live-preview-sdk/commit/763ae747bc2b7b2a493e1757bb5ea679691657a2))
@@ -1627,7 +1652,7 @@
 - fix: updated test snapshots in liveEditor (Vishvam10 - [2038712](https://github.com/contentstack/live-preview-sdk/commit/20387127a85f497c1aa73970e47d3fea551f48c7))
 - fix: multiple add instance buttons not shown while hovering (Vishvam10 - [e58df20](https://github.com/contentstack/live-preview-sdk/commit/e58df20b784c85d569f0da520b803bf38a320edb))
 - fix: incorrect focus on blocks field instead of newly added block (Faraaz Biyabani - [9b7c776](https://github.com/contentstack/live-preview-sdk/commit/9b7c776bfad219c04ef76b65ca287178e25e890e))
-- fix: single line line break and unnecessary psuedo editable due to nbsp (Faraaz Biyabani - [63d2f6a](https://github.com/contentstack/live-preview-sdk/commit/63d2f6a0f9a44d95ff1a1e7c417d1a4ee30fd410))
+- fix: single line line break and unnecessary  psuedo editable due to nbsp (Faraaz Biyabani - [63d2f6a](https://github.com/contentstack/live-preview-sdk/commit/63d2f6a0f9a44d95ff1a1e7c417d1a4ee30fd410))
 - fix: moved global state into VIsualEditor class and updated params.ts to types.ts (Vishvam10 - [e211d2d](https://github.com/contentstack/live-preview-sdk/commit/e211d2dcd0e7ce23e680dccc0505ea2fccf52e44))
 - fix: resolve overlay issue occurring upon clicking the visual editor wrapper element (Vishvam10 - [64d7f3d](https://github.com/contentstack/live-preview-sdk/commit/64d7f3d86ac38b963d8202805adc9490407a6028))
 - fix: eslint errors, add return types and updated interfaces to types (Vishvam10 - [59a3ca0](https://github.com/contentstack/live-preview-sdk/commit/59a3ca0a1cfc070a65ba448337029d853bc2be54))
diff --git a/package-lock.json b/package-lock.json
index c4d7d09e..dd9fb017 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
     "name": "@contentstack/live-preview-utils",
-    "version": "4.5.2",
+    "version": "4.5.3",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "@contentstack/live-preview-utils",
-            "version": "4.5.2",
+            "version": "4.5.3",
             "license": "MIT",
             "dependencies": {
                 "@floating-ui/dom": "^1.7.2",
diff --git a/package.json b/package.json
index 9c7b86b2..d3ab86cd 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@contentstack/live-preview-utils",
-    "version": "4.5.2",
+    "version": "4.5.3",
     "description": "Contentstack provides the Live Preview SDK to establish a communication channel between the various Contentstack SDKs and your website, transmitting  live changes to the preview pane.",
     "type": "module",
     "types": "dist/legacy/index.d.ts",

From 697a526f9826171599a09cd8d5281997cc247891 Mon Sep 17 00:00:00 2001
From: Karan Gandhi <karan.gandhi@contentstack.com>
Date: Tue, 29 Sep 2026 10:56:19 +0530
Subject: [PATCH 16/16] fix: update CDN version to 4.5.3 in README

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 64eb53b6..a6449595 100644
--- a/README.md
+++ b/README.md
@@ -29,11 +29,11 @@ npm install @contentstack/live-preview-utils
 
 ### Load from a CDN (advanced)
 
-Pin the version to match your app (update `4.5.2` when you upgrade):
+Pin the version to match your app (update `4.5.3` when you upgrade):
 
 ```html
 <script type="module" crossorigin="anonymous">
-  import ContentstackLivePreview from "https://esm.sh/@contentstack/live-preview-utils@4.5.2";
+  import ContentstackLivePreview from "https://esm.sh/@contentstack/live-preview-utils@4.5.3";
 
   ContentstackLivePreview.init({
     stackDetails: {