@anzusystems/common-admin 1.49.0 → 2.0.0-rc.10

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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"}

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

@@ -0,0 +1,43 @@
+import { CollabAccessRoomStatusType, CollabJoinAckOptions, CollabRequestToJoinStatusType, CollabRequestToTakeModerationStatusType, CollabRoom, CollabRoomInfo, CollabRoomOptions, CollabRoomPlainData } from '../types/Collab';
+import { Fn } from '@vueuse/core';
+import { AddToCachedArgs } from '../../cached/composables/defineCached';
+import { IntegerId } from '../../../shared/types/common';
+export declare function useCollabRoom(room: CollabRoom, watchForNewUsers?: boolean, addToCachedUsers?: ((...args: AddToCachedArgs<IntegerId>) => void) | undefined, fetchCachedUsers?: (() => unknown) | undefined, disableAutoUnsubscribe?: boolean): {
+    subscribeCollabRoomInfo: () => void;
+    unsubscribeCollabRoomInfo: () => void;
+    joinCollabRoom: (options?: Partial<CollabRoomOptions>, { ackTimeout }?: CollabJoinAckOptions) => Promise<CollabAccessRoomStatusType>;
+    leaveCollabRoom: ({ ackTimeout }?: CollabJoinAckOptions) => Promise<void>;
+    requestToJoinCollabRoom: () => Promise<CollabRequestToJoinStatusType>;
+    approveRequestToJoinCollabRoom: (userId: number) => void;
+    rejectRequestToJoinCollabRoom: (userId: number) => void;
+    addJoinRequestListener: (callback: (userId: number, timestamp: number) => void) => void;
+    addCollabReconnectListener: (callback: () => void) => void;
+    addApprovedJoinRequestListener: (callback: () => void) => void;
+    addRejectedJoinRequestListener: (callback: () => void) => void;
+    requestToTakeModeration: () => Promise<CollabRequestToTakeModerationStatusType>;
+    approveRequestToTakeModeration: () => void;
+    rejectRequestToTakeModeration: () => void;
+    addRequestToTakeModerationListener: (callback: (userId: number, timestamp: number) => void) => void;
+    addApprovedRequestToTakeModerationListener: (callback: () => void) => void;
+    addRejectedRequestToTakeModerationListener: (callback: () => void) => void;
+    enteredCollabRoom: () => void;
+    kickUserFromRoom: (userId: number) => void;
+    purgeRoom: () => void;
+    transferModeration: (userId: number) => void;
+    addKickedFromRoomListener: (callback: () => void) => void;
+    addCollabStartingListener: (callback: (startedCallback: (data: CollabRoomPlainData) => void) => void) => void;
+    fetchRoomInfo: (room: CollabRoom) => Promise<CollabRoomInfo>;
+    collabRoomInfo: import('vue').ComputedRef<CollabRoomInfo>;
+    collabRoomLocks: import('vue').ComputedRef<Map<string, import('../types/Collab').CollabUserIdNullable>>;
+    collabFieldDataBufferState: import('vue').Reactive<Map<string, Map<string, unknown>>>;
+    alertedOccupiedRooms: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    unsubscribeJoinRequestListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeApprovedJoinRequestListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeRejectedJoinRequestListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeRequestToTakeModerationListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeApprovedRequestToTakeModerationListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeRejectedRequestToTakeModerationListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeKickedFromRoomListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeCollabStartingListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+    unsubscribeCollabReconnectListener: import('vue').Ref<Fn | undefined, Fn | undefined>;
+};

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

