@anzusystems/common-admin 2.0.0-rc.1 → 2.0.0-rc.11

package/dist/domains/collab/composables/collabInit.js

@@ -1,100 +1,103 @@
-import { isNull as e } from "../../../shared/utils/common.js";
+import { CollabStatus as e } from "../types/Collab.js";
 import { useCollabApprovedJoinRequestEventBus as t, useCollabApprovedRequestToTakeModerationEventBus as n, useCollabJoinRequestEventBus as r, useCollabKickedFromRoomEventBus as i, useCollabReconnectEventBus as a, useCollabRejectedJoinRequestEventBus as o, useCollabRejectedRequestToTakeModerationEventBus as s, useCollabRequestToTakeModerationEventBus as c, useCollabRoomDataChangeEventBus as l, useCollabStartingEventBus as u } from "./collabEventBus.js";
-import { CollabStatus as d } from "../types/Collab.js";
-import { useCommonAdminCollabOptions as f } from "./commonAdminCollabOptions.js";
-import { useCollabStateInternal as p } from "./collabState.js";
+import { useCollabStateInternal as d } from "./collabState.js";
+import { useCollabCurrentUserId as f } from "./collabCurrentUserId.js";
+import { createCollabRecovery as p } from "./collabRecovery.js";
 import { useAlerts as m } from "../../system/composables/alerts.js";
