@athenaintel/react 0.30.0 → 0.35.0

package/dist/chat-ui/mentions/use-account-workspace-id.js

@@ -0,0 +1,61 @@
+import { useState, useEffect } from "react";
+import { withCredentialRenewal } from "../../runtime/credential-renewal.js";
+import { fetchAccountIdentity } from "../../threads/api.js";
+const workspaceIdRequests = /* @__PURE__ */ new Map();
+function loadWorkspaceId(auth) {
+  if (auth.workspaceId) return Promise.resolve(auth.workspaceId);
+  const cacheKey = `${auth.backendUrl}|${auth.userId ?? ""}`;
+  const cached = workspaceIdRequests.get(cacheKey);
+  if (cached) return cached;
+  const request = withCredentialRenewal(
+    async ({ force } = {}) => {
+      var _a, _b;
+      return {
+        token: (force ? await ((_a = auth.renewAccessToken) == null ? void 0 : _a.call(auth)) : await ((_b = auth.getAccessToken) == null ? void 0 : _b.call(auth))) ?? auth.accessToken ?? null,
+        apiKey: auth.apiKey,
+        credentials: auth.credentials
+      };
+    },
+    (credential) => fetchAccountIdentity(auth.backendUrl, credential)
+  ).then((identity) => identity.workspaceId ?? void 0).catch((error) => {
+    if (workspaceIdRequests.get(cacheKey) === request) {
+      workspaceIdRequests.delete(cacheKey);
+    }
+    throw error;
+  });
+  workspaceIdRequests.set(cacheKey, request);
+  return request;
+}
+function useAccountWorkspaceId(auth) {
+  const cacheKey = auth ? `${auth.backendUrl}|${auth.userId ?? ""}` : void 0;
+  const [resolvedWorkspace, setResolvedWorkspace] = useState();
+  useEffect(() => {
+    if (!auth || !cacheKey) {
+      setResolvedWorkspace(void 0);
+      return void 0;
+    }
+    if (auth.workspaceId) {
+      setResolvedWorkspace({ cacheKey, workspaceId: auth.workspaceId });
+      return void 0;
+    }
+    let cancelled = false;
+    setResolvedWorkspace(void 0);
+    loadWorkspaceId(auth).then(
+      (workspaceId) => {
+        if (!cancelled) setResolvedWorkspace({ cacheKey, workspaceId });
+      },
+      () => {
+        if (!cancelled) setResolvedWorkspace({ cacheKey, workspaceId: void 0 });
+      }
+    );
+    return () => {
+      cancelled = true;
+    };
+  }, [auth, cacheKey]);
+  if (auth == null ? void 0 : auth.workspaceId) return auth.workspaceId;
+  return cacheKey && (resolvedWorkspace == null ? void 0 : resolvedWorkspace.cacheKey) === cacheKey ? resolvedWorkspace.workspaceId : void 0;
+}
+export {
+  useAccountWorkspaceId
+};
+//# sourceMappingURL=use-account-workspace-id.js.map