@@ -0,0 +1,166 @@
+import { CollabAccessRoomStatus as e, CollabRequestToJoinStatus as t, CollabRequestToTakeModerationStatus as n, CollabStatus as r, isCollabSuccessAccessRoomCallback as i } from "../types/Collab.js";
+import { useCollabApprovedJoinRequestEventBus as a, useCollabApprovedRequestToTakeModerationEventBus as o, useCollabJoinRequestEventBus as s, useCollabKickedFromRoomEventBus as c, useCollabReconnectEventBus as ee, useCollabRejectedJoinRequestEventBus as te, useCollabRejectedRequestToTakeModerationEventBus as ne, useCollabRequestToTakeModerationEventBus as re, useCollabStartingEventBus as ie } from "./collabEventBus.js";
+import { useCollabStateInternal as ae } from "./collabState.js";
+import { isDefined as l, isUndefined as u } from "../../../shared/utils/common.js";
+import { useCommonAdminCollabOptions as d } from "./commonAdminCollabOptions.js";
+import { computed as f, ref as p, watch as m } from "vue";
+import { tryOnBeforeUnmount as h } from "@vueuse/core";
+// src/domains/collab/composables/collabRoom.ts
+var g = p(/* @__PURE__ */ new Set()), _ = 5e3;
+function v(v, oe = !1, y = void 0, b = void 0, se = !1) {
+	let { collabSocket: x, collabRoomInfoState: S, collabFieldDataBufferState: C, collabFieldLocksState: w, claimRoomInfoWrite: T, collabConnectionHopeless: E } = ae(), D = ee(), O = p(), k = p(), A = s(), j = p(), M = p(), ce = a(), N = p(), P = p(), le = te(), F = p(), I = p(), L = re(), R = p(), z = p(), B = o(), V = p(), H = p(), U = ne(), W = p(), G = p(), ue = c(), K = p(), q = p(), de = ie(), J = p(), Y = p(), fe = () => {
+		l(k.value) && k.value();
+	}, pe = (e) => {
+		e.room === v && l(M.value) && M.value(e.userId, e.timestamp);
+	}, me = (e) => {
+		e.room === v && l(P.value) && P.value();
+	}, he = (e) => {
+		e.room === v && l(I.value) && I.value();
+	}, ge = (e) => {
+		e.room === v && l(z.value) && z.value(e.userId, e.timestamp);
+	}, _e = (e) => {
+		e.room === v && l(H.value) && H.value();
+	}, ve = (e) => {
+		e.room === v && l(G.value) && G.value();
+	}, ye = (e) => {
+		e.room === v && l(q.value) && q.value();
+	}, be = (e) => {
+		e.room === v && l(Y.value) && Y.value(e.startedCallback);
+	}, xe = (e) => {
+		M.value = e, j.value = A.on(pe);
+	}, Se = (e) => {
+		P.value = e, N.value = ce.on(me);
+	}, Ce = (e) => {
+		I.value = e, F.value = le.on(he);
+	}, we = (e) => {
+		z.value = e, R.value = L.on(ge);
+	}, Te = (e) => {
+		H.value = e, V.value = B.on(_e);
+	}, Ee = (e) => {
+		G.value = e, W.value = U.on(ve);
+	}, De = (e) => {
+		k.value = e, O.value = D.on(fe);
+	}, Oe = (e) => {
+		q.value = e, K.value = ue.on(ye);
+	}, ke = (e) => {
+		Y.value = e, J.value = de.on(be);
+	};
+	h(() => {
+		se || (l(O.value) && O.value(), l(j.value) && j.value(), l(N.value) && N.value(), l(F.value) && F.value(), l(R.value) && R.value(), l(V.value) && V.value(), l(W.value) && W.value(), l(K.value) && K.value(), l(J.value) && J.value());
+	});
+	let { collabOptions: X } = d(), Ae = () => {
+		if (!X.value.enabled || u(x.value)) return;
+		let e = T(v);
+		x.value.emit("subscribeCollabRoomInfo", v, (t) => {
+			e() && S.set(v, t.room);
+		});
+	}, je = () => {
+		if (!X.value.enabled || u(x.value)) return;
+		let e = T(v);
+		x.value.emit("unsubscribeCollabRoomInfo", v, (t) => {
+			e() && S.set(v, t.room);
+		});
+	}, Me = async (t = {}, { ackTimeout: n = _ } = {}) => new Promise((a, o) => {
+		if (!X.value.enabled || u(x.value) || E()) return o(e.Failed);
+		let s = T(v);
+		x.value?.timeout(n).emit("joinCollabRoom", v, t, (t, n) => {
+			t ? (c(), o(e.Failed)) : i(n) ? (s() && (S.set(v, n.room), n.room.status === r.Active && C.delete(v)), a(n.status)) : (c(), o(n.status));
+		});
+		function c() {
+			s() && S.set(v, Q());
+		}
+	}), Ne = ({ ackTimeout: e = _ } = {}) => new Promise((t) => {
+		if (!X.value.enabled || u(x.value)) return void t();
+		C.delete(v);
+		let n = T(v);
+		x.value?.timeout(e).emit("leaveCollabRoom", v, (e, r) => {
+			!e && n() && i(r) && S.set(v, r.room), t();
+		});
+	}), Pe = () => {
+		X.value.enabled && !u(x.value) && (w.set(v, /* @__PURE__ */ new Map()), x.value?.emit("enteredCollabRoom", v));
+	}, Fe = () => new Promise((e, n) => {
+		if (!X.value.enabled || u(x.value) || E()) return n(t.Failed);
+		x.value?.timeout(2e3).emit("requestToJoin", v, (/* @__PURE__ */ new Date()).getTime(), (r, i) => {
+			r ? n(t.Failed) : i.status === t.Ok ? e(i.status) : n(i.status);
+		});
+	}), Z = (e) => {
+		X.value.enabled && !u(x.value) && x.value.emit("approveRequestToJoin", v, e);
+	}, Ie = (e) => {
+		X.value.enabled && !u(x.value) && x.value.emit("rejectRequestToJoin", v, e);
+	}, Le = async () => new Promise((e, t) => {
+		if (!X.value.enabled || u(x.value) || E()) return t(n.Failed);
+		x.value?.timeout(2e3).emit("requestToTakeModeration", v, (/* @__PURE__ */ new Date()).getTime(), (r, i) => {
+			r ? t(n.Failed) : i.status === n.Ok ? e(i.status) : t(i.status);
+		});
+	}), Re = () => {
+		X.value.enabled && !u(x.value) && x.value.emit("approveRequestToTakeModeration", v);
+	}, ze = () => {
+		X.value.enabled && !u(x.value) && x.value.emit("rejectRequestToTakeModeration", v);
+	}, Be = (e) => {
+		X.value.enabled && !u(x.value) && x.value.emit("kickUserFromRoom", v, e);
+	}, Ve = () => {
+		X.value.enabled && !u(x.value) && x.value.emit("purgeRoom", v);
+	}, He = (e) => {
+		X.value.enabled && !u(x.value) && x.value.emit("transferModeration", v, e);
+	}, Q = () => ({
+		name: "",
+		status: r.Inactive,
+		users: [],
+		moderator: null,
+		options: {}
+	}), Ue = async (e) => {
+		let t = Q();
+		return new Promise((n) => {
+			if (!X.value.enabled || u(x.value)) return n(t);
+			x.value?.timeout(500).emit("fetchRoomsInfo", [e], (r, i) => {
+				if (r) return void n(t);
+				let a = i[e];
+				return u(a) ? void n(t) : (u(y) || y(a.users), u(b) || b(), n(a));
+			});
+		});
+	}, $ = f(() => S.get(v) ?? Q());
+	return oe && m($, (e) => {
+		e.users.length && (u(y) || y(e.users), u(b) || b());
+	}, { immediate: !0 }), {
+		subscribeCollabRoomInfo: Ae,
+		unsubscribeCollabRoomInfo: je,
+		joinCollabRoom: Me,
+		leaveCollabRoom: Ne,
+		requestToJoinCollabRoom: Fe,
+		approveRequestToJoinCollabRoom: Z,
+		rejectRequestToJoinCollabRoom: Ie,
+		addJoinRequestListener: xe,
+		addCollabReconnectListener: De,
+		addApprovedJoinRequestListener: Se,
+		addRejectedJoinRequestListener: Ce,
+		requestToTakeModeration: Le,
+		approveRequestToTakeModeration: Re,
+		rejectRequestToTakeModeration: ze,
+		addRequestToTakeModerationListener: we,
+		addApprovedRequestToTakeModerationListener: Te,
+		addRejectedRequestToTakeModerationListener: Ee,
+		enteredCollabRoom: Pe,
+		kickUserFromRoom: Be,
+		purgeRoom: Ve,
+		transferModeration: He,
+		addKickedFromRoomListener: Oe,
+		addCollabStartingListener: ke,
+		fetchRoomInfo: Ue,
+		collabRoomInfo: $,
+		collabRoomLocks: f(() => w.get(v) ?? /* @__PURE__ */ new Map()),
+		collabFieldDataBufferState: C,
+		alertedOccupiedRooms: g,
+		unsubscribeJoinRequestListener: j,
+		unsubscribeApprovedJoinRequestListener: N,
+		unsubscribeRejectedJoinRequestListener: F,
+		unsubscribeRequestToTakeModerationListener: R,
+		unsubscribeApprovedRequestToTakeModerationListener: V,
+		unsubscribeRejectedRequestToTakeModerationListener: W,
+		unsubscribeKickedFromRoomListener: K,
+		unsubscribeCollabStartingListener: J,
+		unsubscribeCollabReconnectListener: O
+	};
+}
+export { v as useCollabRoom };
+
+//# sourceMappingURL=collabRoom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collabRoom.js","names":["alertedOccupiedRooms","ref","ACK_TIMEOUT","useCollabRoom","useCollabStateInternal","reconnectEventBus","useCollabReconnectEventBus","unsubscribeCollabReconnectListener","reconnectCallback","joinRequestEventBus","useCollabJoinRequestEventBus","unsubscribeJoinRequestListener","joinRequestCallback","approvedJoinRequestEventBus","useCollabApprovedJoinRequestEventBus","unsubscribeApprovedJoinRequestListener","approvedJoinRequestCallback","rejectedJoinRequestEventBus","useCollabRejectedJoinRequestEventBus","unsubscribeRejectedJoinRequestListener","rejectedJoinRequestCallback","requestToTakeModerationEventBus","useCollabRequestToTakeModerationEventBus","unsubscribeRequestToTakeModerationListener","requestToTakeModerationCallback","approvedRequestToTakeModerationEventBus","useCollabApprovedRequestToTakeModerationEventBus","unsubscribeApprovedRequestToTakeModerationListener","approvedRequestToTakeModerationCallback","rejectedRequestToTakeModerationEventBus","useCollabRejectedRequestToTakeModerationEventBus","unsubscribeRejectedRequestToTakeModerationListener","rejectedRequestToTakeModerationCallback","kickedFromRoomEventBus","useCollabKickedFromRoomEventBus","unsubscribeKickedFromRoomListener","kickedFromRoomCallback","collabStartingEventBus","useCollabStartingEventBus","unsubscribeCollabStartingListener","collabStartingCallback","reconnectEventBusListener","isDefined","joinRequestEventBusListener","event","room","approvedJoinRequestEventBusListener","rejectedJoinRequestEventBusListener","requestToTakeModerationEventBusListener","approvedRequestToTakeModerationEventBusListener","rejectedRequestToTakeModerationEventBusListener","kickedFromCollabRookEventBusListener","collabStartingEventBusListener","addJoinRequestListener","callback","addApprovedJoinRequestListener","addRejectedJoinRequestListener","addRequestToTakeModerationListener","addApprovedRequestToTakeModerationListener","addRejectedRequestToTakeModerationListener","addCollabReconnectListener","addKickedFromRoomListener","addCollabStartingListener","disableAutoUnsubscribe","useCommonAdminCollabOptions","subscribeCollabRoomInfo","collabOptions","isUndefined","collabSocket","isNewestWrite","claimRoomInfoWrite","collabRoomInfoState","response","unsubscribeCollabRoomInfo","joinCollabRoom","collabConnectionHopeless","reject","CollabAccessRoomStatus","ackTimeout","options","error","markRoomInactiveOnFailedClaim","isCollabSuccessAccessRoomCallback","CollabStatus","collabFieldDataBufferState","resolve","createDefaultCollabRoomInfo","leaveCollabRoom","enteredCollabRoom","collabFieldLocksState","requestToJoinCollabRoom","CollabRequestToJoinStatus","approveRequestToJoinCollabRoom","userId","rejectRequestToJoinCollabRoom","requestToTakeModeration","CollabRequestToTakeModerationStatus","approveRequestToTakeModeration","rejectRequestToTakeModeration","kickUserFromRoom","purgeRoom","transferModeration","fetchRoomInfo","baseRoomInfo","roomInfo","addToCachedUsers","fetchCachedUsers","collabRoomInfo","computed","watchForNewUsers","watch","newValue"],"sources":["../../../../src/domains/collab/composables/collabRoom.ts"],"sourcesContent":["import {\n  type CollabAccessRoomCallbackTypes,\n  CollabAccessRoomStatus,\n  type CollabAccessRoomStatusType,\n  type CollabFieldLock,\n  type CollabFieldName,\n  type CollabJoinAckOptions,\n  CollabRequestToJoinStatus,\n  type CollabRequestToJoinStatusCallback,\n  type CollabRequestToJoinStatusType,\n  CollabRequestToTakeModerationStatus,\n  type CollabRequestToTakeModerationStatusCallback,\n  type CollabRequestToTakeModerationStatusType,\n  type CollabRoom,\n  type CollabRoomInfo,\n  type CollabRoomInfoCallback,\n  type CollabRoomOptions,\n  type CollabRoomPlainData,\n  type CollabRoomsInfo,\n  CollabStatus,\n  isCollabSuccessAccessRoomCallback,\n} from '@/domains/collab/types/Collab'\nimport { computed, ref, watch } from 'vue'\nimport {\n  type CollabApprovedJoinRequestEvent,\n  type CollabApprovedRequestToTakeModerationEvent,\n  type CollabJoinRequestEvent,\n  type CollabKickedFromRoomEvent,\n  type CollabRejectedJoinRequestEvent,\n  type CollabRejectedRequestToTakeModerationEvent,\n  type CollabRequestToTakeModerationEvent,\n  type CollabStartingEvent,\n  useCollabApprovedJoinRequestEventBus,\n  useCollabApprovedRequestToTakeModerationEventBus,\n  useCollabJoinRequestEventBus,\n  useCollabKickedFromRoomEventBus,\n  useCollabReconnectEventBus,\n  useCollabRejectedJoinRequestEventBus,\n  useCollabRejectedRequestToTakeModerationEventBus,\n  useCollabRequestToTakeModerationEventBus,\n  useCollabStartingEventBus,\n} from '@/domains/collab/composables/collabEventBus'\nimport type { Fn } from '@vueuse/core'\nimport { tryOnBeforeUnmount } from '@vueuse/core'\nimport { useCollabStateInternal } from '@/domains/collab/composables/collabState'\nimport { isDefined, isUndefined } from '@/shared/utils/common'\nimport { useCommonAdminCollabOptions } from '@/domains/collab/composables/commonAdminCollabOptions'\nimport type { AddToCachedArgs } from '@/domains/cached/composables/defineCached'\nimport type { IntegerId } from '@/shared/types/common'\n\nconst alertedOccupiedRooms = ref(new Set<CollabRoom>())\nconst ACK_TIMEOUT = 5000\n\nexport function useCollabRoom(\n  room: CollabRoom,\n  watchForNewUsers: boolean = false,\n  addToCachedUsers: ((...args: AddToCachedArgs<IntegerId>) => void) | undefined = undefined,\n  // Called fire-and-forget; any fetch fits, `defineCached().fetch` included.\n  fetchCachedUsers: (() => unknown) | undefined = undefined,\n  disableAutoUnsubscribe = false\n) {\n  const {\n    collabSocket,\n    collabRoomInfoState,\n    collabFieldDataBufferState,\n    collabFieldLocksState,\n    claimRoomInfoWrite,\n    collabConnectionHopeless,\n  } = useCollabStateInternal()\n\n  const reconnectEventBus = useCollabReconnectEventBus()\n  const unsubscribeCollabReconnectListener = ref<undefined | Fn>()\n  const reconnectCallback = ref<undefined | Fn>()\n\n  const joinRequestEventBus = useCollabJoinRequestEventBus()\n  const unsubscribeJoinRequestListener = ref<undefined | Fn>()\n  const joinRequestCallback = ref<undefined | ((userId: number, timestamp: number) => void)>()\n\n  const approvedJoinRequestEventBus = useCollabApprovedJoinRequestEventBus()\n  const unsubscribeApprovedJoinRequestListener = ref<undefined | Fn>()\n  const approvedJoinRequestCallback = ref<undefined | Fn>()\n\n  const rejectedJoinRequestEventBus = useCollabRejectedJoinRequestEventBus()\n  const unsubscribeRejectedJoinRequestListener = ref<undefined | Fn>()\n  const rejectedJoinRequestCallback = ref<undefined | Fn>()\n\n  const requestToTakeModerationEventBus = useCollabRequestToTakeModerationEventBus()\n  const unsubscribeRequestToTakeModerationListener = ref<undefined | Fn>()\n  const requestToTakeModerationCallback = ref<undefined | ((userId: number, timestamp: number) => void)>()\n\n  const approvedRequestToTakeModerationEventBus = useCollabApprovedRequestToTakeModerationEventBus()\n  const unsubscribeApprovedRequestToTakeModerationListener = ref<undefined | Fn>()\n  const approvedRequestToTakeModerationCallback = ref<undefined | Fn>()\n\n  const rejectedRequestToTakeModerationEventBus = useCollabRejectedRequestToTakeModerationEventBus()\n  const unsubscribeRejectedRequestToTakeModerationListener = ref<undefined | Fn>()\n  const rejectedRequestToTakeModerationCallback = ref<undefined | Fn>()\n\n  const kickedFromRoomEventBus = useCollabKickedFromRoomEventBus()\n  const unsubscribeKickedFromRoomListener = ref<undefined | Fn>()\n  const kickedFromRoomCallback = ref<undefined | Fn>()\n\n  const collabStartingEventBus = useCollabStartingEventBus()\n  const unsubscribeCollabStartingListener = ref<undefined | Fn>()\n  const collabStartingCallback = ref<undefined | ((startedCallback: (data: CollabRoomPlainData) => void) => void)>()\n\n  const reconnectEventBusListener = () => {\n    if (isDefined(reconnectCallback.value)) {\n      reconnectCallback.value()\n    }\n  }\n\n  const joinRequestEventBusListener = (event: CollabJoinRequestEvent) => {\n    if (event.room === room && isDefined(joinRequestCallback.value)) {\n      joinRequestCallback.value(event.userId, event.timestamp)\n    }\n  }\n\n  const approvedJoinRequestEventBusListener = (event: CollabApprovedJoinRequestEvent) => {\n    if (event.room === room && isDefined(approvedJoinRequestCallback.value)) {\n      approvedJoinRequestCallback.value()\n    }\n  }\n\n  const rejectedJoinRequestEventBusListener = (event: CollabRejectedJoinRequestEvent) => {\n    if (event.room === room && isDefined(rejectedJoinRequestCallback.value)) {\n      rejectedJoinRequestCallback.value()\n    }\n  }\n\n  const requestToTakeModerationEventBusListener = (event: CollabRequestToTakeModerationEvent) => {\n    if (event.room === room && isDefined(requestToTakeModerationCallback.value)) {\n      requestToTakeModerationCallback.value(event.userId, event.timestamp)\n    }\n  }\n\n  const approvedRequestToTakeModerationEventBusListener = (event: CollabApprovedRequestToTakeModerationEvent) => {\n    if (event.room === room && isDefined(approvedRequestToTakeModerationCallback.value)) {\n      approvedRequestToTakeModerationCallback.value()\n    }\n  }\n\n  const rejectedRequestToTakeModerationEventBusListener = (event: CollabRejectedRequestToTakeModerationEvent) => {\n    if (event.room === room && isDefined(rejectedRequestToTakeModerationCallback.value)) {\n      rejectedRequestToTakeModerationCallback.value()\n    }\n  }\n\n  const kickedFromCollabRookEventBusListener = (event: CollabKickedFromRoomEvent) => {\n    if (event.room === room && isDefined(kickedFromRoomCallback.value)) {\n      kickedFromRoomCallback.value()\n    }\n  }\n\n  const collabStartingEventBusListener = (event: CollabStartingEvent) => {\n    if (event.room === room && isDefined(collabStartingCallback.value)) {\n      collabStartingCallback.value(event.startedCallback)\n    }\n  }\n\n  const addJoinRequestListener = (callback: (userId: number, timestamp: number) => void) => {\n    joinRequestCallback.value = callback\n    unsubscribeJoinRequestListener.value = joinRequestEventBus.on(joinRequestEventBusListener)\n  }\n\n  const addApprovedJoinRequestListener = (callback: () => void) => {\n    approvedJoinRequestCallback.value = callback\n    unsubscribeApprovedJoinRequestListener.value = approvedJoinRequestEventBus.on(approvedJoinRequestEventBusListener)\n  }\n\n  const addRejectedJoinRequestListener = (callback: () => void) => {\n    rejectedJoinRequestCallback.value = callback\n    unsubscribeRejectedJoinRequestListener.value = rejectedJoinRequestEventBus.on(rejectedJoinRequestEventBusListener)\n  }\n\n  const addRequestToTakeModerationListener = (callback: (userId: number, timestamp: number) => void) => {\n    requestToTakeModerationCallback.value = callback\n    unsubscribeRequestToTakeModerationListener.value = requestToTakeModerationEventBus.on(\n      requestToTakeModerationEventBusListener\n    )\n  }\n\n  const addApprovedRequestToTakeModerationListener = (callback: () => void) => {\n    approvedRequestToTakeModerationCallback.value = callback\n    unsubscribeApprovedRequestToTakeModerationListener.value = approvedRequestToTakeModerationEventBus.on(\n      approvedRequestToTakeModerationEventBusListener\n    )\n  }\n\n  const addRejectedRequestToTakeModerationListener = (callback: () => void) => {\n    rejectedRequestToTakeModerationCallback.value = callback\n    unsubscribeRejectedRequestToTakeModerationListener.value = rejectedRequestToTakeModerationEventBus.on(\n      rejectedRequestToTakeModerationEventBusListener\n    )\n  }\n\n  const addCollabReconnectListener = (callback: () => void) => {\n    reconnectCallback.value = callback\n    unsubscribeCollabReconnectListener.value = reconnectEventBus.on(reconnectEventBusListener)\n  }\n\n  const addKickedFromRoomListener = (callback: () => void) => {\n    kickedFromRoomCallback.value = callback\n    unsubscribeKickedFromRoomListener.value = kickedFromRoomEventBus.on(kickedFromCollabRookEventBusListener)\n  }\n\n  const addCollabStartingListener = (callback: (startedCallback: (data: CollabRoomPlainData) => void) => void) => {\n    collabStartingCallback.value = callback\n    unsubscribeCollabStartingListener.value = collabStartingEventBus.on(collabStartingEventBusListener)\n  }\n\n  tryOnBeforeUnmount(() => {\n    if (disableAutoUnsubscribe) return\n    if (isDefined(unsubscribeCollabReconnectListener.value)) {\n      unsubscribeCollabReconnectListener.value()\n    }\n    if (isDefined(unsubscribeJoinRequestListener.value)) {\n      unsubscribeJoinRequestListener.value()\n    }\n    if (isDefined(unsubscribeApprovedJoinRequestListener.value)) {\n      unsubscribeApprovedJoinRequestListener.value()\n    }\n    if (isDefined(unsubscribeRejectedJoinRequestListener.value)) {\n      unsubscribeRejectedJoinRequestListener.value()\n    }\n    if (isDefined(unsubscribeRequestToTakeModerationListener.value)) {\n      unsubscribeRequestToTakeModerationListener.value()\n    }\n    if (isDefined(unsubscribeApprovedRequestToTakeModerationListener.value)) {\n      unsubscribeApprovedRequestToTakeModerationListener.value()\n    }\n    if (isDefined(unsubscribeRejectedRequestToTakeModerationListener.value)) {\n      unsubscribeRejectedRequestToTakeModerationListener.value()\n    }\n    if (isDefined(unsubscribeKickedFromRoomListener.value)) {\n      unsubscribeKickedFromRoomListener.value()\n    }\n    if (isDefined(unsubscribeCollabStartingListener.value)) {\n      unsubscribeCollabStartingListener.value()\n    }\n  })\n\n  const { collabOptions } = useCommonAdminCollabOptions()\n\n  const subscribeCollabRoomInfo = () => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    const isNewestWrite = claimRoomInfoWrite(room)\n    collabSocket.value.emit('subscribeCollabRoomInfo', room, (response: CollabRoomInfoCallback) => {\n      if (!isNewestWrite()) return\n      collabRoomInfoState.set(room, response.room)\n    })\n  }\n\n  const unsubscribeCollabRoomInfo = () => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    const isNewestWrite = claimRoomInfoWrite(room)\n    collabSocket.value.emit('unsubscribeCollabRoomInfo', room, (response: CollabRoomInfoCallback) => {\n      if (!isNewestWrite()) return\n      collabRoomInfoState.set(room, response.room)\n    })\n  }\n\n  const joinCollabRoom = async (\n    options: Partial<CollabRoomOptions> = {},\n    { ackTimeout = ACK_TIMEOUT }: CollabJoinAckOptions = {}\n  ): Promise<CollabAccessRoomStatusType> => {\n    return new Promise((resolve, reject) => {\n      if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return reject(CollabAccessRoomStatus.Failed)\n      // Fail now rather than after the acknowledgement timeout: the caller can offer the record read-only.\n      if (collabConnectionHopeless()) return reject(CollabAccessRoomStatus.Failed)\n      const isNewestWrite = claimRoomInfoWrite(room)\n      collabSocket.value\n        ?.timeout(ackTimeout)\n        .emit('joinCollabRoom', room, options, (error, response: CollabAccessRoomCallbackTypes) => {\n          if (error) {\n            markRoomInactiveOnFailedClaim()\n            /*\n             * No cleanup leave here, though a timed-out join can leave\n             * a server membership this client never hears about.\n             * A leave is not tied to its join, so it could remove the membership of a remount that succeeded meanwhile.\n             * Marking inactive is the safe side; the stale membership is released on\n             * disconnect. A proper fix needs a generation the server can compare.\n             * A caller that leaves after a timeout passes an `ackTimeout` longer than the server's own run.\n             */\n            return void reject(CollabAccessRoomStatus.Failed)\n          }\n          if (isCollabSuccessAccessRoomCallback(response)) {\n            if (isNewestWrite()) {\n              collabRoomInfoState.set(room, response.room)\n              // Joined a room with others: its state was gathered from the moderator.\n              // Data written alone earlier was never gathered, and would later go out as room state over newer values.\n              if (response.room.status === CollabStatus.Active) collabFieldDataBufferState.delete(room)\n            }\n            return void resolve(response.status)\n          }\n          markRoomInactiveOnFailedClaim()\n          return void reject(response.status)\n        })\n\n      /**\n       * A failed claim writes nothing yet still suppresses older acknowledgements, so without this a\n       * failed join would keep showing the membership from before the leave. Recorded as an explicitly\n       * inactive room, never deleted: the mutation guards test `roomInfo && status === Inactive`, so a\n       * missing entry falls through and emits. Only while this claim is still the newest.\n       */\n      function markRoomInactiveOnFailedClaim() {\n        if (isNewestWrite()) collabRoomInfoState.set(room, createDefaultCollabRoomInfo())\n      }\n    })\n  }\n\n  /**\n   * Resolves once the server acknowledges the leave, so a caller re-joining the same room can serialise the two.\n   * Never rejects, because callers (mostly unmount hooks) ignore the result. A missing ack resolves on the timeout.\n   * A caller that joins again afterwards passes an `ackTimeout` longer than the server's own run.\n   */\n  const leaveCollabRoom = ({ ackTimeout = ACK_TIMEOUT }: CollabJoinAckOptions = {}): Promise<void> => {\n    return new Promise((resolve) => {\n      if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return void resolve()\n      // Nobody gathers this buffer any more. If kept, it would go out as room state the next time this editor is alone.\n      collabFieldDataBufferState.delete(room)\n      const isNewestWrite = claimRoomInfoWrite(room)\n      collabSocket.value\n        ?.timeout(ackTimeout)\n        .emit('leaveCollabRoom', room, (error, response: CollabAccessRoomCallbackTypes) => {\n          if (!error && isNewestWrite() && isCollabSuccessAccessRoomCallback(response)) {\n            collabRoomInfoState.set(room, response.room)\n          }\n          resolve()\n        })\n    })\n  }\n\n  const enteredCollabRoom = () => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    /* Anything remembered from a previous stay in this room is a guess: the server answers with the\n     * locks it holds only when it holds some, so a lock released while this client was away produces\n     * no event and the field would read as locked until some later one arrives. */\n    collabFieldLocksState.set(room, new Map())\n    collabSocket.value?.emit('enteredCollabRoom', room)\n  }\n\n  const requestToJoinCollabRoom = (): Promise<CollabRequestToJoinStatusType> => {\n    return new Promise((resolve, reject) => {\n      if (!collabOptions.value.enabled || isUndefined(collabSocket.value) || collabConnectionHopeless()) {\n        return reject(CollabRequestToJoinStatus.Failed)\n      }\n      collabSocket.value\n        ?.timeout(2000)\n        .emit('requestToJoin', room, new Date().getTime(), (error, response: CollabRequestToJoinStatusCallback) => {\n          if (error) {\n            return void reject(CollabRequestToJoinStatus.Failed)\n          }\n          if (response.status === CollabRequestToJoinStatus.Ok) {\n            return void resolve(response.status)\n          }\n          return void reject(response.status)\n        })\n    })\n  }\n\n  const approveRequestToJoinCollabRoom = (userId: number) => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('approveRequestToJoin', room, userId)\n  }\n\n  const rejectRequestToJoinCollabRoom = (userId: number) => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('rejectRequestToJoin', room, userId)\n  }\n\n  const requestToTakeModeration = async (): Promise<CollabRequestToTakeModerationStatusType> => {\n    return new Promise((resolve, reject) => {\n      if (!collabOptions.value.enabled || isUndefined(collabSocket.value) || collabConnectionHopeless()) {\n        return reject(CollabRequestToTakeModerationStatus.Failed)\n      }\n      collabSocket.value\n        ?.timeout(2000)\n        .emit(\n          'requestToTakeModeration',\n          room,\n          new Date().getTime(),\n          (error, response: CollabRequestToTakeModerationStatusCallback) => {\n            if (error) {\n              return void reject(CollabRequestToTakeModerationStatus.Failed)\n            }\n            if (response.status === CollabRequestToTakeModerationStatus.Ok) {\n              return void resolve(response.status)\n            }\n            return void reject(response.status)\n          }\n        )\n    })\n  }\n\n  const approveRequestToTakeModeration = () => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('approveRequestToTakeModeration', room)\n  }\n\n  const rejectRequestToTakeModeration = () => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('rejectRequestToTakeModeration', room)\n  }\n\n  const kickUserFromRoom = (userId: number) => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('kickUserFromRoom', room, userId)\n  }\n\n  const purgeRoom = () => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('purgeRoom', room)\n  }\n\n  const transferModeration = (userId: number) => {\n    if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return\n    collabSocket.value.emit('transferModeration', room, userId)\n  }\n\n  const createDefaultCollabRoomInfo = (): CollabRoomInfo => ({\n    name: '',\n    status: CollabStatus.Inactive,\n    users: [],\n    moderator: null,\n    options: {},\n  })\n\n  const fetchRoomInfo = async (room: CollabRoom): Promise<CollabRoomInfo> => {\n    const baseRoomInfo: CollabRoomInfo = createDefaultCollabRoomInfo()\n\n    return new Promise((resolve) => {\n      if (!collabOptions.value.enabled || isUndefined(collabSocket.value)) return resolve(baseRoomInfo)\n      collabSocket.value?.timeout(500).emit('fetchRoomsInfo', [room], (error, response: CollabRoomsInfo) => {\n        if (error) return void resolve(baseRoomInfo)\n        const roomInfo = response[room]\n        if (isUndefined(roomInfo)) return void resolve(baseRoomInfo)\n        if (!isUndefined(addToCachedUsers)) addToCachedUsers(roomInfo.users)\n        if (!isUndefined(fetchCachedUsers)) fetchCachedUsers()\n\n        return resolve(roomInfo)\n      })\n    })\n  }\n\n  const collabRoomInfo = computed((): CollabRoomInfo => {\n    return collabRoomInfoState.get(room) ?? createDefaultCollabRoomInfo()\n  })\n\n  if (watchForNewUsers) {\n    watch(\n      collabRoomInfo,\n      (newValue) => {\n        if (newValue.users.length) {\n          if (!isUndefined(addToCachedUsers)) addToCachedUsers(newValue.users)\n          if (!isUndefined(fetchCachedUsers)) fetchCachedUsers()\n        }\n      },\n      { immediate: true }\n    )\n  }\n\n  const collabRoomLocks = computed((): Map<CollabFieldName, CollabFieldLock> => {\n    return collabFieldLocksState.get(room) ?? new Map()\n  })\n\n  return {\n    subscribeCollabRoomInfo,\n    unsubscribeCollabRoomInfo,\n    joinCollabRoom,\n    leaveCollabRoom,\n    requestToJoinCollabRoom,\n    approveRequestToJoinCollabRoom,\n    rejectRequestToJoinCollabRoom,\n    addJoinRequestListener,\n    addCollabReconnectListener,\n    addApprovedJoinRequestListener,\n    addRejectedJoinRequestListener,\n    requestToTakeModeration,\n    approveRequestToTakeModeration,\n    rejectRequestToTakeModeration,\n    addRequestToTakeModerationListener,\n    addApprovedRequestToTakeModerationListener,\n    addRejectedRequestToTakeModerationListener,\n    enteredCollabRoom,\n    kickUserFromRoom,\n    purgeRoom,\n    transferModeration,\n    addKickedFromRoomListener,\n    addCollabStartingListener,\n    fetchRoomInfo,\n    collabRoomInfo,\n    collabRoomLocks,\n    collabFieldDataBufferState,\n    alertedOccupiedRooms,\n    unsubscribeJoinRequestListener,\n    unsubscribeApprovedJoinRequestListener,\n    unsubscribeRejectedJoinRequestListener,\n    unsubscribeRequestToTakeModerationListener,\n    unsubscribeApprovedRequestToTakeModerationListener,\n    unsubscribeRejectedRequestToTakeModerationListener,\n    unsubscribeKickedFromRoomListener,\n    unsubscribeCollabStartingListener,\n    unsubscribeCollabReconnectListener,\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,38 @@
+import { Socket } from 'socket.io-client';
+import { CollabClientToServerEvents, CollabConnectionStateType, CollabFieldLock, CollabFieldName, CollabRoom, CollabRoomInfo, CollabRoomPlainData, CollabServerToClientEvents } from '../types/Collab';
+import { Ref } from 'vue';
+/**
+ * Everything the collaboration modules share, the socket included. Internal: an admin reads
+ * `useCollabState()`.
+ */
+export declare function useCollabStateInternal(): {
+    collabReconnecting: import('vue').ComputedRef<boolean>;
+    collabConnectionState: Ref<CollabConnectionStateType, CollabConnectionStateType>;
+    collabConnectionHopeless: () => boolean;
+    setCollabRecover: (recover: () => Promise<void>) => void;
+    reconnectCollab: () => Promise<void>;
+    collabConnected: Ref<boolean, boolean>;
+    collabSocket: Ref<Socket<CollabServerToClientEvents, CollabClientToServerEvents> | undefined, Socket<CollabServerToClientEvents, CollabClientToServerEvents> | undefined>;
+    collabRoomInfoState: import('vue').Reactive<Map<string, CollabRoomInfo>>;
+    claimRoomInfoWrite: (room: CollabRoom) => () => boolean;
+    collabFieldLocksState: import('vue').Reactive<Map<string, Map<string, import('../types/Collab').CollabUserIdNullable>>>;
+    collabFieldDataBufferState: import('vue').Reactive<Map<string, Map<string, unknown>>>;
+    collabFieldLocksUnanswered: Map<string, Set<string>>;
+    setFieldLockUnanswered: (room: CollabRoom, field: CollabFieldName, unanswered: boolean) => undefined;
+    fieldLockMaybeHeld: (room: CollabRoom, field: CollabFieldName, userId: CollabFieldLock) => boolean;
+    gatherBufferData: (room: CollabRoom) => CollabRoomPlainData;
+};
+/**
+ * What an admin reads from the collaboration state: whether the connection is being re-established and why it
+ * is not (`collabConnectionState`), the rooms' info, and the buffered field data of a room (`gatherBufferData`
+ * collects and clears it). `reconnectCollab` is the user's "try again". The socket and the lock bookkeeping stay
+ * inside the library.
+ */
+export declare function useCollabState(): {
+    collabReconnecting: import('vue').ComputedRef<boolean>;
+    collabConnectionState: Readonly<Ref<CollabConnectionStateType, CollabConnectionStateType>>;
+    reconnectCollab: () => Promise<void>;
+    collabRoomInfoState: import('vue').Reactive<Map<string, CollabRoomInfo>>;
+    collabFieldDataBufferState: import('vue').Reactive<Map<string, Map<string, unknown>>>;
+    gatherBufferData: (room: CollabRoom) => CollabRoomPlainData;
+};

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