-import { useSentry as h } from "../../system/composables/sentry.js";
-//#region src/domains/collab/composables/collabInit.ts
-function g() {
-	let { collabOptions: g } = f(), { showWarningT: _, showSuccessT: v } = m(), { collabConnected: y, collabSocket: b, collabRoomInfoState: x, collabFieldLocksState: S, collabFieldLocksUnanswered: C } = p(), { logError: w } = h(), T = !1, E = async () => {
-		try {
-			await g.value.beforeReconnect();
-		} catch (e) {
-			w(e, {
-				level: "warning",
-				tags: { collabPhase: "beforeReconnect" }
-			});
-		}
-	};
+import { useCommonAdminCollabOptions as h } from "./commonAdminCollabOptions.js";
+import { useSentry as g } from "../../system/composables/sentry.js";
+import { isNull as _ } from "../../../shared/utils/common.js";
+// src/domains/collab/composables/collabInit.ts
+function v() {
+	let { collabOptions: v } = h(), { showWarningT: y, showSuccessT: b } = m(), { collabConnected: x, collabSocket: S, collabConnectionState: C, setCollabRecover: w, collabRoomInfoState: T, collabFieldLocksState: E, collabFieldLocksUnanswered: D } = d(), { currentUserId: O } = f(), { logError: k } = g();
 	return { initCollab: () => {
-		let f = l(), p = a(), m = u(), h = r(), D = t(), O = o(), k = c(), A = n(), j = s(), M = i();
-		if (b.value || !g.value.enabled) return;
-		let N = g.value.io;
-		if (!N) w(/* @__PURE__ */ Error("Collab is enabled, but the plugin options pass no `io` from socket.io-client."));
+		let d = l(), f = a(), m = u(), h = r(), g = t(), A = o(), j = c(), M = n(), N = s(), P = i();
+		if (S.value || !v.value.enabled) return;
+		let F = v.value.io;
+		if (!F) k(/* @__PURE__ */ Error("Collab is enabled, but the plugin options pass no `io` from socket.io-client."));
 		else try {
-			b.value = N(g.value.socketUrl, {
+			S.value = F(v.value.socketUrl, {
 				transports: ["websocket"],
 				path: "/ws",
-				forceNew: !0
-			}), b.value.on("collabRoomChanged", (e) => {
+				forceNew: !0,
+				auth: (e) => e({ userId: O.value })
+			});
+			let t = p({
+				socket: S.value,
+				state: C,
+				beforeReconnect: () => v.value.beforeReconnect(),
+				isSameIdentity: () => v.value.isSameIdentity?.(),
+				logError: k
+			});
+			w(t.retry), S.value.io?.on("reconnect_attempt", () => {
+				t.onReconnectAttempt() && (x.value = !1);
+			}), typeof window < "u" && (window.addEventListener("online", t.retryIfWaiting), document.addEventListener("visibilitychange", () => {
+				document.visibilityState === "visible" && t.retryIfWaiting();
+			}), window.addEventListener("pagehide", t.onPageHide), window.addEventListener("pageshow", (e) => t.onPageShow(e.persisted))), S.value.on("collabRoomChanged", (e) => {
 				try {
-					x.has(e.name) && x.set(e.name, e);
+					T.has(e.name) && T.set(e.name, e);
 				} catch (e) {
 					console.error("error", e);
 				}
-			}), b.value.on("collabRoomLocksChanged", (t, n) => {
-				if (!e(n)) {
-					let e = Object.entries(n);
-					(!S.has(t) || Object.keys(n).length === 0) && S.set(t, new Map(e));
-					for (let [n, r] of e) r ? S.get(t)?.set(n, r) : S.get(t)?.delete(n);
+			}), S.value.on("collabRoomLocksChanged", (e, t) => {
+				if (!_(t)) {
+					let n = Object.entries(t);
+					E.has(e) && Object.keys(t).length !== 0 || E.set(e, new Map(n));
+					for (let [t, r] of n) r ? E.get(e)?.set(t, r) : E.get(e)?.delete(t);
 				}
-			}), b.value.on("collabRoomDataChanged", (e, t) => {
+			}), S.value.on("collabRoomDataChanged", (e, t) => {
 				let n = Object.entries(t);
-				for (let [t, r] of n) f.emit({
+				for (let [t, r] of n) d.emit({
 					room: e,
 					field: t
 				}, r);
-			}), b.value?.on("requestToJoin", (e, t, n) => {
+			}), S.value?.on("requestToJoin", (e, t, n) => {
 				h.emit({
 					room: e,
 					userId: t,
 					timestamp: n
 				});
-			}), b.value?.on("approvedRequestToJoin", (e) => {
-				D.emit({ room: e });
-			}), b.value?.on("rejectedRequestToJoin", (e) => {
-				O.emit({ room: e });
-			}), b.value?.on("requestToTakeModeration", (e, t, n) => {
-				k.emit({
+			}), S.value?.on("approvedRequestToJoin", (e) => {
+				g.emit({ room: e });
+			}), S.value?.on("rejectedRequestToJoin", (e) => {
+				A.emit({ room: e });
+			}), S.value?.on("requestToTakeModeration", (e, t, n) => {
+				j.emit({
 					room: e,
 					userId: t,
 					timestamp: n
 				});
-			}), b.value?.on("approvedRequestToTakeModeration", (e) => {
-				A.emit({ room: e });
-			}), b.value?.on("rejectedRequestToTakeModeration", (e) => {
-				j.emit({ room: e });
-			}), b.value?.on("transferredModeration", () => {
-				v("common.collab.alert.transferredModeration");
-			}), b.value?.on("kickedFromRoom", (e) => {
-				_("common.collab.alert.kickedFromRoom"), M.emit({ room: e });
-			}), b.value?.on("startCollab", async (e, t) => {
+			}), S.value?.on("approvedRequestToTakeModeration", (e) => {
+				M.emit({ room: e });
+			}), S.value?.on("rejectedRequestToTakeModeration", (e) => {
+				N.emit({ room: e });
+			}), S.value?.on("transferredModeration", () => {
+				b("common.collab.alert.transferredModeration");
+			}), S.value?.on("kickedFromRoom", (e) => {
+				y("common.collab.alert.kickedFromRoom"), P.emit({ room: e });
+			}), S.value?.on("startCollab", async (e, t) => {
 				m.emit({
 					room: e,
 					startedCallback: t
 				});
-			}), b.value.on("connect", async () => {
-				x.clear(), C.clear(), T = !1;
-				let e = y.value;
-				y.value = b.value?.connected ?? !1, e || (await E(), p.emit("reconnect"));
-			}), b.value.on("connect_error", async (e) => {
-				T ? (y.value = b.value?.connected ?? !1, !b.value?.active && w(e, {
-					level: "error",
-					tags: { collabPhase: "connectRejected" }
-				})) : (T = !0, await E(), b.value?.connect());
-			}), b.value.on("disconnect", async (e) => {
-				x.forEach((e) => e.status = d.Inactive), y.value = b.value?.connected ?? !1, e === "io server disconnect" && (await E(), b.value?.connect());
+			}), S.value.on("connect", () => {
+				T.clear(), D.clear(), t.onConnect();
+				let e = x.value;
+				x.value = S.value?.connected ?? !1, e || f.emit("reconnect");
+			}), S.value.on("connect_error", (e) => {
+				if (x.value = S.value?.connected ?? !1, S.value?.active) return t.onTransportError();
+				t.onRefused(e);
+			}), S.value.on("disconnect", (n) => {
+				T.forEach((t) => t.status = e.Inactive), x.value = S.value?.connected ?? !1, t.onDisconnect(n);
 			});
 		} catch (e) {
-			w(e, {
+			k(e, {
 				level: "error",
 				tags: { collabPhase: "init" }
 			});
 		}
 	} };
 }
-//#endregion
-export { g as useCollabInit };
+export { v as useCollabInit };
 
 //# sourceMappingURL=collabInit.js.map

package/dist/domains/collab/composables/collabInit.js.map

@@ -1 +1 @@
-{"version":3,"file":"collabInit.js","names":["useCollabInit","useCommonAdminCollabOptions","useAlerts","useCollabStateInternal","useSentry","authorizationReconnectTriggered","runBeforeReconnect","collabOptions","error","changeEventBus","useCollabRoomDataChangeEventBus","reconnectEventBus","useCollabReconnectEventBus","collabStartingEventBus","useCollabStartingEventBus","requestAccessEventBus","useCollabJoinRequestEventBus","approvedJoinRequestEventBus","useCollabApprovedJoinRequestEventBus","rejectedJoinRequestEventBus","useCollabRejectedJoinRequestEventBus","requestToTakeModerationEventBus","useCollabRequestToTakeModerationEventBus","approvedRequestToTakeModerationEventBus","useCollabApprovedRequestToTakeModerationEventBus","rejectedRequestToTakeModerationEventBus","useCollabRejectedRequestToTakeModerationEventBus","kickedFromRoomEventBus","useCollabKickedFromRoomEventBus","collabSocket","io","collabRoomInfoState","room","isNull","locks","locksEntries","collabFieldLocksState","field","lock","dataEntries","data","fieldData","showWarningT","callback","collabFieldLocksUnanswered","connectedBefore","collabConnected","logError","CollabStatus","reason"],"sources":["../../../../src/domains/collab/composables/collabInit.ts"],"sourcesContent":["import type {\n  CollabRoom,\n  CollabRoomData,\n  CollabRoomInfo,\n  CollabRoomLocks,\n  CollabRoomPlainData,\n} from '@/domains/collab/types/Collab'\nimport { CollabStatus } from '@/domains/collab/types/Collab'\nimport {\n  useCollabApprovedJoinRequestEventBus,\n  useCollabApprovedRequestToTakeModerationEventBus,\n  useCollabJoinRequestEventBus,\n  useCollabKickedFromRoomEventBus,\n  useCollabReconnectEventBus,\n  useCollabRejectedJoinRequestEventBus,\n  useCollabRejectedRequestToTakeModerationEventBus,\n  useCollabRequestToTakeModerationEventBus,\n  useCollabRoomDataChangeEventBus,\n  useCollabStartingEventBus,\n} from '@/domains/collab/composables/collabEventBus'\nimport { useCollabStateInternal } from '@/domains/collab/composables/collabState'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport { useCommonAdminCollabOptions } from '@/domains/collab/composables/commonAdminCollabOptions'\nimport { useSentry } from '@/domains/system/composables/sentry'\nimport { isNull } from '@/shared/utils/common'\n\nexport function useCollabInit() {\n  const { collabOptions } = useCommonAdminCollabOptions()\n  const { showWarningT, showSuccessT } = useAlerts()\n  const { collabConnected, collabSocket, collabRoomInfoState, collabFieldLocksState, collabFieldLocksUnanswered } =\n    useCollabStateInternal()\n\n  const { logError } = useSentry()\n\n  let authorizationReconnectTriggered = false\n\n  const runBeforeReconnect = async () => {\n    try {\n      await collabOptions.value.beforeReconnect()\n    } catch (error) {\n      logError(error as Error, { level: 'warning', tags: { collabPhase: 'beforeReconnect' } })\n    }\n  }\n\n  const initCollab = () => {\n    const changeEventBus = useCollabRoomDataChangeEventBus()\n    const reconnectEventBus = useCollabReconnectEventBus()\n    const collabStartingEventBus = useCollabStartingEventBus()\n    const requestAccessEventBus = useCollabJoinRequestEventBus()\n    const approvedJoinRequestEventBus = useCollabApprovedJoinRequestEventBus()\n    const rejectedJoinRequestEventBus = useCollabRejectedJoinRequestEventBus()\n    const requestToTakeModerationEventBus = useCollabRequestToTakeModerationEventBus()\n    const approvedRequestToTakeModerationEventBus = useCollabApprovedRequestToTakeModerationEventBus()\n    const rejectedRequestToTakeModerationEventBus = useCollabRejectedRequestToTakeModerationEventBus()\n    const kickedFromRoomEventBus = useCollabKickedFromRoomEventBus()\n\n    if (collabSocket.value || !collabOptions.value.enabled) {\n      return\n    }\n    const io = collabOptions.value.io\n    if (!io) {\n      logError(new Error('Collab is enabled, but the plugin options pass no `io` from socket.io-client.'))\n      return\n    }\n\n    try {\n      collabSocket.value = io(collabOptions.value.socketUrl, {\n        transports: ['websocket'],\n        path: '/ws',\n        forceNew: true,\n      })\n      collabSocket.value.on('collabRoomChanged', (room: CollabRoomInfo) => {\n        try {\n          if (collabRoomInfoState.has(room.name)) {\n            collabRoomInfoState.set(room.name, room)\n          }\n        } catch (error) {\n          console.error('error', error)\n        }\n      })\n      collabSocket.value.on('collabRoomLocksChanged', (room: CollabRoom, locks: CollabRoomLocks | null) => {\n        if (!isNull(locks)) {\n          const locksEntries = Object.entries(locks)\n          if (!collabFieldLocksState.has(room) || Object.keys(locks).length === 0) {\n            collabFieldLocksState.set(room, new Map(locksEntries))\n          }\n          for (const [field, lock] of locksEntries) {\n            if (!lock) {\n              collabFieldLocksState.get(room)?.delete(field)\n              continue\n            }\n            collabFieldLocksState.get(room)?.set(field, lock)\n          }\n        }\n      })\n      collabSocket.value.on('collabRoomDataChanged', (room: CollabRoom, data: CollabRoomData) => {\n        const dataEntries = Object.entries(data)\n        for (const [field, fieldData] of dataEntries) {\n          changeEventBus.emit({ room, field }, fieldData)\n        }\n      })\n      collabSocket.value?.on('requestToJoin', (room: CollabRoom, userId: number, timestamp: number) => {\n        requestAccessEventBus.emit({ room, userId, timestamp })\n      })\n      collabSocket.value?.on('approvedRequestToJoin', (room: CollabRoom) => {\n        approvedJoinRequestEventBus.emit({ room })\n      })\n      collabSocket.value?.on('rejectedRequestToJoin', (room: CollabRoom) => {\n        rejectedJoinRequestEventBus.emit({ room })\n      })\n      collabSocket.value?.on('requestToTakeModeration', (room: CollabRoom, userId: number, timestamp: number) => {\n        requestToTakeModerationEventBus.emit({ room, userId, timestamp })\n      })\n      collabSocket.value?.on('approvedRequestToTakeModeration', (room: CollabRoom) => {\n        approvedRequestToTakeModerationEventBus.emit({ room })\n      })\n      collabSocket.value?.on('rejectedRequestToTakeModeration', (room: CollabRoom) => {\n        rejectedRequestToTakeModerationEventBus.emit({ room })\n      })\n      collabSocket.value?.on('transferredModeration', () => {\n        showSuccessT('common.collab.alert.transferredModeration')\n      })\n      collabSocket.value?.on('kickedFromRoom', (room: CollabRoom) => {\n        showWarningT('common.collab.alert.kickedFromRoom')\n        kickedFromRoomEventBus.emit({ room })\n      })\n      collabSocket.value?.on('startCollab', async (room, callback: (data: CollabRoomPlainData) => void) => {\n        collabStartingEventBus.emit({ room, startedCallback: callback })\n      })\n      collabSocket.value.on('connect', async () => {\n        /* Memberships from before a reconnect are stale; the server does not re-announce them.\n         *\n         * The write claims behind them are deliberately left alone. Socket.io drops the\n         * acknowledgement of a packet it already put on the wire (`_clearAcks`), so one emitted\n         * before the reconnect can no longer land here — but it keeps the acknowledgement of a\n         * packet still in `sendBuffer`, which it delivers on this connection. Resetting the claims\n         * would discard exactly those: a join emitted while the socket was still connecting is\n         * flushed just before this handler runs, and its acknowledgement arrives a round trip\n         * later to find its claim gone. */\n        collabRoomInfoState.clear()\n        // The server let the locks of the old connection go; a timed-out request was dropped from the send buffer.\n        collabFieldLocksUnanswered.clear()\n        // Without the reset a transient network error burns the flag and a later JWT\n        // expiration never triggers a token refresh.\n        authorizationReconnectTriggered = false\n        const connectedBefore = collabConnected.value\n        collabConnected.value = collabSocket.value?.connected ?? false\n        if (!connectedBefore) {\n          await runBeforeReconnect()\n          reconnectEventBus.emit('reconnect')\n        }\n      })\n      collabSocket.value.on('connect_error', async (error) => {\n        if (!authorizationReconnectTriggered) {\n          authorizationReconnectTriggered = true\n          await runBeforeReconnect()\n          collabSocket.value?.connect()\n          return\n        }\n        collabConnected.value = collabSocket.value?.connected ?? false\n        // active === true means socket.io will reconnect on its own; only a permanent\n        // rejection is worth reporting.\n        if (collabSocket.value?.active) {\n          return\n        }\n        logError(error, { level: 'error', tags: { collabPhase: 'connectRejected' } })\n      })\n      collabSocket.value.on('disconnect', async (reason) => {\n        collabRoomInfoState.forEach((roomInfo: CollabRoomInfo) => (roomInfo.status = CollabStatus.Inactive))\n        collabConnected.value = collabSocket.value?.connected ?? false\n        if (reason === 'io server disconnect') {\n          await runBeforeReconnect()\n          collabSocket.value?.connect()\n        }\n      })\n    } catch (error) {\n      // Not `message`: with `level` beside it Sentry reads the object as scope data and drops the key.\n      logError(error as Error, { level: 'error', tags: { collabPhase: 'init' } })\n    }\n  }\n\n  return {\n    initCollab,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"collabInit.js","names":["useCollabInit","useCommonAdminCollabOptions","useAlerts","useCollabStateInternal","useCollabCurrentUserId","useSentry","changeEventBus","useCollabRoomDataChangeEventBus","reconnectEventBus","useCollabReconnectEventBus","collabStartingEventBus","useCollabStartingEventBus","requestAccessEventBus","useCollabJoinRequestEventBus","approvedJoinRequestEventBus","useCollabApprovedJoinRequestEventBus","rejectedJoinRequestEventBus","useCollabRejectedJoinRequestEventBus","requestToTakeModerationEventBus","useCollabRequestToTakeModerationEventBus","approvedRequestToTakeModerationEventBus","useCollabApprovedRequestToTakeModerationEventBus","rejectedRequestToTakeModerationEventBus","useCollabRejectedRequestToTakeModerationEventBus","kickedFromRoomEventBus","useCollabKickedFromRoomEventBus","collabSocket","collabOptions","io","callback","currentUserId","recovery","createCollabRecovery","collabConnectionState","setCollabRecover","event","collabRoomInfoState","room","error","isNull","locks","locksEntries","collabFieldLocksState","field","lock","dataEntries","data","fieldData","showWarningT","collabFieldLocksUnanswered","connectedBefore","collabConnected","CollabStatus","reason"],"sources":["../../../../src/domains/collab/composables/collabInit.ts"],"sourcesContent":["import type {\n  CollabRoom,\n  CollabRoomData,\n  CollabRoomInfo,\n  CollabRoomLocks,\n  CollabRoomPlainData,\n} from '@/domains/collab/types/Collab'\nimport { CollabStatus } from '@/domains/collab/types/Collab'\nimport {\n  useCollabApprovedJoinRequestEventBus,\n  useCollabApprovedRequestToTakeModerationEventBus,\n  useCollabJoinRequestEventBus,\n  useCollabKickedFromRoomEventBus,\n  useCollabReconnectEventBus,\n  useCollabRejectedJoinRequestEventBus,\n  useCollabRejectedRequestToTakeModerationEventBus,\n  useCollabRequestToTakeModerationEventBus,\n  useCollabRoomDataChangeEventBus,\n  useCollabStartingEventBus,\n} from '@/domains/collab/composables/collabEventBus'\nimport { useCollabStateInternal } from '@/domains/collab/composables/collabState'\nimport { useCollabCurrentUserId } from '@/domains/collab/composables/collabCurrentUserId'\nimport { type CollabRefusal, createCollabRecovery } from '@/domains/collab/composables/collabRecovery'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport { useCommonAdminCollabOptions } from '@/domains/collab/composables/commonAdminCollabOptions'\nimport { useSentry } from '@/domains/system/composables/sentry'\nimport { isNull } from '@/shared/utils/common'\n\nexport function useCollabInit() {\n  const { collabOptions } = useCommonAdminCollabOptions()\n  const { showWarningT, showSuccessT } = useAlerts()\n  const {\n    collabConnected,\n    collabSocket,\n    collabConnectionState,\n    setCollabRecover,\n    collabRoomInfoState,\n    collabFieldLocksState,\n    collabFieldLocksUnanswered,\n  } = useCollabStateInternal()\n  const { currentUserId } = useCollabCurrentUserId()\n\n  const { logError } = useSentry()\n\n  const initCollab = () => {\n    const changeEventBus = useCollabRoomDataChangeEventBus()\n    const reconnectEventBus = useCollabReconnectEventBus()\n    const collabStartingEventBus = useCollabStartingEventBus()\n    const requestAccessEventBus = useCollabJoinRequestEventBus()\n    const approvedJoinRequestEventBus = useCollabApprovedJoinRequestEventBus()\n    const rejectedJoinRequestEventBus = useCollabRejectedJoinRequestEventBus()\n    const requestToTakeModerationEventBus = useCollabRequestToTakeModerationEventBus()\n    const approvedRequestToTakeModerationEventBus = useCollabApprovedRequestToTakeModerationEventBus()\n    const rejectedRequestToTakeModerationEventBus = useCollabRejectedRequestToTakeModerationEventBus()\n    const kickedFromRoomEventBus = useCollabKickedFromRoomEventBus()\n\n    if (collabSocket.value || !collabOptions.value.enabled) {\n      return\n    }\n    const io = collabOptions.value.io\n    if (!io) {\n      logError(new Error('Collab is enabled, but the plugin options pass no `io` from socket.io-client.'))\n      return\n    }\n\n    try {\n      collabSocket.value = io(collabOptions.value.socketUrl, {\n        transports: ['websocket'],\n        path: '/ws',\n        forceNew: true,\n        // Read for every handshake: the server refuses cookies of another account than the page belongs to.\n        auth: (callback) => callback({ userId: currentUserId.value }),\n      })\n      const recovery = createCollabRecovery({\n        socket: collabSocket.value,\n        state: collabConnectionState,\n        beforeReconnect: () => collabOptions.value.beforeReconnect(),\n        isSameIdentity: () => collabOptions.value.isSameIdentity?.(),\n        logError,\n      })\n      setCollabRecover(recovery.retry)\n      // Optional: the test doubles of the socket have no manager.\n      collabSocket.value.io?.on('reconnect_attempt', () => {\n        if (recovery.onReconnectAttempt()) collabConnected.value = false\n      })\n      if (typeof window !== 'undefined') {\n        window.addEventListener('online', recovery.retryIfWaiting)\n        document.addEventListener('visibilitychange', () => {\n          if (document.visibilityState === 'visible') recovery.retryIfWaiting()\n        })\n        window.addEventListener('pagehide', recovery.onPageHide)\n        window.addEventListener('pageshow', (event) => recovery.onPageShow(event.persisted))\n      }\n      collabSocket.value.on('collabRoomChanged', (room: CollabRoomInfo) => {\n        try {\n          if (collabRoomInfoState.has(room.name)) {\n            collabRoomInfoState.set(room.name, room)\n          }\n        } catch (error) {\n          console.error('error', error)\n        }\n      })\n      collabSocket.value.on('collabRoomLocksChanged', (room: CollabRoom, locks: CollabRoomLocks | null) => {\n        if (!isNull(locks)) {\n          const locksEntries = Object.entries(locks)\n          if (!collabFieldLocksState.has(room) || Object.keys(locks).length === 0) {\n            collabFieldLocksState.set(room, new Map(locksEntries))\n          }\n          for (const [field, lock] of locksEntries) {\n            if (!lock) {\n              collabFieldLocksState.get(room)?.delete(field)\n              continue\n            }\n            collabFieldLocksState.get(room)?.set(field, lock)\n          }\n        }\n      })\n      collabSocket.value.on('collabRoomDataChanged', (room: CollabRoom, data: CollabRoomData) => {\n        const dataEntries = Object.entries(data)\n        for (const [field, fieldData] of dataEntries) {\n          changeEventBus.emit({ room, field }, fieldData)\n        }\n      })\n      collabSocket.value?.on('requestToJoin', (room: CollabRoom, userId: number, timestamp: number) => {\n        requestAccessEventBus.emit({ room, userId, timestamp })\n      })\n      collabSocket.value?.on('approvedRequestToJoin', (room: CollabRoom) => {\n        approvedJoinRequestEventBus.emit({ room })\n      })\n      collabSocket.value?.on('rejectedRequestToJoin', (room: CollabRoom) => {\n        rejectedJoinRequestEventBus.emit({ room })\n      })\n      collabSocket.value?.on('requestToTakeModeration', (room: CollabRoom, userId: number, timestamp: number) => {\n        requestToTakeModerationEventBus.emit({ room, userId, timestamp })\n      })\n      collabSocket.value?.on('approvedRequestToTakeModeration', (room: CollabRoom) => {\n        approvedRequestToTakeModerationEventBus.emit({ room })\n      })\n      collabSocket.value?.on('rejectedRequestToTakeModeration', (room: CollabRoom) => {\n        rejectedRequestToTakeModerationEventBus.emit({ room })\n      })\n      collabSocket.value?.on('transferredModeration', () => {\n        showSuccessT('common.collab.alert.transferredModeration')\n      })\n      collabSocket.value?.on('kickedFromRoom', (room: CollabRoom) => {\n        showWarningT('common.collab.alert.kickedFromRoom')\n        kickedFromRoomEventBus.emit({ room })\n      })\n      collabSocket.value?.on('startCollab', async (room, callback: (data: CollabRoomPlainData) => void) => {\n        collabStartingEventBus.emit({ room, startedCallback: callback })\n      })\n      collabSocket.value.on('connect', () => {\n        /* Memberships from before a reconnect are stale; the server does not re-announce them.\n         *\n         * The write claims behind them are deliberately left alone. Socket.io drops the\n         * acknowledgement of a packet it already put on the wire (`_clearAcks`), so one emitted\n         * before the reconnect can no longer land here — but it keeps the acknowledgement of a\n         * packet still in `sendBuffer`, which it delivers on this connection. Resetting the claims\n         * would discard exactly those: a join emitted while the socket was still connecting is\n         * flushed just before this handler runs, and its acknowledgement arrives a round trip\n         * later to find its claim gone. */\n        collabRoomInfoState.clear()\n        // The server released the old connection's locks, and timed-out requests were dropped from the send buffer.\n        collabFieldLocksUnanswered.clear()\n        recovery.onConnect()\n        const connectedBefore = collabConnected.value\n        collabConnected.value = collabSocket.value?.connected ?? false\n        if (!connectedBefore) reconnectEventBus.emit('reconnect')\n      })\n      collabSocket.value.on('connect_error', (error: CollabRefusal) => {\n        collabConnected.value = collabSocket.value?.connected ?? false\n        // Still `active`: a transport error, socket.io reconnects on its own. Otherwise the server refused it.\n        if (collabSocket.value?.active) return recovery.onTransportError()\n        recovery.onRefused(error)\n      })\n      collabSocket.value.on('disconnect', (reason) => {\n        collabRoomInfoState.forEach((roomInfo: CollabRoomInfo) => (roomInfo.status = CollabStatus.Inactive))\n        collabConnected.value = collabSocket.value?.connected ?? false\n        recovery.onDisconnect(reason)\n      })\n    } catch (error) {\n      // Not `message`: with `level` beside it Sentry reads the object as scope data and drops the key.\n      logError(error as Error, { level: 'error', tags: { collabPhase: 'init' } })\n    }\n  }\n\n  return {\n    initCollab,\n  }\n}\n"],"mappings":";;;;;;;;;;AA4BA,SAAgBA,IAAgB;CAC9B,IAAM,EAAE,qBAAkBC,EAA4B,GAChD,EAAE,iBAAc,oBAAiBC,EAAU,GAC3C,EACJ,oBACA,iBACA,0BACA,qBACA,wBACA,0BACA,kCACEC,EAAuB,GACrB,EAAE,qBAAkBC,EAAuB,GAE3C,EAAE,gBAAaC,EAAU;CAgJ/B,OAAO,EACL,kBA/IuB;EACvB,IAAMC,IAAiBC,EAAgC,GACjDC,IAAoBC,EAA2B,GAC/CC,IAAyBC,EAA0B,GACnDC,IAAwBC,EAA6B,GACrDC,IAA8BC,EAAqC,GACnEC,IAA8BC,EAAqC,GACnEC,IAAkCC,EAAyC,GAC3EC,IAA0CC,EAAiD,GAC3FC,IAA0CC,EAAiD,GAC3FC,IAAyBC,EAAgC;EAE/D,IAAIC,EAAa,SAAS,CAACC,EAAc,MAAM,SAC7C;EAEF,IAAMC,IAAKD,EAAc,MAAM;EAC/B,IAAI,CAACC,GACH,EAAS,gBAAI,MAAM,+EAA+E,CAAC;OAIrG,IAAI;GACF,EAAa,QAAQA,EAAGD,EAAc,MAAM,WAAW;IACrD,YAAY,CAAC,WAAW;IACxB,MAAM;IACN,UAAU;IAEV,OAAO,MAAaE,EAAS,EAAE,QAAQC,EAAc,MAAM,CAAC;GAC9D,CAAC;GACD,IAAMC,IAAWC,EAAqB;IACpC,QAAQN,EAAa;IACrB,OAAOO;IACP,uBAAuBN,EAAc,MAAM,gBAAgB;IAC3D,sBAAsBA,EAAc,MAAM,iBAAiB;IAC3D;GACF,CAAC;GAgGD,AA/FAO,EAAiBH,EAAS,KAAK,GAE/BL,EAAa,MAAM,IAAI,GAAG,2BAA2B;IACnD,AAAIK,EAAS,mBAAmB,MAAG,EAAgB,QAAQ;GAC7D,CAAC,GACG,OAAO,SAAW,QACpB,OAAO,iBAAiB,UAAUA,EAAS,cAAc,GACzD,SAAS,iBAAiB,0BAA0B;IAClD,AAAI,SAAS,oBAAoB,aAAWA,EAAS,eAAe;GACtE,CAAC,GACD,OAAO,iBAAiB,YAAYA,EAAS,UAAU,GACvD,OAAO,iBAAiB,aAAa,MAAUA,EAAS,WAAWI,EAAM,SAAS,CAAC,IAErFT,EAAa,MAAM,GAAG,sBAAsB,MAAyB;IACnE,IAAI;KACF,AAAIU,EAAoB,IAAIC,EAAK,IAAI,KACnCD,EAAoB,IAAIC,EAAK,MAAMA,CAAI;IAE3C,SAASC,GAAO;KACd,QAAQ,MAAM,SAASA,CAAK;IAC9B;GACF,CAAC,GACDZ,EAAa,MAAM,GAAG,2BAA2B,GAAkB,MAAkC;IACnG,IAAI,CAACa,EAAOC,CAAK,GAAG;KAClB,IAAMC,IAAe,OAAO,QAAQD,CAAK;KACzC,AAAKE,EAAsB,IAAIL,CAAI,KAAK,OAAO,KAAKG,CAAK,CAAC,CAAC,WAAW,KACpEE,EAAsB,IAAIL,GAAM,IAAI,IAAII,CAAY,CAAC;KAEvD,KAAK,IAAM,CAACE,GAAOC,MAASH,GAC1B,AAAKG,IAILF,EAAsB,IAAIL,CAAI,CAAC,EAAE,IAAIM,GAAOC,CAAI,IAH9CF,EAAsB,IAAIL,CAAI,CAAC,EAAE,OAAOM,CAAK;IAKnD;GACF,CAAC,GACDjB,EAAa,MAAM,GAAG,0BAA0B,GAAkB,MAAyB;IACzF,IAAMmB,IAAc,OAAO,QAAQC,CAAI;IACvC,KAAK,IAAM,CAACH,GAAOI,MAAcF,GAC/B,EAAe,KAAK;KAAE;KAAM;IAAM,GAAGE,CAAS;GAElD,CAAC,GACDrB,EAAa,OAAO,GAAG,kBAAkB,GAAkB,GAAgB,MAAsB;IAC/F,EAAsB,KAAK;KAAE;KAAM;KAAQ;IAAU,CAAC;GACxD,CAAC,GACDA,EAAa,OAAO,GAAG,0BAA0B,MAAqB;IACpE,EAA4B,KAAK,EAAE,QAAK,CAAC;GAC3C,CAAC,GACDA,EAAa,OAAO,GAAG,0BAA0B,MAAqB;IACpE,EAA4B,KAAK,EAAE,QAAK,CAAC;GAC3C,CAAC,GACDA,EAAa,OAAO,GAAG,4BAA4B,GAAkB,GAAgB,MAAsB;IACzG,EAAgC,KAAK;KAAE;KAAM;KAAQ;IAAU,CAAC;GAClE,CAAC,GACDA,EAAa,OAAO,GAAG,oCAAoC,MAAqB;IAC9E,EAAwC,KAAK,EAAE,QAAK,CAAC;GACvD,CAAC,GACDA,EAAa,OAAO,GAAG,oCAAoC,MAAqB;IAC9E,EAAwC,KAAK,EAAE,QAAK,CAAC;GACvD,CAAC,GACDA,EAAa,OAAO,GAAG,+BAA+B;IACpD,EAAa,2CAA2C;GAC1D,CAAC,GACDA,EAAa,OAAO,GAAG,mBAAmB,MAAqB;IAE7D,AADAsB,EAAa,oCAAoC,GACjDxB,EAAuB,KAAK,EAAE,QAAK,CAAC;GACtC,CAAC,GACDE,EAAa,OAAO,GAAG,eAAe,OAAO,GAAM,MAAkD;IACnG,EAAuB,KAAK;KAAE;KAAM,iBAAiBG;IAAS,CAAC;GACjE,CAAC,GACDH,EAAa,MAAM,GAAG,iBAAiB;IAarC,AAHAU,EAAoB,MAAM,GAE1Ba,EAA2B,MAAM,GACjClB,EAAS,UAAU;IACnB,IAAMmB,IAAkBC,EAAgB;IAExC,AADA,EAAgB,QAAQzB,EAAa,OAAO,aAAa,IACpDwB,KAAiB1C,EAAkB,KAAK,WAAW;GAC1D,CAAC,GACDkB,EAAa,MAAM,GAAG,kBAAkB,MAAyB;IAG/D,IAFA,EAAgB,QAAQA,EAAa,OAAO,aAAa,IAErDA,EAAa,OAAO,QAAQ,OAAOK,EAAS,iBAAiB;IACjE,EAAS,UAAUO,CAAK;GAC1B,CAAC,GACDZ,EAAa,MAAM,GAAG,eAAe,MAAW;IAG9C,AAFAU,EAAoB,SAAS,MAA8B,EAAS,SAASgB,EAAa,QAAS,GACnG,EAAgB,QAAQ1B,EAAa,OAAO,aAAa,IACzDK,EAAS,aAAasB,CAAM;GAC9B,CAAC;EACH,SAASf,GAAO;GAEd,EAASA,GAAgB;IAAE,OAAO;IAAS,MAAM,EAAE,aAAa,OAAO;GAAE,CAAC;EAC5E;CACF,EAIA;AACF"}

package/dist/domains/collab/composables/collabRecovery.d.ts

@@ -0,0 +1,49 @@
+import { Ref } from 'vue';
+import { CollabConnectionStateType } from '../types/Collab';
+export declare const COLLAB_RETRY_DELAYS_MS: number[];
+export declare const COLLAB_BEFORE_RECONNECT_TIMEOUT_MS = 20000;
+export declare const COLLAB_STUCK_REPORT_MS: number;
+export type CollabRefusal = Error & {
+    data?: {
+        reason?: string;
+    };
+};
+interface CollabRecoverySocket {
+    readonly connected: boolean;
+    readonly active: boolean;
+    connect: () => unknown;
+    disconnect: () => unknown;
+}
+interface CollabRecoveryOptions {
+    socket: CollabRecoverySocket;
+    state: Ref<CollabConnectionStateType>;
+    beforeReconnect: () => unknown;
+    isSameIdentity: () => boolean | undefined;
+    logError: (error: Error, context: {
+        level: 'error' | 'warning';
+        tags: Record<string, string>;
+        fingerprint?: string[];
+    }) => void;
+}
+/**
+ * Brings a socket the server refused back, once per refusal and never under another account.
+ *
+ * Transport errors are socket.io's: it reconnects on its own, and nothing here runs for them. A refusal (the
+ * server's `connect_error`, after which the socket is no longer `active`) asks `beforeReconnect` what to do and
+ * connects the same socket again only on `ready`. A token refresh spent on a transport error used to leave the
+ * refusal that followed it, typically after a night, with nothing to recover by.
+ */
+export declare function createCollabRecovery({ socket, state, beforeReconnect, isSameIdentity, logError, }: CollabRecoveryOptions): {
+    /** The user's "try again": also out of a terminal state, with the retry delays and the refusals counted anew. */
+    retry: () => Promise<void>;
+    retryIfWaiting: () => void;
+    onTransportError: () => void;
+    onRefused: (error: CollabRefusal) => void;
+    onConnect: () => void;
+    onDisconnect: (reason: string) => void;
+    /** socket.io reconnects without `beforeReconnect`; stop it before cookies of another account are sent. */
+    onReconnectAttempt: () => boolean;
+    onPageHide: () => void;
+    onPageShow: (persisted: boolean) => void;
+};
+export {};

package/dist/domains/collab/composables/collabRecovery.js

@@ -0,0 +1,99 @@
+import { CollabConnectionState as e, CollabReconnectVerdict as t } from "../types/Collab.js";
+// src/domains/collab/composables/collabRecovery.ts
+var n = [
+	5e3,
+	15e3,
+	3e4,
+	6e4,
+	3e5
+], r = 2e4, i = 9e5, a = new Set(Object.values(t)), o = /* @__PURE__ */ new Set([
+	e.SessionEnded,
+	e.IdentityChanged,
+	e.Rejected
+]);
+function s({ socket: s, state: c, beforeReconnect: l, isSameIdentity: u, logError: d }) {
+	let f = 0, p, m = !1, h = 0, g = 0, _, v, y = !1, b = /* @__PURE__ */ new Set(), x = (e) => {
+		c.value !== e && (console.info(`[common-admin] collab connection: ${c.value} -> ${e}`), c.value = e);
+	}, S = (e, t, n, r = {}, i) => {
+		y || b.has(e) || (b.add(e), d(t, {
+			level: n,
+			tags: {
+				collabPhase: e,
+				...r
+			},
+			...i && { fingerprint: i }
+		}));
+	}, C = () => {
+		clearTimeout(_), _ = void 0;
+	}, w = () => {
+		clearTimeout(v), v = void 0;
+	}, T = () => o.has(c.value), E = () => {
+		v ||= setTimeout(() => {
+			v = void 0, s.connected || T() || S("transportStuck", /* @__PURE__ */ Error(`Collaboration not connected for ${i / 6e4} minutes (${c.value})`), "warning");
+		}, i);
+	}, D = (e) => {
+		f++, C(), w(), x(e);
+	}, O = async () => {
+		let e;
+		try {
+			let n = await Promise.race([Promise.resolve().then(l), new Promise((t, n) => {
+				e = setTimeout(() => n(/* @__PURE__ */ Error(`beforeReconnect did not settle in ${r} ms`)), r);
+			})]);
+			if (n === void 0) return t.Ready;
+			if (a.has(n)) return n;
+			throw Error(`beforeReconnect returned an unknown verdict: ${String(n)}`);
+		} catch (e) {
+			return S("beforeReconnect", e, "warning"), t.RetryLater;
+		} finally {
+			clearTimeout(e);
+		}
+	}, k = () => {
+		C();
+		let e = n[Math.min(g++, n.length - 1)];
+		_ = setTimeout(() => void A(), e);
+	}, A = () => y || s.connected || s.active ? Promise.resolve() : (p ??= (async () => {
+		let n = ++f;
+		try {
+			C(), x(e.Reconnecting), E();
+			let r = await O();
+			if (n !== f || y || s.connected) return;
+			if (r === t.SessionEnded) return D(e.SessionEnded);
+			if (r === t.IdentityChanged) return D(e.IdentityChanged);
+			if (r === t.RetryLater) return x(e.WaitingForNetwork), k();
+			m = !0, s.connect();
+		} finally {
+			p = void 0;
+		}
+	})(), p);
+	return {
+		retry: () => (h = 0, g = 0, A()),
+		retryIfWaiting: () => {
+			c.value === e.WaitingForNetwork && A();
+		},
+		onTransportError: () => {
+			c.value === e.Connected && x(e.Reconnecting), E();
+		},
+		onRefused: (t) => {
+			let n = t.data?.reason || t.message || "none";
+			if (n === "identityMismatch") return D(e.IdentityChanged);
+			if (m && h++, m = !1, h < 2) return void A();
+			D(e.Rejected), S("connectRejected", /* @__PURE__ */ Error(`Collaboration connection rejected: ${n}`), "error", { collabRejectReason: n }, ["collab-connect-rejected", n]);
+		},
+		onConnect: () => {
+			f++, m = !1, h = 0, g = 0, C(), w(), x(e.Connected);
+		},
+		onDisconnect: (t) => {
+			c.value === e.Connected && x(e.Reconnecting), E(), t === "io server disconnect" && A();
+		},
+		onReconnectAttempt: () => u() === !1 && (s.disconnect(), D(e.IdentityChanged), !0),
+		onPageHide: () => {
+			y = !0, f++, C(), w();
+		},
+		onPageShow: (e) => {
+			e && (y = !1, T() || s.connected || s.active || A());
+		}
+	};
+}
+export { r as COLLAB_BEFORE_RECONNECT_TIMEOUT_MS, n as COLLAB_RETRY_DELAYS_MS, i as COLLAB_STUCK_REPORT_MS, s as createCollabRecovery };
+
+//# sourceMappingURL=collabRecovery.js.map

package/dist/domains/collab/composables/collabRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collabRecovery.js","names":["COLLAB_RETRY_DELAYS_MS","COLLAB_BEFORE_RECONNECT_TIMEOUT_MS","COLLAB_STUCK_REPORT_MS","VERDICTS","CollabReconnectVerdict","TERMINAL","CollabConnectionState","createCollabRecovery","generation","recovering","connectedAfterReady","readyRefusals","retryIndex","retryTimer","stuckTimer","paused","reported","setState","state","next","reportOnce","phase","logError","error","tags","fingerprint","clearRetry","clearStuck","isTerminal","armStuck","socket","settle","askBeforeReconnect","timer","result","beforeReconnect","reject","scheduleRetry","delay","recover","mine","verdict","reason","isSameIdentity","persisted"],"sources":["../../../../src/domains/collab/composables/collabRecovery.ts"],"sourcesContent":["import type { Ref } from 'vue'\nimport {\n  CollabConnectionState,\n  type CollabConnectionStateType,\n  CollabReconnectVerdict,\n  type CollabReconnectVerdictType,\n} from '@/domains/collab/types/Collab'\n\nexport const COLLAB_RETRY_DELAYS_MS = [5_000, 15_000, 30_000, 60_000, 300_000]\nexport const COLLAB_BEFORE_RECONNECT_TIMEOUT_MS = 20_000\nexport const COLLAB_STUCK_REPORT_MS = 15 * 60_000\n\nconst VERDICTS: ReadonlySet<unknown> = new Set(Object.values(CollabReconnectVerdict))\nconst TERMINAL: ReadonlySet<CollabConnectionStateType> = new Set([\n  CollabConnectionState.SessionEnded,\n  CollabConnectionState.IdentityChanged,\n  CollabConnectionState.Rejected,\n])\n\nexport type CollabRefusal = Error & { data?: { reason?: string } }\n\ninterface CollabRecoverySocket {\n  readonly connected: boolean\n  readonly active: boolean\n  connect: () => unknown\n  disconnect: () => unknown\n}\n\ninterface CollabRecoveryOptions {\n  socket: CollabRecoverySocket\n  state: Ref<CollabConnectionStateType>\n  beforeReconnect: () => unknown\n  isSameIdentity: () => boolean | undefined\n  logError: (\n    error: Error,\n    context: { level: 'error' | 'warning'; tags: Record<string, string>; fingerprint?: string[] }\n  ) => void\n}\n\n/**\n * Brings a socket the server refused back, once per refusal and never under another account.\n *\n * Transport errors are socket.io's: it reconnects on its own, and nothing here runs for them. A refusal (the\n * server's `connect_error`, after which the socket is no longer `active`) asks `beforeReconnect` what to do and\n * connects the same socket again only on `ready`. A token refresh spent on a transport error used to leave the\n * refusal that followed it, typically after a night, with nothing to recover by.\n */\nexport function createCollabRecovery({\n  socket,\n  state,\n  beforeReconnect,\n  isSameIdentity,\n  logError,\n}: CollabRecoveryOptions) {\n  let generation = 0\n  let recovering: Promise<void> | undefined\n  let connectedAfterReady = false\n  let readyRefusals = 0\n  let retryIndex = 0\n  let retryTimer: ReturnType<typeof setTimeout> | undefined\n  let stuckTimer: ReturnType<typeof setTimeout> | undefined\n  let paused = false\n  const reported = new Set<string>()\n\n  const setState = (next: CollabConnectionStateType) => {\n    if (state.value === next) return\n    // A console line is a Sentry breadcrumb: the state a later error happened in.\n    console.info(`[common-admin] collab connection: ${state.value} -> ${next}`)\n    state.value = next\n  }\n\n  const reportOnce = (\n    phase: string,\n    error: Error,\n    level: 'error' | 'warning',\n    tags: Record<string, string> = {},\n    fingerprint?: string[]\n  ) => {\n    if (paused || reported.has(phase)) return\n    reported.add(phase)\n    logError(error, { level, tags: { collabPhase: phase, ...tags }, ...(fingerprint && { fingerprint }) })\n  }\n\n  const clearRetry = () => {\n    clearTimeout(retryTimer)\n    retryTimer = undefined\n  }\n  const clearStuck = () => {\n    clearTimeout(stuckTimer)\n    stuckTimer = undefined\n  }\n  const isTerminal = () => TERMINAL.has(state.value)\n\n  // Without it a server out of reach for good (DNS, TLS, CORS) never reports anything.\n  const armStuck = () => {\n    if (stuckTimer) return\n    stuckTimer = setTimeout(() => {\n      stuckTimer = undefined\n      if (socket.connected || isTerminal()) return\n      reportOnce(\n        'transportStuck',\n        new Error(`Collaboration not connected for ${COLLAB_STUCK_REPORT_MS / 60_000} minutes (${state.value})`),\n        'warning'\n      )\n    }, COLLAB_STUCK_REPORT_MS)\n  }\n\n  const settle = (next: CollabConnectionStateType) => {\n    generation++\n    clearRetry()\n    clearStuck()\n    setState(next)\n  }\n\n  const askBeforeReconnect = async (): Promise<CollabReconnectVerdictType> => {\n    let timer: ReturnType<typeof setTimeout> | undefined\n    try {\n      const result = await Promise.race([\n        Promise.resolve().then(beforeReconnect),\n        new Promise((_, reject) => {\n          timer = setTimeout(\n            () => reject(new Error(`beforeReconnect did not settle in ${COLLAB_BEFORE_RECONNECT_TIMEOUT_MS} ms`)),\n            COLLAB_BEFORE_RECONNECT_TIMEOUT_MS\n          )\n        }),\n      ])\n      if (result === undefined) return CollabReconnectVerdict.Ready\n      if (VERDICTS.has(result)) return result as CollabReconnectVerdictType\n      throw new Error(`beforeReconnect returned an unknown verdict: ${String(result)}`)\n    } catch (error) {\n      // Fail closed: connecting with what failed to refresh would only be refused again.\n      reportOnce('beforeReconnect', error as Error, 'warning')\n      return CollabReconnectVerdict.RetryLater\n    } finally {\n      clearTimeout(timer)\n    }\n  }\n\n  const scheduleRetry = () => {\n    clearRetry()\n    const delay = COLLAB_RETRY_DELAYS_MS[Math.min(retryIndex++, COLLAB_RETRY_DELAYS_MS.length - 1)]\n    retryTimer = setTimeout(() => void recover(), delay)\n  }\n\n  const recover = (): Promise<void> => {\n    // A handshake, or socket.io's own reconnection, is already on its way.\n    if (paused || socket.connected || socket.active) return Promise.resolve()\n    recovering ??= (async () => {\n      const mine = ++generation\n      try {\n        clearRetry()\n        setState(CollabConnectionState.Reconnecting)\n        armStuck()\n        const verdict = await askBeforeReconnect()\n        // A connect, a terminal state or a pagehide came while the hook ran.\n        if (mine !== generation || paused || socket.connected) return\n        if (verdict === CollabReconnectVerdict.SessionEnded) return settle(CollabConnectionState.SessionEnded)\n        if (verdict === CollabReconnectVerdict.IdentityChanged) return settle(CollabConnectionState.IdentityChanged)\n        if (verdict === CollabReconnectVerdict.RetryLater) {\n          setState(CollabConnectionState.WaitingForNetwork)\n          return scheduleRetry()\n        }\n        connectedAfterReady = true\n        socket.connect()\n      } finally {\n        recovering = undefined\n      }\n    })()\n    return recovering\n  }\n\n  return {\n    /** The user's \"try again\": also out of a terminal state, with the retry delays and the refusals counted anew. */\n    retry: (): Promise<void> => {\n      readyRefusals = 0\n      retryIndex = 0\n      return recover()\n    },\n    retryIfWaiting: () => {\n      if (state.value === CollabConnectionState.WaitingForNetwork) void recover()\n    },\n    onTransportError: () => {\n      if (state.value === CollabConnectionState.Connected) setState(CollabConnectionState.Reconnecting)\n      armStuck()\n    },\n    onRefused: (error: CollabRefusal) => {\n      const reason = error.data?.reason || error.message || 'none'\n      if (reason === 'identityMismatch') return settle(CollabConnectionState.IdentityChanged)\n      if (connectedAfterReady) readyRefusals++\n      connectedAfterReady = false\n      // Refused twice with a token the admin called good: no refresh helps, someone has to look.\n      if (readyRefusals < 2) return void recover()\n      settle(CollabConnectionState.Rejected)\n      reportOnce(\n        'connectRejected',\n        new Error(`Collaboration connection rejected: ${reason}`),\n        'error',\n        { collabRejectReason: reason },\n        ['collab-connect-rejected', reason]\n      )\n    },\n    onConnect: () => {\n      generation++\n      connectedAfterReady = false\n      readyRefusals = 0\n      retryIndex = 0\n      clearRetry()\n      clearStuck()\n      setState(CollabConnectionState.Connected)\n    },\n    onDisconnect: (reason: string) => {\n      if (state.value === CollabConnectionState.Connected) setState(CollabConnectionState.Reconnecting)\n      armStuck()\n      if (reason === 'io server disconnect') void recover()\n    },\n    /** socket.io reconnects without `beforeReconnect`; stop it before cookies of another account are sent. */\n    onReconnectAttempt: (): boolean => {\n      if (isSameIdentity() !== false) return false\n      socket.disconnect()\n      settle(CollabConnectionState.IdentityChanged)\n      return true\n    },\n    onPageHide: () => {\n      paused = true\n      generation++\n      clearRetry()\n      clearStuck()\n    },\n    onPageShow: (persisted: boolean) => {\n      if (!persisted) return\n      paused = false\n      if (!isTerminal() && !socket.connected && !socket.active) void recover()\n    },\n  }\n}\n"],"mappings":"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"}