package/dist/chat-ui/mentions/use-account-workspace-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-account-workspace-id.js","sources":["../../../src/chat-ui/mentions/use-account-workspace-id.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { withCredentialRenewal } from \"../../runtime/credential-renewal\";\nimport { fetchAccountIdentity } from \"../../threads/api\";\nimport type { MentionAuthContext } from \"./suggestions/data/api-client\";\n\nconst workspaceIdRequests = new Map<string, Promise<string | undefined>>();\n\nfunction loadWorkspaceId(auth: MentionAuthContext): Promise<string | undefined> {\n  if (auth.workspaceId) return Promise.resolve(auth.workspaceId);\n\n  const cacheKey = `${auth.backendUrl}|${auth.userId ?? \"\"}`;\n  const cached = workspaceIdRequests.get(cacheKey);\n  if (cached) return cached;\n\n  const request = withCredentialRenewal(\n    async ({ force }: { force?: boolean } = {}) => ({\n      token: (force ? await auth.renewAccessToken?.() : await auth.getAccessToken?.()) ?? auth.accessToken ?? null,\n      apiKey: auth.apiKey,\n      credentials: auth.credentials,\n    }),\n    (credential) => fetchAccountIdentity(auth.backendUrl, credential),\n  )\n    .then((identity) => identity.workspaceId ?? undefined)\n    .catch((error: unknown) => {\n      if (workspaceIdRequests.get(cacheKey) === request) {\n        workspaceIdRequests.delete(cacheKey);\n      }\n      throw error;\n    });\n\n  workspaceIdRequests.set(cacheKey, request);\n  return request;\n}\n\nexport function useAccountWorkspaceId(auth: MentionAuthContext | null): string | undefined {\n  const cacheKey = auth ? `${auth.backendUrl}|${auth.userId ?? \"\"}` : undefined;\n  const [resolvedWorkspace, setResolvedWorkspace] = useState<{\n    cacheKey: string;\n    workspaceId: string | undefined;\n  }>();\n\n  useEffect(() => {\n    if (!auth || !cacheKey) {\n      setResolvedWorkspace(undefined);\n      return undefined;\n    }\n    if (auth.workspaceId) {\n      setResolvedWorkspace({ cacheKey, workspaceId: auth.workspaceId });\n      return undefined;\n    }\n\n    let cancelled = false;\n    setResolvedWorkspace(undefined);\n    loadWorkspaceId(auth).then(\n      (workspaceId) => {\n        if (!cancelled) setResolvedWorkspace({ cacheKey, workspaceId });\n      },\n      () => {\n        if (!cancelled) setResolvedWorkspace({ cacheKey, workspaceId: undefined });\n      },\n    );\n\n    return () => {\n      cancelled = true;\n    };\n  }, [auth, cacheKey]);\n\n  if (auth?.workspaceId) return auth.workspaceId;\n  return cacheKey && resolvedWorkspace?.cacheKey === cacheKey ? resolvedWorkspace.workspaceId : undefined;\n}\n\nexport function resetAccountWorkspaceIdForTests(): void {\n  workspaceIdRequests.clear();\n}\n"],"names":[],"mappings":";;;AAKA,MAAM,0CAA0B,IAAA;AAEhC,SAAS,gBAAgB,MAAuD;AAC9E,MAAI,KAAK,YAAa,QAAO,QAAQ,QAAQ,KAAK,WAAW;AAE7D,QAAM,WAAW,GAAG,KAAK,UAAU,IAAI,KAAK,UAAU,EAAE;AACxD,QAAM,SAAS,oBAAoB,IAAI,QAAQ;AAC/C,MAAI,OAAQ,QAAO;AAEnB,QAAM,UAAU;AAAA,IACd,OAAO,EAAE,MAAA,IAA+B,OAAC;;AAAO;AAAA,QAC9C,QAAQ,QAAQ,QAAM,UAAK,qBAAL,iCAA4B,QAAM,UAAK,mBAAL,mCAA4B,KAAK,eAAe;AAAA,QACxG,QAAQ,KAAK;AAAA,QACb,aAAa,KAAK;AAAA,MAAA;AAAA;AAAA,IAEpB,CAAC,eAAe,qBAAqB,KAAK,YAAY,UAAU;AAAA,EAAA,EAE/D,KAAK,CAAC,aAAa,SAAS,eAAe,MAAS,EACpD,MAAM,CAAC,UAAmB;AACzB,QAAI,oBAAoB,IAAI,QAAQ,MAAM,SAAS;AACjD,0BAAoB,OAAO,QAAQ;AAAA,IACrC;AACA,UAAM;AAAA,EACR,CAAC;AAEH,sBAAoB,IAAI,UAAU,OAAO;AACzC,SAAO;AACT;AAEO,SAAS,sBAAsB,MAAqD;AACzF,QAAM,WAAW,OAAO,GAAG,KAAK,UAAU,IAAI,KAAK,UAAU,EAAE,KAAK;AACpE,QAAM,CAAC,mBAAmB,oBAAoB,IAAI,SAAA;AAKlD,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ,CAAC,UAAU;AACtB,2BAAqB,MAAS;AAC9B,aAAO;AAAA,IACT;AACA,QAAI,KAAK,aAAa;AACpB,2BAAqB,EAAE,UAAU,aAAa,KAAK,aAAa;AAChE,aAAO;AAAA,IACT;AAEA,QAAI,YAAY;AAChB,yBAAqB,MAAS;AAC9B,oBAAgB,IAAI,EAAE;AAAA,MACpB,CAAC,gBAAgB;AACf,YAAI,CAAC,UAAW,sBAAqB,EAAE,UAAU,aAAa;AAAA,MAChE;AAAA,MACA,MAAM;AACJ,YAAI,CAAC,UAAW,sBAAqB,EAAE,UAAU,aAAa,QAAW;AAAA,MAC3E;AAAA,IAAA;AAGF,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,MAAM,QAAQ,CAAC;AAEnB,MAAI,6BAAM,YAAa,QAAO,KAAK;AACnC,SAAO,aAAY,uDAAmB,cAAa,WAAW,kBAAkB,cAAc;AAChG;"}