@@ -0,0 +1,52 @@
+import { CollabConnectionState as e } from "../types/Collab.js";
+import { useCollabGatheringBufferDataEventBus as t } from "./collabEventBus.js";
+import { useCommonAdminCollabOptions as n } from "./commonAdminCollabOptions.js";
+import { computed as r, reactive as i, readonly as a, ref as o, toRaw as s } from "vue";
+// src/domains/collab/composables/collabState.ts
+var c = o(!0), l = o(e.Connected), u, d = o(), f = i(/* @__PURE__ */ new Map()), p = 0, m = /* @__PURE__ */ new Map(), h = i(/* @__PURE__ */ new Map()), g = i(/* @__PURE__ */ new Map()), _ = /* @__PURE__ */ new Map();
+function v() {
+	let { collabOptions: i } = n();
+	return {
+		collabReconnecting: r(() => i.value.enabled && !c.value),
+		collabConnectionState: l,
+		collabConnectionHopeless: () => l.value !== e.Connected && l.value !== e.Reconnecting,
+		setCollabRecover: (e) => {
+			u = e;
+		},
+		reconnectCollab: () => u?.() ?? Promise.resolve(),
+		collabConnected: c,
+		collabSocket: d,
+		collabRoomInfoState: f,
+		claimRoomInfoWrite: (e) => {
+			let t = ++p;
+			return m.set(e, t), () => m.get(e) === t;
+		},
+		collabFieldLocksState: h,
+		collabFieldDataBufferState: g,
+		collabFieldLocksUnanswered: _,
+		setFieldLockUnanswered: (e, t, n) => {
+			if (!n) return void _.get(e)?.delete(t);
+			_.has(e) || _.set(e, /* @__PURE__ */ new Set()), _.get(e)?.add(t);
+		},
+		fieldLockMaybeHeld: (e, t, n) => h.get(e)?.get(t) === n || !!_.get(e)?.has(t),
+		gatherBufferData: (e) => {
+			t().emit({ room: e });
+			let n = {}, r = g.get(e);
+			return r && (n = s(Object.fromEntries(r.entries())), g.delete(e)), n;
+		}
+	};
+}
+function y() {
+	let { collabReconnecting: e, collabConnectionState: t, reconnectCollab: n, collabRoomInfoState: r, collabFieldDataBufferState: i, gatherBufferData: o } = v();
+	return {
+		collabReconnecting: e,
+		collabConnectionState: a(t),
+		reconnectCollab: n,
+		collabRoomInfoState: r,
+		collabFieldDataBufferState: i,
+		gatherBufferData: o
+	};
+}
+export { y as useCollabState, v as useCollabStateInternal };
+
+//# sourceMappingURL=collabState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collabState.js","names":["collabConnected","ref","collabConnectionState","CollabConnectionState","collabRecover","collabSocket","collabRoomInfoState","reactive","collabRoomInfoWriteCounter","collabRoomInfoWriteSeq","collabFieldLocksState","collabFieldDataBufferState","collabFieldLocksUnanswered","useCollabStateInternal","useCommonAdminCollabOptions","computed","collabOptions","recover","seq","room","unanswered","field","userId","dataBuffer","dataBufferMap","toRaw","useCollabState","readonly"],"sources":["../../../../src/domains/collab/composables/collabState.ts"],"sourcesContent":["import type { Socket } from 'socket.io-client'\nimport {\n  type CollabClientToServerEvents,\n  CollabConnectionState,\n  type CollabConnectionStateType,\n  type CollabFieldData,\n  type CollabFieldLock,\n  type CollabFieldName,\n  type CollabRoom,\n  type CollabRoomInfo,\n  type CollabRoomPlainData,\n  type CollabServerToClientEvents,\n} from '@/domains/collab/types/Collab'\nimport { computed, reactive, readonly, ref, type Ref, toRaw } from 'vue'\nimport { useCollabGatheringBufferDataEventBus } from '@/domains/collab/composables/collabEventBus'\nimport { useCommonAdminCollabOptions } from '@/domains/collab/composables/commonAdminCollabOptions'\n\nconst collabConnected = ref(true)\nconst collabConnectionState = ref<CollabConnectionStateType>(CollabConnectionState.Connected)\n// Set by `initCollab` for the socket it creates.\nlet collabRecover: (() => Promise<void>) | undefined\nconst collabSocket: Ref<Socket<CollabServerToClientEvents, CollabClientToServerEvents> | undefined> = ref()\nconst collabRoomInfoState = reactive(new Map<CollabRoom, CollabRoomInfo>())\n// Plain, not reactive: bookkeeping for the map above, nothing renders from it.\nlet collabRoomInfoWriteCounter = 0\nconst collabRoomInfoWriteSeq = new Map<CollabRoom, number>()\nconst collabFieldLocksState = reactive(new Map<CollabRoom, Map<CollabFieldName, CollabFieldLock>>())\nconst collabFieldDataBufferState = reactive(new Map<CollabRoom, Map<CollabFieldName, CollabFieldData>>())\n// Plain, not reactive: fields whose lock request timed out. The server may still have granted it.\n// The server notifies only other clients of a grant, so the lock map never shows this editor holding it.\n// Kept until a release is confirmed. A later request can be\n// refused while the slow one still holds the field, then granted.\nconst collabFieldLocksUnanswered = new Map<CollabRoom, Set<CollabFieldName>>()\n\n/**\n * Everything the collaboration modules share, the socket included. Internal: an admin reads\n * `useCollabState()`.\n */\nexport function useCollabStateInternal() {\n  const { collabOptions } = useCommonAdminCollabOptions()\n\n  const collabReconnecting = computed(() => collabOptions.value.enabled && !collabConnected.value)\n\n  const gatherBufferData = (room: CollabRoom): CollabRoomPlainData => {\n    const collabGatheringBufferDataEventBus = useCollabGatheringBufferDataEventBus()\n    collabGatheringBufferDataEventBus.emit({ room })\n    let dataBuffer: CollabRoomPlainData = {}\n    const dataBufferMap = collabFieldDataBufferState.get(room)\n    if (dataBufferMap) {\n      dataBuffer = toRaw(Object.fromEntries(dataBufferMap.entries()))\n      collabFieldDataBufferState.delete(room)\n    }\n    return dataBuffer\n  }\n\n  /**\n   * Call before emitting anything whose acknowledgement writes `collabRoomInfoState`, and let the\n   * returned predicate decide whether that write still applies.\n   *\n   * The server serialises join and leave per room only for the lifetime of its lease, so a leave that\n   * outruns it can acknowledge after a following join and mark a room inactive while the client is in\n   * it — after which the client goes quiet with nothing visible to show for it.\n   */\n  const claimRoomInfoWrite = (room: CollabRoom) => {\n    /* Global and never restarting, so a number is never handed out twice. Claims outlive a\n     * reconnect on purpose — see the `connect` handler in `collabInit.ts`. */\n    const seq = ++collabRoomInfoWriteCounter\n    collabRoomInfoWriteSeq.set(room, seq)\n\n    return () => collabRoomInfoWriteSeq.get(room) === seq\n  }\n\n  const setFieldLockUnanswered = (room: CollabRoom, field: CollabFieldName, unanswered: boolean) => {\n    if (!unanswered) return void collabFieldLocksUnanswered.get(room)?.delete(field)\n    if (!collabFieldLocksUnanswered.has(room)) collabFieldLocksUnanswered.set(room, new Set())\n    collabFieldLocksUnanswered.get(room)?.add(field)\n  }\n\n  const fieldLockMaybeHeld = (room: CollabRoom, field: CollabFieldName, userId: CollabFieldLock) =>\n    collabFieldLocksState.get(room)?.get(field) === userId || !!collabFieldLocksUnanswered.get(room)?.has(field)\n\n  /** No connection comes without the user acting (or, waiting for the network, before a retry): fail now. */\n  const collabConnectionHopeless = () =>\n    collabConnectionState.value !== CollabConnectionState.Connected &&\n    collabConnectionState.value !== CollabConnectionState.Reconnecting\n\n  const setCollabRecover = (recover: () => Promise<void>) => {\n    collabRecover = recover\n  }\n\n  /** Try now, also out of `sessionEnded`, `identityChanged` and `rejected`; a no-op while connected or connecting. */\n  const reconnectCollab = (): Promise<void> => collabRecover?.() ?? Promise.resolve()\n\n  return {\n    collabReconnecting,\n    collabConnectionState,\n    collabConnectionHopeless,\n    setCollabRecover,\n    reconnectCollab,\n    collabConnected,\n    collabSocket,\n    collabRoomInfoState,\n    claimRoomInfoWrite,\n    collabFieldLocksState,\n    collabFieldDataBufferState,\n    collabFieldLocksUnanswered,\n    setFieldLockUnanswered,\n    fieldLockMaybeHeld,\n    gatherBufferData,\n  }\n}\n\n/**\n * What an admin reads from the collaboration state: whether the connection is being re-established and why it\n * is not (`collabConnectionState`), the rooms' info, and the buffered field data of a room (`gatherBufferData`\n * collects and clears it). `reconnectCollab` is the user's \"try again\". The socket and the lock bookkeeping stay\n * inside the library.\n */\nexport function useCollabState() {\n  const {\n    collabReconnecting,\n    collabConnectionState,\n    reconnectCollab,\n    collabRoomInfoState,\n    collabFieldDataBufferState,\n    gatherBufferData,\n  } = useCollabStateInternal()\n\n  return {\n    collabReconnecting,\n    collabConnectionState: readonly(collabConnectionState),\n    reconnectCollab,\n    collabRoomInfoState,\n    collabFieldDataBufferState,\n    gatherBufferData,\n  }\n}\n"],"mappings":";;;;;AAiBA,IAAMA,IAAkBC,EAAI,EAAI,GAC1BC,IAAwBD,EAA+BE,EAAsB,SAAS,GAExFC,GACEC,IAAgGJ,EAAI,GACpGK,IAAsBC,kBAAS,IAAI,IAAgC,CAAC,GAEtEC,IAA6B,GAC3BC,oBAAyB,IAAI,IAAwB,GACrDC,IAAwBH,kBAAS,IAAI,IAAuD,CAAC,GAC7FI,IAA6BJ,kBAAS,IAAI,IAAuD,CAAC,GAKlGK,oBAA6B,IAAI,IAAsC;AAM7E,SAAgBC,IAAyB;CACvC,IAAM,EAAE,qBAAkBC,EAA4B;CAsDtD,OAAO;EACL,oBArDyBC,QAAeC,EAAc,MAAM,WAAW,CAAChB,EAAgB,KAqDxF;EACA;EACA,gCAbAE,EAAsB,UAAUC,EAAsB,aACtDD,EAAsB,UAAUC,EAAsB;EAatD,mBAXwB,MAAiC;GACzD,IAAgBc;EAClB;EAUE,uBAP2Cb,IAAgB,KAAK,QAAQ,QAAQ;EAQhF;EACA;EACA;EACA,qBAvC0B,MAAqB;GAG/C,IAAMc,IAAM,EAAEV;GAGd,OAFAC,EAAuB,IAAIU,GAAMD,CAAG,SAEvBT,EAAuB,IAAIU,CAAI,MAAMD;EACpD;EAiCE;EACA;EACA;EACA,yBAlC8B,GAAkB,GAAwB,MAAwB;GAChG,IAAI,CAACE,GAAY,OAAO,KAAKR,EAA2B,IAAIO,CAAI,CAAC,EAAE,OAAOE,CAAK;GAE/E,AADKT,EAA2B,IAAIO,CAAI,KAAGP,EAA2B,IAAIO,mBAAM,IAAI,IAAI,CAAC,GACzFP,EAA2B,IAAIO,CAAI,CAAC,EAAE,IAAIE,CAAK;EACjD;EA+BE,qBA7B0B,GAAkB,GAAwB,MACpEX,EAAsB,IAAIS,CAAI,CAAC,EAAE,IAAIE,CAAK,MAAMC,KAAU,CAAC,CAACV,EAA2B,IAAIO,CAAI,CAAC,EAAE,IAAIE,CAAK;EA6B3G,mBAjEwB,MAA0C;GAElE,EAAA,CAAA,CAAkC,KAAK,EAAE,QAAK,CAAC;GAC/C,IAAIE,IAAkC,CAAC,GACjCC,IAAgBb,EAA2B,IAAIQ,CAAI;GAKzD,OAJIK,MACF,IAAaC,EAAM,OAAO,YAAYD,EAAc,QAAQ,CAAC,CAAC,GAC9Db,EAA2B,OAAOQ,CAAI,IAEjCI;EACT;CAwDA;AACF;AAQA,SAAgBG,IAAiB;CAC/B,IAAM,EACJ,uBACA,0BACA,oBACA,wBACA,+BACA,wBACEb,EAAuB;CAE3B,OAAO;EACL;EACA,uBAAuBc,EAASzB,CAAqB;EACrD;EACA;EACA;EACA;CACF;AACF"}

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

