@atlaskit/editor-synced-block-provider 4.1.0 → 4.1.2

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

@@ -7,7 +7,6 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import isEqual from 'lodash/isEqual';
 import { logException } from '@atlaskit/editor-common/monitoring';
-import { fg } from '@atlaskit/platform-feature-flags';
 import { SyncBlockError } from '../common/types';
 import { updateErrorPayload, createErrorPayload, deleteErrorPayload, updateCacheErrorPayload, getSourceInfoErrorPayload, updateSuccessPayload, createSuccessPayload, deleteSuccessPayload, fetchReferencesErrorPayload } from '../utils/errorHandling';
 import { getCreateSourceExperience, getDeleteSourceExperience, getSaveSourceExperience, getFetchSourceInfoExperience } from '../utils/experienceTracking';
@@ -65,11 +64,9 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           throw new Error('Local ID or resource ID is not set');
         }
         var syncBlockData = convertSyncBlockPMNodeToSyncBlockData(syncBlockNode);
-        if (fg('platform_synced_block_patch_5')) {
-          var cachedBlock = this.syncBlockCache.get(resourceId);
-          if (cachedBlock && !isEqual(syncBlockData.content, cachedBlock.content)) {
-            this.hasReceivedContentChange = true;
-          }
+        var cachedBlock = this.syncBlockCache.get(resourceId);
+        if (cachedBlock && !isEqual(syncBlockData.content, cachedBlock.content)) {
+          this.hasReceivedContentChange = true;
         }
         this.syncBlockCache.set(resourceId, _objectSpread(_objectSpread({}, syncBlockData), {}, {
           isDirty: true

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

@@ -4,24 +4,43 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import { logException } from '@atlaskit/editor-common/monitoring';
-import { fg } from '@atlaskit/platform-feature-flags';
 import { fetchErrorPayload, fetchSuccessPayload } from '../utils/errorHandling';
 import { resolveSyncBlockInstance } from '../utils/resolveSyncBlockInstance';
 /**
  * Manages the lifecycle of GraphQL WebSocket subscriptions for sync block
- * real-time updates, and provides a listener API so React components can
- * react when the set of subscribed resource IDs changes.
+ * real-time updates, owns the subscriptions and titleSubscriptions maps,
+ * and provides a listener API so React components can react when the set
+ * of subscribed resource IDs changes.
  */
 export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   function SyncBlockSubscriptionManager(deps) {
     _classCallCheck(this, SyncBlockSubscriptionManager);
+    _defineProperty(this, "subscriptions", new Map());
+    _defineProperty(this, "titleSubscriptions", new Map());
     _defineProperty(this, "graphqlSubscriptions", new Map());
     _defineProperty(this, "subscriptionChangeListeners", new Set());
     _defineProperty(this, "useRealTimeSubscriptions", false);
+    // Track pending cache deletions to handle block moves (unmount/remount)
+    // When a block is moved, the old component unmounts before the new one mounts,
+    // causing the cache to be deleted prematurely. We delay deletion to allow
+    // the new component to subscribe and cancel the pending deletion.
+    _defineProperty(this, "pendingCacheDeletions", new Map());
     this.deps = deps;
   }
+
+  /**
+   * Returns the subscriptions map. Used by external consumers (e.g. batch fetcher, flush)
+   * that need to read the current subscription state.
+   */
   return _createClass(SyncBlockSubscriptionManager, [{
+    key: "getSubscriptions",
+    value: function getSubscriptions() {
+      return this.subscriptions;
+    }
+  }, {
     key: "setRealTimeSubscriptionsEnabled",
     value: function setRealTimeSubscriptionsEnabled(enabled) {
       if (this.useRealTimeSubscriptions === enabled) {
@@ -42,7 +61,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     key: "getSubscribedResourceIds",
     value: function getSubscribedResourceIds() {
-      return Array.from(this.deps.getSubscriptions().keys());
+      return Array.from(this.subscriptions.keys());
     }
   }, {
     key: "onSubscriptionsChanged",
@@ -82,10 +101,140 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
         this.deps.fetchSyncBlockSourceInfo(resolved.resourceId);
       }
     }
+  }, {
+    key: "subscribeToSyncBlock",
+    value: function subscribeToSyncBlock(resourceId, localId, callback) {
+      var _this3 = this;
+      // Cancel any pending cache deletion for this resourceId.
+      // This handles the case where a block is moved - the old component unmounts
+      // (scheduling deletion) but the new component mounts and subscribes before
+      // the deletion timeout fires.
+      var pendingDeletion = this.pendingCacheDeletions.get(resourceId);
+      if (pendingDeletion) {
+        clearTimeout(pendingDeletion);
+        this.pendingCacheDeletions.delete(resourceId);
+      }
+
+      // add to subscriptions map
+      var resourceSubscriptions = this.subscriptions.get(resourceId) || {};
+      var isNewResourceSubscription = Object.keys(resourceSubscriptions).length === 0;
+      this.subscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, _defineProperty({}, localId, callback)));
+
+      // New subscription means new reference synced block is added to the document
+      this.deps.markCacheDirty();
+
+      // Notify listeners if this is a new resource subscription
+      if (isNewResourceSubscription) {
+        this.notifySubscriptionChangeListeners();
+      }
+      var cachedData = this.deps.getFromCache(resourceId);
+      if (cachedData) {
+        callback(cachedData);
+      } else {
+        this.deps.debouncedBatchedFetchSyncBlocks(resourceId);
+      }
+
+      // Set up GraphQL subscription if real-time subscriptions are enabled
+      if (this.shouldUseRealTime()) {
+        this.setupSubscription(resourceId);
+      }
+      return function () {
+        var resourceSubscriptions = _this3.subscriptions.get(resourceId);
+        if (resourceSubscriptions) {
+          // Unsubscription means a reference synced block is removed from the document
+          _this3.deps.markCacheDirty();
+          delete resourceSubscriptions[localId];
+          if (Object.keys(resourceSubscriptions).length === 0) {
+            _this3.subscriptions.delete(resourceId);
+
+            // Clean up GraphQL subscription when no more local subscribers
+            _this3.cleanupSubscription(resourceId);
+
+            // Notify listeners that subscription was removed
+            _this3.notifySubscriptionChangeListeners();
+
+            // Delay cache deletion to handle block moves (unmount/remount).
+            // When a block is moved, the old component unmounts before the new one mounts.
+            // By delaying deletion, we give the new component time to subscribe and
+            // cancel this pending deletion, preserving the cached data.
+            // TODO: EDITOR-4152 - Rework this logic
+            var deletionTimeout = setTimeout(function () {
+              // Only delete if still no subscribers (wasn't re-subscribed)
+              if (!_this3.subscriptions.has(resourceId)) {
+                _this3.deps.deleteFromCache(resourceId);
+              }
+              _this3.pendingCacheDeletions.delete(resourceId);
+            }, 1000);
+            _this3.pendingCacheDeletions.set(resourceId, deletionTimeout);
+          } else {
+            _this3.subscriptions.set(resourceId, resourceSubscriptions);
+          }
+        }
+      };
+    }
+  }, {
+    key: "subscribeToSourceTitle",
+    value: function subscribeToSourceTitle(node, callback) {
+      var _cachedData$data,
+        _this4 = this;
+      // check node is a sync block, as we only support sync block subscriptions
+      if (node.type.name !== 'syncBlock') {
+        return function () {};
+      }
+      var _node$attrs = node.attrs,
+        resourceId = _node$attrs.resourceId,
+        localId = _node$attrs.localId;
+      if (!localId || !resourceId) {
+        return function () {};
+      }
+      var cachedData = this.deps.getFromCache(resourceId);
+      if (cachedData !== null && cachedData !== void 0 && (_cachedData$data = cachedData.data) !== null && _cachedData$data !== void 0 && _cachedData$data.sourceTitle) {
+        callback(cachedData.data.sourceTitle);
+      }
+
+      // add to subscriptions map
+      var resourceSubscriptions = this.titleSubscriptions.get(resourceId) || {};
+      this.titleSubscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, _defineProperty({}, localId, callback)));
+      return function () {
+        var resourceSubscriptions = _this4.titleSubscriptions.get(resourceId);
+        if (resourceSubscriptions) {
+          delete resourceSubscriptions[localId];
+          if (Object.keys(resourceSubscriptions).length === 0) {
+            _this4.titleSubscriptions.delete(resourceId);
+          } else {
+            _this4.titleSubscriptions.set(resourceId, resourceSubscriptions);
+          }
+        }
+      };
+    }
+  }, {
+    key: "updateSourceTitleSubscriptions",
+    value: function updateSourceTitleSubscriptions(resourceId, title) {
+      var callbacks = this.titleSubscriptions.get(resourceId);
+      if (callbacks) {
+        Object.values(callbacks).forEach(function (callback) {
+          callback(title);
+        });
+      }
+    }
+
+    /**
+     * Notifies all subscription callbacks for a given resource ID with the provided sync block instance.
+     */
+  }, {
+    key: "notifySubscriptionCallbacks",
+    value: function notifySubscriptionCallbacks(resourceId, syncBlock) {
+      var callbacks = this.subscriptions.get(resourceId);
+      if (callbacks) {
+        Object.values(callbacks).forEach(function (callback) {
+          callback(syncBlock);
+        });
+      }
+    }
   }, {
     key: "setupSubscription",
     value: function setupSubscription(resourceId) {
-      var _this3 = this;
+      var _this5 = this;
       if (this.graphqlSubscriptions.has(resourceId)) {
         return;
       }
@@ -94,13 +243,13 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
         return;
       }
       var unsubscribe = dataProvider.subscribeToBlockUpdates(resourceId, function (syncBlockInstance) {
-        _this3.handleGraphQLUpdate(syncBlockInstance);
+        _this5.handleGraphQLUpdate(syncBlockInstance);
       }, function (error) {
-        var _this3$deps$getFireAn;
+        var _this5$deps$getFireAn;
         logException(error, {
           location: 'editor-synced-block-provider/syncBlockSubscriptionManager/graphql-subscription'
         });
-        (_this3$deps$getFireAn = _this3.deps.getFireAnalyticsEvent()) === null || _this3$deps$getFireAn === void 0 || _this3$deps$getFireAn(fetchErrorPayload(error.message));
+        (_this5$deps$getFireAn = _this5.deps.getFireAnalyticsEvent()) === null || _this5$deps$getFireAn === void 0 || _this5$deps$getFireAn(fetchErrorPayload(error.message));
       });
       if (unsubscribe) {
         this.graphqlSubscriptions.set(resourceId, unsubscribe);
@@ -118,7 +267,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     key: "setupSubscriptionsForAllBlocks",
     value: function setupSubscriptionsForAllBlocks() {
-      var _iterator = _createForOfIteratorHelper(this.deps.getSubscriptions().keys()),
+      var _iterator = _createForOfIteratorHelper(this.subscriptions.keys()),
         _step;
       try {
         for (_iterator.s(); !(_step = _iterator.n()).done;) {
@@ -152,8 +301,25 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
     key: "destroy",
     value: function destroy() {
       this.cleanupAll();
+      this.subscriptions.clear();
+      this.titleSubscriptions.clear();
       this.subscriptionChangeListeners.clear();
       this.useRealTimeSubscriptions = false;
+
+      // Clear any pending cache deletions
+      var _iterator3 = _createForOfIteratorHelper(this.pendingCacheDeletions.values()),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var timeout = _step3.value;
+          clearTimeout(timeout);
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+      this.pendingCacheDeletions.clear();
     }
   }, {
     key: "shouldUseRealTime",
@@ -163,22 +329,19 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     key: "handleGraphQLUpdate",
     value: function handleGraphQLUpdate(syncBlockInstance) {
-      var _this4 = this;
+      var _this6 = this;
       if (!syncBlockInstance.resourceId) {
-        if (fg('platform_synced_block_patch_5')) {
-          return;
-        }
-        throw new Error('Sync block instance provided to graphql subscription update missing resource id');
+        return;
       }
       var existing = this.deps.getFromCache(syncBlockInstance.resourceId);
       var resolved = existing ? resolveSyncBlockInstance(existing, syncBlockInstance) : syncBlockInstance;
       this.deps.updateCache(resolved);
       if (!syncBlockInstance.error) {
-        var callbacks = this.deps.getSubscriptions().get(syncBlockInstance.resourceId);
+        var callbacks = this.subscriptions.get(syncBlockInstance.resourceId);
         var localIds = callbacks ? Object.keys(callbacks) : [];
         localIds.forEach(function (localId) {
-          var _this4$deps$getFireAn, _syncBlockInstance$da;
-          (_this4$deps$getFireAn = _this4.deps.getFireAnalyticsEvent()) === null || _this4$deps$getFireAn === void 0 || _this4$deps$getFireAn(fetchSuccessPayload(syncBlockInstance.resourceId, localId, (_syncBlockInstance$da = syncBlockInstance.data) === null || _syncBlockInstance$da === void 0 ? void 0 : _syncBlockInstance$da.product));
+          var _this6$deps$getFireAn, _syncBlockInstance$da;
+          (_this6$deps$getFireAn = _this6.deps.getFireAnalyticsEvent()) === null || _this6$deps$getFireAn === void 0 || _this6$deps$getFireAn(fetchSuccessPayload(syncBlockInstance.resourceId, localId, (_syncBlockInstance$da = syncBlockInstance.data) === null || _syncBlockInstance$da === void 0 ? void 0 : _syncBlockInstance$da.product));
         });
         this.deps.fetchSyncBlockSourceInfo(resolved.resourceId);
       } else {

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

@@ -1,23 +1,15 @@
 import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { Experience } from '@atlaskit/editor-common/experiences';
-import { ProviderFactory, type MediaProvider } from '@atlaskit/editor-common/provider-factory';
+import { type ProviderFactory, type MediaProvider } from '@atlaskit/editor-common/provider-factory';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { type ResourceId, type SyncBlockNode, type SyncBlockPrefetchData } from '../common/types';
 import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, TitleSubscriptionCallback, SyncBlockSourceInfo } from '../providers/types';
 export declare class ReferenceSyncBlockStoreManager {
     private dataProvider?;
     private isCacheDirty;
-    private subscriptions;
-    private titleSubscriptions;
-    private providerFactories;
     private fireAnalyticsEvent?;
     private syncBlockFetchDataRequests;
     private syncBlockSourceInfoRequests;
-    private isRefreshingSubscriptions;
-    private pendingCacheDeletions;
-    private graphqlSubscriptions;
-    private useRealTimeSubscriptions;
-    private subscriptionChangeListeners;
     private newlyAddedSyncBlocks;
     private lastFlushedSyncedBlocks;
     private onUnpublishedSyncBlockDetected?;
@@ -27,11 +19,9 @@ export declare class ReferenceSyncBlockStoreManager {
     fetchExperience: Experience | undefined;
     private fetchSourceInfoExperience;
     private saveExperience;
-    private _subscriptionManager?;
-    private _providerFactoryManager?;
-    private _batchFetcher?;
-    private pendingFetchRequests;
-    private scheduledBatchFetch;
+    private _subscriptionManager;
+    private _providerFactoryManager;
+    private _batchFetcher;
     constructor(dataProvider?: SyncBlockDataProviderInterface);
     /**
      * Enables or disables real-time GraphQL subscriptions for block updates.
@@ -55,10 +45,6 @@ export declare class ReferenceSyncBlockStoreManager {
      * @returns Unsubscribe function to remove the listener
      */
     onSubscriptionsChanged(listener: () => void): () => void;
-    /**
-     * Notifies all subscription change listeners.
-     */
-    private notifySubscriptionChangeListeners;
     /**
      * Handles incoming data from a GraphQL subscription.
      * Called by React subscription components when they receive updates.
@@ -78,35 +64,6 @@ export declare class ReferenceSyncBlockStoreManager {
     getInitialSyncBlockData(resourceId: ResourceId): SyncBlockInstance | undefined;
     private updateSessionCache;
     private getFromSessionCache;
-    /**
-     * Refreshes the subscriptions for all sync blocks.
-     * This is a fallback polling mechanism when real-time subscriptions are not enabled.
-     * @returns {Promise<void>}
-     */
-    refreshSubscriptions(): Promise<void>;
-    /**
-     * Sets up a GraphQL subscription for a specific block.
-     * @param resourceId - The resource ID of the block to subscribe to
-     */
-    private setupGraphQLSubscription;
-    /**
-     * Handles updates received from GraphQL subscriptions.
-     * @param syncBlockInstance - The updated sync block instance
-     */
-    private handleGraphQLSubscriptionUpdate;
-    /**
-     * Cleans up the GraphQL subscription for a specific block.
-     * @param resourceId - The resource ID of the block to unsubscribe from
-     */
-    private cleanupGraphQLSubscription;
-    /**
-     * Sets up GraphQL subscriptions for all currently subscribed blocks.
-     */
-    private setupGraphQLSubscriptionsForAllBlocks;
-    /**
-     * Cleans up all GraphQL subscriptions.
-     */
-    private cleanupAllGraphQLSubscriptions;
     fetchSyncBlockSourceInfoBySourceAri(sourceAri: string, hasAccess?: boolean): Promise<SyncBlockSourceInfo | undefined>;
     fetchSyncBlockSourceInfo(resourceId: ResourceId): Promise<SyncBlockSourceInfo | undefined>;
     /**
@@ -124,7 +81,6 @@ export declare class ReferenceSyncBlockStoreManager {
     private processFetchedData;
     private updateCacheWithSourceInfo;
     private updateCache;
-    private updateSourceTitleSubscriptions;
     getFromCache(resourceId: ResourceId): SyncBlockInstance | undefined;
     private deleteFromCache;
     private debouncedBatchedFetchSyncBlocks;
@@ -142,7 +98,6 @@ export declare class ReferenceSyncBlockStoreManager {
     getSSRProviders(resourceId: ResourceId): {
         media: MediaProvider;
     } | null;
-    private retrieveDynamicProviders;
     /**
      * Update reference synced blocks on the document with the BE
      *

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

@@ -1,33 +1,52 @@
 import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { ResourceId, BlockInstanceId } from '../common/types';
-import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo } from '../providers/types';
+import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo, TitleSubscriptionCallback } from '../providers/types';
 export interface SyncBlockSubscriptionManagerDeps {
+    debouncedBatchedFetchSyncBlocks: (resourceId: string) => void;
+    deleteFromCache: (resourceId: ResourceId) => void;
     fetchSyncBlockSourceInfo: (resourceId: ResourceId) => Promise<SyncBlockSourceInfo | undefined>;
     getDataProvider: () => SyncBlockDataProviderInterface | undefined;
     getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
     getFromCache: (resourceId: ResourceId) => SyncBlockInstance | undefined;
-    getSubscriptions: () => Map<ResourceId, {
-        [localId: BlockInstanceId]: SubscriptionCallback;
-    }>;
+    markCacheDirty: () => void;
     updateCache: (syncBlockInstance: SyncBlockInstance) => void;
 }
 /**
  * Manages the lifecycle of GraphQL WebSocket subscriptions for sync block
- * real-time updates, and provides a listener API so React components can
- * react when the set of subscribed resource IDs changes.
+ * real-time updates, owns the subscriptions and titleSubscriptions maps,
+ * and provides a listener API so React components can react when the set
+ * of subscribed resource IDs changes.
  */
 export declare class SyncBlockSubscriptionManager {
     private deps;
+    private subscriptions;
+    private titleSubscriptions;
     private graphqlSubscriptions;
     private subscriptionChangeListeners;
     private useRealTimeSubscriptions;
+    private pendingCacheDeletions;
     constructor(deps: SyncBlockSubscriptionManagerDeps);
+    /**
+     * Returns the subscriptions map. Used by external consumers (e.g. batch fetcher, flush)
+     * that need to read the current subscription state.
+     */
+    getSubscriptions(): Map<ResourceId, {
+        [localId: BlockInstanceId]: SubscriptionCallback;
+    }>;
     setRealTimeSubscriptionsEnabled(enabled: boolean): void;
     isRealTimeSubscriptionsEnabled(): boolean;
     getSubscribedResourceIds(): ResourceId[];
     onSubscriptionsChanged(listener: () => void): () => void;
     notifySubscriptionChangeListeners(): void;
     handleSubscriptionUpdate(syncBlockInstance: SyncBlockInstance): void;
+    subscribeToSyncBlock(resourceId: string, localId: string, callback: SubscriptionCallback): () => void;
+    subscribeToSourceTitle(node: PMNode, callback: TitleSubscriptionCallback): () => void;
+    updateSourceTitleSubscriptions(resourceId: string, title: string): void;
+    /**
+     * Notifies all subscription callbacks for a given resource ID with the provided sync block instance.
+     */
+    notifySubscriptionCallbacks(resourceId: ResourceId, syncBlock: SyncBlockInstance): void;
     setupSubscription(resourceId: ResourceId): void;
     cleanupSubscription(resourceId: ResourceId): void;
     setupSubscriptionsForAllBlocks(): void;

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

@@ -1,23 +1,15 @@
 import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { Experience } from '@atlaskit/editor-common/experiences';
-import { ProviderFactory, type MediaProvider } from '@atlaskit/editor-common/provider-factory';
+import { type ProviderFactory, type MediaProvider } from '@atlaskit/editor-common/provider-factory';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { type ResourceId, type SyncBlockNode, type SyncBlockPrefetchData } from '../common/types';
 import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, TitleSubscriptionCallback, SyncBlockSourceInfo } from '../providers/types';
 export declare class ReferenceSyncBlockStoreManager {
     private dataProvider?;
     private isCacheDirty;
-    private subscriptions;
-    private titleSubscriptions;
-    private providerFactories;
     private fireAnalyticsEvent?;
     private syncBlockFetchDataRequests;
     private syncBlockSourceInfoRequests;
-    private isRefreshingSubscriptions;
-    private pendingCacheDeletions;
-    private graphqlSubscriptions;
-    private useRealTimeSubscriptions;
-    private subscriptionChangeListeners;
     private newlyAddedSyncBlocks;
     private lastFlushedSyncedBlocks;
     private onUnpublishedSyncBlockDetected?;
@@ -27,11 +19,9 @@ export declare class ReferenceSyncBlockStoreManager {
     fetchExperience: Experience | undefined;
     private fetchSourceInfoExperience;
     private saveExperience;
-    private _subscriptionManager?;
-    private _providerFactoryManager?;
-    private _batchFetcher?;
-    private pendingFetchRequests;
-    private scheduledBatchFetch;
+    private _subscriptionManager;
+    private _providerFactoryManager;
+    private _batchFetcher;
     constructor(dataProvider?: SyncBlockDataProviderInterface);
     /**
      * Enables or disables real-time GraphQL subscriptions for block updates.
@@ -55,10 +45,6 @@ export declare class ReferenceSyncBlockStoreManager {
      * @returns Unsubscribe function to remove the listener
      */
     onSubscriptionsChanged(listener: () => void): () => void;
-    /**
-     * Notifies all subscription change listeners.
-     */
-    private notifySubscriptionChangeListeners;
     /**
      * Handles incoming data from a GraphQL subscription.
      * Called by React subscription components when they receive updates.
@@ -78,35 +64,6 @@ export declare class ReferenceSyncBlockStoreManager {
     getInitialSyncBlockData(resourceId: ResourceId): SyncBlockInstance | undefined;
     private updateSessionCache;
     private getFromSessionCache;
-    /**
-     * Refreshes the subscriptions for all sync blocks.
-     * This is a fallback polling mechanism when real-time subscriptions are not enabled.
-     * @returns {Promise<void>}
-     */
-    refreshSubscriptions(): Promise<void>;
-    /**
-     * Sets up a GraphQL subscription for a specific block.
-     * @param resourceId - The resource ID of the block to subscribe to
-     */
-    private setupGraphQLSubscription;
-    /**
-     * Handles updates received from GraphQL subscriptions.
-     * @param syncBlockInstance - The updated sync block instance
-     */
-    private handleGraphQLSubscriptionUpdate;
-    /**
-     * Cleans up the GraphQL subscription for a specific block.
-     * @param resourceId - The resource ID of the block to unsubscribe from
-     */
-    private cleanupGraphQLSubscription;
-    /**
-     * Sets up GraphQL subscriptions for all currently subscribed blocks.
-     */
-    private setupGraphQLSubscriptionsForAllBlocks;
-    /**
-     * Cleans up all GraphQL subscriptions.
-     */
-    private cleanupAllGraphQLSubscriptions;
     fetchSyncBlockSourceInfoBySourceAri(sourceAri: string, hasAccess?: boolean): Promise<SyncBlockSourceInfo | undefined>;
     fetchSyncBlockSourceInfo(resourceId: ResourceId): Promise<SyncBlockSourceInfo | undefined>;
     /**
@@ -124,7 +81,6 @@ export declare class ReferenceSyncBlockStoreManager {
     private processFetchedData;
     private updateCacheWithSourceInfo;
     private updateCache;
-    private updateSourceTitleSubscriptions;
     getFromCache(resourceId: ResourceId): SyncBlockInstance | undefined;
     private deleteFromCache;
     private debouncedBatchedFetchSyncBlocks;
@@ -142,7 +98,6 @@ export declare class ReferenceSyncBlockStoreManager {
     getSSRProviders(resourceId: ResourceId): {
         media: MediaProvider;
     } | null;
-    private retrieveDynamicProviders;
     /**
      * Update reference synced blocks on the document with the BE
      *

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

@@ -1,33 +1,52 @@
 import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { ResourceId, BlockInstanceId } from '../common/types';
-import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo } from '../providers/types';
+import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo, TitleSubscriptionCallback } from '../providers/types';
 export interface SyncBlockSubscriptionManagerDeps {
+    debouncedBatchedFetchSyncBlocks: (resourceId: string) => void;
+    deleteFromCache: (resourceId: ResourceId) => void;
     fetchSyncBlockSourceInfo: (resourceId: ResourceId) => Promise<SyncBlockSourceInfo | undefined>;
     getDataProvider: () => SyncBlockDataProviderInterface | undefined;
     getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
     getFromCache: (resourceId: ResourceId) => SyncBlockInstance | undefined;
-    getSubscriptions: () => Map<ResourceId, {
-        [localId: BlockInstanceId]: SubscriptionCallback;
-    }>;
+    markCacheDirty: () => void;
     updateCache: (syncBlockInstance: SyncBlockInstance) => void;
 }
 /**
  * Manages the lifecycle of GraphQL WebSocket subscriptions for sync block
- * real-time updates, and provides a listener API so React components can
- * react when the set of subscribed resource IDs changes.
+ * real-time updates, owns the subscriptions and titleSubscriptions maps,
+ * and provides a listener API so React components can react when the set
+ * of subscribed resource IDs changes.
  */
 export declare class SyncBlockSubscriptionManager {
     private deps;
+    private subscriptions;
+    private titleSubscriptions;
     private graphqlSubscriptions;
     private subscriptionChangeListeners;
     private useRealTimeSubscriptions;
+    private pendingCacheDeletions;
     constructor(deps: SyncBlockSubscriptionManagerDeps);
+    /**
+     * Returns the subscriptions map. Used by external consumers (e.g. batch fetcher, flush)
+     * that need to read the current subscription state.
+     */
+    getSubscriptions(): Map<ResourceId, {
+        [localId: BlockInstanceId]: SubscriptionCallback;
+    }>;
     setRealTimeSubscriptionsEnabled(enabled: boolean): void;
     isRealTimeSubscriptionsEnabled(): boolean;
     getSubscribedResourceIds(): ResourceId[];
     onSubscriptionsChanged(listener: () => void): () => void;
     notifySubscriptionChangeListeners(): void;
     handleSubscriptionUpdate(syncBlockInstance: SyncBlockInstance): void;
+    subscribeToSyncBlock(resourceId: string, localId: string, callback: SubscriptionCallback): () => void;
+    subscribeToSourceTitle(node: PMNode, callback: TitleSubscriptionCallback): () => void;
+    updateSourceTitleSubscriptions(resourceId: string, title: string): void;
+    /**
+     * Notifies all subscription callbacks for a given resource ID with the provided sync block instance.
+     */
+    notifySubscriptionCallbacks(resourceId: ResourceId, syncBlock: SyncBlockInstance): void;
     setupSubscription(resourceId: ResourceId): void;
     cleanupSubscription(resourceId: ResourceId): void;
     setupSubscriptionsForAllBlocks(): void;

package/package.json

@@ -29,7 +29,7 @@
 		"@atlaskit/editor-prosemirror": "^7.3.0",
 		"@atlaskit/node-data-provider": "^9.0.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
-		"@atlaskit/tmp-editor-statsig": "^40.3.0",
+		"@atlaskit/tmp-editor-statsig": "^41.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.20.0",
 		"graphql-ws": "^5.14.2",
@@ -38,7 +38,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^112.5.0",
+		"@atlaskit/editor-common": "^112.6.0",
 		"react": "^18.2.0"
 	},
 	"devDependencies": {
@@ -81,16 +81,12 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "4.1.0",
+	"version": "4.1.2",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
 	},
-	"platform-feature-flags": {
-		"platform_synced_block_patch_5": {
-			"type": "boolean"
-		}
-	}
+	"platform-feature-flags": {}
 }