package/dist/chat-ui/mentions/use-member-avatar.cjs

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const apiClient = require("./suggestions/data/api-client.cjs");
+const MEMBER_AVATAR_TTL_MS = 5 * 60 * 1e3;
+const memberAvatarRequests = /* @__PURE__ */ new Map();
+function loadMemberAvatars(auth) {
+  const workspaceId = auth.workspaceId;
+  if (!workspaceId) return Promise.resolve(/* @__PURE__ */ new Map());
+  const cacheKey = `${auth.backendUrl}|${workspaceId}`;
+  const cached = memberAvatarRequests.get(cacheKey);
+  if (cached && (cached.fetchedAt === null || Date.now() - cached.fetchedAt < MEMBER_AVATAR_TTL_MS)) {
+    return cached.request;
+  }
+  const entry = {
+    request: Promise.resolve(/* @__PURE__ */ new Map()),
+    fetchedAt: null
+  };
+  const request = apiClient.fetchGraphQL(
+    auth,
+    apiClient.WORKSPACE_MEMBERS_QUERY,
+    { workspaceId }
+  ).then((data) => {
+    var _a;
+    const avatars = /* @__PURE__ */ new Map();
+    for (const member of data.getUsersInWorkspace ?? []) {
+      const email = (_a = member.email) == null ? void 0 : _a.trim().toLowerCase();
+      if (email && member.avatarUrl != null) {
+        avatars.set(email, member.avatarUrl);
+      }
+    }
+    entry.fetchedAt = Date.now();
+    return avatars;
+  }).catch((error) => {
+    if (memberAvatarRequests.get(cacheKey) === entry) {
+      memberAvatarRequests.delete(cacheKey);
+    }
+    throw error;
+  });
+  entry.request = request;
+  memberAvatarRequests.set(cacheKey, entry);
+  return request;
+}
+function useMemberAvatarUrl(email) {
+  const auth = react.useContext(apiClient.MentionAuthCtx);
+  const normalizedEmail = email == null ? void 0 : email.trim().toLowerCase();
+  const cacheKey = (auth == null ? void 0 : auth.workspaceId) && `${auth.backendUrl}|${auth.workspaceId}`;
+  const [resolvedAvatar, setResolvedAvatar] = react.useState();
+  react.useEffect(() => {
+    if (!auth || !cacheKey || !normalizedEmail) {
+      setResolvedAvatar(void 0);
+      return;
+    }
+    let cancelled = false;
+    loadMemberAvatars(auth).then(
+      (avatars) => {
+        if (!cancelled) {
+          setResolvedAvatar({ cacheKey, url: avatars.get(normalizedEmail) });
+        }
+      },
+      () => {
+        if (!cancelled) setResolvedAvatar({ cacheKey, url: void 0 });
+      }
+    );
+    return () => {
+      cancelled = true;
+    };
+  }, [auth, cacheKey, normalizedEmail]);
+  if (!cacheKey || !resolvedAvatar || resolvedAvatar.cacheKey !== cacheKey) {
+    return void 0;
+  }
+  return resolvedAvatar.url;
+}
+exports.useMemberAvatarUrl = useMemberAvatarUrl;
+//# sourceMappingURL=use-member-avatar.cjs.map