@@ -0,0 +1,16 @@
+export { initCommonAdminCollabOptions } from '../../../plugins/pluginOptions';
+export declare function useCommonAdminCollabOptions(): {
+    collabOptions: import('vue').Ref<{
+        enabled: boolean;
+        socketUrl: string;
+        beforeReconnect: () => Promise<void | import('../types/Collab').CollabReconnectVerdictType>;
+        isSameIdentity?: (() => boolean | undefined) | undefined;
+        io: typeof import('socket.io-client').io | undefined;
+    }, import('../../../AnzuSystemsCommonAdmin').CommonAdminCollabOptions | {
+        enabled: boolean;
+        socketUrl: string;
+        beforeReconnect: () => Promise<void | import('../types/Collab').CollabReconnectVerdictType>;
+        isSameIdentity?: (() => boolean | undefined) | undefined;
+        io: typeof import('socket.io-client').io | undefined;
+    }>;
+};

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

@@ -0,0 +1,10 @@
+import { collabOptions as e } from "../../../plugins/pluginOptions.js";
+import { isUndefined as t } from "../../../shared/utils/common.js";
+// src/domains/collab/composables/commonAdminCollabOptions.ts
+function n() {
+	if (t(e.value)) throw Error("Composable can't be used without properly configured common admin.");
+	return { collabOptions: e };
+}
+export { n as useCommonAdminCollabOptions };
+
+//# sourceMappingURL=commonAdminCollabOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonAdminCollabOptions.js","names":["useCommonAdminCollabOptions","isUndefined","collabOptions"],"sources":["../../../../src/domains/collab/composables/commonAdminCollabOptions.ts"],"sourcesContent":["import { collabOptions } from '@/plugins/pluginOptions'\nimport { isUndefined } from '@/shared/utils/common'\n\nexport { initCommonAdminCollabOptions } from '@/plugins/pluginOptions'\n\nexport function useCommonAdminCollabOptions() {\n  if (isUndefined(collabOptions.value)) {\n    throw new Error(\"Composable can't be used without properly configured common admin.\")\n  }\n\n  return {\n    collabOptions,\n  }\n}\n"],"mappings":";;;AAKA,SAAgBA,IAA8B;CAC5C,IAAIC,EAAYC,EAAc,KAAK,GACjC,MAAU,MAAM,oEAAoE;CAGtF,OAAO,EACL,iBACF;AACF"}