@athenaintel/react 0.18.0 → 0.20.0

package/dist/chat/athena-citation-links.cjs

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const assetPanelStore = require("../assets/asset-panel-store.cjs");
+const AthenaContext = require("../provider/AthenaContext.cjs");
+const ATHENA_APP_HOSTNAMES = /* @__PURE__ */ new Set(["app.athenaintel.com", "staging-app.athenaintel.com"]);
+const ATHENA_PREVIEW_HOSTNAME_SUFFIX = ".previews.athenaintel.com";
+const ATHENA_WORKSPACE_HOSTNAME_SUFFIXES = [".app.athenaintel.com", ".staging-app.athenaintel.com"];
+const ASSET_TYPE_ALIASES = {
+  document: "document",
+  notebook: "notebook",
+  pdf: "document",
+  powerpoint: "presentation",
+  presentation: "presentation",
+  sheet: "spreadsheet",
+  spreadsheet: "spreadsheet",
+  word_document: "document"
+};
+const isAthenaSpacesPath = (url) => url.pathname.replace(/\/+$/, "") === "/dashboard/spaces";
+const getFiniteNumber = (url, key) => {
+  const value = url.searchParams.get(key);
+  if (value === null || value.trim() === "") return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+};
+const parseCitationReference = ({
+  url,
+  assetId
+}) => {
+  const reference = { id: assetId };
+  const anchorType = url.searchParams.get("anchor");
+  const page = getFiniteNumber(url, "page");
+  switch (anchorType) {
+    case "page":
+      if (page !== null) reference.anchor = { type: anchorType, page };
+      break;
+    case "page_range": {
+      const startPage = getFiniteNumber(url, "start_page");
+      const endPage = getFiniteNumber(url, "end_page");
+      if (startPage !== null && endPage !== null) {
+        reference.anchor = { type: anchorType, startPage, endPage };
+      }
+      break;
+    }
+    case "page_rect": {
+      const x = getFiniteNumber(url, "x");
+      const y = getFiniteNumber(url, "y");
+      const width = getFiniteNumber(url, "width");
+      const height = getFiniteNumber(url, "height");
+      if (page !== null && x !== null && y !== null && width !== null && height !== null) {
+        const unit = url.searchParams.get("unit");
+        reference.anchor = {
+          type: anchorType,
+          page,
+          x,
+          y,
+          width,
+          height,
+          ...unit === "percent" || unit === "point" ? { unit } : {}
+        };
+      }
+      break;
+    }
+    case "page_text": {
+      const text = url.searchParams.get("text");
+      if (page !== null && text) reference.anchor = { type: anchorType, page, text };
+      break;
+    }
+    // Sheet anchors: the embed's spreadsheet view navigates + flashes the
+    // target range (Olympus `useSheetAnchors`). `sheet_id` is the engine's
+    // numeric sheet id, NOT a tab index.
+    case "sheet_cell": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      const cell = url.searchParams.get("cell");
+      if (sheetId !== null && cell) reference.anchor = { type: anchorType, sheetId, cell };
+      break;
+    }
+    case "sheet_range": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      const range = url.searchParams.get("range");
+      if (sheetId !== null && range) reference.anchor = { type: anchorType, sheetId, range };
+      break;
+    }
+    case "sheet_tab": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      if (sheetId !== null) reference.anchor = { type: anchorType, sheetId };
+      break;
+    }
+    case "sheet_table": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      const tableName = url.searchParams.get("table_name");
+      const fallbackRange = url.searchParams.get("fallback_range");
+      if (sheetId !== null && tableName) {
+        reference.anchor = {
+          type: anchorType,
+          sheetId,
+          tableName,
+          ...fallbackRange ? { fallbackRange } : {}
+        };
+      }
+      break;
+    }
+  }
+  const excerpt = url.searchParams.get("excerpt");
+  if (excerpt) reference.meta = { excerpt };
+  return reference;
+};
+const normalizeAssetType = (value) => {
+  if (!value) {
+    return null;
+  }
+  const normalizedValue = value.trim().replace(/^athena\//, "").toLowerCase().replace(/-/g, "_");
+  return ASSET_TYPE_ALIASES[normalizedValue] ?? null;
+};
+const getOrigin = (value) => {
+  if (!value) {
+    return null;
+  }
+  try {
+    return new URL(value).origin;
+  } catch {
+    return null;
+  }
+};
+const getHostname = (value) => {
+  if (!value) {
+    return null;
+  }
+  try {
+    return new URL(value).hostname.toLowerCase();
+  } catch {
+    return null;
+  }
+};
+const matchesHostnameOrSubdomain = ({
+  hostname,
+  candidateHostname
+}) => hostname === candidateHostname || hostname.endsWith(`.${candidateHostname}`);
+const getCurrentOrigin = () => {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  return window.location.origin;
+};
+const parseUrl = ({
+  href,
+  appUrl
+}) => {
+  const fallbackBase = appUrl ?? getCurrentOrigin() ?? "https://app.athenaintel.com";
+  try {
+    return new URL(href, fallbackBase);
+  } catch {
+    return null;
+  }
+};
+const isAthenaAppUrl = ({
+  url,
+  appUrl
+}) => {
+  const hostname = url.hostname.toLowerCase();
+  if (ATHENA_APP_HOSTNAMES.has(hostname) || hostname.endsWith(ATHENA_PREVIEW_HOSTNAME_SUFFIX) || ATHENA_WORKSPACE_HOSTNAME_SUFFIXES.some((suffix) => hostname.endsWith(suffix))) {
+    return true;
+  }
+  const configuredHostname = getHostname(appUrl);
+  if (configuredHostname && matchesHostnameOrSubdomain({ hostname, candidateHostname: configuredHostname })) {
+    return true;
+  }
+  const configuredOrigin = getOrigin(appUrl);
+  if (configuredOrigin && url.origin === configuredOrigin) {
+    return true;
+  }
+  const currentOrigin = getCurrentOrigin();
+  return !!currentOrigin && url.origin === currentOrigin;
+};
+const parseAthenaCitationLink = ({
+  href,
+  appUrl
+}) => {
+  const url = parseUrl({ href, appUrl });
+  if (!url || !isAthenaAppUrl({ url, appUrl }) || !isAthenaSpacesPath(url)) {
+    return null;
+  }
+  const assetIdsParam = url.searchParams.get("asset_ids");
+  if (!assetIdsParam) {
+    return null;
+  }
+  const assetIds = assetIdsParam.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+  const assetId = assetIds[0];
+  if (!assetId) {
+    return null;
+  }
+  return {
+    url,
+    assetId,
+    assetIds,
+    assetType: normalizeAssetType(url.searchParams.get("asset_type") ?? url.searchParams.get("type")),
+    reference: parseCitationReference({ url, assetId })
+  };
+};
+const isAthenaCitationUrl = ({
+  href,
+  appUrl
+}) => parseAthenaCitationLink({ href, appUrl }) !== null;
+const resolveAthenaLink = ({
+  href,
+  appUrl
+}) => {
+  const url = parseUrl({ href, appUrl });
+  if (!url) {
+    return null;
+  }
+  const citation = parseAthenaCitationLink({ href, appUrl });
+  if (citation) {
+    return {
+      url: citation.url,
+      kind: "athena-citation",
+      citation
+    };
+  }
+  return {
+    url,
+    kind: isAthenaAppUrl({ url, appUrl }) ? "athena-app" : "external",
+    citation: null
+  };
+};
+const useAthenaLinkClickHandler = () => {
+  const openAsset = assetPanelStore.useAssetPanelStore((state) => state.openAsset);
+  const isAssetPanelAvailable = assetPanelStore.useAssetPanelStore((state) => state.assetPanelHostCount > 0);
+  const athenaConfig = react.useContext(AthenaContext.AthenaContext);
+  const appUrl = athenaConfig == null ? void 0 : athenaConfig.appUrl;
+  return react.useCallback(
+    ({ href, linkText, target, nativeEvent }) => {
+      var _a, _b;
+      const resolvedLink = resolveAthenaLink({ href, appUrl });
+      if (!resolvedLink) {
+        return false;
+      }
+      const linkClicks = athenaConfig == null ? void 0 : athenaConfig.linkClicks;
+      const citationLinks = athenaConfig == null ? void 0 : athenaConfig.citationLinks;
+      const trimmedLinkText = (linkText == null ? void 0 : linkText.trim()) || null;
+      const citationLink = resolvedLink.citation;
+      const citationMetadata = citationLink ? {
+        assetId: citationLink.assetId,
+        assetIds: citationLink.assetIds,
+        assetType: citationLink.assetType
+      } : null;
+      const openInAssetPanel = citationLink ? () => {
+        openAsset(citationLink.assetId, {
+          name: trimmedLinkText ?? void 0,
+          type: citationLink.assetType ?? void 0,
+          // Carry the citation target so the panel's iframe navigates to
+          // the cited range/page instead of opening at the top.
+          reference: citationLink.reference,
+          // Reading references is one preview surface: a citation to a
+          // different asset swaps the active tab rather than stacking a
+          // tab per cited document.
+          replaceActiveTab: true
+        });
+      } : void 0;
+      const context = {
+        href,
+        url: resolvedLink.url,
+        target: target ?? null,
+        linkText: trimmedLinkText,
+        isAssetPanelAvailable,
+        kind: resolvedLink.kind,
+        citation: citationMetadata,
+        nativeEvent: nativeEvent ?? null,
+        openInAssetPanel,
+        openInBrowser: (nextTarget) => {
+          var _a2;
+          (_a2 = window.open(resolvedLink.url.toString(), nextTarget ?? target ?? "_blank")) == null ? void 0 : _a2.focus();
+        }
+      };
+      if (((_a = linkClicks == null ? void 0 : linkClicks.onClick) == null ? void 0 : _a.call(linkClicks, context)) === true) {
+        nativeEvent == null ? void 0 : nativeEvent.preventDefault();
+        return true;
+      }
+      if (!citationLink || !openInAssetPanel || !citationMetadata) {
+        return false;
+      }
+      const citationContext = {
+        ...context,
+        kind: "athena-citation",
+        citation: citationMetadata,
+        assetId: citationMetadata.assetId,
+        assetIds: citationMetadata.assetIds,
+        assetType: citationMetadata.assetType,
+        openInAssetPanel
+      };
+      if (((_b = citationLinks == null ? void 0 : citationLinks.onClick) == null ? void 0 : _b.call(citationLinks, citationContext)) === true) {
+        nativeEvent == null ? void 0 : nativeEvent.preventDefault();
+        return true;
+      }
+      if (((linkClicks == null ? void 0 : linkClicks.interceptAthenaCitations) ?? (citationLinks == null ? void 0 : citationLinks.interceptAthenaCitations)) === false) {
+        return false;
+      }
+      if (!isAssetPanelAvailable) {
+        return false;
+      }
+      citationContext.openInAssetPanel();
+      nativeEvent == null ? void 0 : nativeEvent.preventDefault();
+      return true;
+    },
+    [appUrl, athenaConfig, isAssetPanelAvailable, openAsset]
+  );
+};
+const useAthenaCitationLinkHandler = () => {
+  const athenaConfig = react.useContext(AthenaContext.AthenaContext);
+  const appUrl = athenaConfig == null ? void 0 : athenaConfig.appUrl;
+  const handleLinkClick = useAthenaLinkClickHandler();
+  return react.useCallback(
+    (input) => {
+      if (!parseAthenaCitationLink({ href: input.href, appUrl })) {
+        return false;
+      }
+      return handleLinkClick(input);
+    },
+    [appUrl, handleLinkClick]
+  );
+};
+exports.isAthenaCitationUrl = isAthenaCitationUrl;
+exports.parseAthenaCitationLink = parseAthenaCitationLink;
+exports.useAthenaCitationLinkHandler = useAthenaCitationLinkHandler;
+exports.useAthenaLinkClickHandler = useAthenaLinkClickHandler;
+//# sourceMappingURL=athena-citation-links.cjs.map

package/dist/chat/athena-citation-links.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"athena-citation-links.cjs","sources":["../../src/chat/athena-citation-links.ts"],"sourcesContent":["import { useCallback, useContext } from 'react';\nimport type { AthenaAssetCitationReference } from '../assets/asset-embed-messages';\nimport { type AssetType, useAssetPanelStore } from '../assets/asset-panel-store';\nimport { AthenaContext } from '../provider/AthenaContext';\nimport type {\n  AthenaCitationLinkMetadata,\n  AthenaCitationLinkClickContext,\n  AthenaCitationLinkHandleInput,\n  AthenaCitationLinkHandler,\n  AthenaLinkClickContext,\n  AthenaLinkClickHandler,\n  AthenaLinkClickHandleInput,\n  AthenaLinkKind,\n} from '../provider/citation-links';\n\nconst ATHENA_APP_HOSTNAMES = new Set(['app.athenaintel.com', 'staging-app.athenaintel.com']);\nconst ATHENA_PREVIEW_HOSTNAME_SUFFIX = '.previews.athenaintel.com';\nconst ATHENA_WORKSPACE_HOSTNAME_SUFFIXES = ['.app.athenaintel.com', '.staging-app.athenaintel.com'];\n\nconst ASSET_TYPE_ALIASES: Record<string, AssetType> = {\n  document: 'document',\n  notebook: 'notebook',\n  pdf: 'document',\n  powerpoint: 'presentation',\n  presentation: 'presentation',\n  sheet: 'spreadsheet',\n  spreadsheet: 'spreadsheet',\n  word_document: 'document',\n};\n\nconst isAthenaSpacesPath = (url: URL): boolean => url.pathname.replace(/\\/+$/, '') === '/dashboard/spaces';\n\nexport interface ParsedAthenaCitationLink {\n  url: URL;\n  assetId: string;\n  assetIds: string[];\n  assetType: AssetType | null;\n  /** Complete target that can be passed directly to AthenaAssetEmbed.reference. */\n  reference: AthenaAssetCitationReference;\n}\n\nconst getFiniteNumber = (url: URL, key: string): number | null => {\n  const value = url.searchParams.get(key);\n  if (value === null || value.trim() === '') return null;\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : null;\n};\n\nconst parseCitationReference = ({\n  url,\n  assetId,\n}: {\n  url: URL;\n  assetId: string;\n}): AthenaAssetCitationReference => {\n  const reference: AthenaAssetCitationReference = { id: assetId };\n  const anchorType = url.searchParams.get('anchor');\n  const page = getFiniteNumber(url, 'page');\n\n  switch (anchorType) {\n    case 'page':\n      if (page !== null) reference.anchor = { type: anchorType, page };\n      break;\n    case 'page_range': {\n      const startPage = getFiniteNumber(url, 'start_page');\n      const endPage = getFiniteNumber(url, 'end_page');\n      if (startPage !== null && endPage !== null) {\n        reference.anchor = { type: anchorType, startPage, endPage };\n      }\n      break;\n    }\n    case 'page_rect': {\n      const x = getFiniteNumber(url, 'x');\n      const y = getFiniteNumber(url, 'y');\n      const width = getFiniteNumber(url, 'width');\n      const height = getFiniteNumber(url, 'height');\n      if (page !== null && x !== null && y !== null && width !== null && height !== null) {\n        const unit = url.searchParams.get('unit');\n        reference.anchor = {\n          type: anchorType,\n          page,\n          x,\n          y,\n          width,\n          height,\n          ...(unit === 'percent' || unit === 'point' ? { unit } : {}),\n        };\n      }\n      break;\n    }\n    case 'page_text': {\n      const text = url.searchParams.get('text');\n      if (page !== null && text) reference.anchor = { type: anchorType, page, text };\n      break;\n    }\n    // Sheet anchors: the embed's spreadsheet view navigates + flashes the\n    // target range (Olympus `useSheetAnchors`). `sheet_id` is the engine's\n    // numeric sheet id, NOT a tab index.\n    case 'sheet_cell': {\n      const sheetId = getFiniteNumber(url, 'sheet_id');\n      const cell = url.searchParams.get('cell');\n      if (sheetId !== null && cell) reference.anchor = { type: anchorType, sheetId, cell };\n      break;\n    }\n    case 'sheet_range': {\n      const sheetId = getFiniteNumber(url, 'sheet_id');\n      const range = url.searchParams.get('range');\n      if (sheetId !== null && range) reference.anchor = { type: anchorType, sheetId, range };\n      break;\n    }\n    case 'sheet_tab': {\n      const sheetId = getFiniteNumber(url, 'sheet_id');\n      if (sheetId !== null) reference.anchor = { type: anchorType, sheetId };\n      break;\n    }\n    case 'sheet_table': {\n      const sheetId = getFiniteNumber(url, 'sheet_id');\n      const tableName = url.searchParams.get('table_name');\n      const fallbackRange = url.searchParams.get('fallback_range');\n      if (sheetId !== null && tableName) {\n        reference.anchor = {\n          type: anchorType,\n          sheetId,\n          tableName,\n          ...(fallbackRange ? { fallbackRange } : {}),\n        };\n      }\n      break;\n    }\n  }\n\n  const excerpt = url.searchParams.get('excerpt');\n  if (excerpt) reference.meta = { excerpt };\n  return reference;\n};\n\nconst normalizeAssetType = (value: string | null): AssetType | null => {\n  if (!value) {\n    return null;\n  }\n\n  const normalizedValue = value.trim().replace(/^athena\\//, '').toLowerCase().replace(/-/g, '_');\n  return ASSET_TYPE_ALIASES[normalizedValue] ?? null;\n};\n\nconst getOrigin = (value?: string | null): string | null => {\n  if (!value) {\n    return null;\n  }\n\n  try {\n    return new URL(value).origin;\n  } catch {\n    return null;\n  }\n};\n\nconst getHostname = (value?: string | null): string | null => {\n  if (!value) {\n    return null;\n  }\n\n  try {\n    return new URL(value).hostname.toLowerCase();\n  } catch {\n    return null;\n  }\n};\n\nconst matchesHostnameOrSubdomain = ({\n  hostname,\n  candidateHostname,\n}: {\n  hostname: string;\n  candidateHostname: string;\n}): boolean => hostname === candidateHostname || hostname.endsWith(`.${candidateHostname}`);\n\nconst getCurrentOrigin = (): string | null => {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n\n  return window.location.origin;\n};\n\nconst parseUrl = ({\n  href,\n  appUrl,\n}: {\n  href: string;\n  appUrl?: string | null;\n}): URL | null => {\n  const fallbackBase = appUrl ?? getCurrentOrigin() ?? 'https://app.athenaintel.com';\n\n  try {\n    return new URL(href, fallbackBase);\n  } catch {\n    return null;\n  }\n};\n\nconst isAthenaAppUrl = ({\n  url,\n  appUrl,\n}: {\n  url: URL;\n  appUrl?: string | null;\n}): boolean => {\n  const hostname = url.hostname.toLowerCase();\n\n  if (\n    ATHENA_APP_HOSTNAMES.has(hostname)\n    || hostname.endsWith(ATHENA_PREVIEW_HOSTNAME_SUFFIX)\n    || ATHENA_WORKSPACE_HOSTNAME_SUFFIXES.some((suffix) => hostname.endsWith(suffix))\n  ) {\n    return true;\n  }\n\n  const configuredHostname = getHostname(appUrl);\n  if (configuredHostname && matchesHostnameOrSubdomain({ hostname, candidateHostname: configuredHostname })) {\n    return true;\n  }\n\n  const configuredOrigin = getOrigin(appUrl);\n  if (configuredOrigin && url.origin === configuredOrigin) {\n    return true;\n  }\n\n  // Fallback: treat same-origin `/dashboard/spaces?asset_ids=...` links as Athena\n  // citations so local dev and private-cloud embeds still work without appUrl.\n  // Consumers can disable the default interception with\n  // linkClicks={{ interceptAthenaCitations: false }} or the legacy citationLinks alias.\n  const currentOrigin = getCurrentOrigin();\n  return !!currentOrigin && url.origin === currentOrigin;\n};\n\nexport const parseAthenaCitationLink = ({\n  href,\n  appUrl,\n}: {\n  href: string;\n  appUrl?: string | null;\n}): ParsedAthenaCitationLink | null => {\n  const url = parseUrl({ href, appUrl });\n  if (!url || !isAthenaAppUrl({ url, appUrl }) || !isAthenaSpacesPath(url)) {\n    return null;\n  }\n\n  const assetIdsParam = url.searchParams.get('asset_ids');\n  if (!assetIdsParam) {\n    return null;\n  }\n\n  const assetIds = assetIdsParam\n    .split(',')\n    .map((value) => value.trim())\n    .filter((value) => value.length > 0);\n  const assetId = assetIds[0];\n\n  if (!assetId) {\n    return null;\n  }\n\n  return {\n    url,\n    assetId,\n    assetIds,\n    assetType: normalizeAssetType(url.searchParams.get('asset_type') ?? url.searchParams.get('type')),\n    reference: parseCitationReference({ url, assetId }),\n  };\n};\n\nexport const isAthenaCitationUrl = ({\n  href,\n  appUrl,\n}: {\n  href: string;\n  appUrl?: string | null;\n}): boolean => parseAthenaCitationLink({ href, appUrl }) !== null;\n\ninterface ResolvedAthenaLink {\n  url: URL;\n  kind: AthenaLinkKind;\n  citation: ParsedAthenaCitationLink | null;\n}\n\nconst resolveAthenaLink = ({\n  href,\n  appUrl,\n}: AthenaLinkClickHandleInput & {\n  appUrl?: string | null;\n}): ResolvedAthenaLink | null => {\n  const url = parseUrl({ href, appUrl });\n  if (!url) {\n    return null;\n  }\n\n  const citation = parseAthenaCitationLink({ href, appUrl });\n  if (citation) {\n    return {\n      url: citation.url,\n      kind: 'athena-citation',\n      citation,\n    };\n  }\n\n  return {\n    url,\n    kind: isAthenaAppUrl({ url, appUrl }) ? 'athena-app' : 'external',\n    citation: null,\n  };\n};\n\nexport const useAthenaLinkClickHandler = (): AthenaLinkClickHandler => {\n  const openAsset = useAssetPanelStore((state) => state.openAsset);\n  const isAssetPanelAvailable = useAssetPanelStore((state) => state.assetPanelHostCount > 0);\n  const athenaConfig = useContext(AthenaContext);\n  const appUrl = athenaConfig?.appUrl;\n\n  return useCallback<AthenaLinkClickHandler>(\n    ({ href, linkText, target, nativeEvent }: AthenaLinkClickHandleInput) => {\n      const resolvedLink = resolveAthenaLink({ href, appUrl });\n      if (!resolvedLink) {\n        return false;\n      }\n\n      const linkClicks = athenaConfig?.linkClicks;\n      const citationLinks = athenaConfig?.citationLinks;\n      const trimmedLinkText = linkText?.trim() || null;\n      const citationLink = resolvedLink.citation;\n      const citationMetadata: AthenaCitationLinkMetadata | null = citationLink\n        ? {\n            assetId: citationLink.assetId,\n            assetIds: citationLink.assetIds,\n            assetType: citationLink.assetType,\n          }\n        : null;\n      const openInAssetPanel = citationLink\n        ? () => {\n            openAsset(citationLink.assetId, {\n              name: trimmedLinkText ?? undefined,\n              type: citationLink.assetType ?? undefined,\n              // Carry the citation target so the panel's iframe navigates to\n              // the cited range/page instead of opening at the top.\n              reference: citationLink.reference,\n              // Reading references is one preview surface: a citation to a\n              // different asset swaps the active tab rather than stacking a\n              // tab per cited document.\n              replaceActiveTab: true,\n            });\n          }\n        : undefined;\n      const context: AthenaLinkClickContext = {\n        href,\n        url: resolvedLink.url,\n        target: target ?? null,\n        linkText: trimmedLinkText,\n        isAssetPanelAvailable,\n        kind: resolvedLink.kind,\n        citation: citationMetadata,\n        nativeEvent: nativeEvent ?? null,\n        openInAssetPanel,\n        openInBrowser: (nextTarget) => {\n          window.open(resolvedLink.url.toString(), nextTarget ?? target ?? '_blank')?.focus();\n        },\n      };\n\n      if (linkClicks?.onClick?.(context) === true) {\n        nativeEvent?.preventDefault();\n        return true;\n      }\n\n      if (!citationLink || !openInAssetPanel || !citationMetadata) {\n        return false;\n      }\n\n      const citationContext: AthenaCitationLinkClickContext = {\n        ...context,\n        kind: 'athena-citation',\n        citation: citationMetadata,\n        assetId: citationMetadata.assetId,\n        assetIds: citationMetadata.assetIds,\n        assetType: citationMetadata.assetType,\n        openInAssetPanel,\n      };\n\n      if (citationLinks?.onClick?.(citationContext) === true) {\n        nativeEvent?.preventDefault();\n        return true;\n      }\n\n      if ((linkClicks?.interceptAthenaCitations ?? citationLinks?.interceptAthenaCitations) === false) {\n        return false;\n      }\n\n      if (!isAssetPanelAvailable) {\n        return false;\n      }\n\n      citationContext.openInAssetPanel();\n      nativeEvent?.preventDefault();\n      return true;\n    },\n    [appUrl, athenaConfig, isAssetPanelAvailable, openAsset],\n  );\n};\n\nexport const useAthenaCitationLinkHandler = (): AthenaCitationLinkHandler => {\n  const athenaConfig = useContext(AthenaContext);\n  const appUrl = athenaConfig?.appUrl;\n  const handleLinkClick = useAthenaLinkClickHandler();\n\n  return useCallback<AthenaCitationLinkHandler>(\n    (input: AthenaCitationLinkHandleInput) => {\n      if (!parseAthenaCitationLink({ href: input.href, appUrl })) {\n        return false;\n      }\n\n      return handleLinkClick(input);\n    },\n    [appUrl, handleLinkClick],\n  );\n};\n"],"names":["useAssetPanelStore","useContext","AthenaContext","useCallback","_a"],"mappings":"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"}