package/dist/chat-ui/mentions/use-member-avatar.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-member-avatar.cjs","sources":["../../../src/chat-ui/mentions/use-member-avatar.ts"],"sourcesContent":["import { useContext, useEffect, useState } from \"react\";\nimport {\n  fetchGraphQL,\n  MentionAuthCtx,\n  WORKSPACE_MEMBERS_QUERY,\n} from \"./suggestions/data/api-client\";\nimport type { MentionAuthContext } from \"./suggestions/data/api-client\";\n\ntype WorkspaceMemberAvatar = {\n  email?: string | null;\n  avatarUrl?: string | null;\n};\n\ntype WorkspaceMembersResponse = {\n  getUsersInWorkspace?: WorkspaceMemberAvatar[] | null;\n};\n\nconst MEMBER_AVATAR_TTL_MS = 5 * 60 * 1000;\n\ntype MemberAvatarCacheEntry = {\n  request: Promise<Map<string, string>>;\n  fetchedAt: number | null;\n};\n\nconst memberAvatarRequests = new Map<string, MemberAvatarCacheEntry>();\n\nfunction loadMemberAvatars(\n  auth: MentionAuthContext,\n): Promise<Map<string, string>> {\n  const workspaceId = auth.workspaceId;\n  if (!workspaceId) return Promise.resolve(new Map());\n\n  const cacheKey = `${auth.backendUrl}|${workspaceId}`;\n  const cached = memberAvatarRequests.get(cacheKey);\n  if (cached && (cached.fetchedAt === null || Date.now() - cached.fetchedAt < MEMBER_AVATAR_TTL_MS)) {\n    return cached.request;\n  }\n\n  const entry: MemberAvatarCacheEntry = {\n    request: Promise.resolve(new Map<string, string>()),\n    fetchedAt: null,\n  };\n  const request = fetchGraphQL<WorkspaceMembersResponse>(\n    auth,\n    WORKSPACE_MEMBERS_QUERY,\n    { workspaceId },\n  )\n    .then((data) => {\n      const avatars = new Map<string, string>();\n      for (const member of data.getUsersInWorkspace ?? []) {\n        const email = member.email?.trim().toLowerCase();\n        if (email && member.avatarUrl != null) {\n          avatars.set(email, member.avatarUrl);\n        }\n      }\n      entry.fetchedAt = Date.now();\n      return avatars;\n    })\n    .catch((error: unknown) => {\n      if (memberAvatarRequests.get(cacheKey) === entry) {\n        memberAvatarRequests.delete(cacheKey);\n      }\n      throw error;\n    });\n\n  entry.request = request;\n  memberAvatarRequests.set(cacheKey, entry);\n  return request;\n}\n\nexport function useMemberAvatarUrl(\n  email: string | undefined,\n): string | undefined {\n  const auth = useContext(MentionAuthCtx);\n  const normalizedEmail = email?.trim().toLowerCase();\n  const cacheKey =\n    auth?.workspaceId && `${auth.backendUrl}|${auth.workspaceId}`;\n  const [resolvedAvatar, setResolvedAvatar] = useState<{\n    cacheKey: string;\n    url: string | undefined;\n  }>();\n\n  useEffect(() => {\n    if (!auth || !cacheKey || !normalizedEmail) {\n      setResolvedAvatar(undefined);\n      return;\n    }\n\n    let cancelled = false;\n    loadMemberAvatars(auth).then(\n      (avatars) => {\n        if (!cancelled) {\n          setResolvedAvatar({ cacheKey, url: avatars.get(normalizedEmail) });\n        }\n      },\n      () => {\n        if (!cancelled) setResolvedAvatar({ cacheKey, url: undefined });\n      },\n    );\n\n    return () => {\n      cancelled = true;\n    };\n  }, [auth, cacheKey, normalizedEmail]);\n\n  if (!cacheKey || !resolvedAvatar || resolvedAvatar.cacheKey !== cacheKey) {\n    return undefined;\n  }\n  return resolvedAvatar.url;\n}\n\nexport function resetMemberAvatarsForTests(): void {\n  memberAvatarRequests.clear();\n}\n"],"names":["fetchGraphQL","WORKSPACE_MEMBERS_QUERY","useContext","MentionAuthCtx","useState","useEffect"],"mappings":";;;;AAiBA,MAAM,uBAAuB,IAAI,KAAK;AAOtC,MAAM,2CAA2B,IAAA;AAEjC,SAAS,kBACP,MAC8B;AAC9B,QAAM,cAAc,KAAK;AACzB,MAAI,CAAC,YAAa,QAAO,QAAQ,QAAQ,oBAAI,KAAK;AAElD,QAAM,WAAW,GAAG,KAAK,UAAU,IAAI,WAAW;AAClD,QAAM,SAAS,qBAAqB,IAAI,QAAQ;AAChD,MAAI,WAAW,OAAO,cAAc,QAAQ,KAAK,IAAA,IAAQ,OAAO,YAAY,uBAAuB;AACjG,WAAO,OAAO;AAAA,EAChB;AAEA,QAAM,QAAgC;AAAA,IACpC,SAAS,QAAQ,QAAQ,oBAAI,KAAqB;AAAA,IAClD,WAAW;AAAA,EAAA;AAEb,QAAM,UAAUA,UAAAA;AAAAA,IACd;AAAA,IACAC,UAAAA;AAAAA,IACA,EAAE,YAAA;AAAA,EAAY,EAEb,KAAK,CAAC,SAAS;;AACd,UAAM,8BAAc,IAAA;AACpB,eAAW,UAAU,KAAK,uBAAuB,CAAA,GAAI;AACnD,YAAM,SAAQ,YAAO,UAAP,mBAAc,OAAO;AACnC,UAAI,SAAS,OAAO,aAAa,MAAM;AACrC,gBAAQ,IAAI,OAAO,OAAO,SAAS;AAAA,MACrC;AAAA,IACF;AACA,UAAM,YAAY,KAAK,IAAA;AACvB,WAAO;AAAA,EACT,CAAC,EACA,MAAM,CAAC,UAAmB;AACzB,QAAI,qBAAqB,IAAI,QAAQ,MAAM,OAAO;AAChD,2BAAqB,OAAO,QAAQ;AAAA,IACtC;AACA,UAAM;AAAA,EACR,CAAC;AAEH,QAAM,UAAU;AAChB,uBAAqB,IAAI,UAAU,KAAK;AACxC,SAAO;AACT;AAEO,SAAS,mBACd,OACoB;AACpB,QAAM,OAAOC,MAAAA,WAAWC,wBAAc;AACtC,QAAM,kBAAkB,+BAAO,OAAO;AACtC,QAAM,YACJ,6BAAM,gBAAe,GAAG,KAAK,UAAU,IAAI,KAAK,WAAW;AAC7D,QAAM,CAAC,gBAAgB,iBAAiB,IAAIC,eAAA;AAK5CC,QAAAA,UAAU,MAAM;AACd,QAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,iBAAiB;AAC1C,wBAAkB,MAAS;AAC3B;AAAA,IACF;AAEA,QAAI,YAAY;AAChB,sBAAkB,IAAI,EAAE;AAAA,MACtB,CAAC,YAAY;AACX,YAAI,CAAC,WAAW;AACd,4BAAkB,EAAE,UAAU,KAAK,QAAQ,IAAI,eAAe,GAAG;AAAA,QACnE;AAAA,MACF;AAAA,MACA,MAAM;AACJ,YAAI,CAAC,UAAW,mBAAkB,EAAE,UAAU,KAAK,QAAW;AAAA,MAChE;AAAA,IAAA;AAGF,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,MAAM,UAAU,eAAe,CAAC;AAEpC,MAAI,CAAC,YAAY,CAAC,kBAAkB,eAAe,aAAa,UAAU;AACxE,WAAO;AAAA,EACT;AACA,SAAO,eAAe;AACxB;;"}

