@athenaintel/react 0.57.2 → 0.59.0

package/dist/search/useAthenaAssets.cjs

@@ -0,0 +1,394 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactQuery = require("@tanstack/react-query");
+const require$$0 = require("react");
+const AthenaAuthContext = require("../auth/AthenaAuthContext.cjs");
+const apiClient = require("../chat-ui/mentions/suggestions/data/api-client.cjs");
+const useAccountWorkspaceId = require("../chat-ui/mentions/use-account-workspace-id.cjs");
+const useAthenaRestQuery = require("../lib/use-athena-rest-query.cjs");
+const AthenaContext = require("../provider/AthenaContext.cjs");
+const AthenaAssetOrder = {
+  /**
+   * The best title match first (agora's `RELEVANCE`: the title is the words, starts with them,
+   * holds them…), then the newest change. An agora from before that order answers by the newest
+   * change instead.
+   */
+  BestMatch: "best-match",
+  /** The newest change first. */
+  NewestChange: "newest-change"
+};
+const ATHENA_RECENT_ASSETS_NOT_TYPES = [
+  "folder",
+  "email_message",
+  "session",
+  "catalog"
+];
+const ATHENA_SUB_ASSET_MEDIA_TYPES = [
+  "athena/meeting_transcript",
+  "athena/meeting_transcript_formatted",
+  "athena/meeting_recording",
+  "athena/meeting_chat_transcript",
+  "athena/browse_session_recording"
+];
+function athenaAssetSearchInput({
+  query,
+  sortField
+}) {
+  var _a, _b;
+  const filterColumns = { isArchived: false, isHidden: false };
+  if (query.favorites) filterColumns.isFavorited = true;
+  if ((_a = query.createdBy) == null ? void 0 : _a.length) filterColumns.createdBy = [...query.createdBy];
+  if ((_b = query.notMediaTypes) == null ? void 0 : _b.length) filterColumns.notMediaType = [...query.notMediaTypes];
+  return {
+    searchRequest: {
+      query: query.words.trim(),
+      type: [...query.types ?? []],
+      notType: [...query.notTypes ?? []],
+      limit: query.limit,
+      offset: query.offset ?? 0
+    },
+    returnFullAsset: true,
+    shouldCalculateTotal: false,
+    sort: { field: sortField, direction: "DESC" },
+    filterColumns
+  };
+}
+const BAD_USER_INPUT = "BAD_USER_INPUT";
+function refusedInput(error) {
+  return Reflect.get(Object(error), "code") === BAD_USER_INPUT;
+}
+async function searchAthenaAssets({
+  auth,
+  query,
+  signal
+}) {
+  const ask = async (sortField) => {
+    var _a;
+    const data = await apiClient.fetchGraphQL(
+      auth,
+      apiClient.SIMPLE_SEARCH_QUERY,
+      { input: athenaAssetSearchInput({ query, sortField }) },
+      { signal }
+    );
+    return ((_a = data.simpleSearch) == null ? void 0 : _a.assets) ?? [];
+  };
+  if (query.order === AthenaAssetOrder.NewestChange) return ask("UPDATED_AT");
+  try {
+    return await ask("RELEVANCE");
+  } catch (error) {
+    if (!refusedInput(error)) throw error;
+    return ask("UPDATED_AT");
+  }
+}
+const REFUSED_STATUSES = /* @__PURE__ */ new Set([400, 401, 403, 404]);
+const REFUSED_CODES = /* @__PURE__ */ new Set([BAD_USER_INPUT, "UNAUTHORIZED", "FORBIDDEN"]);
+function retryTransient(failureCount, error) {
+  const status = Reflect.get(error, "status");
+  const code = Reflect.get(error, "code");
+  if (typeof status === "number" && REFUSED_STATUSES.has(status)) return false;
+  if (typeof code === "string" && REFUSED_CODES.has(code)) return false;
+  return failureCount < 1;
+}
+function useAssetReadAuth() {
+  var _a, _b;
+  const config = AthenaContext.useAthenaConfig();
+  const userId = (_b = (_a = require$$0.useContext(AthenaAuthContext.AthenaAuthContext)) == null ? void 0 : _a.user) == null ? void 0 : _b.userId;
+  return require$$0.useMemo(
+    () => ({
+      backendUrl: config.backendUrl,
+      appUrl: config.appUrl,
+      apiKey: config.apiKey,
+      credentials: "include",
+      userId,
+      get accessToken() {
+        return config.token ?? void 0;
+      },
+      getAccessToken: async () => {
+        var _a2;
+        return await ((_a2 = config.getToken) == null ? void 0 : _a2.call(config)) ?? void 0;
+      },
+      renewAccessToken: async () => {
+        var _a2;
+        return await ((_a2 = config.getToken) == null ? void 0 : _a2.call(config, { force: true })) ?? void 0;
+      }
+    }),
+    [config, userId]
+  );
+}
+const ASSET_READ_FRESH_MS = 3e4;
+function useAssetRead({
+  name,
+  query,
+  enabled
+}) {
+  const config = AthenaContext.useAthenaConfig();
+  const auth = useAssetReadAuth();
+  const identity = useAthenaRestQuery.useAthenaQueryIdentity({
+    apiKey: config.apiKey,
+    token: config.token,
+    getToken: config.getToken
+  });
+  return reactQuery.useQuery(
+    {
+      queryKey: ["athena-sdk", "assets", name, config.backendUrl, ...identity, query],
+      queryFn: ({ signal }) => searchAthenaAssets({ auth, query, signal }),
+      enabled: enabled && config.backendUrl.length > 0,
+      staleTime: ASSET_READ_FRESH_MS,
+      retry: retryTransient,
+      refetchOnWindowFocus: false
+    },
+    useAthenaRestQuery.useAthenaQueryClient()
+  );
+}
+function useAthenaAssetSearch({
+  words,
+  limit = 8,
+  notTypes = [],
+  enabled = true
+}) {
+  const trimmed = words.trim();
+  return useAssetRead({
+    name: "search",
+    query: { words: trimmed, limit, notTypes, order: AthenaAssetOrder.BestMatch },
+    enabled: enabled && trimmed.length > 0
+  });
+}
+function useAthenaRecentAssets({
+  limit = 8,
+  enabled = true
+} = {}) {
+  const config = AthenaContext.useAthenaConfig();
+  const { userId } = useAccountWorkspaceId.useAccountIdentity(useAssetReadAuth(), { tokenGetter: config.getToken });
+  return useAssetRead({
+    name: "recent",
+    query: {
+      words: "",
+      limit,
+      notTypes: ATHENA_RECENT_ASSETS_NOT_TYPES,
+      notMediaTypes: ATHENA_SUB_ASSET_MEDIA_TYPES,
+      createdBy: userId ? [userId] : [],
+      order: AthenaAssetOrder.NewestChange
+    },
+    enabled: enabled && userId !== void 0
+  });
+}
+function useAthenaFavoriteAssets({
+  limit = 8,
+  notTypes = [],
+  enabled = true
+} = {}) {
+  return useAssetRead({
+    name: "favorites",
+    query: { words: "", limit, favorites: true, notTypes, order: AthenaAssetOrder.NewestChange },
+    enabled
+  });
+}
+function useAthenaProjects({
+  limit = 20,
+  enabled = true
+} = {}) {
+  return useAssetRead({
+    name: "projects",
+    query: { words: "", limit, types: ["project"], order: AthenaAssetOrder.NewestChange },
+    enabled
+  });
+}
+const FOLDER_LEFT_OUT = /* @__PURE__ */ new Set(["session", "catalog"]);
+function shownInFolder(asset) {
+  return !FOLDER_LEFT_OUT.has(asset.athenaOriginalType ?? "");
+}
+function filedIn(asset, folderId) {
+  return (asset.parentFolderId ?? null) === folderId && asset.isHidden !== true;
+}
+function athenaFolderPageOf({
+  rows,
+  folderId,
+  limit,
+  offset
+}) {
+  const own = rows.slice(0, limit).filter((asset) => filedIn(asset, folderId));
+  const seen = /* @__PURE__ */ new Set();
+  const assets = own.filter((asset) => {
+    if (seen.has(asset.id) || !shownInFolder(asset)) return false;
+    seen.add(asset.id);
+    return true;
+  });
+  return { assets, next: own.length >= limit ? offset + limit : null };
+}
+async function listAthenaFolder({
+  auth,
+  folderId,
+  limit,
+  offset,
+  signal
+}) {
+  const data = await apiClient.fetchGraphQL(
+    auth,
+    apiClient.PAGINATED_ASSETS_QUERY,
+    {
+      limit,
+      offset,
+      parentFolderId: folderId,
+      filterTypes: null,
+      filterColumns: { isArchived: false, isHidden: false }
+    },
+    { signal }
+  );
+  return athenaFolderPageOf({
+    rows: data.getPaginatedAssetsForWorkspace ?? [],
+    folderId,
+    limit,
+    offset
+  });
+}
+function oncePerAsset(data) {
+  const seen = /* @__PURE__ */ new Set();
+  return {
+    ...data,
+    pages: data.pages.map((page) => ({
+      ...page,
+      assets: page.assets.filter((asset) => {
+        if (seen.has(asset.id)) return false;
+        seen.add(asset.id);
+        return true;
+      })
+    }))
+  };
+}
+function useAthenaFolderAssets({
+  folderId,
+  pageSize = 50,
+  enabled = true
+}) {
+  const config = AthenaContext.useAthenaConfig();
+  const auth = useAssetReadAuth();
+  const identity = useAthenaRestQuery.useAthenaQueryIdentity({
+    apiKey: config.apiKey,
+    token: config.token,
+    getToken: config.getToken
+  });
+  return reactQuery.useInfiniteQuery(
+    {
+      queryKey: [
+        "athena-sdk",
+        "assets",
+        "folder",
+        config.backendUrl,
+        ...identity,
+        folderId,
+        pageSize
+      ],
+      queryFn: ({ pageParam, signal }) => listAthenaFolder({
+        auth,
+        folderId,
+        limit: pageSize,
+        offset: typeof pageParam === "number" ? pageParam : 0,
+        signal
+      }),
+      initialPageParam: 0,
+      getNextPageParam: (last) => last.next ?? void 0,
+      select: oncePerAsset,
+      enabled: enabled && config.backendUrl.length > 0,
+      staleTime: ASSET_READ_FRESH_MS,
+      retry: retryTransient,
+      refetchOnWindowFocus: false
+    },
+    useAthenaRestQuery.useAthenaQueryClient()
+  );
+}
+function useAthenaAssetsRefresh() {
+  const config = AthenaContext.useAthenaConfig();
+  const identity = useAthenaRestQuery.useAthenaQueryIdentity({
+    apiKey: config.apiKey,
+    token: config.token,
+    getToken: config.getToken
+  });
+  const queryClient = useAthenaRestQuery.useAthenaQueryClient();
+  return () => queryClient.invalidateQueries({
+    predicate: ({ queryKey }) => queryKey[0] === "athena-sdk" && queryKey[1] === "assets" && queryKey[3] === config.backendUrl && identity.every((part, at) => Object.is(queryKey[4 + at], part))
+  });
+}
+const PROJECT_ASSETS_QUERY = `
+  query AthenaProjectAssets($projectId: String!, $first: Int!, $after: String) {
+    getProjectLinkedAssetsPaginated(projectId: $projectId, first: $first, after: $after) {
+      hasNextPage
+      nextCursor
+      items {
+        asset {
+          ${apiClient.MENTION_ASSET_FIELDS}
+        }
+      }
+    }
+  }
+`;
+async function listAthenaProjectAssets({
+  auth,
+  projectId,
+  first,
+  after,
+  signal
+}) {
+  const data = await apiClient.fetchGraphQL(auth, PROJECT_ASSETS_QUERY, { projectId, first, after }, { signal });
+  const page = data.getProjectLinkedAssetsPaginated;
+  return {
+    assets: ((page == null ? void 0 : page.items) ?? []).map((item) => item.asset).filter(shownInFolder),
+    next: (page == null ? void 0 : page.hasNextPage) && page.nextCursor ? page.nextCursor : null
+  };
+}
+function useAthenaProjectAssets({
+  projectId,
+  pageSize = 20,
+  enabled = true
+}) {
+  const config = AthenaContext.useAthenaConfig();
+  const auth = useAssetReadAuth();
+  const identity = useAthenaRestQuery.useAthenaQueryIdentity({
+    apiKey: config.apiKey,
+    token: config.token,
+    getToken: config.getToken
+  });
+  return reactQuery.useInfiniteQuery(
+    {
+      queryKey: [
+        "athena-sdk",
+        "assets",
+        "project",
+        config.backendUrl,
+        ...identity,
+        projectId,
+        pageSize
+      ],
+      queryFn: ({ pageParam, signal }) => listAthenaProjectAssets({
+        auth,
+        projectId,
+        first: pageSize,
+        after: typeof pageParam === "string" ? pageParam : null,
+        signal
+      }),
+      initialPageParam: null,
+      getNextPageParam: (last) => last.next ?? void 0,
+      enabled: enabled && config.backendUrl.length > 0,
+      staleTime: ASSET_READ_FRESH_MS,
+      retry: retryTransient,
+      refetchOnWindowFocus: false
+    },
+    useAthenaRestQuery.useAthenaQueryClient()
+  );
+}
+exports.ATHENA_RECENT_ASSETS_NOT_TYPES = ATHENA_RECENT_ASSETS_NOT_TYPES;
+exports.ATHENA_SUB_ASSET_MEDIA_TYPES = ATHENA_SUB_ASSET_MEDIA_TYPES;
+exports.AthenaAssetOrder = AthenaAssetOrder;
+exports.PROJECT_ASSETS_QUERY = PROJECT_ASSETS_QUERY;
+exports.athenaAssetSearchInput = athenaAssetSearchInput;
+exports.athenaFolderPageOf = athenaFolderPageOf;
+exports.listAthenaFolder = listAthenaFolder;
+exports.listAthenaProjectAssets = listAthenaProjectAssets;
+exports.searchAthenaAssets = searchAthenaAssets;
+exports.useAthenaAssetSearch = useAthenaAssetSearch;
+exports.useAthenaAssetsRefresh = useAthenaAssetsRefresh;
+exports.useAthenaFavoriteAssets = useAthenaFavoriteAssets;
+exports.useAthenaFolderAssets = useAthenaFolderAssets;
+exports.useAthenaProjectAssets = useAthenaProjectAssets;
+exports.useAthenaProjects = useAthenaProjects;
+exports.useAthenaRecentAssets = useAthenaRecentAssets;
+//# sourceMappingURL=useAthenaAssets.cjs.map

