@atlaskit/editor-synced-block-provider 4.3.5 → 4.4.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/editor-synced-block-provider
 
+## 4.4.0
+
+### Minor Changes
+
+- [`dd9c0778c3832`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/dd9c0778c3832) -
+  Add \_\_livePage option to syncedBlock plugin and store managers. Add isReferenceBlock/isSyncBlock
+  methods. Use predicate functions instead of hardcoded node type names. Fix isDirty logic for
+  remote transactions. Fix flush() view-mode return value.
+
+## 4.3.6
+
+### Patch Changes
+
+- [`540d72eba7200`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/540d72eba7200) -
+  Editor-5503: Add connection diagnostics to GraphQL WebSocket errors for improved debugging of
+  opaque browser error events
+
 ## 4.3.5
 
 ### Patch Changes

package/dist/cjs/clients/block-service/blockSubscription.js

@@ -1,14 +1,60 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.subscribeToBlockUpdates = void 0;
+exports.subscribeToBlockUpdates = exports.getConnectionDiagnosticsSummary = exports.extractGraphQLWSErrorMessage = void 0;
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _graphqlWs = require("graphql-ws");
 var _coreUtils = require("@atlaskit/editor-common/core-utils");
+var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _utils = require("../../utils/utils");
 var GRAPHQL_WS_ENDPOINT = '/gateway/api/graphql/subscriptions';
 var blockServiceClient = null;
