@atlaskit/editor-synced-block-provider 6.6.11 → 6.7.0

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

@@ -20,6 +20,9 @@ export declare class ReferenceSyncBlockStoreManager {
     private queuedFlushTimeout?;
     private entityNotFoundRetryCount;
     private entityNotFoundRetryTimers;
+    private pendingCacheDeletions;
+    private cacheDeletionRescheduleCounts;
+    private isDestroyed;
     fetchExperience: Experience | undefined;
     private fetchSourceInfoExperience;
     private saveExperience;
@@ -90,6 +93,28 @@ export declare class ReferenceSyncBlockStoreManager {
     private updateCache;
     getFromCache(resourceId: ResourceId): SyncBlockInstance | undefined;
     private deleteFromCache;
+    /**
+     * Returns true if the cache entry for `resourceId` is safe to delete:
+     * no active subscribers, no in-flight source-info request, and no
+     * queued/in-flight batch fetch (gated by `platform_synced_block_patch_14`).
+     */
+    private canDeleteCache;
+    /**
+     * Schedules cache deletion for `resourceId` after the grace period
+     * (gated by `platform_synced_block_patch_14`). Called when the last
+     * subscriber unsubscribes. Guards are re-checked at fire time; if any
+     * are positive the timer is rescheduled up to MAX_RESCHEDULES times.
+     */
+    scheduleCacheDeletion(resourceId: ResourceId): void;
+    /**
+     * Cancels any pending cache deletion timer for `resourceId` and resets the
+     * reschedule counter (gated by `platform_synced_block_patch_14`). Called
+     * when a new subscriber arrives.
+     */
+    cancelPendingCacheDeletion(resourceId: ResourceId): void;
+    /** Returns whether a cache deletion timer is pending for `resourceId`. */
+    hasPendingCacheDeletion(resourceId: ResourceId): boolean;
+    private onCacheDeletionTimerFire;
     /**
      * Schedules a delayed retry for a block that returned EntityNotFound.
      * The block may be in the process of being created by a collaborator —

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

@@ -16,9 +16,17 @@ export interface SyncBlockBatchFetcherDeps {
 export declare class SyncBlockBatchFetcher {
     private deps;
     private pendingFetchRequests;
+    private inFlightFetches;
+    private isDestroyed;
     private scheduledBatchFetch;
     constructor(deps: SyncBlockBatchFetcherDeps);
     queueFetch(resourceId: string): void;
+    /**
+     * Returns true if a batched fetch is queued or in flight for `resourceId`.
+     * Used by cache deletion guards to prevent deleting while a fetch is
+     * about to populate the entry.
+     */
+    hasPendingFetch(resourceId: string): boolean;
     cancel(): void;
     clearPending(): void;
     destroy(): void;

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

@@ -3,6 +3,8 @@ import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { ResourceId, BlockInstanceId } from '../common/types';
 import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo, TitleSubscriptionCallback } from '../providers/types';
 export interface SyncBlockSubscriptionManagerDeps {
+    /** Cancels any pending cache deletion timer for `resourceId` (gated). */
+    cancelPendingCacheDeletion: (resourceId: ResourceId) => void;
     debouncedBatchedFetchSyncBlocks: (resourceId: string) => void;
     deleteFromCache: (resourceId: ResourceId) => void;
     fetchSyncBlockSourceInfo: (resourceId: ResourceId) => Promise<SyncBlockSourceInfo | undefined>;
@@ -10,6 +12,8 @@ export interface SyncBlockSubscriptionManagerDeps {
     getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
     getFromCache: (resourceId: ResourceId) => SyncBlockInstance | undefined;
     markCacheDirty: () => void;
+    /** Schedules guarded cache deletion for `resourceId` after a grace period (gated). */
+    scheduleCacheDeletion: (resourceId: ResourceId) => void;
     updateCache: (syncBlockInstance: SyncBlockInstance) => void;
 }
 /**

package/dist/types/utils/errorHandling.d.ts

@@ -13,6 +13,21 @@ export declare const updateReferenceErrorPayload: (error: string, resourceId?: s
 export declare const createErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const deleteErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const updateCacheErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
+/**
+ * Payload for `SYNCED_BLOCK_SOURCE_INFO_ORPHANED`. Fired when source-info
+ * resolves into a cache that has already been deleted — should be unreachable
+ * under `platform_synced_block_patch_14`.
+ */
+export declare const sourceInfoOrphanedPayload: (resourceId?: string, sourceProduct?: string, context?: {
+    hasPendingDeletion?: boolean;
+    hasSubscribers?: boolean;
+}) => RendererSyncBlockEventPayload;
+/**
+ * Payload for `SYNCED_BLOCK_CACHE_DELETION_FORCED`. Fired when the cache
+ * deletion timer has been rescheduled `MAX_RESCHEDULE_COUNT` times and we force
+ * the deletion to avoid leaking memory. Indicates a stuck in-flight flag.
+ */
+export declare const cacheDeletionForcedPayload: (rescheduleCount: number, resourceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 export declare const fetchReferencesErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const fetchSuccessPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 export declare const createSuccessPayload: (resourceId: string, sourceProduct?: string) => SyncBlockEventPayload;

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

@@ -20,6 +20,9 @@ export declare class ReferenceSyncBlockStoreManager {
     private queuedFlushTimeout?;
     private entityNotFoundRetryCount;
     private entityNotFoundRetryTimers;
+    private pendingCacheDeletions;
+    private cacheDeletionRescheduleCounts;
+    private isDestroyed;
     fetchExperience: Experience | undefined;
     private fetchSourceInfoExperience;
     private saveExperience;
@@ -90,6 +93,28 @@ export declare class ReferenceSyncBlockStoreManager {
     private updateCache;
     getFromCache(resourceId: ResourceId): SyncBlockInstance | undefined;
     private deleteFromCache;
+    /**
+     * Returns true if the cache entry for `resourceId` is safe to delete:
+     * no active subscribers, no in-flight source-info request, and no
+     * queued/in-flight batch fetch (gated by `platform_synced_block_patch_14`).
+     */
+    private canDeleteCache;
+    /**
+     * Schedules cache deletion for `resourceId` after the grace period
+     * (gated by `platform_synced_block_patch_14`). Called when the last
+     * subscriber unsubscribes. Guards are re-checked at fire time; if any
+     * are positive the timer is rescheduled up to MAX_RESCHEDULES times.
+     */
+    scheduleCacheDeletion(resourceId: ResourceId): void;
+    /**
+     * Cancels any pending cache deletion timer for `resourceId` and resets the
+     * reschedule counter (gated by `platform_synced_block_patch_14`). Called
+     * when a new subscriber arrives.
+     */
+    cancelPendingCacheDeletion(resourceId: ResourceId): void;
+    /** Returns whether a cache deletion timer is pending for `resourceId`. */
+    hasPendingCacheDeletion(resourceId: ResourceId): boolean;
+    private onCacheDeletionTimerFire;
     /**
      * Schedules a delayed retry for a block that returned EntityNotFound.
      * The block may be in the process of being created by a collaborator —

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

@@ -16,9 +16,17 @@ export interface SyncBlockBatchFetcherDeps {
 export declare class SyncBlockBatchFetcher {
     private deps;
     private pendingFetchRequests;
+    private inFlightFetches;
+    private isDestroyed;
     private scheduledBatchFetch;
     constructor(deps: SyncBlockBatchFetcherDeps);
     queueFetch(resourceId: string): void;
+    /**
+     * Returns true if a batched fetch is queued or in flight for `resourceId`.
+     * Used by cache deletion guards to prevent deleting while a fetch is
+     * about to populate the entry.
+     */
+    hasPendingFetch(resourceId: string): boolean;
     cancel(): void;
     clearPending(): void;
     destroy(): void;

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

@@ -3,6 +3,8 @@ import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { ResourceId, BlockInstanceId } from '../common/types';
 import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProviderInterface, SyncBlockSourceInfo, TitleSubscriptionCallback } from '../providers/types';
 export interface SyncBlockSubscriptionManagerDeps {
+    /** Cancels any pending cache deletion timer for `resourceId` (gated). */
+    cancelPendingCacheDeletion: (resourceId: ResourceId) => void;
     debouncedBatchedFetchSyncBlocks: (resourceId: string) => void;
     deleteFromCache: (resourceId: ResourceId) => void;
     fetchSyncBlockSourceInfo: (resourceId: ResourceId) => Promise<SyncBlockSourceInfo | undefined>;
@@ -10,6 +12,8 @@ export interface SyncBlockSubscriptionManagerDeps {
     getFireAnalyticsEvent: () => ((payload: RendererSyncBlockEventPayload) => void) | undefined;
     getFromCache: (resourceId: ResourceId) => SyncBlockInstance | undefined;
     markCacheDirty: () => void;
+    /** Schedules guarded cache deletion for `resourceId` after a grace period (gated). */
+    scheduleCacheDeletion: (resourceId: ResourceId) => void;
     updateCache: (syncBlockInstance: SyncBlockInstance) => void;
 }
 /**

package/dist/types-ts4.5/utils/errorHandling.d.ts

@@ -13,6 +13,21 @@ export declare const updateReferenceErrorPayload: (error: string, resourceId?: s
 export declare const createErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const deleteErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const updateCacheErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
+/**
+ * Payload for `SYNCED_BLOCK_SOURCE_INFO_ORPHANED`. Fired when source-info
+ * resolves into a cache that has already been deleted — should be unreachable
+ * under `platform_synced_block_patch_14`.
+ */
+export declare const sourceInfoOrphanedPayload: (resourceId?: string, sourceProduct?: string, context?: {
+    hasPendingDeletion?: boolean;
+    hasSubscribers?: boolean;
+}) => RendererSyncBlockEventPayload;
+/**
+ * Payload for `SYNCED_BLOCK_CACHE_DELETION_FORCED`. Fired when the cache
+ * deletion timer has been rescheduled `MAX_RESCHEDULE_COUNT` times and we force
+ * the deletion to avoid leaking memory. Indicates a stuck in-flight flag.
+ */
+export declare const cacheDeletionForcedPayload: (rescheduleCount: number, resourceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 export declare const fetchReferencesErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const fetchSuccessPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 export declare const createSuccessPayload: (resourceId: string, sourceProduct?: string) => SyncBlockEventPayload;

package/package.json

@@ -29,7 +29,7 @@
 		"@atlaskit/editor-prosemirror": "^7.3.0",
 		"@atlaskit/node-data-provider": "^11.1.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
-		"@atlaskit/tmp-editor-statsig": "^84.3.0",
+		"@atlaskit/tmp-editor-statsig": "^85.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": "^114.50.0",
+		"@atlaskit/editor-common": "^114.54.0",
 		"react": "^18.2.0"
 	},
 	"devDependencies": {
@@ -82,7 +82,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "6.6.11",
+	"version": "6.7.0",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -92,6 +92,9 @@
 	"platform-feature-flags": {
 		"platform_synced_block_patch_13": {
 			"type": "boolean"
+		},
+		"platform_synced_block_patch_14": {
+			"type": "boolean"
 		}
 	}
 }