package/dist/chat-ui/mentions/use-member-avatar.d.ts

@@ -0,0 +1,2 @@
+export declare function useMemberAvatarUrl(email: string | undefined): string | undefined;
+export declare function resetMemberAvatarsForTests(): void;

package/dist/chat-ui/mentions/use-member-avatar.js

@@ -0,0 +1,75 @@
+import { useContext, useState, useEffect } from "react";
+import { MentionAuthCtx, fetchGraphQL, WORKSPACE_MEMBERS_QUERY } from "./suggestions/data/api-client.js";
+const MEMBER_AVATAR_TTL_MS = 5 * 60 * 1e3;
+const memberAvatarRequests = /* @__PURE__ */ new Map();
+function loadMemberAvatars(auth) {
+  const workspaceId = auth.workspaceId;
+  if (!workspaceId) return Promise.resolve(/* @__PURE__ */ new Map());
+  const cacheKey = `${auth.backendUrl}|${workspaceId}`;
+  const cached = memberAvatarRequests.get(cacheKey);
+  if (cached && (cached.fetchedAt === null || Date.now() - cached.fetchedAt < MEMBER_AVATAR_TTL_MS)) {
+    return cached.request;
+  }
+  const entry = {
+    request: Promise.resolve(/* @__PURE__ */ new Map()),
+    fetchedAt: null
+  };
+  const request = fetchGraphQL(
+    auth,
+    WORKSPACE_MEMBERS_QUERY,
+    { workspaceId }
+  ).then((data) => {
+    var _a;
+    const avatars = /* @__PURE__ */ new Map();
+    for (const member of data.getUsersInWorkspace ?? []) {
+      const email = (_a = member.email) == null ? void 0 : _a.trim().toLowerCase();
+      if (email && member.avatarUrl != null) {
+        avatars.set(email, member.avatarUrl);
+      }
+    }
+    entry.fetchedAt = Date.now();
+    return avatars;
+  }).catch((error) => {
+    if (memberAvatarRequests.get(cacheKey) === entry) {
+      memberAvatarRequests.delete(cacheKey);
+    }
+    throw error;
+  });
+  entry.request = request;
+  memberAvatarRequests.set(cacheKey, entry);
+  return request;
+}
+function useMemberAvatarUrl(email) {
+  const auth = useContext(MentionAuthCtx);
+  const normalizedEmail = email == null ? void 0 : email.trim().toLowerCase();
+  const cacheKey = (auth == null ? void 0 : auth.workspaceId) && `${auth.backendUrl}|${auth.workspaceId}`;
+  const [resolvedAvatar, setResolvedAvatar] = useState();
+  useEffect(() => {
+    if (!auth || !cacheKey || !normalizedEmail) {
+      setResolvedAvatar(void 0);
+      return;
+    }
+    let cancelled = false;
+    loadMemberAvatars(auth).then(
+      (avatars) => {
+        if (!cancelled) {
+          setResolvedAvatar({ cacheKey, url: avatars.get(normalizedEmail) });
+        }
+      },
+      () => {
+        if (!cancelled) setResolvedAvatar({ cacheKey, url: void 0 });
+      }
+    );
+    return () => {
+      cancelled = true;
+    };
+  }, [auth, cacheKey, normalizedEmail]);
+  if (!cacheKey || !resolvedAvatar || resolvedAvatar.cacheKey !== cacheKey) {
+    return void 0;
+  }
+  return resolvedAvatar.url;
+}
+export {
+  useMemberAvatarUrl
+};
+//# sourceMappingURL=use-member-avatar.js.map