+
+/**
+ * Tracks the last known WebSocket connection context for diagnostics.
+ * Since browser WebSocket errors are intentionally opaque ({isTrusted: true}),
+ * we capture lifecycle events to provide meaningful context when errors occur.
+ */
+var connectionDiagnostics = {
+  /** Whether the last connection attempt was a retry */
+  wasRetry: false,
+  /** Timestamp of the last successful connection */
+  lastConnectedAt: 0,
+  /** The close code from the most recent WebSocket CloseEvent, see (https://websocket.org/reference/close-codes/)*/
+  lastCloseCode: 0,
+  /** The close reason from the most recent WebSocket CloseEvent */
+  lastCloseReason: '',
+  /** Whether the last close was clean */
+  lastCloseWasClean: true,
+  /** Current connection state */
+  state: 'idle',
+  /** Number of consecutive connection failures */
+  consecutiveFailures: 0
+};
+
+/**
+ * Returns a diagnostic summary string from the last known connection state.
+ * This provides context that the opaque WebSocket error events cannot.
+ */
+var getConnectionDiagnosticsSummary = exports.getConnectionDiagnosticsSummary = function getConnectionDiagnosticsSummary() {
+  var parts = [];
+  if (connectionDiagnostics.lastCloseCode !== 0) {
+    parts.push("lastCloseCode=".concat(connectionDiagnostics.lastCloseCode));
+    parts.push("lastCloseReason=\"".concat(connectionDiagnostics.lastCloseReason || 'none', "\""));
+    parts.push("wasClean=".concat(connectionDiagnostics.lastCloseWasClean));
+  }
+  parts.push("state=".concat(connectionDiagnostics.state));
+  parts.push("wasRetry=".concat(connectionDiagnostics.wasRetry));
+  parts.push("consecutiveFailures=".concat(connectionDiagnostics.consecutiveFailures));
+  if (connectionDiagnostics.lastConnectedAt > 0) {
+    var elapsed = Date.now() - connectionDiagnostics.lastConnectedAt;
+    parts.push("timeSinceLastConnection=".concat(elapsed, "ms"));
+  }
+  return parts.join(', ');
+};
 var getBlockServiceClient = function getBlockServiceClient() {
   // Don't create client during SSR
   if ((0, _coreUtils.isSSR)()) {
@@ -20,12 +66,63 @@ var getBlockServiceClient = function getBlockServiceClient() {
     blockServiceClient = (0, _graphqlWs.createClient)({
       url: wsUrl,
       lazy: true,
-      retryAttempts: 3
+      retryAttempts: 3,
+      on: (0, _platformFeatureFlags.fg)('platform_synced_block_add_info_web_socket_error') ? {
+        connecting: function connecting(isRetry) {
+          connectionDiagnostics.wasRetry = isRetry;
+          connectionDiagnostics.state = 'connecting';
+        },
+        connected: function connected(_socket, _payload, wasRetry) {
+          connectionDiagnostics.state = 'connected';
+          connectionDiagnostics.lastConnectedAt = Date.now();
+          connectionDiagnostics.wasRetry = wasRetry;
+          connectionDiagnostics.consecutiveFailures = 0;
+        },
+        closed: function closed(event) {
+          var _closeEvent$code, _closeEvent$reason, _closeEvent$wasClean;
+          connectionDiagnostics.state = 'closed';
+          var closeEvent = event;
+          connectionDiagnostics.lastCloseCode = (_closeEvent$code = closeEvent.code) !== null && _closeEvent$code !== void 0 ? _closeEvent$code : 0;
+          connectionDiagnostics.lastCloseReason = (_closeEvent$reason = closeEvent.reason) !== null && _closeEvent$reason !== void 0 ? _closeEvent$reason : '';
+          connectionDiagnostics.lastCloseWasClean = (_closeEvent$wasClean = closeEvent.wasClean) !== null && _closeEvent$wasClean !== void 0 ? _closeEvent$wasClean : false;
+        },
+        error: function error() {
+          connectionDiagnostics.state = 'error';
+          connectionDiagnostics.consecutiveFailures += 1;
+        }
+      } : undefined
     });
   }
   return blockServiceClient;
 };
 var SUBSCRIPTION_QUERY = "\nsubscription EDITOR_SYNCED_BLOCK_ON_BLOCK_UPDATED($resourceId: ID!) {\n\tblockService_onBlockUpdated(resourceId: $resourceId) {\n\t\tblockAri\n\t\tblockInstanceId\n\t\tcontent\n\t\tcontentUpdatedAt\n\t\tcreatedAt\n\t\tcreatedBy\n\t\tdeletionReason\n\t\tproduct\n\t\tsourceAri\n\t\tstatus\n\t}\n}\n";
+/**
+ * Extracts a meaningful error message from the error: GraphQL WebSocket Error: {"isTrusted":true}
+ *
+ * @param error - The error passed to the sink's error callback
+ * @returns A descriptive error message string
+ */
+var extractGraphQLWSErrorMessage = exports.extractGraphQLWSErrorMessage = function extractGraphQLWSErrorMessage(error) {
+  var diagnostics = getConnectionDiagnosticsSummary();
+
+  // Raw Event from WebSocket.onerror — browsers don't expose error details
+  // for security reasons, so {isTrusted: true} is all we get.
+  if ((0, _typeof2.default)(error) === 'object' && error !== null && 'isTrusted' in error) {
+    return "GraphQL WebSocket connection error (browser restricted error details). Diagnostics: ".concat(diagnostics);
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  // Fallback: try to stringify whatever we got
+  try {
+    var serialized = JSON.stringify(error);
+    return "GraphQL subscription error: ".concat(serialized);
+  } catch (_unused) {
+    return 'GraphQL subscription error: unknown error';
+  }
+};
+
 /**
  * Extracts the resourceId from a block ARI.
  * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
@@ -65,7 +162,7 @@ var parseSubscriptionPayload = function parseSubscriptionPayload(payload) {
       sourceAri: payload.sourceAri,
       status: payload.status
     };
-  } catch (_unused) {
+  } catch (_unused2) {
     return null;
   }
 };
@@ -111,8 +208,12 @@ var subscribeToBlockUpdates = exports.subscribeToBlockUpdates = function subscri
       };
       return error;
     }(function (error) {
-      var errorMessage = error instanceof Error ? error.message : 'GraphQL subscription error';
-      onError === null || onError === void 0 || onError(new Error(errorMessage));
+      if ((0, _platformFeatureFlags.fg)('platform_synced_block_add_info_web_socket_error')) {
+        onError === null || onError === void 0 || onError(new Error(extractGraphQLWSErrorMessage(error)));
+      } else {
+        var errorMessage = error instanceof Error ? error.message : 'GraphQL subscription error';
+        onError === null || onError === void 0 || onError(new Error(errorMessage));
+      }
     }),
     complete: function complete() {
       // Subscription completed

package/dist/cjs/hooks/useHandleContentChanges.js

@@ -10,6 +10,6 @@ var useHandleContentChanges = exports.useHandleContentChanges = function useHand
   // node content is modified by a ProseMirror transaction, which is exactly
   // when the source manager cache needs to be updated.
   (0, _react.useEffect)(function () {
-    manager.sourceManager.updateSyncBlockData(syncBlockNode);
+    manager.sourceManager.updateSyncBlockData(syncBlockNode, false);
   }, [manager, syncBlockNode]);
 };

package/dist/cjs/index.js

@@ -87,6 +87,12 @@ Object.defineProperty(exports, "createSyncBlockNode", {
     return _utils.createSyncBlockNode;
   }
 });
+Object.defineProperty(exports, "extractGraphQLWSErrorMessage", {
+  enumerable: true,
+  get: function get() {
+    return _blockSubscription.extractGraphQLWSErrorMessage;
+  }
+});
 Object.defineProperty(exports, "extractResourceIdFromBlockAri", {
   enumerable: true,
   get: function get() {
@@ -135,6 +141,12 @@ Object.defineProperty(exports, "getConfluencePageAri", {
     return _ari2.getConfluencePageAri;
   }
 });
+Object.defineProperty(exports, "getConnectionDiagnosticsSummary", {
+  enumerable: true,
+  get: function get() {
+    return _blockSubscription.getConnectionDiagnosticsSummary;
+  }
+});
 Object.defineProperty(exports, "getContentIdAndProductFromResourceId", {
   enumerable: true,
   get: function get() {
@@ -262,6 +274,7 @@ var _useFetchSyncBlockTitle = require("./hooks/useFetchSyncBlockTitle");
 var _useHandleContentChanges = require("./hooks/useHandleContentChanges");
 var _ari = require("./clients/block-service/ari");
 var _blockService = require("./clients/block-service/blockService");
+var _blockSubscription = require("./clients/block-service/blockSubscription");
 var _ari2 = require("./clients/confluence/ari");
 var _fetchMediaToken = require("./clients/confluence/fetchMediaToken");
 var _ari3 = require("./clients/jira/ari");

package/dist/cjs/store-manager/referenceSyncBlockStoreManager.js

@@ -109,14 +109,19 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
     // The provider might have SSR data cache already set, so we need to update the cache in session memory storage
     this.setSSRDataInSessionCache((_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.getNodeDataCacheKeys());
   }
-
-  /**
-   * Enables or disables real-time GraphQL subscriptions for block updates.
-   * When enabled, the store manager will subscribe to real-time updates
-   * instead of relying on polling.
-   * @param enabled - Whether to enable real-time subscriptions
-   */
   return (0, _createClass2.default)(ReferenceSyncBlockStoreManager, [{
+    key: "isReferenceBlock",
+    value: function isReferenceBlock(node) {
+      return node.type.name === 'syncBlock';
+    }
+
+    /**
+     * Enables or disables real-time GraphQL subscriptions for block updates.
+     * When enabled, the store manager will subscribe to real-time updates
+     * instead of relying on polling.
+     * @param enabled - Whether to enable real-time subscriptions
+     */
+  }, {
     key: "setRealTimeSubscriptionsEnabled",
     value: function setRealTimeSubscriptionsEnabled(enabled) {
       this._subscriptionManager.setRealTimeSubscriptionsEnabled(enabled);

package/dist/cjs/store-manager/sourceSyncBlockStoreManager.js

@@ -26,7 +26,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 // Handles caching, debouncing updates, and publish/subscribe for local changes.
 // Ensures consistency between local and remote state, and can be used in both editor and renderer contexts.
 var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PURE__*/function () {
-  function SourceSyncBlockStoreManager(dataProvider, viewMode) {
+  function SourceSyncBlockStoreManager(dataProvider, viewMode, isLivePage) {
     var _this = this;
     (0, _classCallCheck2.default)(this, SourceSyncBlockStoreManager);
     (0, _defineProperty2.default)(this, "hasReceivedContentChange", false);
@@ -41,6 +41,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
     });
     this.dataProvider = dataProvider;
     this.viewMode = viewMode;
+    this.isLivePage = isLivePage;
     this.syncBlockCache = new Map();
     this.creationCompletionCallbacks = new Map();
   }
@@ -76,7 +77,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
      */
   }, {
     key: "updateSyncBlockData",
-    value: function updateSyncBlockData(syncBlockNode) {
+    value: function updateSyncBlockData(syncBlockNode, isRemote) {
       try {
         if (this.viewMode === 'view' && (0, _platformFeatureFlags.fg)('platform_synced_block_patch_8')) {
           return false;
@@ -99,11 +100,13 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
             return true;
           }
           var syncBlockData = (0, _utils.convertSyncBlockPMNodeToSyncBlockData)(syncBlockNode);
-          if (cachedBlock) {
+          if (cachedBlock && !isRemote) {
             this.hasReceivedContentChange = true;
           }
+          var isDirty = !isRemote || !cachedBlock; // if the change is not remote, or the block is not in the cache yet, it's dirty
           this.syncBlockCache.set(resourceId, _objectSpread(_objectSpread({}, syncBlockData), {}, {
-            isDirty: true,
+            isDirty: isDirty,
+            // if the change is from remote, it's not dirty
             contentFragment: syncBlockNode.content
           }));
         } else {
@@ -145,7 +148,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
                 _context.next = 3;
                 break;
               }
-              return _context.abrupt("return", false);
+              return _context.abrupt("return", true);
             case 3:
               bodiedSyncBlockNodes = [];
               bodiedSyncBlockData = [];
@@ -256,6 +259,13 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
       if (this.viewMode === 'view' && (0, _platformFeatureFlags.fg)('platform_synced_block_patch_8')) {
         return false;
       }
+
+      // Only track unsaved changes in source synced block for live pages
+      // classic pages's draft don't publish synced block content to block service and the content itself is saved as part of the draft
+      // classic page's publish flow will trigger a flush which only uses the isDirty flag to determine if there are unsaved changes
+      if (!this.isLivePage) {
+        return false;
+      }
       return this.hasReceivedContentChange && Array.from(this.syncBlockCache.values()).some(function (syncBlockData) {
         return syncBlockData.isDirty;
       });
@@ -356,7 +366,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         }
         if ((0, _platformFeatureFlags.fg)('platform_synced_block_update_refactor')) {
           // add the node to the cache
-          this.updateSyncBlockData(node);
+          this.updateSyncBlockData(node, false);
         }
         this.creationCompletionCallbacks.set(resourceId, onCompletion);
         (_this$createExperienc = this.createExperience) === null || _this$createExperienc === void 0 || _this$createExperienc.start({});

package/dist/cjs/store-manager/syncBlockStoreManager.js

@@ -27,16 +27,21 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 // SourceSyncBlockStoreManager is responsible for the lifecycle and state management of source sync blocks in an editor instance.
 // Can be used in both editor and renderer contexts.
 var SyncBlockStoreManager = exports.SyncBlockStoreManager = /*#__PURE__*/function () {
-  function SyncBlockStoreManager(dataProvider, viewMode) {
+  function SyncBlockStoreManager(dataProvider, viewMode, isLivePage) {
     (0, _classCallCheck2.default)(this, SyncBlockStoreManager);
     // In future, if reference manager needs to reach to source manager and read its current in memory cache
     // we can pass the source manager as a parameter to the reference manager constructor
-    this.sourceSyncBlockStoreManager = new _sourceSyncBlockStoreManager.SourceSyncBlockStoreManager(dataProvider, viewMode);
+    this.sourceSyncBlockStoreManager = new _sourceSyncBlockStoreManager.SourceSyncBlockStoreManager(dataProvider, viewMode, isLivePage);
     this.referenceSyncBlockStoreManager = new _referenceSyncBlockStoreManager.ReferenceSyncBlockStoreManager(dataProvider, viewMode);
     this.dataProvider = dataProvider;
     this.referenceSyncBlockStoreManager.setRealTimeSubscriptionsEnabled(true);
   }
   return (0, _createClass2.default)(SyncBlockStoreManager, [{
+    key: "isSyncBlock",
+    value: function isSyncBlock(node) {
+      return this.sourceSyncBlockStoreManager.isSourceBlock(node) || this.referenceSyncBlockStoreManager.isReferenceBlock(node);
+    }
+  }, {
     key: "fetchReferencesSourceInfo",
     value: function () {
       var _fetchReferencesSourceInfo = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(resourceId, blockInstanceId, isSourceSyncBlock) {

package/dist/es2019/clients/block-service/blockSubscription.js

@@ -1,8 +1,52 @@
 import { createClient } from 'graphql-ws';
 import { isSSR } from '@atlaskit/editor-common/core-utils';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { convertContentUpdatedAt } from '../../utils/utils';
 const GRAPHQL_WS_ENDPOINT = '/gateway/api/graphql/subscriptions';
 let blockServiceClient = null;
+
+/**
+ * Tracks the last known WebSocket connection context for diagnostics.
+ * Since browser WebSocket errors are intentionally opaque ({isTrusted: true}),
+ * we capture lifecycle events to provide meaningful context when errors occur.
+ */
+const connectionDiagnostics = {
+  /** Whether the last connection attempt was a retry */
+  wasRetry: false,
+  /** Timestamp of the last successful connection */
+  lastConnectedAt: 0,
+  /** The close code from the most recent WebSocket CloseEvent, see (https://websocket.org/reference/close-codes/)*/
+  lastCloseCode: 0,
+  /** The close reason from the most recent WebSocket CloseEvent */
+  lastCloseReason: '',
+  /** Whether the last close was clean */
+  lastCloseWasClean: true,
+  /** Current connection state */
+  state: 'idle',
+  /** Number of consecutive connection failures */
+  consecutiveFailures: 0
+};
+
+/**
+ * Returns a diagnostic summary string from the last known connection state.
+ * This provides context that the opaque WebSocket error events cannot.
+ */
+export const getConnectionDiagnosticsSummary = () => {
+  const parts = [];
+  if (connectionDiagnostics.lastCloseCode !== 0) {
+    parts.push(`lastCloseCode=${connectionDiagnostics.lastCloseCode}`);
+    parts.push(`lastCloseReason="${connectionDiagnostics.lastCloseReason || 'none'}"`);
+    parts.push(`wasClean=${connectionDiagnostics.lastCloseWasClean}`);
+  }
+  parts.push(`state=${connectionDiagnostics.state}`);
+  parts.push(`wasRetry=${connectionDiagnostics.wasRetry}`);
+  parts.push(`consecutiveFailures=${connectionDiagnostics.consecutiveFailures}`);
+  if (connectionDiagnostics.lastConnectedAt > 0) {
+    const elapsed = Date.now() - connectionDiagnostics.lastConnectedAt;
+    parts.push(`timeSinceLastConnection=${elapsed}ms`);
+  }
+  return parts.join(', ');
+};
 const getBlockServiceClient = () => {
   // Don't create client during SSR
   if (isSSR()) {
@@ -14,7 +58,31 @@ const getBlockServiceClient = () => {
     blockServiceClient = createClient({
       url: wsUrl,
       lazy: true,
-      retryAttempts: 3
+      retryAttempts: 3,
+      on: fg('platform_synced_block_add_info_web_socket_error') ? {
+        connecting: isRetry => {
+          connectionDiagnostics.wasRetry = isRetry;
+          connectionDiagnostics.state = 'connecting';
+        },
+        connected: (_socket, _payload, wasRetry) => {
+          connectionDiagnostics.state = 'connected';
+          connectionDiagnostics.lastConnectedAt = Date.now();
+          connectionDiagnostics.wasRetry = wasRetry;
+          connectionDiagnostics.consecutiveFailures = 0;
+        },
+        closed: event => {
+          var _closeEvent$code, _closeEvent$reason, _closeEvent$wasClean;
+          connectionDiagnostics.state = 'closed';
+          const closeEvent = event;
+          connectionDiagnostics.lastCloseCode = (_closeEvent$code = closeEvent.code) !== null && _closeEvent$code !== void 0 ? _closeEvent$code : 0;
+          connectionDiagnostics.lastCloseReason = (_closeEvent$reason = closeEvent.reason) !== null && _closeEvent$reason !== void 0 ? _closeEvent$reason : '';
+          connectionDiagnostics.lastCloseWasClean = (_closeEvent$wasClean = closeEvent.wasClean) !== null && _closeEvent$wasClean !== void 0 ? _closeEvent$wasClean : false;
+        },
+        error: () => {
+          connectionDiagnostics.state = 'error';
+          connectionDiagnostics.consecutiveFailures += 1;
+        }
+      } : undefined
     });
   }
   return blockServiceClient;
@@ -35,6 +103,33 @@ subscription EDITOR_SYNCED_BLOCK_ON_BLOCK_UPDATED($resourceId: ID!) {
 	}
 }
 `;
+/**
+ * Extracts a meaningful error message from the error: GraphQL WebSocket Error: {"isTrusted":true}
+ *
+ * @param error - The error passed to the sink's error callback
+ * @returns A descriptive error message string
+ */
+export const extractGraphQLWSErrorMessage = error => {
+  const diagnostics = getConnectionDiagnosticsSummary();
+
+  // Raw Event from WebSocket.onerror — browsers don't expose error details
+  // for security reasons, so {isTrusted: true} is all we get.
+  if (typeof error === 'object' && error !== null && 'isTrusted' in error) {
+    return `GraphQL WebSocket connection error (browser restricted error details). Diagnostics: ${diagnostics}`;
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  // Fallback: try to stringify whatever we got
+  try {
+    const serialized = JSON.stringify(error);
+    return `GraphQL subscription error: ${serialized}`;
+  } catch {
+    return 'GraphQL subscription error: unknown error';
+  }
+};
+
 /**
  * Extracts the resourceId from a block ARI.
  * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
@@ -112,8 +207,12 @@ export const subscribeToBlockUpdates = (blockAri, onData, onError) => {
       }
     },
     error: error => {
-      const errorMessage = error instanceof Error ? error.message : 'GraphQL subscription error';
-      onError === null || onError === void 0 ? void 0 : onError(new Error(errorMessage));
+      if (fg('platform_synced_block_add_info_web_socket_error')) {
+        onError === null || onError === void 0 ? void 0 : onError(new Error(extractGraphQLWSErrorMessage(error)));
+      } else {
+        const errorMessage = error instanceof Error ? error.message : 'GraphQL subscription error';
+        onError === null || onError === void 0 ? void 0 : onError(new Error(errorMessage));
+      }
     },
     complete: () => {
       // Subscription completed

package/dist/es2019/hooks/useHandleContentChanges.js

@@ -4,6 +4,6 @@ export const useHandleContentChanges = (manager, syncBlockNode) => {
   // node content is modified by a ProseMirror transaction, which is exactly
   // when the source manager cache needs to be updated.
   useEffect(() => {
-    manager.sourceManager.updateSyncBlockData(syncBlockNode);
+    manager.sourceManager.updateSyncBlockData(syncBlockNode, false);
   }, [manager, syncBlockNode]);
 };

package/dist/es2019/index.js

@@ -11,6 +11,7 @@ export { useHandleContentChanges } from './hooks/useHandleContentChanges';
 // clients
 export { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockResourceId } from './clients/block-service/ari';
 export { BlockError, updateSyncedBlocks } from './clients/block-service/blockService';
+export { extractGraphQLWSErrorMessage, getConnectionDiagnosticsSummary } from './clients/block-service/blockSubscription';
 export { getConfluencePageAri, getPageIdAndTypeFromConfluencePageAri } from './clients/confluence/ari';
 export { fetchMediaToken } from './clients/confluence/fetchMediaToken';
 export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';

package/dist/es2019/store-manager/referenceSyncBlockStoreManager.js

@@ -64,6 +64,9 @@ export class ReferenceSyncBlockStoreManager {
     // The provider might have SSR data cache already set, so we need to update the cache in session memory storage
     this.setSSRDataInSessionCache((_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.getNodeDataCacheKeys());
   }
+  isReferenceBlock(node) {
+    return node.type.name === 'syncBlock';
+  }
 
   /**
    * Enables or disables real-time GraphQL subscriptions for block updates.

package/dist/es2019/store-manager/sourceSyncBlockStoreManager.js

@@ -13,7 +13,7 @@ import { convertSyncBlockPMNodeToSyncBlockData } from '../utils/utils';
 // Handles caching, debouncing updates, and publish/subscribe for local changes.
 // Ensures consistency between local and remote state, and can be used in both editor and renderer contexts.
 export class SourceSyncBlockStoreManager {
-  constructor(dataProvider, viewMode) {
+  constructor(dataProvider, viewMode, isLivePage) {
     _defineProperty(this, "hasReceivedContentChange", false);
     _defineProperty(this, "setPendingDeletion", (Ids, value) => {
       if (this.viewMode === 'view' && fg('platform_synced_block_patch_8')) {
@@ -26,6 +26,7 @@ export class SourceSyncBlockStoreManager {
     });
     this.dataProvider = dataProvider;
     this.viewMode = viewMode;
+    this.isLivePage = isLivePage;
     this.syncBlockCache = new Map();
     this.creationCompletionCallbacks = new Map();
   }
@@ -53,7 +54,7 @@ export class SourceSyncBlockStoreManager {
    * Add/update a sync block node to/from the local cache
    * @param syncBlockNode - The sync block node to update
    */
-  updateSyncBlockData(syncBlockNode) {
+  updateSyncBlockData(syncBlockNode, isRemote) {
     try {
       if (this.viewMode === 'view' && fg('platform_synced_block_patch_8')) {
         return false;
@@ -77,12 +78,14 @@ export class SourceSyncBlockStoreManager {
           return true;
         }
         const syncBlockData = convertSyncBlockPMNodeToSyncBlockData(syncBlockNode);
-        if (cachedBlock) {
+        if (cachedBlock && !isRemote) {
           this.hasReceivedContentChange = true;
         }
+        const isDirty = !isRemote || !cachedBlock; // if the change is not remote, or the block is not in the cache yet, it's dirty
         this.syncBlockCache.set(resourceId, {
           ...syncBlockData,
-          isDirty: true,
+          isDirty: isDirty,
+          // if the change is from remote, it's not dirty
           contentFragment: syncBlockNode.content
         });
       } else {
@@ -115,7 +118,7 @@ export class SourceSyncBlockStoreManager {
     try {
       var _this$saveExperience;
       if (this.viewMode === 'view' && fg('platform_synced_block_patch_8')) {
-        return false;
+        return true;
       }
       const bodiedSyncBlockNodes = [];
       const bodiedSyncBlockData = [];
@@ -198,6 +201,13 @@ export class SourceSyncBlockStoreManager {
     if (this.viewMode === 'view' && fg('platform_synced_block_patch_8')) {
       return false;
     }
+
+    // Only track unsaved changes in source synced block for live pages
+    // classic pages's draft don't publish synced block content to block service and the content itself is saved as part of the draft
+    // classic page's publish flow will trigger a flush which only uses the isDirty flag to determine if there are unsaved changes
+    if (!this.isLivePage) {
+      return false;
+    }
     return this.hasReceivedContentChange && Array.from(this.syncBlockCache.values()).some(syncBlockData => syncBlockData.isDirty);
   }
   isPendingCreation(resourceId) {
@@ -285,7 +295,7 @@ export class SourceSyncBlockStoreManager {
       }
       if (fg('platform_synced_block_update_refactor')) {
         // add the node to the cache
-        this.updateSyncBlockData(node);
+        this.updateSyncBlockData(node, false);
       }
       this.creationCompletionCallbacks.set(resourceId, onCompletion);
       (_this$createExperienc = this.createExperience) === null || _this$createExperienc === void 0 ? void 0 : _this$createExperienc.start({});

package/dist/es2019/store-manager/syncBlockStoreManager.js

@@ -14,14 +14,17 @@ import { SourceSyncBlockStoreManager } from './sourceSyncBlockStoreManager';
 // SourceSyncBlockStoreManager is responsible for the lifecycle and state management of source sync blocks in an editor instance.
 // Can be used in both editor and renderer contexts.
 export class SyncBlockStoreManager {
-  constructor(dataProvider, viewMode) {
+  constructor(dataProvider, viewMode, isLivePage) {
     // In future, if reference manager needs to reach to source manager and read its current in memory cache
     // we can pass the source manager as a parameter to the reference manager constructor
-    this.sourceSyncBlockStoreManager = new SourceSyncBlockStoreManager(dataProvider, viewMode);
+    this.sourceSyncBlockStoreManager = new SourceSyncBlockStoreManager(dataProvider, viewMode, isLivePage);
     this.referenceSyncBlockStoreManager = new ReferenceSyncBlockStoreManager(dataProvider, viewMode);
     this.dataProvider = dataProvider;
     this.referenceSyncBlockStoreManager.setRealTimeSubscriptionsEnabled(true);
   }
+  isSyncBlock(node) {
+    return this.sourceSyncBlockStoreManager.isSourceBlock(node) || this.referenceSyncBlockStoreManager.isReferenceBlock(node);
+  }
   async fetchReferencesSourceInfo(resourceId, blockInstanceId, isSourceSyncBlock) {
     try {
       var _this$fetchReferences, _response$references, _this$fetchReferences5, _response$references2;

package/dist/esm/clients/block-service/blockSubscription.js

@@ -1,8 +1,53 @@
+import _typeof from "@babel/runtime/helpers/typeof";
 import { createClient } from 'graphql-ws';
 import { isSSR } from '@atlaskit/editor-common/core-utils';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { convertContentUpdatedAt } from '../../utils/utils';
 var GRAPHQL_WS_ENDPOINT = '/gateway/api/graphql/subscriptions';
 var blockServiceClient = null;
+
+/**
+ * Tracks the last known WebSocket connection context for diagnostics.
+ * Since browser WebSocket errors are intentionally opaque ({isTrusted: true}),
+ * we capture lifecycle events to provide meaningful context when errors occur.
+ */
+var connectionDiagnostics = {
+  /** Whether the last connection attempt was a retry */
+  wasRetry: false,
+  /** Timestamp of the last successful connection */
+  lastConnectedAt: 0,
+  /** The close code from the most recent WebSocket CloseEvent, see (https://websocket.org/reference/close-codes/)*/
+  lastCloseCode: 0,
+  /** The close reason from the most recent WebSocket CloseEvent */
+  lastCloseReason: '',
+  /** Whether the last close was clean */
+  lastCloseWasClean: true,
+  /** Current connection state */
+  state: 'idle',
+  /** Number of consecutive connection failures */
+  consecutiveFailures: 0
+};
+
+/**
+ * Returns a diagnostic summary string from the last known connection state.
+ * This provides context that the opaque WebSocket error events cannot.
+ */
+export var getConnectionDiagnosticsSummary = function getConnectionDiagnosticsSummary() {
+  var parts = [];
+  if (connectionDiagnostics.lastCloseCode !== 0) {
+    parts.push("lastCloseCode=".concat(connectionDiagnostics.lastCloseCode));
+    parts.push("lastCloseReason=\"".concat(connectionDiagnostics.lastCloseReason || 'none', "\""));
+    parts.push("wasClean=".concat(connectionDiagnostics.lastCloseWasClean));
+  }
+  parts.push("state=".concat(connectionDiagnostics.state));
+  parts.push("wasRetry=".concat(connectionDiagnostics.wasRetry));
+  parts.push("consecutiveFailures=".concat(connectionDiagnostics.consecutiveFailures));
+  if (connectionDiagnostics.lastConnectedAt > 0) {
+    var elapsed = Date.now() - connectionDiagnostics.lastConnectedAt;
+    parts.push("timeSinceLastConnection=".concat(elapsed, "ms"));
+  }
+  return parts.join(', ');
+};
 var getBlockServiceClient = function getBlockServiceClient() {
   // Don't create client during SSR
   if (isSSR()) {
@@ -14,12 +59,63 @@ var getBlockServiceClient = function getBlockServiceClient() {
     blockServiceClient = createClient({
       url: wsUrl,
       lazy: true,
-      retryAttempts: 3
+      retryAttempts: 3,
+      on: fg('platform_synced_block_add_info_web_socket_error') ? {
+        connecting: function connecting(isRetry) {
+          connectionDiagnostics.wasRetry = isRetry;
+          connectionDiagnostics.state = 'connecting';
+        },
+        connected: function connected(_socket, _payload, wasRetry) {
+          connectionDiagnostics.state = 'connected';
+          connectionDiagnostics.lastConnectedAt = Date.now();
+          connectionDiagnostics.wasRetry = wasRetry;
+          connectionDiagnostics.consecutiveFailures = 0;
+        },
+        closed: function closed(event) {
+          var _closeEvent$code, _closeEvent$reason, _closeEvent$wasClean;
+          connectionDiagnostics.state = 'closed';
+          var closeEvent = event;
+          connectionDiagnostics.lastCloseCode = (_closeEvent$code = closeEvent.code) !== null && _closeEvent$code !== void 0 ? _closeEvent$code : 0;
+          connectionDiagnostics.lastCloseReason = (_closeEvent$reason = closeEvent.reason) !== null && _closeEvent$reason !== void 0 ? _closeEvent$reason : '';
+          connectionDiagnostics.lastCloseWasClean = (_closeEvent$wasClean = closeEvent.wasClean) !== null && _closeEvent$wasClean !== void 0 ? _closeEvent$wasClean : false;
+        },
+        error: function error() {
+          connectionDiagnostics.state = 'error';
+          connectionDiagnostics.consecutiveFailures += 1;
+        }
+      } : undefined
     });
   }
   return blockServiceClient;
 };
 var SUBSCRIPTION_QUERY = "\nsubscription EDITOR_SYNCED_BLOCK_ON_BLOCK_UPDATED($resourceId: ID!) {\n\tblockService_onBlockUpdated(resourceId: $resourceId) {\n\t\tblockAri\n\t\tblockInstanceId\n\t\tcontent\n\t\tcontentUpdatedAt\n\t\tcreatedAt\n\t\tcreatedBy\n\t\tdeletionReason\n\t\tproduct\n\t\tsourceAri\n\t\tstatus\n\t}\n}\n";
+/**
+ * Extracts a meaningful error message from the error: GraphQL WebSocket Error: {"isTrusted":true}
+ *
+ * @param error - The error passed to the sink's error callback
+ * @returns A descriptive error message string
+ */
+export var extractGraphQLWSErrorMessage = function extractGraphQLWSErrorMessage(error) {
+  var diagnostics = getConnectionDiagnosticsSummary();
+
+  // Raw Event from WebSocket.onerror — browsers don't expose error details
+  // for security reasons, so {isTrusted: true} is all we get.
+  if (_typeof(error) === 'object' && error !== null && 'isTrusted' in error) {
+    return "GraphQL WebSocket connection error (browser restricted error details). Diagnostics: ".concat(diagnostics);
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  // Fallback: try to stringify whatever we got
+  try {
+    var serialized = JSON.stringify(error);
+    return "GraphQL subscription error: ".concat(serialized);
+  } catch (_unused) {
+    return 'GraphQL subscription error: unknown error';
+  }
+};
+
 /**
  * Extracts the resourceId from a block ARI.
  * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
@@ -59,7 +155,7 @@ var parseSubscriptionPayload = function parseSubscriptionPayload(payload) {
       sourceAri: payload.sourceAri,
       status: payload.status
     };
-  } catch (_unused) {
+  } catch (_unused2) {
     return null;
   }
 };
@@ -105,8 +201,12 @@ export var subscribeToBlockUpdates = function subscribeToBlockUpdates(blockAri,
       };
       return error;
     }(function (error) {
-      var errorMessage = error instanceof Error ? error.message : 'GraphQL subscription error';
-      onError === null || onError === void 0 || onError(new Error(errorMessage));
+      if (fg('platform_synced_block_add_info_web_socket_error')) {
+        onError === null || onError === void 0 || onError(new Error(extractGraphQLWSErrorMessage(error)));
+      } else {
+        var errorMessage = error instanceof Error ? error.message : 'GraphQL subscription error';
+        onError === null || onError === void 0 || onError(new Error(errorMessage));
+      }
     }),
     complete: function complete() {
       // Subscription completed

package/dist/esm/hooks/useHandleContentChanges.js

@@ -4,6 +4,6 @@ export var useHandleContentChanges = function useHandleContentChanges(manager, s
   // node content is modified by a ProseMirror transaction, which is exactly
   // when the source manager cache needs to be updated.
   useEffect(function () {
-    manager.sourceManager.updateSyncBlockData(syncBlockNode);
+    manager.sourceManager.updateSyncBlockData(syncBlockNode, false);
   }, [manager, syncBlockNode]);
 };

package/dist/esm/index.js

@@ -11,6 +11,7 @@ export { useHandleContentChanges } from './hooks/useHandleContentChanges';
 // clients
 export { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockResourceId } from './clients/block-service/ari';
 export { BlockError, updateSyncedBlocks } from './clients/block-service/blockService';
+export { extractGraphQLWSErrorMessage, getConnectionDiagnosticsSummary } from './clients/block-service/blockSubscription';
 export { getConfluencePageAri, getPageIdAndTypeFromConfluencePageAri } from './clients/confluence/ari';
 export { fetchMediaToken } from './clients/confluence/fetchMediaToken';
 export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';

package/dist/esm/store-manager/referenceSyncBlockStoreManager.js

@@ -102,14 +102,19 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
     // The provider might have SSR data cache already set, so we need to update the cache in session memory storage
     this.setSSRDataInSessionCache((_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.getNodeDataCacheKeys());
   }
-
-  /**
-   * Enables or disables real-time GraphQL subscriptions for block updates.
-   * When enabled, the store manager will subscribe to real-time updates
-   * instead of relying on polling.
-   * @param enabled - Whether to enable real-time subscriptions
-   */
   return _createClass(ReferenceSyncBlockStoreManager, [{
+    key: "isReferenceBlock",
+    value: function isReferenceBlock(node) {
+      return node.type.name === 'syncBlock';
+    }
+
+    /**
+     * Enables or disables real-time GraphQL subscriptions for block updates.
+     * When enabled, the store manager will subscribe to real-time updates
+     * instead of relying on polling.
+     * @param enabled - Whether to enable real-time subscriptions
+     */
+  }, {
     key: "setRealTimeSubscriptionsEnabled",
     value: function setRealTimeSubscriptionsEnabled(enabled) {
       this._subscriptionManager.setRealTimeSubscriptionsEnabled(enabled);

package/dist/esm/store-manager/sourceSyncBlockStoreManager.js

@@ -19,7 +19,7 @@ import { convertSyncBlockPMNodeToSyncBlockData } from '../utils/utils';
 // Handles caching, debouncing updates, and publish/subscribe for local changes.
 // Ensures consistency between local and remote state, and can be used in both editor and renderer contexts.
 export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
-  function SourceSyncBlockStoreManager(dataProvider, viewMode) {
+  function SourceSyncBlockStoreManager(dataProvider, viewMode, isLivePage) {
     var _this = this;
     _classCallCheck(this, SourceSyncBlockStoreManager);
     _defineProperty(this, "hasReceivedContentChange", false);
@@ -34,6 +34,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     });
     this.dataProvider = dataProvider;
     this.viewMode = viewMode;
+    this.isLivePage = isLivePage;
     this.syncBlockCache = new Map();
     this.creationCompletionCallbacks = new Map();
   }
@@ -69,7 +70,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
      */
   }, {
     key: "updateSyncBlockData",
-    value: function updateSyncBlockData(syncBlockNode) {
+    value: function updateSyncBlockData(syncBlockNode, isRemote) {
       try {
         if (this.viewMode === 'view' && fg('platform_synced_block_patch_8')) {
           return false;
@@ -92,11 +93,13 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
             return true;
           }
           var syncBlockData = convertSyncBlockPMNodeToSyncBlockData(syncBlockNode);
-          if (cachedBlock) {
+          if (cachedBlock && !isRemote) {
             this.hasReceivedContentChange = true;
           }
+          var isDirty = !isRemote || !cachedBlock; // if the change is not remote, or the block is not in the cache yet, it's dirty
           this.syncBlockCache.set(resourceId, _objectSpread(_objectSpread({}, syncBlockData), {}, {
-            isDirty: true,
+            isDirty: isDirty,
+            // if the change is from remote, it's not dirty
             contentFragment: syncBlockNode.content
           }));
         } else {
@@ -138,7 +141,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
                 _context.next = 3;
                 break;
               }
-              return _context.abrupt("return", false);
+              return _context.abrupt("return", true);
             case 3:
               bodiedSyncBlockNodes = [];
               bodiedSyncBlockData = [];
@@ -249,6 +252,13 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       if (this.viewMode === 'view' && fg('platform_synced_block_patch_8')) {
         return false;
       }
+
+      // Only track unsaved changes in source synced block for live pages
+      // classic pages's draft don't publish synced block content to block service and the content itself is saved as part of the draft
+      // classic page's publish flow will trigger a flush which only uses the isDirty flag to determine if there are unsaved changes
+      if (!this.isLivePage) {
+        return false;
+      }
       return this.hasReceivedContentChange && Array.from(this.syncBlockCache.values()).some(function (syncBlockData) {
         return syncBlockData.isDirty;
       });
@@ -349,7 +359,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         }
         if (fg('platform_synced_block_update_refactor')) {
           // add the node to the cache
-          this.updateSyncBlockData(node);
+          this.updateSyncBlockData(node, false);
         }
         this.creationCompletionCallbacks.set(resourceId, onCompletion);
         (_this$createExperienc = this.createExperience) === null || _this$createExperienc === void 0 || _this$createExperienc.start({});

package/dist/esm/store-manager/syncBlockStoreManager.js

@@ -21,16 +21,21 @@ import { SourceSyncBlockStoreManager } from './sourceSyncBlockStoreManager';
 // SourceSyncBlockStoreManager is responsible for the lifecycle and state management of source sync blocks in an editor instance.
 // Can be used in both editor and renderer contexts.
 export var SyncBlockStoreManager = /*#__PURE__*/function () {
-  function SyncBlockStoreManager(dataProvider, viewMode) {
+  function SyncBlockStoreManager(dataProvider, viewMode, isLivePage) {
     _classCallCheck(this, SyncBlockStoreManager);
     // In future, if reference manager needs to reach to source manager and read its current in memory cache
     // we can pass the source manager as a parameter to the reference manager constructor
-    this.sourceSyncBlockStoreManager = new SourceSyncBlockStoreManager(dataProvider, viewMode);
+    this.sourceSyncBlockStoreManager = new SourceSyncBlockStoreManager(dataProvider, viewMode, isLivePage);
     this.referenceSyncBlockStoreManager = new ReferenceSyncBlockStoreManager(dataProvider, viewMode);
     this.dataProvider = dataProvider;
     this.referenceSyncBlockStoreManager.setRealTimeSubscriptionsEnabled(true);
   }
   return _createClass(SyncBlockStoreManager, [{
+    key: "isSyncBlock",
+    value: function isSyncBlock(node) {
+      return this.sourceSyncBlockStoreManager.isSourceBlock(node) || this.referenceSyncBlockStoreManager.isReferenceBlock(node);
+    }
+  }, {
     key: "fetchReferencesSourceInfo",
     value: function () {
       var _fetchReferencesSourceInfo = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(resourceId, blockInstanceId, isSourceSyncBlock) {

package/dist/types/clients/block-service/blockSubscription.d.ts

@@ -1,5 +1,10 @@
 import type { ADFEntity } from '@atlaskit/adf-utils/types';
 import type { SyncBlockProduct } from '../../common/types';
+/**
+ * Returns a diagnostic summary string from the last known connection state.
+ * This provides context that the opaque WebSocket error events cannot.
+ */
+export declare const getConnectionDiagnosticsSummary: () => string;
 export type BlockSubscriptionPayload = {
     blockAri: string;
     blockInstanceId: string;
@@ -27,6 +32,13 @@ export type ParsedBlockSubscriptionData = {
 type SubscriptionCallback = (data: ParsedBlockSubscriptionData) => void;
 type ErrorCallback = (error: Error) => void;
 type Unsubscribe = () => void;
+/**
+ * Extracts a meaningful error message from the error: GraphQL WebSocket Error: {"isTrusted":true}
+ *
+ * @param error - The error passed to the sink's error callback
+ * @returns A descriptive error message string
+ */
+export declare const extractGraphQLWSErrorMessage: (error: unknown) => string;
 /**
  * Creates a GraphQL subscription to block updates using the shared graphql-ws client.
  *

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ export { useHandleContentChanges } from './hooks/useHandleContentChanges';
 export { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockResourceId, } from './clients/block-service/ari';
 export type { BlockContentResponse, BatchRetrieveSyncedBlocksResponse, ErrorResponse, } from './clients/block-service/blockService';
 export { BlockError, updateSyncedBlocks } from './clients/block-service/blockService';
+export { extractGraphQLWSErrorMessage, getConnectionDiagnosticsSummary, } from './clients/block-service/blockSubscription';
 export { getConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, } from './clients/confluence/ari';
 export { fetchMediaToken, type TokenData, type ConfigData, } from './clients/confluence/fetchMediaToken';
 export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';

package/dist/types/store-manager/referenceSyncBlockStoreManager.d.ts

@@ -25,6 +25,7 @@ export declare class ReferenceSyncBlockStoreManager {
     private _providerFactoryManager;
     private _batchFetcher;
     constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
+    isReferenceBlock(node: PMNode): boolean;
     /**
      * Enables or disables real-time GraphQL subscriptions for block updates.
      * When enabled, the store manager will subscribe to real-time updates

package/dist/types/store-manager/sourceSyncBlockStoreManager.d.ts

@@ -9,6 +9,7 @@ type OnCompletion = (success: boolean) => void;
 type DestroyCallback = () => void;
 export declare class SourceSyncBlockStoreManager {
     private viewMode?;
+    private isLivePage?;
     private dataProvider?;
     private fireAnalyticsEvent?;
     private syncBlockCache;
@@ -21,7 +22,7 @@ export declare class SourceSyncBlockStoreManager {
     private saveExperience;
     private deleteExperience;
     private fetchSourceInfoExperience;
-    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
+    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode, isLivePage?: boolean);
     /**
      * Register a callback to be invoked after flush() completes.
      * Used by the pm-plugin to dispatch a transaction so that
@@ -34,7 +35,7 @@ export declare class SourceSyncBlockStoreManager {
      * Add/update a sync block node to/from the local cache
      * @param syncBlockNode - The sync block node to update
      */
-    updateSyncBlockData(syncBlockNode: PMNode): boolean;
+    updateSyncBlockData(syncBlockNode: PMNode, isRemote: boolean): boolean;
     /**
      * Save content of bodiedSyncBlock nodes in local cache to backend
      *

package/dist/types/store-manager/syncBlockStoreManager.d.ts

@@ -1,5 +1,6 @@
 import type { SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { ViewMode } from '@atlaskit/editor-plugin-editor-viewmode';
+import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { BlockInstanceId, ReferencesSourceInfo, ResourceId } from '../common/types';
 import type { SyncBlockDataProviderInterface } from '../providers/types';
 import { ReferenceSyncBlockStoreManager } from './referenceSyncBlockStoreManager';
@@ -11,7 +12,8 @@ export declare class SyncBlockStoreManager {
     private fireAnalyticsEvent?;
     private fetchReferencesExperience;
     private fetchSourceInfoExperience;
-    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
+    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode, isLivePage?: boolean);
+    isSyncBlock(node: PMNode): boolean;
     fetchReferencesSourceInfo(resourceId: ResourceId, blockInstanceId: BlockInstanceId, isSourceSyncBlock: boolean): Promise<ReferencesSourceInfo>;
     setFireAnalyticsEvent(fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void): void;
     get referenceManager(): ReferenceSyncBlockStoreManager;

package/dist/types-ts4.5/clients/block-service/blockSubscription.d.ts

@@ -1,5 +1,10 @@
 import type { ADFEntity } from '@atlaskit/adf-utils/types';
 import type { SyncBlockProduct } from '../../common/types';
+/**
+ * Returns a diagnostic summary string from the last known connection state.
+ * This provides context that the opaque WebSocket error events cannot.
+ */
+export declare const getConnectionDiagnosticsSummary: () => string;
 export type BlockSubscriptionPayload = {
     blockAri: string;
     blockInstanceId: string;
@@ -27,6 +32,13 @@ export type ParsedBlockSubscriptionData = {
 type SubscriptionCallback = (data: ParsedBlockSubscriptionData) => void;
 type ErrorCallback = (error: Error) => void;
 type Unsubscribe = () => void;
+/**
+ * Extracts a meaningful error message from the error: GraphQL WebSocket Error: {"isTrusted":true}
+ *
+ * @param error - The error passed to the sink's error callback
+ * @returns A descriptive error message string
+ */
+export declare const extractGraphQLWSErrorMessage: (error: unknown) => string;
 /**
  * Creates a GraphQL subscription to block updates using the shared graphql-ws client.
  *

package/dist/types-ts4.5/index.d.ts

@@ -7,6 +7,7 @@ export { useHandleContentChanges } from './hooks/useHandleContentChanges';
 export { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockResourceId, } from './clients/block-service/ari';
 export type { BlockContentResponse, BatchRetrieveSyncedBlocksResponse, ErrorResponse, } from './clients/block-service/blockService';
 export { BlockError, updateSyncedBlocks } from './clients/block-service/blockService';
+export { extractGraphQLWSErrorMessage, getConnectionDiagnosticsSummary, } from './clients/block-service/blockSubscription';
 export { getConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, } from './clients/confluence/ari';
 export { fetchMediaToken, type TokenData, type ConfigData, } from './clients/confluence/fetchMediaToken';
 export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';

package/dist/types-ts4.5/store-manager/referenceSyncBlockStoreManager.d.ts

@@ -25,6 +25,7 @@ export declare class ReferenceSyncBlockStoreManager {
     private _providerFactoryManager;
     private _batchFetcher;
     constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
+    isReferenceBlock(node: PMNode): boolean;
     /**
      * Enables or disables real-time GraphQL subscriptions for block updates.
      * When enabled, the store manager will subscribe to real-time updates

package/dist/types-ts4.5/store-manager/sourceSyncBlockStoreManager.d.ts

@@ -9,6 +9,7 @@ type OnCompletion = (success: boolean) => void;
 type DestroyCallback = () => void;
 export declare class SourceSyncBlockStoreManager {
     private viewMode?;
+    private isLivePage?;
     private dataProvider?;
     private fireAnalyticsEvent?;
     private syncBlockCache;
@@ -21,7 +22,7 @@ export declare class SourceSyncBlockStoreManager {
     private saveExperience;
     private deleteExperience;
     private fetchSourceInfoExperience;
-    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
+    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode, isLivePage?: boolean);
     /**
      * Register a callback to be invoked after flush() completes.
      * Used by the pm-plugin to dispatch a transaction so that
@@ -34,7 +35,7 @@ export declare class SourceSyncBlockStoreManager {
      * Add/update a sync block node to/from the local cache
      * @param syncBlockNode - The sync block node to update
      */
-    updateSyncBlockData(syncBlockNode: PMNode): boolean;
+    updateSyncBlockData(syncBlockNode: PMNode, isRemote: boolean): boolean;
     /**
      * Save content of bodiedSyncBlock nodes in local cache to backend
      *

package/dist/types-ts4.5/store-manager/syncBlockStoreManager.d.ts

@@ -1,5 +1,6 @@
 import type { SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { ViewMode } from '@atlaskit/editor-plugin-editor-viewmode';
+import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { BlockInstanceId, ReferencesSourceInfo, ResourceId } from '../common/types';
 import type { SyncBlockDataProviderInterface } from '../providers/types';
 import { ReferenceSyncBlockStoreManager } from './referenceSyncBlockStoreManager';
@@ -11,7 +12,8 @@ export declare class SyncBlockStoreManager {
     private fireAnalyticsEvent?;
     private fetchReferencesExperience;
     private fetchSourceInfoExperience;
-    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
+    constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode, isLivePage?: boolean);
+    isSyncBlock(node: PMNode): boolean;
     fetchReferencesSourceInfo(resourceId: ResourceId, blockInstanceId: BlockInstanceId, isSourceSyncBlock: boolean): Promise<ReferencesSourceInfo>;
     setFireAnalyticsEvent(fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void): void;
     get referenceManager(): ReferenceSyncBlockStoreManager;

package/package.json

@@ -81,7 +81,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "4.3.5",
+	"version": "4.4.0",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -97,6 +97,9 @@
 		},
 		"platform_synced_block_patch_8": {
 			"type": "boolean"
+		},
+		"platform_synced_block_add_info_web_socket_error": {
+			"type": "boolean"
 		}
 	}
 }