@atlaskit/editor-synced-block-provider 3.31.0 → 3.31.2

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

@@ -15,6 +15,13 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
  * (least-recently-used) entries are evicted first.
  */
 export var SyncBlockInMemorySessionCache = /*#__PURE__*/function () {
+  /**
+   * Maximum total size of all cached values, measured in **UTF-16 code
+   * units** (i.e. `String.prototype.length`), not bytes.  For ASCII-only
+   * content the two are equivalent; for content with characters outside
+   * the BMP each surrogate pair counts as 2.
+   */
+
   function SyncBlockInMemorySessionCache() {
     var maxSize = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 5 * 1024 * 1024;
     _classCallCheck(this, SyncBlockInMemorySessionCache);
@@ -22,6 +29,14 @@ export var SyncBlockInMemorySessionCache = /*#__PURE__*/function () {
     _defineProperty(this, "currentSize", 0);
     this.maxSize = maxSize;
   }
+
+  /**
+   * Retrieves a cached value by key.
+   *
+   * **Side-effect:** promotes the entry to the most-recently-used
+   * position by re-inserting it at the end of the underlying Map's
+   * iteration order.
+   */
   return _createClass(SyncBlockInMemorySessionCache, [{
     key: "getItem",
     value: function getItem(key) {
@@ -63,6 +78,17 @@ export var SyncBlockInMemorySessionCache = /*#__PURE__*/function () {
         this.store.delete(key);
       }
     }
+
+    /**
+     * Removes all entries from the cache and resets the tracked size to zero.
+     * Useful for cleaning up the singleton on SPA navigation boundaries.
+     */
+  }, {
+    key: "clear",
+    value: function clear() {
+      this.store.clear();
+      this.currentSize = 0;
+    }
   }]);
 }();
 export var syncBlockInMemorySessionCache = new SyncBlockInMemorySessionCache();

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

@@ -0,0 +1,168 @@
+import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
+import _createClass from "@babel/runtime/helpers/createClass";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import { logException } from '@atlaskit/editor-common/monitoring';
+import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
+import { fetchErrorPayload } from '../utils/errorHandling';
+import { parseResourceId } from '../utils/resourceId';
+/**
+ * Manages creation and caching of ProviderFactory instances used to
+ * render synced block content (media, emoji, smart links, etc.).
+ */
+export var SyncBlockProviderFactoryManager = /*#__PURE__*/function () {
+  function SyncBlockProviderFactoryManager(deps) {
+    _classCallCheck(this, SyncBlockProviderFactoryManager);
+    _defineProperty(this, "providerFactories", new Map());
+    this.deps = deps;
+  }
+  return _createClass(SyncBlockProviderFactoryManager, [{
+    key: "getProviderFactory",
+    value: function getProviderFactory(resourceId) {
+      var dataProvider = this.deps.getDataProvider();
+      if (!dataProvider) {
+        var _this$deps$getFireAna;
+        var error = new Error('Data provider not set');
+        logException(error, {
+          location: 'editor-synced-block-provider/syncBlockProviderFactoryManager'
+        });
+        (_this$deps$getFireAna = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna === void 0 || _this$deps$getFireAna(fetchErrorPayload(error.message));
+        return undefined;
+      }
+      var _dataProvider$getSync = dataProvider.getSyncedBlockRendererProviderOptions(),
+        parentDataProviders = _dataProvider$getSync.parentDataProviders,
+        providerCreator = _dataProvider$getSync.providerCreator;
+      var providerFactory = this.providerFactories.get(resourceId);
+      if (!providerFactory) {
+        providerFactory = ProviderFactory.create({
+          mentionProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.mentionProvider,
+          profilecardProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.profilecardProvider,
+          taskDecisionProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.taskDecisionProvider
+        });
+        this.providerFactories.set(resourceId, providerFactory);
+      } else {
+        if (parentDataProviders !== null && parentDataProviders !== void 0 && parentDataProviders.mentionProvider) {
+          providerFactory.setProvider('mentionProvider', parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.mentionProvider);
+        }
+        if (parentDataProviders !== null && parentDataProviders !== void 0 && parentDataProviders.profilecardProvider) {
+          providerFactory.setProvider('profilecardProvider', parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.profilecardProvider);
+        }
+        if (parentDataProviders !== null && parentDataProviders !== void 0 && parentDataProviders.taskDecisionProvider) {
+          providerFactory.setProvider('taskDecisionProvider', parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.taskDecisionProvider);
+        }
+      }
+      if (providerCreator) {
+        try {
+          this.retrieveDynamicProviders(resourceId, providerFactory, providerCreator);
+        } catch (error) {
+          var _this$deps$getFireAna2;
+          logException(error, {
+            location: 'editor-synced-block-provider/syncBlockProviderFactoryManager'
+          });
+          (_this$deps$getFireAna2 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna2 === void 0 || _this$deps$getFireAna2(fetchErrorPayload(error.message, resourceId));
+        }
+      }
+      return providerFactory;
+    }
+  }, {
+    key: "getSSRProviders",
+    value: function getSSRProviders(resourceId) {
+      var dataProvider = this.deps.getDataProvider();
+      if (!dataProvider) {
+        return null;
+      }
+      var _dataProvider$getSync2 = dataProvider.getSyncedBlockRendererProviderOptions(),
+        providerCreator = _dataProvider$getSync2.providerCreator;
+      if (!(providerCreator !== null && providerCreator !== void 0 && providerCreator.createSSRMediaProvider)) {
+        return null;
+      }
+      var parsedResourceId = parseResourceId(resourceId);
+      if (!parsedResourceId) {
+        return null;
+      }
+      var contentId = parsedResourceId.contentId,
+        contentProduct = parsedResourceId.product;
+      try {
+        var mediaProvider = providerCreator.createSSRMediaProvider({
+          contentId: contentId,
+          contentProduct: contentProduct
+        });
+        if (mediaProvider) {
+          return {
+            media: mediaProvider
+          };
+        }
+      } catch (error) {
+        logException(error, {
+          location: 'editor-synced-block-provider/syncBlockProviderFactoryManager'
+        });
+      }
+      return null;
+    }
+  }, {
+    key: "deleteFactory",
+    value: function deleteFactory(resourceId) {
+      this.providerFactories.delete(resourceId);
+    }
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.providerFactories.forEach(function (pf) {
+        return pf.destroy();
+      });
+      this.providerFactories.clear();
+    }
+  }, {
+    key: "retrieveDynamicProviders",
+    value: function retrieveDynamicProviders(resourceId, providerFactory, providerCreator) {
+      var dataProvider = this.deps.getDataProvider();
+      if (!dataProvider) {
+        throw new Error('Data provider not set');
+      }
+      var hasMediaProvider = providerFactory.hasProvider('mediaProvider');
+      var hasEmojiProvider = providerFactory.hasProvider('emojiProvider');
+      var hasCardProvider = providerFactory.hasProvider('cardProvider');
+      if (hasMediaProvider && hasEmojiProvider && hasCardProvider) {
+        return;
+      }
+      var syncBlock = this.deps.getFromCache(resourceId);
+      if (!(syncBlock !== null && syncBlock !== void 0 && syncBlock.data)) {
+        return;
+      }
+      if (!syncBlock.data.sourceAri || !syncBlock.data.product) {
+        var _this$deps$getFireAna3;
+        (_this$deps$getFireAna3 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna3 === void 0 || _this$deps$getFireAna3(fetchErrorPayload('Sync block source ari or product not found'));
+        return;
+      }
+      var parentInfo = dataProvider.retrieveSyncBlockParentInfo(syncBlock.data.sourceAri, syncBlock.data.product);
+      if (!parentInfo) {
+        throw new Error('Unable to retrieve sync block parent info');
+      }
+      var contentId = parentInfo.contentId,
+        contentProduct = parentInfo.contentProduct;
+      if (!hasMediaProvider && providerCreator.createMediaProvider && contentId && contentProduct) {
+        var mediaProvider = providerCreator.createMediaProvider({
+          contentProduct: contentProduct,
+          contentId: contentId
+        });
+        if (mediaProvider) {
+          providerFactory.setProvider('mediaProvider', mediaProvider);
+        }
+      }
+      if (!hasEmojiProvider && providerCreator.createEmojiProvider && contentId && contentProduct) {
+        var emojiProvider = providerCreator.createEmojiProvider({
+          contentProduct: contentProduct,
+          contentId: contentId
+        });
+        if (emojiProvider) {
+          providerFactory.setProvider('emojiProvider', emojiProvider);
+        }
+      }
+      if (!hasCardProvider && providerCreator.createSmartLinkProvider) {
+        var smartLinkProvider = providerCreator.createSmartLinkProvider();
+        if (smartLinkProvider) {
+          providerFactory.setProvider('cardProvider', smartLinkProvider);
+        }
+      }
+    }
+  }]);
+}();

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

@@ -0,0 +1,191 @@
+import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
+import _createClass from "@babel/runtime/helpers/createClass";
+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; }
+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.
+ */
+export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
+  function SyncBlockSubscriptionManager(deps) {
+    _classCallCheck(this, SyncBlockSubscriptionManager);
+    _defineProperty(this, "graphqlSubscriptions", new Map());
+    _defineProperty(this, "subscriptionChangeListeners", new Set());
+    _defineProperty(this, "useRealTimeSubscriptions", false);
+    this.deps = deps;
+  }
+  return _createClass(SyncBlockSubscriptionManager, [{
+    key: "setRealTimeSubscriptionsEnabled",
+    value: function setRealTimeSubscriptionsEnabled(enabled) {
+      if (this.useRealTimeSubscriptions === enabled) {
+        return;
+      }
+      this.useRealTimeSubscriptions = enabled;
+      if (enabled) {
+        this.setupSubscriptionsForAllBlocks();
+      } else {
+        this.cleanupAll();
+      }
+    }
+  }, {
+    key: "isRealTimeSubscriptionsEnabled",
+    value: function isRealTimeSubscriptionsEnabled() {
+      return this.useRealTimeSubscriptions;
+    }
+  }, {
+    key: "getSubscribedResourceIds",
+    value: function getSubscribedResourceIds() {
+      return Array.from(this.deps.getSubscriptions().keys());
+    }
+  }, {
+    key: "onSubscriptionsChanged",
+    value: function onSubscriptionsChanged(listener) {
+      var _this = this;
+      this.subscriptionChangeListeners.add(listener);
+      return function () {
+        _this.subscriptionChangeListeners.delete(listener);
+      };
+    }
+  }, {
+    key: "notifySubscriptionChangeListeners",
+    value: function notifySubscriptionChangeListeners() {
+      var _this2 = this;
+      this.subscriptionChangeListeners.forEach(function (listener) {
+        try {
+          listener();
+        } catch (error) {
+          var _this2$deps$getFireAn;
+          logException(error, {
+            location: 'editor-synced-block-provider/syncBlockSubscriptionManager/notifySubscriptionChangeListeners'
+          });
+          (_this2$deps$getFireAn = _this2.deps.getFireAnalyticsEvent()) === null || _this2$deps$getFireAn === void 0 || _this2$deps$getFireAn(fetchErrorPayload(error.message));
+        }
+      });
+    }
+  }, {
+    key: "handleSubscriptionUpdate",
+    value: function handleSubscriptionUpdate(syncBlockInstance) {
+      if (!syncBlockInstance.resourceId) {
+        return;
+      }
+      var existing = this.deps.getFromCache(syncBlockInstance.resourceId);
+      var resolved = existing ? resolveSyncBlockInstance(existing, syncBlockInstance) : syncBlockInstance;
+      this.deps.updateCache(resolved);
+      if (!syncBlockInstance.error) {
+        this.deps.fetchSyncBlockSourceInfo(resolved.resourceId);
+      }
+    }
+  }, {
+    key: "setupSubscription",
+    value: function setupSubscription(resourceId) {
+      var _this3 = this;
+      if (this.graphqlSubscriptions.has(resourceId)) {
+        return;
+      }
+      var dataProvider = this.deps.getDataProvider();
+      if (!(dataProvider !== null && dataProvider !== void 0 && dataProvider.subscribeToBlockUpdates)) {
+        return;
+      }
+      var unsubscribe = dataProvider.subscribeToBlockUpdates(resourceId, function (syncBlockInstance) {
+        _this3.handleGraphQLUpdate(syncBlockInstance);
+      }, function (error) {
+        var _this3$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));
+      });
+      if (unsubscribe) {
+        this.graphqlSubscriptions.set(resourceId, unsubscribe);
+      }
+    }
+  }, {
+    key: "cleanupSubscription",
+    value: function cleanupSubscription(resourceId) {
+      var unsubscribe = this.graphqlSubscriptions.get(resourceId);
+      if (unsubscribe) {
+        unsubscribe();
+        this.graphqlSubscriptions.delete(resourceId);
+      }
+    }
+  }, {
+    key: "setupSubscriptionsForAllBlocks",
+    value: function setupSubscriptionsForAllBlocks() {
+      var _iterator = _createForOfIteratorHelper(this.deps.getSubscriptions().keys()),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var resourceId = _step.value;
+          this.setupSubscription(resourceId);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+  }, {
+    key: "cleanupAll",
+    value: function cleanupAll() {
+      var _iterator2 = _createForOfIteratorHelper(this.graphqlSubscriptions.values()),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var unsubscribe = _step2.value;
+          unsubscribe();
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      this.graphqlSubscriptions.clear();
+    }
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.cleanupAll();
+      this.subscriptionChangeListeners.clear();
+      this.useRealTimeSubscriptions = false;
+    }
+  }, {
+    key: "shouldUseRealTime",
+    value: function shouldUseRealTime() {
+      return this.useRealTimeSubscriptions;
+    }
+  }, {
+    key: "handleGraphQLUpdate",
+    value: function handleGraphQLUpdate(syncBlockInstance) {
+      var _this4 = 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');
+      }
+      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 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));
+        });
+        this.deps.fetchSyncBlockSourceInfo(resolved.resourceId);
+      } else {
+        var _syncBlockInstance$er, _syncBlockInstance$er2, _syncBlockInstance$er3, _this$deps$getFireAna;
+        var errorMessage = fg('platform_synced_block_patch_3') ? ((_syncBlockInstance$er = syncBlockInstance.error) === null || _syncBlockInstance$er === void 0 ? void 0 : _syncBlockInstance$er.reason) || ((_syncBlockInstance$er2 = syncBlockInstance.error) === null || _syncBlockInstance$er2 === void 0 ? void 0 : _syncBlockInstance$er2.type) : (_syncBlockInstance$er3 = syncBlockInstance.error) === null || _syncBlockInstance$er3 === void 0 ? void 0 : _syncBlockInstance$er3.type;
+        (_this$deps$getFireAna = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna === void 0 || _this$deps$getFireAna(fetchErrorPayload(errorMessage, syncBlockInstance.resourceId));
+      }
+    }
+  }]);
+}();

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