package/dist/search/useAthenaAssets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAthenaAssets.cjs","sources":["../../src/search/useAthenaAssets.ts"],"sourcesContent":["/**\n * Finding the assets the signed-in person may open, the way Athena on the web's ⌘K box and its\n * sidebar find them: a title search, the person's recent work (what they created, newest change\n * first: the sidebar's \"Your Recents\") and their favourites. Every read is agora's `simpleSearch`\n * (`SIMPLE_SEARCH_QUERY`, the query the composer's @-mentions send), which agora answers under the\n * workspace's read gate (`search_visibility`, built on `asset_access_query`): only assets the\n * caller may open come back, never a hidden one, and never an archived one here. The hooks read\n * through TanStack Query on the host's client (the session list's when the provider has one), so\n * they wait while Athena can't be reached, as the SDK's other reads do.\n */\nimport {\n  type InfiniteData,\n  useInfiniteQuery,\n  type UseInfiniteQueryResult,\n  useQuery,\n  type UseQueryResult,\n} from '@tanstack/react-query';\nimport { useContext, useMemo } from 'react';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  type AssetResult,\n  fetchGraphQL,\n  MENTION_ASSET_FIELDS,\n  type MentionAuthContext,\n  PAGINATED_ASSETS_QUERY,\n  SIMPLE_SEARCH_QUERY,\n} from '../chat-ui/mentions/suggestions/data/api-client';\nimport { useAccountIdentity } from '../chat-ui/mentions/use-account-workspace-id';\nimport { useAthenaQueryClient, useAthenaQueryIdentity } from '../lib/use-athena-rest-query';\nimport { useAthenaConfig } from '../provider/AthenaContext';\n\n/** An asset as these reads answer it: what a row needs to draw it and open it. */\nexport type AthenaAssetSummary = AssetResult;\n\n/** The order a read asks agora for. */\nexport const AthenaAssetOrder = {\n  /**\n   * The best title match first (agora's `RELEVANCE`: the title is the words, starts with them,\n   * holds them…), then the newest change. An agora from before that order answers by the newest\n   * change instead.\n   */\n  BestMatch: 'best-match',\n  /** The newest change first. */\n  NewestChange: 'newest-change',\n} as const;\nexport type AthenaAssetOrder = (typeof AthenaAssetOrder)[keyof typeof AthenaAssetOrder];\n\n/** One read of the assets the person may open. */\nexport interface AthenaAssetQuery {\n  /** Words the title holds; empty lists without words. */\n  words: string;\n  limit: number;\n  offset?: number;\n  /** Only assets of these types (agora's asset type values: `spreadsheet`, `folder`…). */\n  types?: readonly string[];\n  /** Leave out assets of these types. */\n  notTypes?: readonly string[];\n  /** Leave out the sub-assets of these media types (a meeting's transcript files). */\n  notMediaTypes?: readonly string[];\n  /** Only the person's favourites. */\n  favorites?: boolean;\n  /** Only the assets these agora users created (`user_…`). */\n  createdBy?: readonly string[];\n  order: AthenaAssetOrder;\n}\n\n/** The sort field agora's `SortField` names for an order. */\ntype AssetSortField = 'RELEVANCE' | 'UPDATED_AT';\n\n/**\n * What \"Your Recents\" leaves out, as Athena on the web's sidebar does (`useYourRecents`): folders,\n * emails, conversations and catalogs.\n */\nexport const ATHENA_RECENT_ASSETS_NOT_TYPES: readonly string[] = [\n  'folder',\n  'email_message',\n  'session',\n  'catalog',\n];\n\n/**\n * The files a meeting or a browse session keeps beside itself (its transcripts, its recording),\n * which Athena on the web never lists among the person's own (`HIDDEN_SUB_ASSET_MEDIA_TYPES`).\n */\nexport const ATHENA_SUB_ASSET_MEDIA_TYPES: readonly string[] = [\n  'athena/meeting_transcript',\n  'athena/meeting_transcript_formatted',\n  'athena/meeting_recording',\n  'athena/meeting_chat_transcript',\n  'athena/browse_session_recording',\n];\n\n/** `simpleSearch`'s `input` for a read, sorted by `sortField`. */\nexport function athenaAssetSearchInput({\n  query,\n  sortField,\n}: {\n  query: AthenaAssetQuery;\n  sortField: AssetSortField;\n}): Record<string, unknown> {\n  const filterColumns: Record<string, unknown> = { isArchived: false, isHidden: false };\n  if (query.favorites) filterColumns.isFavorited = true;\n  if (query.createdBy?.length) filterColumns.createdBy = [...query.createdBy];\n  if (query.notMediaTypes?.length) filterColumns.notMediaType = [...query.notMediaTypes];\n  return {\n    searchRequest: {\n      query: query.words.trim(),\n      type: [...(query.types ?? [])],\n      notType: [...(query.notTypes ?? [])],\n      limit: query.limit,\n      offset: query.offset ?? 0,\n    },\n    returnFullAsset: true,\n    shouldCalculateTotal: false,\n    sort: { field: sortField, direction: 'DESC' },\n    filterColumns,\n  };\n}\n\n/** The `extensions.code` agora answers a GraphQL input it cannot read with. */\nconst BAD_USER_INPUT = 'BAD_USER_INPUT';\n\n/** Whether agora refused the request's inputs (an older agora reading a newer value). */\nfunction refusedInput(error: unknown): boolean {\n  return Reflect.get(Object(error), 'code') === BAD_USER_INPUT;\n}\n\n/**\n * One read (`simpleSearch`). `BestMatch` asks agora for `RELEVANCE`; an agora that predates it\n * refuses the value as bad input, and is asked once more by the newest change. Any other failure\n * stands.\n */\nexport async function searchAthenaAssets({\n  auth,\n  query,\n  signal,\n}: {\n  auth: MentionAuthContext;\n  query: AthenaAssetQuery;\n  signal?: AbortSignal;\n}): Promise<AthenaAssetSummary[]> {\n  const ask = async (sortField: AssetSortField) => {\n    const data = await fetchGraphQL<{\n      simpleSearch: { assets: AssetResult[] | null } | null;\n    }>(\n      auth,\n      SIMPLE_SEARCH_QUERY,\n      { input: athenaAssetSearchInput({ query, sortField }) },\n      { signal },\n    );\n    return data.simpleSearch?.assets ?? [];\n  };\n  if (query.order === AthenaAssetOrder.NewestChange) return ask('UPDATED_AT');\n  try {\n    return await ask('RELEVANCE');\n  } catch (error) {\n    if (!refusedInput(error)) throw error;\n    return ask('UPDATED_AT');\n  }\n}\n\n/** Statuses and codes that answer the same way again: never retried. */\nconst REFUSED_STATUSES: ReadonlySet<number> = new Set([400, 401, 403, 404]);\nconst REFUSED_CODES: ReadonlySet<string> = new Set([BAD_USER_INPUT, 'UNAUTHORIZED', 'FORBIDDEN']);\n\n/** A transient failure is read once more; a refusal is not. */\nfunction retryTransient(failureCount: number, error: Error): boolean {\n  const status: unknown = Reflect.get(error, 'status');\n  const code: unknown = Reflect.get(error, 'code');\n  if (typeof status === 'number' && REFUSED_STATUSES.has(status)) return false;\n  if (typeof code === 'string' && REFUSED_CODES.has(code)) return false;\n  return failureCount < 1;\n}\n\n/**\n * The provider's credential as agora's GraphQL reads take it: the same shape the chat's\n * @-mentions read with (`AthenaChat`), so a host adds no other path for its key or token.\n */\nfunction useAssetReadAuth(): MentionAuthContext {\n  const config = useAthenaConfig();\n  const userId = useContext(AthenaAuthContext)?.user?.userId;\n  return useMemo<MentionAuthContext>(\n    () => ({\n      backendUrl: config.backendUrl,\n      appUrl: config.appUrl,\n      apiKey: config.apiKey,\n      credentials: 'include',\n      userId,\n      get accessToken() {\n        return config.token ?? undefined;\n      },\n      getAccessToken: async () => (await config.getToken?.()) ?? undefined,\n      renewAccessToken: async () => (await config.getToken?.({ force: true })) ?? undefined,\n    }),\n    [config, userId],\n  );\n}\n\n/** How long an answer serves another read of the same assets before agora is asked again. */\nconst ASSET_READ_FRESH_MS = 30_000;\n\n/**\n * A read through TanStack Query, keyed by the request, the backend, the signed-in principal and\n * a fingerprint of the credential (`useAthenaQueryIdentity`), never the credential itself.\n */\nfunction useAssetRead({\n  name,\n  query,\n  enabled,\n}: {\n  name: string;\n  query: AthenaAssetQuery;\n  enabled: boolean;\n}): UseQueryResult<AthenaAssetSummary[], Error> {\n  const config = useAthenaConfig();\n  const auth = useAssetReadAuth();\n  const identity = useAthenaQueryIdentity({\n    apiKey: config.apiKey,\n    token: config.token,\n    getToken: config.getToken,\n  });\n  return useQuery(\n    {\n      queryKey: ['athena-sdk', 'assets', name, config.backendUrl, ...identity, query],\n      queryFn: ({ signal }) => searchAthenaAssets({ auth, query, signal }),\n      enabled: enabled && config.backendUrl.length > 0,\n      staleTime: ASSET_READ_FRESH_MS,\n      retry: retryTransient,\n      refetchOnWindowFocus: false,\n    },\n    useAthenaQueryClient(),\n  );\n}\n\nexport interface UseAthenaAssetSearchOptions {\n  /** The words; blank holds the read idle. */\n  words: string;\n  /** At most this many, the best match first. Default 8. */\n  limit?: number;\n  /** Leave out assets of these types (`session`, `catalog`…). */\n  notTypes?: readonly string[];\n  /** `false` holds the read idle. Default `true`. */\n  enabled?: boolean;\n}\n\n/**\n * The assets whose title holds the words, the best match first, as Athena on the web's ⌘K box\n * ranks them.\n */\nexport function useAthenaAssetSearch({\n  words,\n  limit = 8,\n  notTypes = [],\n  enabled = true,\n}: UseAthenaAssetSearchOptions): UseQueryResult<AthenaAssetSummary[], Error> {\n  const trimmed = words.trim();\n  return useAssetRead({\n    name: 'search',\n    query: { words: trimmed, limit, notTypes, order: AthenaAssetOrder.BestMatch },\n    enabled: enabled && trimmed.length > 0,\n  });\n}\n\nexport interface UseAthenaAssetListOptions {\n  /** At most this many, the newest change first. Default 8. */\n  limit?: number;\n  /** `false` holds the read idle. Default `true`. */\n  enabled?: boolean;\n}\n\n/**\n * The person's recent work, as Athena on the web's sidebar lists it (\"Your Recents\"): what they\n * created, the newest change first, without folders, emails, conversations, catalogs or a\n * meeting's own files. It waits for agora to say who the credential is (`/api/v0/me`, the read the\n * chat shares).\n */\nexport function useAthenaRecentAssets({\n  limit = 8,\n  enabled = true,\n}: UseAthenaAssetListOptions = {}): UseQueryResult<AthenaAssetSummary[], Error> {\n  const config = useAthenaConfig();\n  const { userId } = useAccountIdentity(useAssetReadAuth(), { tokenGetter: config.getToken });\n  return useAssetRead({\n    name: 'recent',\n    query: {\n      words: '',\n      limit,\n      notTypes: ATHENA_RECENT_ASSETS_NOT_TYPES,\n      notMediaTypes: ATHENA_SUB_ASSET_MEDIA_TYPES,\n      createdBy: userId ? [userId] : [],\n      order: AthenaAssetOrder.NewestChange,\n    },\n    enabled: enabled && userId !== undefined,\n  });\n}\n\nexport interface UseAthenaFavoriteAssetsOptions extends UseAthenaAssetListOptions {\n  /** Leave out favourites of these types (`session`…). */\n  notTypes?: readonly string[];\n}\n\n/** The person's favourites, from every folder, the newest change first. */\nexport function useAthenaFavoriteAssets({\n  limit = 8,\n  notTypes = [],\n  enabled = true,\n}: UseAthenaFavoriteAssetsOptions = {}): UseQueryResult<AthenaAssetSummary[], Error> {\n  return useAssetRead({\n    name: 'favorites',\n    query: { words: '', limit, favorites: true, notTypes, order: AthenaAssetOrder.NewestChange },\n    enabled,\n  });\n}\n\nexport type UseAthenaProjectsOptions = UseAthenaAssetListOptions;\n\n/**\n * The projects the person can open, the newest change first, as Athena on the web's Projects index\n * lists them.\n */\nexport function useAthenaProjects({\n  limit = 20,\n  enabled = true,\n}: UseAthenaProjectsOptions = {}): UseQueryResult<AthenaAssetSummary[], Error> {\n  return useAssetRead({\n    name: 'projects',\n    query: { words: '', limit, types: ['project'], order: AthenaAssetOrder.NewestChange },\n    enabled,\n  });\n}\n\n/**\n * What a folder holds that these lists leave out: conversations and catalogs (agora's listing\n * already leaves conversations out; a catalog is a connection, not a file).\n */\nconst FOLDER_LEFT_OUT: ReadonlySet<string> = new Set(['session', 'catalog']);\n\nfunction shownInFolder(asset: AthenaAssetSummary): boolean {\n  return !FOLDER_LEFT_OUT.has(asset.athenaOriginalType ?? '');\n}\n\n/** One page of a listing: the assets shown, and whether agora has more. */\nexport interface AthenaAssetPage {\n  assets: AthenaAssetSummary[];\n  /** Where the next page starts (agora's offset or cursor); `null` at the end. */\n  next: number | string | null;\n}\n\n/**\n * Whether a row of agora's folder listing is one of the folder's own: agora reads a page of the\n * folder's own rows (filed in it, not hidden) and then appends each listed meeting's transcript and\n * video and each listed catalog's children, wherever those are filed.\n */\nfunction filedIn(asset: AthenaAssetSummary, folderId: string | null): boolean {\n  return (asset.parentFolderId ?? null) === folderId && asset.isHidden !== true;\n}\n\n/**\n * The page a folder listing's rows make: the folder's own rows, without conversations or catalogs.\n * agora's own rows come first, `limit` of them at most, and the rows it appends follow, so only the\n * first `limit` rows can be the folder's own; a full page of them means another may follow, at\n * `offset + limit` (never at the rows' count, which the appended rows would push past rows not yet\n * read).\n */\nexport function athenaFolderPageOf({\n  rows,\n  folderId,\n  limit,\n  offset,\n}: {\n  rows: readonly AthenaAssetSummary[];\n  folderId: string | null;\n  limit: number;\n  offset: number;\n}): AthenaAssetPage {\n  const own = rows.slice(0, limit).filter((asset) => filedIn(asset, folderId));\n  const seen = new Set<string>();\n  const assets = own.filter((asset) => {\n    if (seen.has(asset.id) || !shownInFolder(asset)) return false;\n    seen.add(asset.id);\n    return true;\n  });\n  return { assets, next: own.length >= limit ? offset + limit : null };\n}\n\n/**\n * One page of a folder's children, or the workspace's top level for `folderId: null` (agora's\n * `getPaginatedAssetsForWorkspace`, gated by `asset_access_query`): folders first, then the newest\n * change, without conversations or catalogs (`athenaFolderPageOf`).\n */\nexport async function listAthenaFolder({\n  auth,\n  folderId,\n  limit,\n  offset,\n  signal,\n}: {\n  auth: MentionAuthContext;\n  /** The folder, or `null` for the workspace's top level. */\n  folderId: string | null;\n  limit: number;\n  offset: number;\n  signal?: AbortSignal;\n}): Promise<AthenaAssetPage> {\n  const data = await fetchGraphQL<{ getPaginatedAssetsForWorkspace: AssetResult[] | null }>(\n    auth,\n    PAGINATED_ASSETS_QUERY,\n    {\n      limit,\n      offset,\n      parentFolderId: folderId,\n      filterTypes: null,\n      filterColumns: { isArchived: false, isHidden: false },\n    },\n    { signal },\n  );\n  return athenaFolderPageOf({\n    rows: data.getPaginatedAssetsForWorkspace ?? [],\n    folderId,\n    limit,\n    offset,\n  });\n}\n\nexport interface UseAthenaFolderAssetsOptions {\n  /** The folder, or `null` for the workspace's top level. */\n  folderId: string | null;\n  /** How many to read a page. Default 50. */\n  pageSize?: number;\n  /** `false` holds the read idle. Default `true`. */\n  enabled?: boolean;\n}\n\n/**\n * Each asset once across the pages read so far: a row agora appended to one page (a catalog's\n * child filed in the same folder) can also be one of the folder's own on another.\n */\nfunction oncePerAsset(data: InfiniteData<AthenaAssetPage>): InfiniteData<AthenaAssetPage> {\n  const seen = new Set<string>();\n  return {\n    ...data,\n    pages: data.pages.map((page) => ({\n      ...page,\n      assets: page.assets.filter((asset) => {\n        if (seen.has(asset.id)) return false;\n        seen.add(asset.id);\n        return true;\n      }),\n    })),\n  };\n}\n\n/**\n * A folder's children (or the workspace's top level), a page at a time (`fetchNextPage`), without\n * conversations or catalogs. Keyed by the folder and the credential's fingerprint, never the\n * credential.\n */\nexport function useAthenaFolderAssets({\n  folderId,\n  pageSize = 50,\n  enabled = true,\n}: UseAthenaFolderAssetsOptions): UseInfiniteQueryResult<InfiniteData<AthenaAssetPage>, Error> {\n  const config = useAthenaConfig();\n  const auth = useAssetReadAuth();\n  const identity = useAthenaQueryIdentity({\n    apiKey: config.apiKey,\n    token: config.token,\n    getToken: config.getToken,\n  });\n  return useInfiniteQuery(\n    {\n      queryKey: [\n        'athena-sdk',\n        'assets',\n        'folder',\n        config.backendUrl,\n        ...identity,\n        folderId,\n        pageSize,\n      ],\n      queryFn: ({ pageParam, signal }) =>\n        listAthenaFolder({\n          auth,\n          folderId,\n          limit: pageSize,\n          offset: typeof pageParam === 'number' ? pageParam : 0,\n          signal,\n        }),\n      initialPageParam: 0 as number | string,\n      getNextPageParam: (last: AthenaAssetPage) => last.next ?? undefined,\n      select: oncePerAsset,\n      enabled: enabled && config.backendUrl.length > 0,\n      staleTime: ASSET_READ_FRESH_MS,\n      retry: retryTransient,\n      refetchOnWindowFocus: false,\n    },\n    useAthenaQueryClient(),\n  );\n}\n\n/**\n * Has every asset read of the provider in use read again (the title search, recent work,\n * favourites, projects, and each folder's and project's pages), for the backend and credential in\n * use alone: a host that changed the person's assets (an upload into a folder, which also makes\n * recent work) calls it. Only the reads on screen are sent again; the rest read again when shown.\n */\nexport function useAthenaAssetsRefresh(): () => Promise<void> {\n  const config = useAthenaConfig();\n  const identity = useAthenaQueryIdentity({\n    apiKey: config.apiKey,\n    token: config.token,\n    getToken: config.getToken,\n  });\n  const queryClient = useAthenaQueryClient();\n  return () =>\n    queryClient.invalidateQueries({\n      predicate: ({ queryKey }) =>\n        queryKey[0] === 'athena-sdk' &&\n        queryKey[1] === 'assets' &&\n        queryKey[3] === config.backendUrl &&\n        identity.every((part, at) => Object.is(queryKey[4 + at], part)),\n    });\n}\n\nexport const PROJECT_ASSETS_QUERY = `\n  query AthenaProjectAssets($projectId: String!, $first: Int!, $after: String) {\n    getProjectLinkedAssetsPaginated(projectId: $projectId, first: $first, after: $after) {\n      hasNextPage\n      nextCursor\n      items {\n        asset {\n          ${MENTION_ASSET_FIELDS}\n        }\n      }\n    }\n  }\n`;\n\n/**\n * One page of the assets a project links (agora's `getProjectLinkedAssetsPaginated`, which leaves\n * out every asset the caller may not open), without conversations or catalogs.\n */\nexport async function listAthenaProjectAssets({\n  auth,\n  projectId,\n  first,\n  after,\n  signal,\n}: {\n  auth: MentionAuthContext;\n  projectId: string;\n  first: number;\n  after: string | null;\n  signal?: AbortSignal;\n}): Promise<AthenaAssetPage> {\n  const data = await fetchGraphQL<{\n    getProjectLinkedAssetsPaginated: {\n      hasNextPage: boolean;\n      nextCursor: string | null;\n      items: Array<{ asset: AssetResult }>;\n    } | null;\n  }>(auth, PROJECT_ASSETS_QUERY, { projectId, first, after }, { signal });\n  const page = data.getProjectLinkedAssetsPaginated;\n  return {\n    assets: (page?.items ?? []).map((item) => item.asset).filter(shownInFolder),\n    next: page?.hasNextPage && page.nextCursor ? page.nextCursor : null,\n  };\n}\n\nexport interface UseAthenaProjectAssetsOptions {\n  projectId: string;\n  /** How many to read a page (agora reads 50 at most). Default 20. */\n  pageSize?: number;\n  /** `false` holds the read idle. Default `true`. */\n  enabled?: boolean;\n}\n\n/** The assets a project links, a page at a time (`fetchNextPage`). */\nexport function useAthenaProjectAssets({\n  projectId,\n  pageSize = 20,\n  enabled = true,\n}: UseAthenaProjectAssetsOptions): UseInfiniteQueryResult<InfiniteData<AthenaAssetPage>, Error> {\n  const config = useAthenaConfig();\n  const auth = useAssetReadAuth();\n  const identity = useAthenaQueryIdentity({\n    apiKey: config.apiKey,\n    token: config.token,\n    getToken: config.getToken,\n  });\n  return useInfiniteQuery(\n    {\n      queryKey: [\n        'athena-sdk',\n        'assets',\n        'project',\n        config.backendUrl,\n        ...identity,\n        projectId,\n        pageSize,\n      ],\n      queryFn: ({ pageParam, signal }) =>\n        listAthenaProjectAssets({\n          auth,\n          projectId,\n          first: pageSize,\n          after: typeof pageParam === 'string' ? pageParam : null,\n          signal,\n        }),\n      initialPageParam: null as number | string | null,\n      getNextPageParam: (last: AthenaAssetPage) => last.next ?? undefined,\n      enabled: enabled && config.backendUrl.length > 0,\n      staleTime: ASSET_READ_FRESH_MS,\n      retry: retryTransient,\n      refetchOnWindowFocus: false,\n    },\n    useAthenaQueryClient(),\n  );\n}\n"],"names":["fetchGraphQL","SIMPLE_SEARCH_QUERY","useAthenaConfig","useContext","AthenaAuthContext","useMemo","_a","useAthenaQueryIdentity","useQuery","useAthenaQueryClient","useAccountIdentity","PAGINATED_ASSETS_QUERY","useInfiniteQuery","MENTION_ASSET_FIELDS"],"mappings":"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"}