package/dist/chat-ui/mentions/use-member-avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-member-avatar.js","sources":["../../../src/chat-ui/mentions/use-member-avatar.ts"],"sourcesContent":["import { useContext, useEffect, useState } from \"react\";\nimport {\n  fetchGraphQL,\n  MentionAuthCtx,\n  WORKSPACE_MEMBERS_QUERY,\n} from \"./suggestions/data/api-client\";\nimport type { MentionAuthContext } from \"./suggestions/data/api-client\";\n\ntype WorkspaceMemberAvatar = {\n  email?: string | null;\n  avatarUrl?: string | null;\n};\n\ntype WorkspaceMembersResponse = {\n  getUsersInWorkspace?: WorkspaceMemberAvatar[] | null;\n};\n\nconst MEMBER_AVATAR_TTL_MS = 5 * 60 * 1000;\n\ntype MemberAvatarCacheEntry = {\n  request: Promise<Map<string, string>>;\n  fetchedAt: number | null;\n};\n\nconst memberAvatarRequests = new Map<string, MemberAvatarCacheEntry>();\n\nfunction loadMemberAvatars(\n  auth: MentionAuthContext,\n): Promise<Map<string, string>> {\n  const workspaceId = auth.workspaceId;\n  if (!workspaceId) return Promise.resolve(new Map());\n\n  const cacheKey = `${auth.backendUrl}|${workspaceId}`;\n  const cached = memberAvatarRequests.get(cacheKey);\n  if (cached && (cached.fetchedAt === null || Date.now() - cached.fetchedAt < MEMBER_AVATAR_TTL_MS)) {\n    return cached.request;\n  }\n\n  const entry: MemberAvatarCacheEntry = {\n    request: Promise.resolve(new Map<string, string>()),\n    fetchedAt: null,\n  };\n  const request = fetchGraphQL<WorkspaceMembersResponse>(\n    auth,\n    WORKSPACE_MEMBERS_QUERY,\n    { workspaceId },\n  )\n    .then((data) => {\n      const avatars = new Map<string, string>();\n      for (const member of data.getUsersInWorkspace ?? []) {\n        const email = member.email?.trim().toLowerCase();\n        if (email && member.avatarUrl != null) {\n          avatars.set(email, member.avatarUrl);\n        }\n      }\n      entry.fetchedAt = Date.now();\n      return avatars;\n    })\n    .catch((error: unknown) => {\n      if (memberAvatarRequests.get(cacheKey) === entry) {\n        memberAvatarRequests.delete(cacheKey);\n      }\n      throw error;\n    });\n\n  entry.request = request;\n  memberAvatarRequests.set(cacheKey, entry);\n  return request;\n}\n\nexport function useMemberAvatarUrl(\n  email: string | undefined,\n): string | undefined {\n  const auth = useContext(MentionAuthCtx);\n  const normalizedEmail = email?.trim().toLowerCase();\n  const cacheKey =\n    auth?.workspaceId && `${auth.backendUrl}|${auth.workspaceId}`;\n  const [resolvedAvatar, setResolvedAvatar] = useState<{\n    cacheKey: string;\n    url: string | undefined;\n  }>();\n\n  useEffect(() => {\n    if (!auth || !cacheKey || !normalizedEmail) {\n      setResolvedAvatar(undefined);\n      return;\n    }\n\n    let cancelled = false;\n    loadMemberAvatars(auth).then(\n      (avatars) => {\n        if (!cancelled) {\n          setResolvedAvatar({ cacheKey, url: avatars.get(normalizedEmail) });\n        }\n      },\n      () => {\n        if (!cancelled) setResolvedAvatar({ cacheKey, url: undefined });\n      },\n    );\n\n    return () => {\n      cancelled = true;\n    };\n  }, [auth, cacheKey, normalizedEmail]);\n\n  if (!cacheKey || !resolvedAvatar || resolvedAvatar.cacheKey !== cacheKey) {\n    return undefined;\n  }\n  return resolvedAvatar.url;\n}\n\nexport function resetMemberAvatarsForTests(): void {\n  memberAvatarRequests.clear();\n}\n"],"names":[],"mappings":";;AAiBA,MAAM,uBAAuB,IAAI,KAAK;AAOtC,MAAM,2CAA2B,IAAA;AAEjC,SAAS,kBACP,MAC8B;AAC9B,QAAM,cAAc,KAAK;AACzB,MAAI,CAAC,YAAa,QAAO,QAAQ,QAAQ,oBAAI,KAAK;AAElD,QAAM,WAAW,GAAG,KAAK,UAAU,IAAI,WAAW;AAClD,QAAM,SAAS,qBAAqB,IAAI,QAAQ;AAChD,MAAI,WAAW,OAAO,cAAc,QAAQ,KAAK,IAAA,IAAQ,OAAO,YAAY,uBAAuB;AACjG,WAAO,OAAO;AAAA,EAChB;AAEA,QAAM,QAAgC;AAAA,IACpC,SAAS,QAAQ,QAAQ,oBAAI,KAAqB;AAAA,IAClD,WAAW;AAAA,EAAA;AAEb,QAAM,UAAU;AAAA,IACd;AAAA,IACA;AAAA,IACA,EAAE,YAAA;AAAA,EAAY,EAEb,KAAK,CAAC,SAAS;;AACd,UAAM,8BAAc,IAAA;AACpB,eAAW,UAAU,KAAK,uBAAuB,CAAA,GAAI;AACnD,YAAM,SAAQ,YAAO,UAAP,mBAAc,OAAO;AACnC,UAAI,SAAS,OAAO,aAAa,MAAM;AACrC,gBAAQ,IAAI,OAAO,OAAO,SAAS;AAAA,MACrC;AAAA,IACF;AACA,UAAM,YAAY,KAAK,IAAA;AACvB,WAAO;AAAA,EACT,CAAC,EACA,MAAM,CAAC,UAAmB;AACzB,QAAI,qBAAqB,IAAI,QAAQ,MAAM,OAAO;AAChD,2BAAqB,OAAO,QAAQ;AAAA,IACtC;AACA,UAAM;AAAA,EACR,CAAC;AAEH,QAAM,UAAU;AAChB,uBAAqB,IAAI,UAAU,KAAK;AACxC,SAAO;AACT;AAEO,SAAS,mBACd,OACoB;AACpB,QAAM,OAAO,WAAW,cAAc;AACtC,QAAM,kBAAkB,+BAAO,OAAO;AACtC,QAAM,YACJ,6BAAM,gBAAe,GAAG,KAAK,UAAU,IAAI,KAAK,WAAW;AAC7D,QAAM,CAAC,gBAAgB,iBAAiB,IAAI,SAAA;AAK5C,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,iBAAiB;AAC1C,wBAAkB,MAAS;AAC3B;AAAA,IACF;AAEA,QAAI,YAAY;AAChB,sBAAkB,IAAI,EAAE;AAAA,MACtB,CAAC,YAAY;AACX,YAAI,CAAC,WAAW;AACd,4BAAkB,EAAE,UAAU,KAAK,QAAQ,IAAI,eAAe,GAAG;AAAA,QACnE;AAAA,MACF;AAAA,MACA,MAAM;AACJ,YAAI,CAAC,UAAW,mBAAkB,EAAE,UAAU,KAAK,QAAW;AAAA,MAChE;AAAA,IAAA;AAGF,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,MAAM,UAAU,eAAe,CAAC;AAEpC,MAAI,CAAC,YAAY,CAAC,kBAAkB,eAAe,aAAa,UAAU;AACxE,WAAO;AAAA,EACT;AACA,SAAO,eAAe;AACxB;"}

