@atlaskit/collab-provider 11.3.1 → 11.3.2

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

@@ -9,61 +9,77 @@ import type { StepJson, CollabSendableSelection, Metadata, UserPermitType, Prese
 import { type CatchupEventReason } from './helpers/const';
 import type { EditorState } from '@atlaskit/editor-prosemirror/state';
 export interface CollabEventDisconnectedData {
-    sid: string;
     reason: 'CLIENT_DISCONNECT' | 'SERVER_DISCONNECT' | 'SOCKET_CLOSED' | 'SOCKET_ERROR' | 'SOCKET_TIMEOUT' | 'UNKNOWN_DISCONNECT';
+    sid: string;
 }
 export interface Storage {
+    delete: (key: string) => Promise<void>;
     get: (key: string) => Promise<string>;
     set: (key: string, value: string) => Promise<void>;
-    delete: (key: string) => Promise<void>;
 }
 export interface InitialDraft {
     document: JSONDocNode;
-    version: number;
     metadata?: Metadata;
+    version: number;
 }
 export type FetchAnonymousAsset = (presenceId: string | undefined) => Promise<AnonymousAsset | undefined>;
 export interface Config {
-    url: string;
-    documentAri: string;
-    lifecycle?: Lifecycle;
-    storage?: Storage;
-    need404?: boolean;
-    createSocket: (path: string, auth?: AuthCallback | InitAndAuthData, productInfo?: ProductInformation, isPresenceOnly?: boolean, analyticsHelper?: AnalyticsHelper) => SocketIOSocket;
-    batchProps?: BatchProps;
-    fetchAnonymousAsset?: FetchAnonymousAsset;
+    /**
+     * There is expected to be temporary divergence between Live Page editor expand behaviour and the standard expand behaviour.
+     *
+     * This is expected to be removed in Q4 as Editor and Live Page teams align on a singular behaviour.
+     *
+     * It is only supported for use by Confluence.
+     *
+     * @default false
+     */
+    __livePage?: boolean;
     /**
      * @deprecated: Use promise based getAnalyticsWebClient instead
      */
     analyticsClient?: AnalyticsWebClient;
-    getAnalyticsWebClient?: Promise<AnalyticsWebClient>;
+    batchProps?: BatchProps;
+    createSocket: (path: string, auth?: AuthCallback | InitAndAuthData, productInfo?: ProductInformation, isPresenceOnly?: boolean, analyticsHelper?: AnalyticsHelper) => SocketIOSocket;
+    documentAri: string;
+    /**
+     * Enable checking if a document update from collab-provider is being dropped by the editor,
+     * throwing a non-recoverable error if it's detected.
+     */
+    enableErrorOnFailedDocumentApply?: boolean;
+    /**
+     * When a page is being published this number can control the number of failed steps until a catchup is triggered.
+     * The default value is MAX_STEP_REJECTED_ERROR (15).
+     */
+    failedStepLimitBeforeCatchupOnPublish?: number;
     featureFlags?: {
         [key: string]: boolean;
     };
+    fetchAnonymousAsset?: FetchAnonymousAsset;
+    getAnalyticsWebClient?: Promise<AnalyticsWebClient>;
     getUser?: GetUserType;
+    initialDraft?: InitialDraft;
+    isBufferingEnabled?: boolean;
+    isPresenceOnly?: boolean;
+    lifecycle?: Lifecycle;
+    need404?: boolean;
     /**
      * If provided, permissionTokenRefresh is called whenever a new JWT token is required.
      */
     permissionTokenRefresh?: () => Promise<string | null>;
-    productInfo?: ProductInformation;
-    /**
-     * Throws errors when trying to send data to collab but the client is not offline.
-     * This can lead to potential dataloss and retrying should be considered. Without this flag the provider silently drops the requests.
-     */
-    throwOnNotConnected?: boolean;
-    initialDraft?: InitialDraft;
-    isBufferingEnabled?: boolean;
-    isPresenceOnly?: boolean;
     /**
-     * When a page is being published this number can control the number of failed steps until a catchup is triggered.
-     * The default value is MAX_STEP_REJECTED_ERROR (15).
+     * Configure the provider to pass along a default activity during presence events. This activity will be used
+     * to display a user's activity, such as 'viewer' or 'editor'.
+     *
+     * This activity can be updated later on by the participants-service.
      */
-    failedStepLimitBeforeCatchupOnPublish?: number;
+    presenceActivity?: PresenceActivity;
     /**
-     * Enable checking if a document update from collab-provider is being dropped by the editor,
-     * throwing a non-recoverable error if it's detected.
+     * Configure the provider to pass along a persistent presenceId during presence events. This presenceId will be used
+     * to calculate the colors of the presence avatars as well as the editors telepointers. Since these two features are split across
+     * multiple websocket connections, the presenceId is used to correlate the two.
      */
-    enableErrorOnFailedDocumentApply?: boolean;
+    presenceId?: string;
+    productInfo?: ProductInformation;
     /**
      * Configure the client side circuit breaker in the event that abnormal behaviour causes the client to flood
      * NCS with too many steps or too large a volume of data. This can result in either a soft fail or a hard (fatal) fail
@@ -73,29 +89,13 @@ export interface Config {
     rateLimitStepCount?: number;
     rateLimitTotalStepSize?: number;
     rateLimitType?: number;
+    storage?: Storage;
     /**
-     * There is expected to be temporary divergence between Live Page editor expand behaviour and the standard expand behaviour.
-     *
-     * This is expected to be removed in Q4 as Editor and Live Page teams align on a singular behaviour.
-     *
-     * It is only supported for use by Confluence.
-     *
-     * @default false
-     */
-    __livePage?: boolean;
-    /**
-     * Configure the provider to pass along a persistent presenceId during presence events. This presenceId will be used
-     * to calculate the colors of the presence avatars as well as the editors telepointers. Since these two features are split across
-     * multiple websocket connections, the presenceId is used to correlate the two.
-     */
-    presenceId?: string;
-    /**
-     * Configure the provider to pass along a default activity during presence events. This activity will be used
-     * to display a user's activity, such as 'viewer' or 'editor'.
-     *
-     * This activity can be updated later on by the participants-service.
+     * Throws errors when trying to send data to collab but the client is not offline.
+     * This can lead to potential dataloss and retrying should be considered. Without this flag the provider silently drops the requests.
      */
-    presenceActivity?: PresenceActivity;
+    throwOnNotConnected?: boolean;
+    url: string;
 }
 export interface InitAndAuthData {
     initialized: boolean;
@@ -107,10 +107,10 @@ interface SimpleEventEmitter {
     on: (event: string, fn: Function) => SimpleEventEmitter;
 }
 export interface Socket extends SimpleEventEmitter {
-    id: string;
+    close: () => Socket;
     connect: () => Socket;
     emit: (event: string, ...args: any[]) => Socket;
-    close: () => Socket;
+    id: string;
     io?: Manager;
 }
 export type LifecycleEvents = 'save' | 'restore';
@@ -120,10 +120,10 @@ export interface Lifecycle {
 }
 export type InitPayload = {
     doc: any;
-    version: number;
-    userId?: string;
     metadata?: Metadata;
     targetClientId?: string;
+    userId?: string;
+    version: number;
 };
 /**
  * @description Incoming payload type from the `broadcast` route in NCS
@@ -132,21 +132,21 @@ export type InitPayload = {
  * @param data event specific data from NCS
  */
 export type BroadcastIncomingPayload = {
+    data: PresencePayload | TelepointerPayload | StepsPayload | any;
     sessionId?: string;
     timestamp?: number;
-    data: PresencePayload | TelepointerPayload | StepsPayload | any;
 };
 export type PresenceData = {
-    sessionId: string;
-    userId: string | undefined;
     clientId: number | string;
     permit?: UserPermitType;
-    presenceId?: string;
     presenceActivity?: PresenceActivity;
+    presenceId?: string;
+    sessionId: string;
+    userId: string | undefined;
 };
 export type PresencePayload = PresenceData & {
-    timestamp: number;
     data?: Record<string, any>;
+    timestamp: number;
 };
 export type TelepointerPayload = PresencePayload & {
     selection: CollabSendableSelection;
@@ -160,19 +160,19 @@ export type AcknowledgementSuccessPayload = {
 };
 export type AcknowledgementPayload = AcknowledgementSuccessPayload | AcknowledgementErrorPayload;
 export type AddStepAcknowledgementSuccessPayload = {
+    delay?: number;
     type: AcknowledgementResponseTypes.SUCCESS;
     version: number;
-    delay?: number;
 };
 export type AcknowledgementErrorPayload = {
-    type: AcknowledgementResponseTypes.ERROR;
-    error: InternalError;
     delay?: number;
+    error: InternalError;
+    type: AcknowledgementResponseTypes.ERROR;
 };
 export type AddStepAcknowledgementPayload = AddStepAcknowledgementSuccessPayload | AcknowledgementErrorPayload;
 export type StepsPayload = {
-    version: number;
     steps: StepJson[];
+    version: number;
 };
 export type NamespaceStatus = {
     isLocked: boolean;
@@ -181,64 +181,64 @@ export type NamespaceStatus = {
 };
 export type ChannelEvent = {
     connected: {
-        sid: string;
         initialized: boolean;
+        sid: string;
     };
+    disconnect: {
+        reason: string;
+    };
+    error: InternalError;
     init: InitPayload;
-    restore: InitPayload;
-    reconnected: null;
-    'presence:joined': PresencePayload;
-    presence: PresencePayload;
+    'metadata:changed': Metadata;
     'participant:left': PresencePayload;
     'participant:telepointer': TelepointerPayload;
     'participant:updated': PresencePayload;
+    permission: UserPermitType;
+    presence: PresencePayload;
+    'presence:joined': PresencePayload;
+    reconnected: null;
+    restore: InitPayload;
+    status: NamespaceStatus;
+    'steps:added': StepsPayload;
     'steps:commit': StepsPayload & {
-        userId: string;
         collabMode: string;
         forcePublish?: boolean;
+        userId: string;
     };
-    'steps:added': StepsPayload;
-    'metadata:changed': Metadata;
-    permission: UserPermitType;
-    error: InternalError;
-    disconnect: {
-        reason: string;
-    };
-    status: NamespaceStatus;
 };
 export interface Catchupv2Response {
-    steps?: StepJson[];
     metadata?: Metadata;
+    steps?: StepJson[];
 }
 export interface ReconcileResponse {
-    document: string;
-    version: number;
     ari?: string;
+    document: string;
     metadata?: Metadata;
+    version: number;
 }
 export type GenerateDiffStepsResponseBody = {
     documentAri: string;
     generatedSteps: StepJson[];
     latestDocument?: string;
-    userId: string;
     message?: string;
+    userId: string;
 };
 export interface Catchupv2Options {
-    getCurrentPmVersion: () => number;
-    fetchCatchupv2: (fromVersion: number, clientId: number | string | undefined, catchUpOutofSync: boolean, reason?: CatchupEventReason, sessionId?: string) => Promise<Catchupv2Response>;
-    updateMetadata: (metadata: Metadata | undefined) => void;
     analyticsHelper: AnalyticsHelper | undefined;
+    catchUpOutofSync: boolean;
     clientId: number | string | undefined;
+    fetchCatchupv2: (fromVersion: number, clientId: number | string | undefined, catchUpOutofSync: boolean, reason?: CatchupEventReason, sessionId?: string) => Promise<Catchupv2Response>;
+    getCurrentPmVersion: () => number;
+    getState: (() => EditorState) | undefined;
+    onCatchupComplete?: (steps: StepJson[]) => void;
     onStepsAdded: (data: StepsPayload) => void;
-    catchUpOutofSync: boolean;
     reason?: CatchupEventReason;
     sessionId?: string;
-    onCatchupComplete?: (steps: StepJson[]) => void;
-    getState: (() => EditorState) | undefined;
+    updateMetadata: (metadata: Metadata | undefined) => void;
 }
 export type ReconnectionMetadata = {
-    unconfirmedStepsLength: number | undefined;
     disconnectionPeriodSeconds: number | undefined;
+    unconfirmedStepsLength: number | undefined;
 };
 export type ProductInformation = {
     product: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/collab-provider",
-	"version": "11.3.1",
+	"version": "11.3.2",
 	"description": "A provider for collaborative editing.",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -35,14 +35,14 @@
 		"@atlaskit/adf-utils": "^19.21.0",
 		"@atlaskit/analytics-gas-types": "^5.1.0",
 		"@atlaskit/analytics-listeners": "^9.0.0",
-		"@atlaskit/anonymous-assets": "^0.0.4",
+		"@atlaskit/anonymous-assets": "^0.0.5",
 		"@atlaskit/editor-json-transformer": "^8.27.0",
 		"@atlaskit/editor-prosemirror": "7.0.0",
 		"@atlaskit/feature-gate-js-client": "^5.5.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/prosemirror-collab": "^0.17.0",
 		"@atlaskit/react-ufo": "^4.4.0",
-		"@atlaskit/tmp-editor-statsig": "^11.5.0",
+		"@atlaskit/tmp-editor-statsig": "^11.6.0",
 		"@atlaskit/ufo": "^0.4.0",
 		"@atlaskit/util-service-support": "^6.3.0",
 		"@babel/runtime": "^7.0.0",
@@ -86,6 +86,6 @@
 		}
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^107.28.0"
+		"@atlaskit/editor-common": "^107.29.0"
 	}
 }