package/dist/search/useAthenaAssets.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Finding the assets the signed-in person may open, the way Athena on the web's ⌘K box and its
+ * sidebar find them: a title search, the person's recent work (what they created, newest change
+ * first: the sidebar's "Your Recents") and their favourites. Every read is agora's `simpleSearch`
+ * (`SIMPLE_SEARCH_QUERY`, the query the composer's @-mentions send), which agora answers under the
+ * workspace's read gate (`search_visibility`, built on `asset_access_query`): only assets the
+ * caller may open come back, never a hidden one, and never an archived one here. The hooks read
+ * through TanStack Query on the host's client (the session list's when the provider has one), so
+ * they wait while Athena can't be reached, as the SDK's other reads do.
+ */
+import { type InfiniteData, type UseInfiniteQueryResult, type UseQueryResult } from '@tanstack/react-query';
+import { type AssetResult, type MentionAuthContext } from '../chat-ui/mentions/suggestions/data/api-client';
+/** An asset as these reads answer it: what a row needs to draw it and open it. */
+export type AthenaAssetSummary = AssetResult;
+/** The order a read asks agora for. */
+export declare const AthenaAssetOrder: {
+    /**
+     * The best title match first (agora's `RELEVANCE`: the title is the words, starts with them,
+     * holds them…), then the newest change. An agora from before that order answers by the newest
+     * change instead.
+     */
+    readonly BestMatch: 'best-match';
+    /** The newest change first. */
+    readonly NewestChange: 'newest-change';
+};
+export type AthenaAssetOrder = (typeof AthenaAssetOrder)[keyof typeof AthenaAssetOrder];
+/** One read of the assets the person may open. */
+export interface AthenaAssetQuery {
+    /** Words the title holds; empty lists without words. */
+    words: string;
+    limit: number;
+    offset?: number;
+    /** Only assets of these types (agora's asset type values: `spreadsheet`, `folder`…). */
+    types?: readonly string[];
+    /** Leave out assets of these types. */
+    notTypes?: readonly string[];
+    /** Leave out the sub-assets of these media types (a meeting's transcript files). */
+    notMediaTypes?: readonly string[];
+    /** Only the person's favourites. */
+    favorites?: boolean;
+    /** Only the assets these agora users created (`user_…`). */
+    createdBy?: readonly string[];
+    order: AthenaAssetOrder;
+}
+/** The sort field agora's `SortField` names for an order. */
+type AssetSortField = 'RELEVANCE' | 'UPDATED_AT';
+/**
+ * What "Your Recents" leaves out, as Athena on the web's sidebar does (`useYourRecents`): folders,
+ * emails, conversations and catalogs.
+ */
+export declare const ATHENA_RECENT_ASSETS_NOT_TYPES: readonly string[];
+/**
+ * The files a meeting or a browse session keeps beside itself (its transcripts, its recording),
+ * which Athena on the web never lists among the person's own (`HIDDEN_SUB_ASSET_MEDIA_TYPES`).
+ */
+export declare const ATHENA_SUB_ASSET_MEDIA_TYPES: readonly string[];
+/** `simpleSearch`'s `input` for a read, sorted by `sortField`. */
+export declare function athenaAssetSearchInput({ query, sortField, }: {
+    query: AthenaAssetQuery;
+    sortField: AssetSortField;
+}): Record<string, unknown>;
+/**
+ * One read (`simpleSearch`). `BestMatch` asks agora for `RELEVANCE`; an agora that predates it
+ * refuses the value as bad input, and is asked once more by the newest change. Any other failure
+ * stands.
+ */
+export declare function searchAthenaAssets({ auth, query, signal, }: {
+    auth: MentionAuthContext;
+    query: AthenaAssetQuery;
+    signal?: AbortSignal;
+}): Promise<AthenaAssetSummary[]>;
+export interface UseAthenaAssetSearchOptions {
+    /** The words; blank holds the read idle. */
+    words: string;
+    /** At most this many, the best match first. Default 8. */
+    limit?: number;
+    /** Leave out assets of these types (`session`, `catalog`…). */
+    notTypes?: readonly string[];
+    /** `false` holds the read idle. Default `true`. */
+    enabled?: boolean;
+}
+/**
+ * The assets whose title holds the words, the best match first, as Athena on the web's ⌘K box
+ * ranks them.
+ */
+export declare function useAthenaAssetSearch({ words, limit, notTypes, enabled, }: UseAthenaAssetSearchOptions): UseQueryResult<AthenaAssetSummary[], Error>;
+export interface UseAthenaAssetListOptions {
+    /** At most this many, the newest change first. Default 8. */
+    limit?: number;
+    /** `false` holds the read idle. Default `true`. */
+    enabled?: boolean;
+}
+/**
+ * The person's recent work, as Athena on the web's sidebar lists it ("Your Recents"): what they
+ * created, the newest change first, without folders, emails, conversations, catalogs or a
+ * meeting's own files. It waits for agora to say who the credential is (`/api/v0/me`, the read the
+ * chat shares).
+ */
+export declare function useAthenaRecentAssets({ limit, enabled, }?: UseAthenaAssetListOptions): UseQueryResult<AthenaAssetSummary[], Error>;
+export interface UseAthenaFavoriteAssetsOptions extends UseAthenaAssetListOptions {
+    /** Leave out favourites of these types (`session`…). */
+    notTypes?: readonly string[];
+}
+/** The person's favourites, from every folder, the newest change first. */
+export declare function useAthenaFavoriteAssets({ limit, notTypes, enabled, }?: UseAthenaFavoriteAssetsOptions): UseQueryResult<AthenaAssetSummary[], Error>;
+export type UseAthenaProjectsOptions = UseAthenaAssetListOptions;
+/**
+ * The projects the person can open, the newest change first, as Athena on the web's Projects index
+ * lists them.
+ */
+export declare function useAthenaProjects({ limit, enabled, }?: UseAthenaProjectsOptions): UseQueryResult<AthenaAssetSummary[], Error>;
+/** One page of a listing: the assets shown, and whether agora has more. */
+export interface AthenaAssetPage {
+    assets: AthenaAssetSummary[];
+    /** Where the next page starts (agora's offset or cursor); `null` at the end. */
+    next: number | string | null;
+}
+/**
+ * The page a folder listing's rows make: the folder's own rows, without conversations or catalogs.
+ * agora's own rows come first, `limit` of them at most, and the rows it appends follow, so only the
+ * first `limit` rows can be the folder's own; a full page of them means another may follow, at
+ * `offset + limit` (never at the rows' count, which the appended rows would push past rows not yet
+ * read).
+ */
+export declare function athenaFolderPageOf({ rows, folderId, limit, offset, }: {
+    rows: readonly AthenaAssetSummary[];
+    folderId: string | null;
+    limit: number;
+    offset: number;
+}): AthenaAssetPage;
+/**
+ * One page of a folder's children, or the workspace's top level for `folderId: null` (agora's
+ * `getPaginatedAssetsForWorkspace`, gated by `asset_access_query`): folders first, then the newest
+ * change, without conversations or catalogs (`athenaFolderPageOf`).
+ */
+export declare function listAthenaFolder({ auth, folderId, limit, offset, signal, }: {
+    auth: MentionAuthContext;
+    /** The folder, or `null` for the workspace's top level. */
+    folderId: string | null;
+    limit: number;
+    offset: number;
+    signal?: AbortSignal;
+}): Promise<AthenaAssetPage>;
+export interface UseAthenaFolderAssetsOptions {
+    /** The folder, or `null` for the workspace's top level. */
+    folderId: string | null;
+    /** How many to read a page. Default 50. */
+    pageSize?: number;
+    /** `false` holds the read idle. Default `true`. */
+    enabled?: boolean;
+}
+/**
+ * A folder's children (or the workspace's top level), a page at a time (`fetchNextPage`), without
+ * conversations or catalogs. Keyed by the folder and the credential's fingerprint, never the
+ * credential.
+ */
+export declare function useAthenaFolderAssets({ folderId, pageSize, enabled, }: UseAthenaFolderAssetsOptions): UseInfiniteQueryResult<InfiniteData<AthenaAssetPage>, Error>;
+/**
+ * Has every asset read of the provider in use read again (the title search, recent work,
+ * favourites, projects, and each folder's and project's pages), for the backend and credential in
+ * use alone: a host that changed the person's assets (an upload into a folder, which also makes
+ * recent work) calls it. Only the reads on screen are sent again; the rest read again when shown.
+ */
+export declare function useAthenaAssetsRefresh(): () => Promise<void>;
+export declare const PROJECT_ASSETS_QUERY = "\n  query AthenaProjectAssets($projectId: String!, $first: Int!, $after: String) {\n    getProjectLinkedAssetsPaginated(projectId: $projectId, first: $first, after: $after) {\n      hasNextPage\n      nextCursor\n      items {\n        asset {\n          \n  id\n  title\n  athenaOriginalType\n  athenaConvertedType\n  parentFolderId\n  updatedAt\n  isFavorited\n  isArchived\n  isHidden\n\n        }\n      }\n    }\n  }\n";
+/**
+ * One page of the assets a project links (agora's `getProjectLinkedAssetsPaginated`, which leaves
+ * out every asset the caller may not open), without conversations or catalogs.
+ */
+export declare function listAthenaProjectAssets({ auth, projectId, first, after, signal, }: {
+    auth: MentionAuthContext;
+    projectId: string;
+    first: number;
+    after: string | null;
+    signal?: AbortSignal;
+}): Promise<AthenaAssetPage>;
+export interface UseAthenaProjectAssetsOptions {
+    projectId: string;
+    /** How many to read a page (agora reads 50 at most). Default 20. */
+    pageSize?: number;
+    /** `false` holds the read idle. Default `true`. */
+    enabled?: boolean;
+}
+/** The assets a project links, a page at a time (`fetchNextPage`). */
+export declare function useAthenaProjectAssets({ projectId, pageSize, enabled, }: UseAthenaProjectAssetsOptions): UseInfiniteQueryResult<InfiniteData<AthenaAssetPage>, Error>;
+export {};