package/dist/collab/client.cjs

@@ -50,7 +50,8 @@ function connectGenericDoc(args) {
   let openingPastThreshold = null;
   let mintRetries = 0;
   let destroyed = false;
-  let status = "connecting";
+  let connectionEnabled = args.connectionEnabled ?? true;
+  let status = connectionEnabled ? "connecting" : "disconnected";
   let synced = false;
   let accessType = null;
   let error = null;
@@ -86,11 +87,10 @@ function connectGenericDoc(args) {
   };
   const refreshLocalChangesSynced = () => {
     const next = carriedUpdates.length === 0 && ((provider == null ? void 0 : provider.unconfirmedUpdates.length) ?? 0) === 0;
-    if (next !== localChangesSynced) {
-      localChangesSynced = next;
-      notify();
-    }
+    const changed = next !== localChangesSynced;
+    localChangesSynced = next;
     transportChanged();
+    if (changed) notify();
   };
   doc.on("update", (update, origin) => {
     if (!prepared || provider !== null || destroyed || origin instanceof websocket.WebsocketProvider) return;
@@ -140,9 +140,10 @@ function connectGenericDoc(args) {
       notify();
     }
     if (provider) {
-      carriedUpdates = [...carriedUpdates, ...provider.unconfirmedUpdates];
-      provider.destroy();
+      const previous = provider;
       provider = null;
+      carriedUpdates = [...carriedUpdates, ...previous.unconfirmedUpdates];
+      previous.destroy();
     }
   };
   const scheduleRefresh = (grant) => {
@@ -162,17 +163,17 @@ function connectGenericDoc(args) {
     }, delay);
   };
   const onBrowserOnline = () => {
-    if (destroyed || status === "closed" || status === "error" || provider !== null || held) return;
+    if (destroyed || !connectionEnabled || status === "closed" || status === "error" || provider !== null || held) return;
     mintRetries = 0;
     clearRetryTimer();
     void connect();
   };
   if (typeof window !== "undefined") window.addEventListener("online", onBrowserOnline);
   const armOfflineTakeover = () => {
-    if (offlineTimer !== null || !(localCopy == null ? void 0 : localCopy.beforeConnect)) return;
+    if (!connectionEnabled || offlineTimer !== null || !(localCopy == null ? void 0 : localCopy.beforeConnect)) return;
     offlineTimer = setTimeout(() => {
       offlineTimer = null;
-      if (destroyed || status === "connected" || provider === null) return;
+      if (destroyed || !connectionEnabled || status === "connected" || provider === null) return;
       if (provider.wsconnecting && !hasUnsyncedLocalEdits()) {
         openingPastThreshold = provider;
         armOfflineTakeover();
@@ -184,10 +185,10 @@ function connectGenericDoc(args) {
   };
   const hasUnsyncedLocalEdits = () => carriedUpdates.length > 0 || ((provider == null ? void 0 : provider.unconfirmedUpdates.length) ?? 0) > 0;
   const connect = async (opts) => {
-    if (destroyed) return;
-    await preparing;
-    if (destroyed) return;
+    if (destroyed || !connectionEnabled) return;
     const seq = ++connectSeq;
+    await preparing;
+    if (destroyed || !connectionEnabled || seq !== connectSeq) return;
     const scheduledRefresh = (opts == null ? void 0 : opts.scheduledRefresh) === true && status === "connected";
     if (!scheduledRefresh) {
       teardownProvider();
@@ -195,6 +196,7 @@ function connectGenericDoc(args) {
       clearRefreshTimer();
     }
     clearRetryTimer();
+    if (destroyed || !connectionEnabled || seq !== connectSeq) return;
     let grant;
     if ((opts == null ? void 0 : opts.grant) && opts.grant.expires_at_ms - Date.now() > tokenRefresh.MIN_REFRESH_DELAY_MS) {
       grant = opts.grant;
@@ -202,7 +204,7 @@ function connectGenericDoc(args) {
       try {
         grant = await mint2({ assetId: args.assetId, access });
       } catch (err) {
-        if (destroyed || seq !== connectSeq) return;
+        if (destroyed || !connectionEnabled || seq !== connectSeq) return;
         if (scheduledRefresh) {
           refreshTimer = setTimeout(() => {
             void connect({ scheduledRefresh: true });
@@ -218,7 +220,7 @@ function connectGenericDoc(args) {
         return;
       }
     }
-    if (destroyed || seq !== connectSeq) return;
+    if (destroyed || !connectionEnabled || seq !== connectSeq) return;
     mintRetries = 0;
     accessType = grant.access_type;
     const beforeConnect = localCopy == null ? void 0 : localCopy.beforeConnect;
@@ -234,12 +236,12 @@ function connectGenericDoc(args) {
           hasUnsyncedEdits: hasUnsyncedLocalEdits()
         });
       } catch {
-        if (destroyed || seq !== connectSeq) return;
+        if (destroyed || !connectionEnabled || seq !== connectSeq) return;
         if (status !== "disconnected") setStatus("disconnected");
         scheduleRetry();
         return;
       }
-      if (destroyed || seq !== connectSeq) return;
+      if (destroyed || !connectionEnabled || seq !== connectSeq) return;
       if (decision === "hold") {
         held = true;
         heldGrant = grant;
@@ -251,6 +253,7 @@ function connectGenericDoc(args) {
     if (scheduledRefresh) {
       teardownProvider();
     }
+    if (destroyed || !connectionEnabled || seq !== connectSeq) return;
     const nextProvider = new websocket.WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {
       params: {
         yauth: grant.token,
@@ -372,6 +375,41 @@ function connectGenericDoc(args) {
     };
     listeners.add(listener);
   });
+  const waitForAcknowledged = (timeoutMs = 15e3) => new Promise((resolve, reject) => {
+    let finished = false;
+    let checkQueued = false;
+    let timer = null;
+    const finish = (failure) => {
+      if (finished) return;
+      finished = true;
+      if (timer !== null) clearTimeout(timer);
+      listeners.delete(check);
+      if (failure) reject(failure);
+      else resolve();
+    };
+    const check = () => {
+      if (finished || checkQueued) return;
+      checkQueued = true;
+      queueMicrotask(() => {
+        checkQueued = false;
+        if (finished) return;
+        if (destroyed) {
+          finish(new Error("Handle destroyed before local changes were acknowledged"));
+        } else if (!connectionEnabled) {
+          finish(new Error("Connection disabled before local changes were acknowledged"));
+        } else if (status === "closed" || status === "error") {
+          finish(error ?? new Error(`Connection ${status} before local changes were acknowledged`));
+        } else if (prepared && status === "connected" && synced && localChangesSynced) {
+          finish();
+        }
+      });
+    };
+    timer = setTimeout(() => {
+      finish(new Error(`Timed out after ${timeoutMs}ms waiting for local changes to be acknowledged`));
+    }, timeoutMs);
+    listeners.add(check);
+    check();
+  });
   return {
     doc,
     get status() {
@@ -392,6 +430,9 @@ function connectGenericDoc(args) {
     get prepared() {
       return prepared;
     },
+    get connectionEnabled() {
+      return connectionEnabled;
+    },
     get held() {
       return held;
     },
@@ -399,6 +440,7 @@ function connectGenericDoc(args) {
       return version;
     },
     waitForSync,
+    waitForAcknowledged,
     getPresence: () => {
       if (!provider) return [];
       const entries = [];
@@ -412,11 +454,30 @@ function connectGenericDoc(args) {
       provider == null ? void 0 : provider.awareness.setLocalState(state);
     },
     refreshNow: () => {
-      if (held) return Promise.resolve();
+      if (!connectionEnabled || held) return Promise.resolve();
       return provider ? connect({ scheduledRefresh: true }) : connect();
     },
+    setConnectionEnabled: (enabled) => {
+      var _a, _b;
+      if (destroyed || enabled === connectionEnabled) return;
+      connectionEnabled = enabled;
+      if (!enabled) {
+        connectSeq += 1;
+        clearRetryTimer();
+        clearOfflineTimer();
+        teardownProvider();
+        setStatus("disconnected");
+        (_a = localCopy == null ? void 0 : localCopy.connectionPolicyChanged) == null ? void 0 : _a.call(localCopy, false);
+        return;
+      }
+      (_b = localCopy == null ? void 0 : localCopy.connectionPolicyChanged) == null ? void 0 : _b.call(localCopy, true);
+      held = false;
+      heldGrant = null;
+      setStatus("connecting");
+      void connect();
+    },
     resume: () => {
-      if (!held || destroyed) return;
+      if (!held || destroyed || !connectionEnabled) return;
       held = false;
       const grant = heldGrant;
       heldGrant = null;