@atlaskit/editor-synced-block-provider 8.1.9 → 8.2.0

package/dist/types/common/types.d.ts

@@ -80,3 +80,32 @@ export type SyncBlockPrefetchData = {
     prefetchPromise: Promise<SyncBlockInstance[] | undefined>;
     resourceIds: string[];
 };
+/**
+ * Helpers to distinguish "data provider not ready / torn down" from a genuine
+ * fetch/subscribe failure (EDITOR-7860). On Jira the provider is wired
+ * asynchronously and `destroy()` nulls it on orphaned managers, so queued/
+ * in-flight ops throw `Data provider not set` — previously mis-logged as a real
+ * error. These let throw and catch sites agree on one non-string-matched signal
+ * so the residual false errors are suppressed. Gated by
+ * `platform_editor_blocks_patch_3`.
+ *
+ * NB: these intentionally live here rather than in a dedicated module to avoid
+ * adding a downstream file to consuming Jira packages' Thunderstone complexity.
+ */
+/** Legacy message — kept identical for gate-off and historical events. */
+export declare const PROVIDER_NOT_READY_MESSAGE = "Data provider not set";
+/**
+ * Thrown when a fetch/subscribe runs against a manager whose provider is not
+ * (yet) available or torn down. Keeps the legacy message + name so string
+ * matchers still work, while new code uses {@link isProviderNotReadyError}.
+ */
+export declare class ProviderNotReadyError extends Error {
+    readonly isProviderNotReadyError = true;
+    constructor(message?: string);
+}
+/**
+ * True when the value is a "provider not ready / torn down" condition, not a
+ * genuine failure. Recognises the tagged {@link ProviderNotReadyError} and the
+ * legacy message (for errors thrown before rollout).
+ */
+export declare const isProviderNotReadyError: (error: unknown) => boolean;

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

@@ -31,6 +31,14 @@ export declare class ReferenceSyncBlockStoreManager {
     private _batchFetcher;
     constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode);
     isReferenceBlock(node: PMNode): boolean;
+    /**
+     * Whether the async data provider is wired and the manager is not torn down.
+     * Consumers gate fetch/subscribe on this to avoid a false `Data provider not
+     * set` fetch error (EDITOR-7860). The `isDestroyed` check covers managers
+     * orphaned mid-flight during an async provider swap, where `dataProvider`
+     * alone is insufficient.
+     */
+    hasDataProvider(): 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/syncBlockBatchFetcher.d.ts

@@ -7,6 +7,13 @@ export interface SyncBlockBatchFetcherDeps {
     getSubscriptions: () => Map<ResourceId, {
         [localId: BlockInstanceId]: SubscriptionCallback;
     }>;
+    /**
+     * Returns true when the data provider is wired and not torn down. When false,
+     * the fetcher skips and re-queues so the IDs are fetched once ready, avoiding
+     * the false `Data provider not set` errors (EDITOR-7860). Optional; when
+     * omitted, behaviour is unchanged.
+     */
+    isProviderReady?: () => boolean;
 }
 /**
  * Handles debounced batch-fetching of sync block data via `raf-schd`.

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

@@ -33,8 +33,12 @@ export declare class SyncBlockSubscriptionManager {
     private static readonly INITIAL_RETRY_DELAY_MS;
     private static readonly RETRY_BACKOFF_MULTIPLIER;
     private static readonly MAX_RETRY_ATTEMPTS;
+    private static readonly MAX_RETRY_ATTEMPTS_HARDENED;
+    private static readonly MAX_RETRY_DELAY_MS;
     private retryAttempts;
     private pendingRetries;
+    private getMaxRetryAttempts;
+    private getReconnectionDelay;
     constructor(deps: SyncBlockSubscriptionManagerDeps);
     /**
      * Returns the subscriptions map. Used by external consumers (e.g. batch fetcher, flush)
@@ -62,11 +66,6 @@ export declare class SyncBlockSubscriptionManager {
      * stale entry and scheduling a reconnection with exponential backoff.
      */
     private handleSubscriptionTerminated;
-    /**
-     * Schedules a reconnection attempt with exponential backoff.
-     * Delay = INITIAL_RETRY_DELAY_MS * (RETRY_BACKOFF_MULTIPLIER ^ attempts)
-     * e.g. 1s, 2s, 4s, 8s, 16s
-     */
     private scheduleReconnection;
     /**
      * Resets the retry counter for a resource. Called when a successful

package/package.json

@@ -30,7 +30,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^116.13.0",
+		"@atlaskit/editor-common": "^116.15.0",
 		"react": "^18.2.0"
 	},
 	"devDependencies": {
@@ -74,7 +74,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "8.1.9",
+	"version": "8.2.0",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",