@@ -27,6 +27,9 @@ export declare class ReferenceSyncBlockStoreManager {
     fetchExperience: Experience | undefined;
     private fetchSourceInfoExperience;
     private saveExperience;
+    private _subscriptionManager?;
+    private _providerFactoryManager?;
+    private _batchFetcher?;
     private pendingFetchRequests;
     private scheduledBatchFetch;
     constructor(dataProvider?: SyncBlockDataProviderInterface);

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

@@ -10,6 +10,7 @@ export declare class SourceSyncBlockStoreManager {
     private dataProvider?;
     private fireAnalyticsEvent?;
     private syncBlockCache;
+    private hasReceivedContentChange;
     private confirmationCallback?;
     private deletionRetryInfo?;
     private creationCompletionCallbacks;
@@ -31,6 +32,7 @@ export declare class SourceSyncBlockStoreManager {
      * @returns true if saving all nodes successfully, false if fail to save some/all nodes
      */
     flush(): Promise<boolean>;
+    hasUnsavedChanges(): boolean;
     isPendingCreation(resourceId: ResourceId): boolean;
     /**
      *  Fires callback to insert node (if creation is successful) and clears pending creation data

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

@@ -0,0 +1,25 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import type { ResourceId, BlockInstanceId, SyncBlockNode } from '../common/types';
+import type { SubscriptionCallback } from '../providers/types';
+export interface SyncBlockBatchFetcherDeps {
+    fetchSyncBlocksData: (nodes: SyncBlockNode[]) => Promise<void>;
+    getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
+    getSubscriptions: () => Map<ResourceId, {
+        [localId: BlockInstanceId]: SubscriptionCallback;
+    }>;
+}
+/**
+ * Handles debounced batch-fetching of sync block data via `raf-schd`.
+ * Accumulates resource IDs and flushes them in a single fetch per
+ * animation frame.
+ */
+export declare class SyncBlockBatchFetcher {
+    private deps;
+    private pendingFetchRequests;
+    private scheduledBatchFetch;
+    constructor(deps: SyncBlockBatchFetcherDeps);
+    queueFetch(resourceId: string): void;
+    cancel(): void;
+    clearPending(): void;
+    destroy(): void;
+}

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

@@ -14,10 +14,28 @@
 export declare class SyncBlockInMemorySessionCache {
     private store;
     private currentSize;
+    /**
+     * Maximum total size of all cached values, measured in **UTF-16 code
+     * units** (i.e. `String.prototype.length`), not bytes.  For ASCII-only
+     * content the two are equivalent; for content with characters outside
+     * the BMP each surrogate pair counts as 2.
+     */
     private maxSize;
     constructor(maxSize?: number);
+    /**
+     * Retrieves a cached value by key.
+     *
+     * **Side-effect:** promotes the entry to the most-recently-used
+     * position by re-inserting it at the end of the underlying Map's
+     * iteration order.
+     */
     getItem(key: string): string | null;
     setItem(key: string, value: string): void;
     removeItem(key: string): void;
+    /**
+     * Removes all entries from the cache and resets the tracked size to zero.
+     * Useful for cleaning up the singleton on SPA navigation boundaries.
+     */
+    clear(): void;
 }
 export declare const syncBlockInMemorySessionCache: SyncBlockInMemorySessionCache;

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

@@ -0,0 +1,25 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
+import type { ResourceId } from '../common/types';
+import type { SyncBlockInstance, SyncBlockDataProviderInterface } from '../providers/types';
+export interface SyncBlockProviderFactoryManagerDeps {
+    getDataProvider: () => SyncBlockDataProviderInterface | undefined;
+    getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
+    getFromCache: (resourceId: ResourceId) => SyncBlockInstance | undefined;
+}
+/**
+ * Manages creation and caching of ProviderFactory instances used to
+ * render synced block content (media, emoji, smart links, etc.).
+ */
+export declare class SyncBlockProviderFactoryManager {
+    private deps;
+    private providerFactories;
+    constructor(deps: SyncBlockProviderFactoryManagerDeps);
+    getProviderFactory(resourceId: ResourceId): ProviderFactory | undefined;
+    getSSRProviders(resourceId: ResourceId): {
+        media: import("@atlaskit/editor-common/provider-factory").MediaProvider;
+    } | null;
+    deleteFactory(resourceId: ResourceId): void;
+    destroy(): void;
+    private retrieveDynamicProviders;
+}

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

@@ -0,0 +1,38 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import type { ResourceId, BlockInstanceId } from '../common/types';
+import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo } from '../providers/types';
+export interface SyncBlockSubscriptionManagerDeps {
+    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;
+    }>;
+    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.
+ */
+export declare class SyncBlockSubscriptionManager {
+    private deps;
+    private graphqlSubscriptions;
+    private subscriptionChangeListeners;
+    private useRealTimeSubscriptions;
+    constructor(deps: SyncBlockSubscriptionManagerDeps);
+    setRealTimeSubscriptionsEnabled(enabled: boolean): void;
+    isRealTimeSubscriptionsEnabled(): boolean;
+    getSubscribedResourceIds(): ResourceId[];
+    onSubscriptionsChanged(listener: () => void): () => void;
+    notifySubscriptionChangeListeners(): void;
+    handleSubscriptionUpdate(syncBlockInstance: SyncBlockInstance): void;
+    setupSubscription(resourceId: ResourceId): void;
+    cleanupSubscription(resourceId: ResourceId): void;
+    setupSubscriptionsForAllBlocks(): void;
+    cleanupAll(): void;
+    destroy(): void;
+    shouldUseRealTime(): boolean;
+    private handleGraphQLUpdate;
+}

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

@@ -27,6 +27,9 @@ export declare class ReferenceSyncBlockStoreManager {
     fetchExperience: Experience | undefined;
     private fetchSourceInfoExperience;
     private saveExperience;
+    private _subscriptionManager?;
+    private _providerFactoryManager?;
+    private _batchFetcher?;
     private pendingFetchRequests;
     private scheduledBatchFetch;
     constructor(dataProvider?: SyncBlockDataProviderInterface);

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

@@ -10,6 +10,7 @@ export declare class SourceSyncBlockStoreManager {
     private dataProvider?;
     private fireAnalyticsEvent?;
     private syncBlockCache;
+    private hasReceivedContentChange;
     private confirmationCallback?;
     private deletionRetryInfo?;
     private creationCompletionCallbacks;
@@ -31,6 +32,7 @@ export declare class SourceSyncBlockStoreManager {
      * @returns true if saving all nodes successfully, false if fail to save some/all nodes
      */
     flush(): Promise<boolean>;
+    hasUnsavedChanges(): boolean;
     isPendingCreation(resourceId: ResourceId): boolean;
     /**
      *  Fires callback to insert node (if creation is successful) and clears pending creation data

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

@@ -0,0 +1,25 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import type { ResourceId, BlockInstanceId, SyncBlockNode } from '../common/types';
+import type { SubscriptionCallback } from '../providers/types';
+export interface SyncBlockBatchFetcherDeps {
+    fetchSyncBlocksData: (nodes: SyncBlockNode[]) => Promise<void>;
+    getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
+    getSubscriptions: () => Map<ResourceId, {
+        [localId: BlockInstanceId]: SubscriptionCallback;
+    }>;
+}
+/**
+ * Handles debounced batch-fetching of sync block data via `raf-schd`.
+ * Accumulates resource IDs and flushes them in a single fetch per
+ * animation frame.
+ */
+export declare class SyncBlockBatchFetcher {
+    private deps;
+    private pendingFetchRequests;
+    private scheduledBatchFetch;
+    constructor(deps: SyncBlockBatchFetcherDeps);
+    queueFetch(resourceId: string): void;
+    cancel(): void;
+    clearPending(): void;
+    destroy(): void;
+}

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

@@ -14,10 +14,28 @@
 export declare class SyncBlockInMemorySessionCache {
     private store;
     private currentSize;
+    /**
+     * Maximum total size of all cached values, measured in **UTF-16 code
+     * units** (i.e. `String.prototype.length`), not bytes.  For ASCII-only
+     * content the two are equivalent; for content with characters outside
+     * the BMP each surrogate pair counts as 2.
+     */
     private maxSize;
     constructor(maxSize?: number);
+    /**
+     * Retrieves a cached value by key.
+     *
+     * **Side-effect:** promotes the entry to the most-recently-used
+     * position by re-inserting it at the end of the underlying Map's
+     * iteration order.
+     */
     getItem(key: string): string | null;
     setItem(key: string, value: string): void;
     removeItem(key: string): void;
+    /**
+     * Removes all entries from the cache and resets the tracked size to zero.
+     * Useful for cleaning up the singleton on SPA navigation boundaries.
+     */
+    clear(): void;
 }
 export declare const syncBlockInMemorySessionCache: SyncBlockInMemorySessionCache;

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

@@ -0,0 +1,25 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
+import type { ResourceId } from '../common/types';
+import type { SyncBlockInstance, SyncBlockDataProviderInterface } from '../providers/types';
+export interface SyncBlockProviderFactoryManagerDeps {
+    getDataProvider: () => SyncBlockDataProviderInterface | undefined;
+    getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
+    getFromCache: (resourceId: ResourceId) => SyncBlockInstance | undefined;
+}
+/**
+ * Manages creation and caching of ProviderFactory instances used to
+ * render synced block content (media, emoji, smart links, etc.).
+ */
+export declare class SyncBlockProviderFactoryManager {
+    private deps;
+    private providerFactories;
+    constructor(deps: SyncBlockProviderFactoryManagerDeps);
+    getProviderFactory(resourceId: ResourceId): ProviderFactory | undefined;
+    getSSRProviders(resourceId: ResourceId): {
+        media: import("@atlaskit/editor-common/provider-factory").MediaProvider;
+    } | null;
+    deleteFactory(resourceId: ResourceId): void;
+    destroy(): void;
+    private retrieveDynamicProviders;
+}