package/dist/chat/athena-citation-links.js

@@ -0,0 +1,326 @@
+import { useContext, useCallback } from "react";
+import { useAssetPanelStore } from "../assets/asset-panel-store.js";
+import { AthenaContext } from "../provider/AthenaContext.js";
+const ATHENA_APP_HOSTNAMES = /* @__PURE__ */ new Set(["app.athenaintel.com", "staging-app.athenaintel.com"]);
+const ATHENA_PREVIEW_HOSTNAME_SUFFIX = ".previews.athenaintel.com";
+const ATHENA_WORKSPACE_HOSTNAME_SUFFIXES = [".app.athenaintel.com", ".staging-app.athenaintel.com"];
+const ASSET_TYPE_ALIASES = {
+  document: "document",
+  notebook: "notebook",
+  pdf: "document",
+  powerpoint: "presentation",
+  presentation: "presentation",
+  sheet: "spreadsheet",
+  spreadsheet: "spreadsheet",
+  word_document: "document"
+};
+const isAthenaSpacesPath = (url) => url.pathname.replace(/\/+$/, "") === "/dashboard/spaces";
+const getFiniteNumber = (url, key) => {
+  const value = url.searchParams.get(key);
+  if (value === null || value.trim() === "") return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+};
+const parseCitationReference = ({
+  url,
+  assetId
+}) => {
+  const reference = { id: assetId };
+  const anchorType = url.searchParams.get("anchor");
+  const page = getFiniteNumber(url, "page");
+  switch (anchorType) {
+    case "page":
+      if (page !== null) reference.anchor = { type: anchorType, page };
+      break;
+    case "page_range": {
+      const startPage = getFiniteNumber(url, "start_page");
+      const endPage = getFiniteNumber(url, "end_page");
+      if (startPage !== null && endPage !== null) {
+        reference.anchor = { type: anchorType, startPage, endPage };
+      }
+      break;
+    }
+    case "page_rect": {
+      const x = getFiniteNumber(url, "x");
+      const y = getFiniteNumber(url, "y");
+      const width = getFiniteNumber(url, "width");
+      const height = getFiniteNumber(url, "height");
+      if (page !== null && x !== null && y !== null && width !== null && height !== null) {
+        const unit = url.searchParams.get("unit");
+        reference.anchor = {
+          type: anchorType,
+          page,
+          x,
+          y,
+          width,
+          height,
+          ...unit === "percent" || unit === "point" ? { unit } : {}
+        };
+      }
+      break;
+    }
+    case "page_text": {
+      const text = url.searchParams.get("text");
+      if (page !== null && text) reference.anchor = { type: anchorType, page, text };
+      break;
+    }
+    // Sheet anchors: the embed's spreadsheet view navigates + flashes the
+    // target range (Olympus `useSheetAnchors`). `sheet_id` is the engine's
+    // numeric sheet id, NOT a tab index.
+    case "sheet_cell": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      const cell = url.searchParams.get("cell");
+      if (sheetId !== null && cell) reference.anchor = { type: anchorType, sheetId, cell };
+      break;
+    }
+    case "sheet_range": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      const range = url.searchParams.get("range");
+      if (sheetId !== null && range) reference.anchor = { type: anchorType, sheetId, range };
+      break;
+    }
+    case "sheet_tab": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      if (sheetId !== null) reference.anchor = { type: anchorType, sheetId };
+      break;
+    }
+    case "sheet_table": {
+      const sheetId = getFiniteNumber(url, "sheet_id");
+      const tableName = url.searchParams.get("table_name");
+      const fallbackRange = url.searchParams.get("fallback_range");
+      if (sheetId !== null && tableName) {
+        reference.anchor = {
+          type: anchorType,
+          sheetId,
+          tableName,
+          ...fallbackRange ? { fallbackRange } : {}
+        };
+      }
+      break;
+    }
+  }
+  const excerpt = url.searchParams.get("excerpt");
+  if (excerpt) reference.meta = { excerpt };
+  return reference;
+};
+const normalizeAssetType = (value) => {
+  if (!value) {
+    return null;
+  }
+  const normalizedValue = value.trim().replace(/^athena\//, "").toLowerCase().replace(/-/g, "_");
+  return ASSET_TYPE_ALIASES[normalizedValue] ?? null;
+};
+const getOrigin = (value) => {
+  if (!value) {
+    return null;
+  }
+  try {
+    return new URL(value).origin;
+  } catch {
+    return null;
+  }
+};
+const getHostname = (value) => {
+  if (!value) {
+    return null;
+  }
+  try {
+    return new URL(value).hostname.toLowerCase();
+  } catch {
+    return null;
+  }
+};
+const matchesHostnameOrSubdomain = ({
+  hostname,
+  candidateHostname
+}) => hostname === candidateHostname || hostname.endsWith(`.${candidateHostname}`);
+const getCurrentOrigin = () => {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  return window.location.origin;
+};
+const parseUrl = ({
+  href,
+  appUrl
+}) => {
+  const fallbackBase = appUrl ?? getCurrentOrigin() ?? "https://app.athenaintel.com";
+  try {
+    return new URL(href, fallbackBase);
+  } catch {
+    return null;
+  }
+};
+const isAthenaAppUrl = ({
+  url,
+  appUrl
+}) => {
+  const hostname = url.hostname.toLowerCase();
+  if (ATHENA_APP_HOSTNAMES.has(hostname) || hostname.endsWith(ATHENA_PREVIEW_HOSTNAME_SUFFIX) || ATHENA_WORKSPACE_HOSTNAME_SUFFIXES.some((suffix) => hostname.endsWith(suffix))) {
+    return true;
+  }
+  const configuredHostname = getHostname(appUrl);
+  if (configuredHostname && matchesHostnameOrSubdomain({ hostname, candidateHostname: configuredHostname })) {
+    return true;
+  }
+  const configuredOrigin = getOrigin(appUrl);
+  if (configuredOrigin && url.origin === configuredOrigin) {
+    return true;
+  }
+  const currentOrigin = getCurrentOrigin();
+  return !!currentOrigin && url.origin === currentOrigin;
+};
+const parseAthenaCitationLink = ({
+  href,
+  appUrl
+}) => {
+  const url = parseUrl({ href, appUrl });
+  if (!url || !isAthenaAppUrl({ url, appUrl }) || !isAthenaSpacesPath(url)) {
+    return null;
+  }
+  const assetIdsParam = url.searchParams.get("asset_ids");
+  if (!assetIdsParam) {
+    return null;
+  }
+  const assetIds = assetIdsParam.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+  const assetId = assetIds[0];
+  if (!assetId) {
+    return null;
+  }
+  return {
+    url,
+    assetId,
+    assetIds,
+    assetType: normalizeAssetType(url.searchParams.get("asset_type") ?? url.searchParams.get("type")),
+    reference: parseCitationReference({ url, assetId })
+  };
+};
+const isAthenaCitationUrl = ({
+  href,
+  appUrl
+}) => parseAthenaCitationLink({ href, appUrl }) !== null;
+const resolveAthenaLink = ({
+  href,
+  appUrl
+}) => {
+  const url = parseUrl({ href, appUrl });
+  if (!url) {
+    return null;
+  }
+  const citation = parseAthenaCitationLink({ href, appUrl });
+  if (citation) {
+    return {
+      url: citation.url,
+      kind: "athena-citation",
+      citation
+    };
+  }
+  return {
+    url,
+    kind: isAthenaAppUrl({ url, appUrl }) ? "athena-app" : "external",
+    citation: null
+  };
+};
+const useAthenaLinkClickHandler = () => {
+  const openAsset = useAssetPanelStore((state) => state.openAsset);
+  const isAssetPanelAvailable = useAssetPanelStore((state) => state.assetPanelHostCount > 0);
+  const athenaConfig = useContext(AthenaContext);
+  const appUrl = athenaConfig == null ? void 0 : athenaConfig.appUrl;
+  return useCallback(
+    ({ href, linkText, target, nativeEvent }) => {
+      var _a, _b;
+      const resolvedLink = resolveAthenaLink({ href, appUrl });
+      if (!resolvedLink) {
+        return false;
+      }
+      const linkClicks = athenaConfig == null ? void 0 : athenaConfig.linkClicks;
+      const citationLinks = athenaConfig == null ? void 0 : athenaConfig.citationLinks;
+      const trimmedLinkText = (linkText == null ? void 0 : linkText.trim()) || null;
+      const citationLink = resolvedLink.citation;
+      const citationMetadata = citationLink ? {
+        assetId: citationLink.assetId,
+        assetIds: citationLink.assetIds,
+        assetType: citationLink.assetType
+      } : null;
+      const openInAssetPanel = citationLink ? () => {
+        openAsset(citationLink.assetId, {
+          name: trimmedLinkText ?? void 0,
+          type: citationLink.assetType ?? void 0,
+          // Carry the citation target so the panel's iframe navigates to
+          // the cited range/page instead of opening at the top.
+          reference: citationLink.reference,
+          // Reading references is one preview surface: a citation to a
+          // different asset swaps the active tab rather than stacking a
+          // tab per cited document.
+          replaceActiveTab: true
+        });
+      } : void 0;
+      const context = {
+        href,
+        url: resolvedLink.url,
+        target: target ?? null,
+        linkText: trimmedLinkText,
+        isAssetPanelAvailable,
+        kind: resolvedLink.kind,
+        citation: citationMetadata,
+        nativeEvent: nativeEvent ?? null,
+        openInAssetPanel,
+        openInBrowser: (nextTarget) => {
+          var _a2;
+          (_a2 = window.open(resolvedLink.url.toString(), nextTarget ?? target ?? "_blank")) == null ? void 0 : _a2.focus();
+        }
+      };
+      if (((_a = linkClicks == null ? void 0 : linkClicks.onClick) == null ? void 0 : _a.call(linkClicks, context)) === true) {
+        nativeEvent == null ? void 0 : nativeEvent.preventDefault();
+        return true;
+      }
+      if (!citationLink || !openInAssetPanel || !citationMetadata) {
+        return false;
+      }
+      const citationContext = {
+        ...context,
+        kind: "athena-citation",
+        citation: citationMetadata,
+        assetId: citationMetadata.assetId,
+        assetIds: citationMetadata.assetIds,
+        assetType: citationMetadata.assetType,
+        openInAssetPanel
+      };
+      if (((_b = citationLinks == null ? void 0 : citationLinks.onClick) == null ? void 0 : _b.call(citationLinks, citationContext)) === true) {
+        nativeEvent == null ? void 0 : nativeEvent.preventDefault();
+        return true;
+      }
+      if (((linkClicks == null ? void 0 : linkClicks.interceptAthenaCitations) ?? (citationLinks == null ? void 0 : citationLinks.interceptAthenaCitations)) === false) {
+        return false;
+      }
+      if (!isAssetPanelAvailable) {
+        return false;
+      }
+      citationContext.openInAssetPanel();
+      nativeEvent == null ? void 0 : nativeEvent.preventDefault();
+      return true;
+    },
+    [appUrl, athenaConfig, isAssetPanelAvailable, openAsset]
+  );
+};
+const useAthenaCitationLinkHandler = () => {
+  const athenaConfig = useContext(AthenaContext);
+  const appUrl = athenaConfig == null ? void 0 : athenaConfig.appUrl;
+  const handleLinkClick = useAthenaLinkClickHandler();
+  return useCallback(
+    (input) => {
+      if (!parseAthenaCitationLink({ href: input.href, appUrl })) {
+        return false;
+      }
+      return handleLinkClick(input);
+    },
+    [appUrl, handleLinkClick]
+  );
+};
+export {
+  isAthenaCitationUrl,
+  parseAthenaCitationLink,
+  useAthenaCitationLinkHandler,
+  useAthenaLinkClickHandler
+};
+//# sourceMappingURL=athena-citation-links.js.map