@athenaintel/react 0.30.0 → 0.35.0

package/dist/assets/AthenaAssetEmbed.cjs

@@ -18,6 +18,7 @@ const AthenaAssetEmbed = ({
   reference,
   displayMode = useAssetEmbed.DEFAULT_ASSET_EMBED_DISPLAY_MODE,
   readOnly = useAssetEmbed.DEFAULT_ASSET_EMBED_READ_ONLY,
+  allowQuickEdit = useAssetEmbed.DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,
   expiresInSeconds,
   citationBehavior,
   onCitationClick,
@@ -25,6 +26,7 @@ const AthenaAssetEmbed = ({
   onCitationAction,
   embedUrl: hostEmbedUrl,
   onReady,
+  onContentReady,
   onLoad,
   onError,
   loadingFallback,
@@ -46,7 +48,8 @@ const AthenaAssetEmbed = ({
     getToken: athenaConfig.getToken,
     readOnly,
     expiresInSeconds,
-    displayMode
+    displayMode,
+    allowQuickEdit
   });
   const embedUrl = hostEmbedUrl ?? minted.embedUrl;
   const isLoading = hostEmbedUrl ? false : minted.isLoading;
@@ -95,6 +98,10 @@ const AthenaAssetEmbed = ({
         onReady == null ? void 0 : onReady();
         return;
       }
+      if (assetEmbedMessages.isAthenaAssetEmbedContentReadyEvent(event.data)) {
+        if (event.data.assetId === assetId) onContentReady == null ? void 0 : onContentReady();
+        return;
+      }
       if (assetEmbedMessages.isAthenaAssetCitationClickEvent(event.data)) {
         onCitationClick == null ? void 0 : onCitationClick(event.data);
         return;
@@ -105,7 +112,7 @@ const AthenaAssetEmbed = ({
     };
     window.addEventListener("message", handleMessage);
     return () => window.removeEventListener("message", handleMessage);
-  }, [embedUrl, onCitationAction, onCitationClick, onReady, sendConfig, targetOrigin]);
+  }, [assetId, embedUrl, onCitationAction, onCitationClick, onReady, onContentReady, sendConfig, targetOrigin]);
   react.useEffect(() => {
     if (!embedUrl) return;
     sendConfig();

package/dist/assets/AthenaAssetEmbed.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaAssetEmbed.cjs","sources":["../../src/assets/AthenaAssetEmbed.tsx"],"sourcesContent":["\"use client\";\n\nimport { AlertCircle, Loader2 } from \"lucide-react\";\nimport { type CSSProperties, type FC, type IframeHTMLAttributes, useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { useAthenaConfig } from \"../provider/AthenaContext\";\nimport {\n  ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n  type AthenaAssetCitationActionEvent,\n  type AthenaAssetCitationBehavior,\n  type AthenaAssetCitationClickEvent,\n  type AthenaAssetCitationReference,\n  isAthenaAssetCitationActionEvent,\n  isAthenaAssetCitationClickEvent,\n  isAthenaAssetEmbedReadyEvent,\n  resolveAthenaAssetCitationActionBehavior,\n  resolveAthenaAssetCitationBehavior,\n} from \"./asset-embed-messages\";\nimport {\n  buildSdkAssetEmbedUrl,\n  DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  DEFAULT_ASSET_EMBED_READ_ONLY,\n  useAssetEmbed,\n} from \"./use-asset-embed\";\n\nexport interface AthenaAssetEmbedProps extends Omit<\n  IframeHTMLAttributes<HTMLIFrameElement>,\n  \"src\" | \"onError\" | \"onLoad\"\n> {\n  assetId: string;\n  /** Optional citation target to open inside the embedded asset, such as a PDF page. */\n  reference?: AthenaAssetCitationReference;\n  /** Defaults to the native full asset experience. */\n  displayMode?: \"minimal\" | \"full\";\n  /** Defaults to false so authorized users can edit the embedded asset. */\n  readOnly?: boolean;\n  expiresInSeconds?: number;\n  citationBehavior?: AthenaAssetCitationBehavior;\n  onCitationClick?: (event: AthenaAssetCitationClickEvent) => void;\n  /** Controls the citation popover's actions, including the (+) Open in Spaces button. */\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  onCitationAction?: (event: AthenaAssetCitationActionEvent) => void;\n  /**\n   * An embed link the host minted itself (`POST /api/embed/generate-token`, its `/embed/<token>/`\n   * page): the component shows it and mints none. Without it the component mints one with the\n   * provider's credentials, as before.\n   */\n  embedUrl?: string;\n  /** The embedded page said it is ready (its bridge's first message): Athena runs in the frame. */\n  onReady?: () => void;\n  onLoad?: () => void;\n  onError?: (error: Error) => void;\n  loadingFallback?: React.ReactNode;\n  errorFallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n}\n\nconst DEFAULT_STYLE: CSSProperties = {\n  width: \"100%\",\n  height: \"100%\",\n  border: 0,\n};\nconst AUTH_SYNC_INTERVAL_MS = 60_000;\n\nexport const AthenaAssetEmbed: FC<AthenaAssetEmbedProps> = ({\n  assetId,\n  reference,\n  displayMode = DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  readOnly = DEFAULT_ASSET_EMBED_READ_ONLY,\n  expiresInSeconds,\n  citationBehavior,\n  onCitationClick,\n  citationActionBehavior,\n  onCitationAction,\n  embedUrl: hostEmbedUrl,\n  onReady,\n  onLoad,\n  onError,\n  loadingFallback,\n  errorFallback,\n  className,\n  style,\n  title,\n  allow = \"clipboard-read; clipboard-write; fullscreen\",\n  ...iframeProps\n}) => {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const athenaConfig = useAthenaConfig();\n  const { backendUrl, appUrl, apiKey } = athenaConfig;\n  // A link the host minted is shown as given; the hook then mints nothing (no asset to mint for).\n  const minted = useAssetEmbed(hostEmbedUrl ? null : assetId, {\n    backendUrl,\n    appUrl,\n    apiKey,\n    token: athenaConfig.token,\n    getToken: athenaConfig.getToken,\n    readOnly,\n    expiresInSeconds,\n    displayMode,\n  });\n  const embedUrl = hostEmbedUrl ?? minted.embedUrl;\n  const isLoading = hostEmbedUrl ? false : minted.isLoading;\n  const error = hostEmbedUrl ? null : minted.error;\n  const targetOrigin = useMemo(() => {\n    if (!embedUrl) return null;\n    try {\n      return new URL(embedUrl, window.location.href).origin;\n    } catch {\n      return null;\n    }\n  }, [embedUrl]);\n  const iframeSrc = useMemo(\n    () => (embedUrl ? buildSdkAssetEmbedUrl(embedUrl, reference) : null),\n    [embedUrl, reference],\n  );\n  const effectiveCitationBehavior = resolveAthenaAssetCitationBehavior({\n    citationBehavior,\n    hasCitationClickHandler: !!onCitationClick,\n  });\n  const effectiveCitationActionBehavior = resolveAthenaAssetCitationActionBehavior({\n    citationActionBehavior,\n    hasCitationActionHandler: !!onCitationAction,\n  });\n\n  const sendConfig = useCallback(() => {\n    if (!targetOrigin) return;\n    iframeRef.current?.contentWindow?.postMessage(\n      {\n        type: ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n        version: 1,\n        ...(athenaConfig.token ? { token: athenaConfig.token } : {}),\n        citationBehavior: effectiveCitationBehavior,\n        citationActionBehavior: effectiveCitationActionBehavior,\n      },\n      targetOrigin,\n    );\n  }, [athenaConfig, effectiveCitationActionBehavior, effectiveCitationBehavior, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl || !targetOrigin) return;\n    const handleMessage = (event: MessageEvent<unknown>) => {\n      if (event.origin !== targetOrigin || event.source !== iframeRef.current?.contentWindow) return;\n      if (isAthenaAssetEmbedReadyEvent(event.data)) {\n        sendConfig();\n        onReady?.();\n        return;\n      }\n      if (isAthenaAssetCitationClickEvent(event.data)) {\n        onCitationClick?.(event.data);\n        return;\n      }\n      if (isAthenaAssetCitationActionEvent(event.data)) {\n        onCitationAction?.(event.data);\n      }\n    };\n    window.addEventListener(\"message\", handleMessage);\n    return () => window.removeEventListener(\"message\", handleMessage);\n  }, [embedUrl, onCitationAction, onCitationClick, onReady, sendConfig, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl) return;\n    sendConfig();\n    const interval = window.setInterval(sendConfig, AUTH_SYNC_INTERVAL_MS);\n    return () => window.clearInterval(interval);\n  }, [embedUrl, sendConfig]);\n\n  useEffect(() => {\n    if (error) onError?.(new Error(error));\n  }, [error, onError]);\n\n  if (isLoading) {\n    return (\n      loadingFallback ?? (\n        <output className=\"athena-sdk-chrome flex h-full w-full items-center justify-center\">\n          <Loader2 className=\"size-6 animate-spin text-muted-foreground\" />\n          <span className=\"sr-only\">Loading asset</span>\n        </output>\n      )\n    );\n  }\n\n  if (error) {\n    const embedError = new Error(error);\n    if (typeof errorFallback === \"function\") return errorFallback(embedError);\n    return (\n      errorFallback ?? (\n        <div\n          className=\"athena-sdk-chrome flex h-full w-full items-center justify-center gap-2 p-4 text-sm text-muted-foreground\"\n          role=\"alert\"\n        >\n          <AlertCircle className=\"size-4 text-destructive\" />\n          <span>{error}</span>\n        </div>\n      )\n    );\n  }\n\n  if (!embedUrl) return null;\n\n  return (\n    <iframe\n      {...iframeProps}\n      ref={iframeRef}\n      src={iframeSrc ?? undefined}\n      title={title ?? `Athena asset ${assetId}`}\n      allow={allow}\n      className={cn(\"block h-full w-full\", className)}\n      style={{ ...DEFAULT_STYLE, ...style }}\n      onLoad={() => {\n        sendConfig();\n        onLoad?.();\n      }}\n    />\n  );\n};\n"],"names":["DEFAULT_ASSET_EMBED_DISPLAY_MODE","DEFAULT_ASSET_EMBED_READ_ONLY","useRef","useAthenaConfig","useAssetEmbed","useMemo","buildSdkAssetEmbedUrl","resolveAthenaAssetCitationBehavior","resolveAthenaAssetCitationActionBehavior","useCallback","ATHENA_ASSET_EMBED_CONFIG_MESSAGE","useEffect","isAthenaAssetEmbedReadyEvent","isAthenaAssetCitationClickEvent","isAthenaAssetCitationActionEvent","jsxs","jsx","Loader2","AlertCircle","cn"],"mappings":"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"}
+{"version":3,"file":"AthenaAssetEmbed.cjs","sources":["../../src/assets/AthenaAssetEmbed.tsx"],"sourcesContent":["\"use client\";\n\nimport { AlertCircle, Loader2 } from \"lucide-react\";\nimport { type CSSProperties, type FC, type IframeHTMLAttributes, useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { useAthenaConfig } from \"../provider/AthenaContext\";\nimport {\n  ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n  type AthenaAssetCitationActionEvent,\n  type AthenaAssetCitationBehavior,\n  type AthenaAssetCitationClickEvent,\n  type AthenaAssetCitationReference,\n  isAthenaAssetCitationActionEvent,\n  isAthenaAssetCitationClickEvent,\n  isAthenaAssetEmbedReadyEvent,\n  isAthenaAssetEmbedContentReadyEvent,\n  resolveAthenaAssetCitationActionBehavior,\n  resolveAthenaAssetCitationBehavior,\n} from \"./asset-embed-messages\";\nimport {\n  buildSdkAssetEmbedUrl,\n  DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,\n  DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  DEFAULT_ASSET_EMBED_READ_ONLY,\n  useAssetEmbed,\n} from \"./use-asset-embed\";\n\nexport interface AthenaAssetEmbedProps extends Omit<\n  IframeHTMLAttributes<HTMLIFrameElement>,\n  \"src\" | \"onError\" | \"onLoad\"\n> {\n  assetId: string;\n  /** Optional citation target to open inside the embedded asset, such as a PDF page. */\n  reference?: AthenaAssetCitationReference;\n  /** Defaults to the native full asset experience. */\n  displayMode?: \"minimal\" | \"full\";\n  /** Defaults to false so authorized users can edit the embedded asset. */\n  readOnly?: boolean;\n  /**\n   * Offer Quick Edit (⌘J) in a minimal embed (`displayMode=\"minimal\"`): spreadsheets and Word\n   * documents, on an editable link (`readOnly: false`) only. Billed to the asset's workspace, with\n   * an hourly cap per link; the full mode's editors offer it to the signed-in person already.\n   * Defaults to false. Ignored with `embedUrl`: a link the host minted says itself.\n   */\n  allowQuickEdit?: boolean;\n  expiresInSeconds?: number;\n  citationBehavior?: AthenaAssetCitationBehavior;\n  onCitationClick?: (event: AthenaAssetCitationClickEvent) => void;\n  /** Controls the citation popover's actions, including the (+) Open in Spaces button. */\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  onCitationAction?: (event: AthenaAssetCitationActionEvent) => void;\n  /**\n   * An embed link the host minted itself (`POST /api/embed/generate-token`, its `/embed/<token>/`\n   * page): the component shows it and mints none. Without it the component mints one with the\n   * provider's credentials, as before.\n   */\n  embedUrl?: string;\n  /** The embedded page said it is ready (its bridge's first message): Athena runs in the frame. */\n  onReady?: () => void;\n  /** The matching asset viewer has committed usable content in this frame. */\n  onContentReady?: () => void;\n  onLoad?: () => void;\n  onError?: (error: Error) => void;\n  loadingFallback?: React.ReactNode;\n  errorFallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n}\n\nconst DEFAULT_STYLE: CSSProperties = {\n  width: \"100%\",\n  height: \"100%\",\n  border: 0,\n};\nconst AUTH_SYNC_INTERVAL_MS = 60_000;\n\nexport const AthenaAssetEmbed: FC<AthenaAssetEmbedProps> = ({\n  assetId,\n  reference,\n  displayMode = DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  readOnly = DEFAULT_ASSET_EMBED_READ_ONLY,\n  allowQuickEdit = DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,\n  expiresInSeconds,\n  citationBehavior,\n  onCitationClick,\n  citationActionBehavior,\n  onCitationAction,\n  embedUrl: hostEmbedUrl,\n  onReady,\n  onContentReady,\n  onLoad,\n  onError,\n  loadingFallback,\n  errorFallback,\n  className,\n  style,\n  title,\n  allow = \"clipboard-read; clipboard-write; fullscreen\",\n  ...iframeProps\n}) => {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const athenaConfig = useAthenaConfig();\n  const { backendUrl, appUrl, apiKey } = athenaConfig;\n  // A link the host minted is shown as given; the hook then mints nothing (no asset to mint for).\n  const minted = useAssetEmbed(hostEmbedUrl ? null : assetId, {\n    backendUrl,\n    appUrl,\n    apiKey,\n    token: athenaConfig.token,\n    getToken: athenaConfig.getToken,\n    readOnly,\n    expiresInSeconds,\n    displayMode,\n    allowQuickEdit,\n  });\n  const embedUrl = hostEmbedUrl ?? minted.embedUrl;\n  const isLoading = hostEmbedUrl ? false : minted.isLoading;\n  const error = hostEmbedUrl ? null : minted.error;\n  const targetOrigin = useMemo(() => {\n    if (!embedUrl) return null;\n    try {\n      return new URL(embedUrl, window.location.href).origin;\n    } catch {\n      return null;\n    }\n  }, [embedUrl]);\n  const iframeSrc = useMemo(\n    () => (embedUrl ? buildSdkAssetEmbedUrl(embedUrl, reference) : null),\n    [embedUrl, reference],\n  );\n  const effectiveCitationBehavior = resolveAthenaAssetCitationBehavior({\n    citationBehavior,\n    hasCitationClickHandler: !!onCitationClick,\n  });\n  const effectiveCitationActionBehavior = resolveAthenaAssetCitationActionBehavior({\n    citationActionBehavior,\n    hasCitationActionHandler: !!onCitationAction,\n  });\n\n  const sendConfig = useCallback(() => {\n    if (!targetOrigin) return;\n    iframeRef.current?.contentWindow?.postMessage(\n      {\n        type: ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n        version: 1,\n        ...(athenaConfig.token ? { token: athenaConfig.token } : {}),\n        citationBehavior: effectiveCitationBehavior,\n        citationActionBehavior: effectiveCitationActionBehavior,\n      },\n      targetOrigin,\n    );\n  }, [athenaConfig, effectiveCitationActionBehavior, effectiveCitationBehavior, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl || !targetOrigin) return;\n    const handleMessage = (event: MessageEvent<unknown>) => {\n      if (event.origin !== targetOrigin || event.source !== iframeRef.current?.contentWindow) return;\n      if (isAthenaAssetEmbedReadyEvent(event.data)) {\n        sendConfig();\n        onReady?.();\n        return;\n      }\n      if (isAthenaAssetEmbedContentReadyEvent(event.data)) {\n        if (event.data.assetId === assetId) onContentReady?.();\n        return;\n      }\n      if (isAthenaAssetCitationClickEvent(event.data)) {\n        onCitationClick?.(event.data);\n        return;\n      }\n      if (isAthenaAssetCitationActionEvent(event.data)) {\n        onCitationAction?.(event.data);\n      }\n    };\n    window.addEventListener(\"message\", handleMessage);\n    return () => window.removeEventListener(\"message\", handleMessage);\n  }, [assetId, embedUrl, onCitationAction, onCitationClick, onReady, onContentReady, sendConfig, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl) return;\n    sendConfig();\n    const interval = window.setInterval(sendConfig, AUTH_SYNC_INTERVAL_MS);\n    return () => window.clearInterval(interval);\n  }, [embedUrl, sendConfig]);\n\n  useEffect(() => {\n    if (error) onError?.(new Error(error));\n  }, [error, onError]);\n\n  if (isLoading) {\n    return (\n      loadingFallback ?? (\n        <output className=\"athena-sdk-chrome flex h-full w-full items-center justify-center\">\n          <Loader2 className=\"size-6 animate-spin text-muted-foreground\" />\n          <span className=\"sr-only\">Loading asset</span>\n        </output>\n      )\n    );\n  }\n\n  if (error) {\n    const embedError = new Error(error);\n    if (typeof errorFallback === \"function\") return errorFallback(embedError);\n    return (\n      errorFallback ?? (\n        <div\n          className=\"athena-sdk-chrome flex h-full w-full items-center justify-center gap-2 p-4 text-sm text-muted-foreground\"\n          role=\"alert\"\n        >\n          <AlertCircle className=\"size-4 text-destructive\" />\n          <span>{error}</span>\n        </div>\n      )\n    );\n  }\n\n  if (!embedUrl) return null;\n\n  return (\n    <iframe\n      {...iframeProps}\n      ref={iframeRef}\n      src={iframeSrc ?? undefined}\n      title={title ?? `Athena asset ${assetId}`}\n      allow={allow}\n      className={cn(\"block h-full w-full\", className)}\n      style={{ ...DEFAULT_STYLE, ...style }}\n      onLoad={() => {\n        sendConfig();\n        onLoad?.();\n      }}\n    />\n  );\n};\n"],"names":["DEFAULT_ASSET_EMBED_DISPLAY_MODE","DEFAULT_ASSET_EMBED_READ_ONLY","DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT","useRef","useAthenaConfig","useAssetEmbed","useMemo","buildSdkAssetEmbedUrl","resolveAthenaAssetCitationBehavior","resolveAthenaAssetCitationActionBehavior","useCallback","ATHENA_ASSET_EMBED_CONFIG_MESSAGE","useEffect","isAthenaAssetEmbedReadyEvent","isAthenaAssetEmbedContentReadyEvent","isAthenaAssetCitationClickEvent","isAthenaAssetCitationActionEvent","jsxs","jsx","Loader2","AlertCircle","cn"],"mappings":"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"}

package/dist/assets/AthenaAssetEmbed.d.ts

@@ -8,6 +8,13 @@ export interface AthenaAssetEmbedProps extends Omit<IframeHTMLAttributes<HTMLIFr
     displayMode?: "minimal" | "full";
     /** Defaults to false so authorized users can edit the embedded asset. */
     readOnly?: boolean;
+    /**
+     * Offer Quick Edit (⌘J) in a minimal embed (`displayMode="minimal"`): spreadsheets and Word
+     * documents, on an editable link (`readOnly: false`) only. Billed to the asset's workspace, with
+     * an hourly cap per link; the full mode's editors offer it to the signed-in person already.
+     * Defaults to false. Ignored with `embedUrl`: a link the host minted says itself.
+     */
+    allowQuickEdit?: boolean;
     expiresInSeconds?: number;
     citationBehavior?: AthenaAssetCitationBehavior;
     onCitationClick?: (event: AthenaAssetCitationClickEvent) => void;
@@ -22,6 +29,8 @@ export interface AthenaAssetEmbedProps extends Omit<IframeHTMLAttributes<HTMLIFr
     embedUrl?: string;
     /** The embedded page said it is ready (its bridge's first message): Athena runs in the frame. */
     onReady?: () => void;
+    /** The matching asset viewer has committed usable content in this frame. */
+    onContentReady?: () => void;
     onLoad?: () => void;
     onError?: (error: Error) => void;
     loadingFallback?: React.ReactNode;

package/dist/assets/AthenaAssetEmbed.js

@@ -2,8 +2,8 @@ import { jsxs, jsx } from "react/jsx-runtime";
 import { Loader2, AlertCircle } from "lucide-react";
 import { useRef, useMemo, useCallback, useEffect } from "react";
 import { useAthenaConfig } from "../provider/AthenaContext.js";
-import { ATHENA_ASSET_EMBED_CONFIG_MESSAGE, resolveAthenaAssetCitationActionBehavior, resolveAthenaAssetCitationBehavior, isAthenaAssetEmbedReadyEvent, isAthenaAssetCitationClickEvent, isAthenaAssetCitationActionEvent } from "./asset-embed-messages.js";
-import { useAssetEmbed, buildSdkAssetEmbedUrl, DEFAULT_ASSET_EMBED_DISPLAY_MODE, DEFAULT_ASSET_EMBED_READ_ONLY } from "./use-asset-embed.js";
+import { ATHENA_ASSET_EMBED_CONFIG_MESSAGE, resolveAthenaAssetCitationActionBehavior, resolveAthenaAssetCitationBehavior, isAthenaAssetEmbedReadyEvent, isAthenaAssetEmbedContentReadyEvent, isAthenaAssetCitationClickEvent, isAthenaAssetCitationActionEvent } from "./asset-embed-messages.js";
+import { useAssetEmbed, buildSdkAssetEmbedUrl, DEFAULT_ASSET_EMBED_DISPLAY_MODE, DEFAULT_ASSET_EMBED_READ_ONLY, DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT } from "./use-asset-embed.js";
 import { cn } from "cnfast";
 const DEFAULT_STYLE = {
   width: "100%",
@@ -16,6 +16,7 @@ const AthenaAssetEmbed = ({
   reference,
   displayMode = DEFAULT_ASSET_EMBED_DISPLAY_MODE,
   readOnly = DEFAULT_ASSET_EMBED_READ_ONLY,
+  allowQuickEdit = DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,
   expiresInSeconds,
   citationBehavior,
   onCitationClick,
@@ -23,6 +24,7 @@ const AthenaAssetEmbed = ({
   onCitationAction,
   embedUrl: hostEmbedUrl,
   onReady,
+  onContentReady,
   onLoad,
   onError,
   loadingFallback,
@@ -44,7 +46,8 @@ const AthenaAssetEmbed = ({
     getToken: athenaConfig.getToken,
     readOnly,
     expiresInSeconds,
-    displayMode
+    displayMode,
+    allowQuickEdit
   });
   const embedUrl = hostEmbedUrl ?? minted.embedUrl;
   const isLoading = hostEmbedUrl ? false : minted.isLoading;
@@ -93,6 +96,10 @@ const AthenaAssetEmbed = ({
         onReady == null ? void 0 : onReady();
         return;
       }
+      if (isAthenaAssetEmbedContentReadyEvent(event.data)) {
+        if (event.data.assetId === assetId) onContentReady == null ? void 0 : onContentReady();
+        return;
+      }
       if (isAthenaAssetCitationClickEvent(event.data)) {
         onCitationClick == null ? void 0 : onCitationClick(event.data);
         return;
@@ -103,7 +110,7 @@ const AthenaAssetEmbed = ({
     };
     window.addEventListener("message", handleMessage);
     return () => window.removeEventListener("message", handleMessage);
-  }, [embedUrl, onCitationAction, onCitationClick, onReady, sendConfig, targetOrigin]);
+  }, [assetId, embedUrl, onCitationAction, onCitationClick, onReady, onContentReady, sendConfig, targetOrigin]);
   useEffect(() => {
     if (!embedUrl) return;
     sendConfig();

package/dist/assets/AthenaAssetEmbed.js.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaAssetEmbed.js","sources":["../../src/assets/AthenaAssetEmbed.tsx"],"sourcesContent":["\"use client\";\n\nimport { AlertCircle, Loader2 } from \"lucide-react\";\nimport { type CSSProperties, type FC, type IframeHTMLAttributes, useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { useAthenaConfig } from \"../provider/AthenaContext\";\nimport {\n  ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n  type AthenaAssetCitationActionEvent,\n  type AthenaAssetCitationBehavior,\n  type AthenaAssetCitationClickEvent,\n  type AthenaAssetCitationReference,\n  isAthenaAssetCitationActionEvent,\n  isAthenaAssetCitationClickEvent,\n  isAthenaAssetEmbedReadyEvent,\n  resolveAthenaAssetCitationActionBehavior,\n  resolveAthenaAssetCitationBehavior,\n} from \"./asset-embed-messages\";\nimport {\n  buildSdkAssetEmbedUrl,\n  DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  DEFAULT_ASSET_EMBED_READ_ONLY,\n  useAssetEmbed,\n} from \"./use-asset-embed\";\n\nexport interface AthenaAssetEmbedProps extends Omit<\n  IframeHTMLAttributes<HTMLIFrameElement>,\n  \"src\" | \"onError\" | \"onLoad\"\n> {\n  assetId: string;\n  /** Optional citation target to open inside the embedded asset, such as a PDF page. */\n  reference?: AthenaAssetCitationReference;\n  /** Defaults to the native full asset experience. */\n  displayMode?: \"minimal\" | \"full\";\n  /** Defaults to false so authorized users can edit the embedded asset. */\n  readOnly?: boolean;\n  expiresInSeconds?: number;\n  citationBehavior?: AthenaAssetCitationBehavior;\n  onCitationClick?: (event: AthenaAssetCitationClickEvent) => void;\n  /** Controls the citation popover's actions, including the (+) Open in Spaces button. */\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  onCitationAction?: (event: AthenaAssetCitationActionEvent) => void;\n  /**\n   * An embed link the host minted itself (`POST /api/embed/generate-token`, its `/embed/<token>/`\n   * page): the component shows it and mints none. Without it the component mints one with the\n   * provider's credentials, as before.\n   */\n  embedUrl?: string;\n  /** The embedded page said it is ready (its bridge's first message): Athena runs in the frame. */\n  onReady?: () => void;\n  onLoad?: () => void;\n  onError?: (error: Error) => void;\n  loadingFallback?: React.ReactNode;\n  errorFallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n}\n\nconst DEFAULT_STYLE: CSSProperties = {\n  width: \"100%\",\n  height: \"100%\",\n  border: 0,\n};\nconst AUTH_SYNC_INTERVAL_MS = 60_000;\n\nexport const AthenaAssetEmbed: FC<AthenaAssetEmbedProps> = ({\n  assetId,\n  reference,\n  displayMode = DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  readOnly = DEFAULT_ASSET_EMBED_READ_ONLY,\n  expiresInSeconds,\n  citationBehavior,\n  onCitationClick,\n  citationActionBehavior,\n  onCitationAction,\n  embedUrl: hostEmbedUrl,\n  onReady,\n  onLoad,\n  onError,\n  loadingFallback,\n  errorFallback,\n  className,\n  style,\n  title,\n  allow = \"clipboard-read; clipboard-write; fullscreen\",\n  ...iframeProps\n}) => {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const athenaConfig = useAthenaConfig();\n  const { backendUrl, appUrl, apiKey } = athenaConfig;\n  // A link the host minted is shown as given; the hook then mints nothing (no asset to mint for).\n  const minted = useAssetEmbed(hostEmbedUrl ? null : assetId, {\n    backendUrl,\n    appUrl,\n    apiKey,\n    token: athenaConfig.token,\n    getToken: athenaConfig.getToken,\n    readOnly,\n    expiresInSeconds,\n    displayMode,\n  });\n  const embedUrl = hostEmbedUrl ?? minted.embedUrl;\n  const isLoading = hostEmbedUrl ? false : minted.isLoading;\n  const error = hostEmbedUrl ? null : minted.error;\n  const targetOrigin = useMemo(() => {\n    if (!embedUrl) return null;\n    try {\n      return new URL(embedUrl, window.location.href).origin;\n    } catch {\n      return null;\n    }\n  }, [embedUrl]);\n  const iframeSrc = useMemo(\n    () => (embedUrl ? buildSdkAssetEmbedUrl(embedUrl, reference) : null),\n    [embedUrl, reference],\n  );\n  const effectiveCitationBehavior = resolveAthenaAssetCitationBehavior({\n    citationBehavior,\n    hasCitationClickHandler: !!onCitationClick,\n  });\n  const effectiveCitationActionBehavior = resolveAthenaAssetCitationActionBehavior({\n    citationActionBehavior,\n    hasCitationActionHandler: !!onCitationAction,\n  });\n\n  const sendConfig = useCallback(() => {\n    if (!targetOrigin) return;\n    iframeRef.current?.contentWindow?.postMessage(\n      {\n        type: ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n        version: 1,\n        ...(athenaConfig.token ? { token: athenaConfig.token } : {}),\n        citationBehavior: effectiveCitationBehavior,\n        citationActionBehavior: effectiveCitationActionBehavior,\n      },\n      targetOrigin,\n    );\n  }, [athenaConfig, effectiveCitationActionBehavior, effectiveCitationBehavior, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl || !targetOrigin) return;\n    const handleMessage = (event: MessageEvent<unknown>) => {\n      if (event.origin !== targetOrigin || event.source !== iframeRef.current?.contentWindow) return;\n      if (isAthenaAssetEmbedReadyEvent(event.data)) {\n        sendConfig();\n        onReady?.();\n        return;\n      }\n      if (isAthenaAssetCitationClickEvent(event.data)) {\n        onCitationClick?.(event.data);\n        return;\n      }\n      if (isAthenaAssetCitationActionEvent(event.data)) {\n        onCitationAction?.(event.data);\n      }\n    };\n    window.addEventListener(\"message\", handleMessage);\n    return () => window.removeEventListener(\"message\", handleMessage);\n  }, [embedUrl, onCitationAction, onCitationClick, onReady, sendConfig, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl) return;\n    sendConfig();\n    const interval = window.setInterval(sendConfig, AUTH_SYNC_INTERVAL_MS);\n    return () => window.clearInterval(interval);\n  }, [embedUrl, sendConfig]);\n\n  useEffect(() => {\n    if (error) onError?.(new Error(error));\n  }, [error, onError]);\n\n  if (isLoading) {\n    return (\n      loadingFallback ?? (\n        <output className=\"athena-sdk-chrome flex h-full w-full items-center justify-center\">\n          <Loader2 className=\"size-6 animate-spin text-muted-foreground\" />\n          <span className=\"sr-only\">Loading asset</span>\n        </output>\n      )\n    );\n  }\n\n  if (error) {\n    const embedError = new Error(error);\n    if (typeof errorFallback === \"function\") return errorFallback(embedError);\n    return (\n      errorFallback ?? (\n        <div\n          className=\"athena-sdk-chrome flex h-full w-full items-center justify-center gap-2 p-4 text-sm text-muted-foreground\"\n          role=\"alert\"\n        >\n          <AlertCircle className=\"size-4 text-destructive\" />\n          <span>{error}</span>\n        </div>\n      )\n    );\n  }\n\n  if (!embedUrl) return null;\n\n  return (\n    <iframe\n      {...iframeProps}\n      ref={iframeRef}\n      src={iframeSrc ?? undefined}\n      title={title ?? `Athena asset ${assetId}`}\n      allow={allow}\n      className={cn(\"block h-full w-full\", className)}\n      style={{ ...DEFAULT_STYLE, ...style }}\n      onLoad={() => {\n        sendConfig();\n        onLoad?.();\n      }}\n    />\n  );\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"AthenaAssetEmbed.js","sources":["../../src/assets/AthenaAssetEmbed.tsx"],"sourcesContent":["\"use client\";\n\nimport { AlertCircle, Loader2 } from \"lucide-react\";\nimport { type CSSProperties, type FC, type IframeHTMLAttributes, useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { useAthenaConfig } from \"../provider/AthenaContext\";\nimport {\n  ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n  type AthenaAssetCitationActionEvent,\n  type AthenaAssetCitationBehavior,\n  type AthenaAssetCitationClickEvent,\n  type AthenaAssetCitationReference,\n  isAthenaAssetCitationActionEvent,\n  isAthenaAssetCitationClickEvent,\n  isAthenaAssetEmbedReadyEvent,\n  isAthenaAssetEmbedContentReadyEvent,\n  resolveAthenaAssetCitationActionBehavior,\n  resolveAthenaAssetCitationBehavior,\n} from \"./asset-embed-messages\";\nimport {\n  buildSdkAssetEmbedUrl,\n  DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,\n  DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  DEFAULT_ASSET_EMBED_READ_ONLY,\n  useAssetEmbed,\n} from \"./use-asset-embed\";\n\nexport interface AthenaAssetEmbedProps extends Omit<\n  IframeHTMLAttributes<HTMLIFrameElement>,\n  \"src\" | \"onError\" | \"onLoad\"\n> {\n  assetId: string;\n  /** Optional citation target to open inside the embedded asset, such as a PDF page. */\n  reference?: AthenaAssetCitationReference;\n  /** Defaults to the native full asset experience. */\n  displayMode?: \"minimal\" | \"full\";\n  /** Defaults to false so authorized users can edit the embedded asset. */\n  readOnly?: boolean;\n  /**\n   * Offer Quick Edit (⌘J) in a minimal embed (`displayMode=\"minimal\"`): spreadsheets and Word\n   * documents, on an editable link (`readOnly: false`) only. Billed to the asset's workspace, with\n   * an hourly cap per link; the full mode's editors offer it to the signed-in person already.\n   * Defaults to false. Ignored with `embedUrl`: a link the host minted says itself.\n   */\n  allowQuickEdit?: boolean;\n  expiresInSeconds?: number;\n  citationBehavior?: AthenaAssetCitationBehavior;\n  onCitationClick?: (event: AthenaAssetCitationClickEvent) => void;\n  /** Controls the citation popover's actions, including the (+) Open in Spaces button. */\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  onCitationAction?: (event: AthenaAssetCitationActionEvent) => void;\n  /**\n   * An embed link the host minted itself (`POST /api/embed/generate-token`, its `/embed/<token>/`\n   * page): the component shows it and mints none. Without it the component mints one with the\n   * provider's credentials, as before.\n   */\n  embedUrl?: string;\n  /** The embedded page said it is ready (its bridge's first message): Athena runs in the frame. */\n  onReady?: () => void;\n  /** The matching asset viewer has committed usable content in this frame. */\n  onContentReady?: () => void;\n  onLoad?: () => void;\n  onError?: (error: Error) => void;\n  loadingFallback?: React.ReactNode;\n  errorFallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n}\n\nconst DEFAULT_STYLE: CSSProperties = {\n  width: \"100%\",\n  height: \"100%\",\n  border: 0,\n};\nconst AUTH_SYNC_INTERVAL_MS = 60_000;\n\nexport const AthenaAssetEmbed: FC<AthenaAssetEmbedProps> = ({\n  assetId,\n  reference,\n  displayMode = DEFAULT_ASSET_EMBED_DISPLAY_MODE,\n  readOnly = DEFAULT_ASSET_EMBED_READ_ONLY,\n  allowQuickEdit = DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,\n  expiresInSeconds,\n  citationBehavior,\n  onCitationClick,\n  citationActionBehavior,\n  onCitationAction,\n  embedUrl: hostEmbedUrl,\n  onReady,\n  onContentReady,\n  onLoad,\n  onError,\n  loadingFallback,\n  errorFallback,\n  className,\n  style,\n  title,\n  allow = \"clipboard-read; clipboard-write; fullscreen\",\n  ...iframeProps\n}) => {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const athenaConfig = useAthenaConfig();\n  const { backendUrl, appUrl, apiKey } = athenaConfig;\n  // A link the host minted is shown as given; the hook then mints nothing (no asset to mint for).\n  const minted = useAssetEmbed(hostEmbedUrl ? null : assetId, {\n    backendUrl,\n    appUrl,\n    apiKey,\n    token: athenaConfig.token,\n    getToken: athenaConfig.getToken,\n    readOnly,\n    expiresInSeconds,\n    displayMode,\n    allowQuickEdit,\n  });\n  const embedUrl = hostEmbedUrl ?? minted.embedUrl;\n  const isLoading = hostEmbedUrl ? false : minted.isLoading;\n  const error = hostEmbedUrl ? null : minted.error;\n  const targetOrigin = useMemo(() => {\n    if (!embedUrl) return null;\n    try {\n      return new URL(embedUrl, window.location.href).origin;\n    } catch {\n      return null;\n    }\n  }, [embedUrl]);\n  const iframeSrc = useMemo(\n    () => (embedUrl ? buildSdkAssetEmbedUrl(embedUrl, reference) : null),\n    [embedUrl, reference],\n  );\n  const effectiveCitationBehavior = resolveAthenaAssetCitationBehavior({\n    citationBehavior,\n    hasCitationClickHandler: !!onCitationClick,\n  });\n  const effectiveCitationActionBehavior = resolveAthenaAssetCitationActionBehavior({\n    citationActionBehavior,\n    hasCitationActionHandler: !!onCitationAction,\n  });\n\n  const sendConfig = useCallback(() => {\n    if (!targetOrigin) return;\n    iframeRef.current?.contentWindow?.postMessage(\n      {\n        type: ATHENA_ASSET_EMBED_CONFIG_MESSAGE,\n        version: 1,\n        ...(athenaConfig.token ? { token: athenaConfig.token } : {}),\n        citationBehavior: effectiveCitationBehavior,\n        citationActionBehavior: effectiveCitationActionBehavior,\n      },\n      targetOrigin,\n    );\n  }, [athenaConfig, effectiveCitationActionBehavior, effectiveCitationBehavior, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl || !targetOrigin) return;\n    const handleMessage = (event: MessageEvent<unknown>) => {\n      if (event.origin !== targetOrigin || event.source !== iframeRef.current?.contentWindow) return;\n      if (isAthenaAssetEmbedReadyEvent(event.data)) {\n        sendConfig();\n        onReady?.();\n        return;\n      }\n      if (isAthenaAssetEmbedContentReadyEvent(event.data)) {\n        if (event.data.assetId === assetId) onContentReady?.();\n        return;\n      }\n      if (isAthenaAssetCitationClickEvent(event.data)) {\n        onCitationClick?.(event.data);\n        return;\n      }\n      if (isAthenaAssetCitationActionEvent(event.data)) {\n        onCitationAction?.(event.data);\n      }\n    };\n    window.addEventListener(\"message\", handleMessage);\n    return () => window.removeEventListener(\"message\", handleMessage);\n  }, [assetId, embedUrl, onCitationAction, onCitationClick, onReady, onContentReady, sendConfig, targetOrigin]);\n\n  useEffect(() => {\n    if (!embedUrl) return;\n    sendConfig();\n    const interval = window.setInterval(sendConfig, AUTH_SYNC_INTERVAL_MS);\n    return () => window.clearInterval(interval);\n  }, [embedUrl, sendConfig]);\n\n  useEffect(() => {\n    if (error) onError?.(new Error(error));\n  }, [error, onError]);\n\n  if (isLoading) {\n    return (\n      loadingFallback ?? (\n        <output className=\"athena-sdk-chrome flex h-full w-full items-center justify-center\">\n          <Loader2 className=\"size-6 animate-spin text-muted-foreground\" />\n          <span className=\"sr-only\">Loading asset</span>\n        </output>\n      )\n    );\n  }\n\n  if (error) {\n    const embedError = new Error(error);\n    if (typeof errorFallback === \"function\") return errorFallback(embedError);\n    return (\n      errorFallback ?? (\n        <div\n          className=\"athena-sdk-chrome flex h-full w-full items-center justify-center gap-2 p-4 text-sm text-muted-foreground\"\n          role=\"alert\"\n        >\n          <AlertCircle className=\"size-4 text-destructive\" />\n          <span>{error}</span>\n        </div>\n      )\n    );\n  }\n\n  if (!embedUrl) return null;\n\n  return (\n    <iframe\n      {...iframeProps}\n      ref={iframeRef}\n      src={iframeSrc ?? undefined}\n      title={title ?? `Athena asset ${assetId}`}\n      allow={allow}\n      className={cn(\"block h-full w-full\", className)}\n      style={{ ...DEFAULT_STYLE, ...style }}\n      onLoad={() => {\n        sendConfig();\n        onLoad?.();\n      }}\n    />\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/assets/asset-embed-messages.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const ATHENA_ASSET_EMBED_READY_MESSAGE = "athena:asset-embed-ready";
+const ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE = "athena:asset-embed-content-ready";
 const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = "athena:asset-embed-config";
 const ATHENA_ASSET_CITATION_CLICK_MESSAGE = "athena:asset-citation-click";
 const ATHENA_ASSET_CITATION_ACTION_MESSAGE = "athena:asset-citation-action";
@@ -27,12 +28,17 @@ function isAthenaAssetCitationClickEvent(value) {
 function isAthenaAssetCitationActionEvent(value) {
   return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE && "version" in value && value.version === 1 && "action" in value && value.action === "open-in-spaces" && "reference" in value && typeof value.reference === "object" && value.reference !== null && "id" in value.reference && typeof value.reference.id === "string";
 }
+function isAthenaAssetEmbedContentReadyEvent(value) {
+  return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE && "version" in value && value.version === 1 && "assetId" in value && typeof value.assetId === "string" && value.assetId.length > 0;
+}
 exports.ATHENA_ASSET_CITATION_ACTION_MESSAGE = ATHENA_ASSET_CITATION_ACTION_MESSAGE;
 exports.ATHENA_ASSET_CITATION_CLICK_MESSAGE = ATHENA_ASSET_CITATION_CLICK_MESSAGE;
 exports.ATHENA_ASSET_EMBED_CONFIG_MESSAGE = ATHENA_ASSET_EMBED_CONFIG_MESSAGE;
+exports.ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE = ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE;
 exports.ATHENA_ASSET_EMBED_READY_MESSAGE = ATHENA_ASSET_EMBED_READY_MESSAGE;
 exports.isAthenaAssetCitationActionEvent = isAthenaAssetCitationActionEvent;
 exports.isAthenaAssetCitationClickEvent = isAthenaAssetCitationClickEvent;
+exports.isAthenaAssetEmbedContentReadyEvent = isAthenaAssetEmbedContentReadyEvent;
 exports.isAthenaAssetEmbedReadyEvent = isAthenaAssetEmbedReadyEvent;
 exports.resolveAthenaAssetCitationActionBehavior = resolveAthenaAssetCitationActionBehavior;
 exports.resolveAthenaAssetCitationBehavior = resolveAthenaAssetCitationBehavior;

package/dist/assets/asset-embed-messages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"asset-embed-messages.cjs","sources":["../../src/assets/asset-embed-messages.ts"],"sourcesContent":["export const ATHENA_ASSET_EMBED_READY_MESSAGE = \"athena:asset-embed-ready\" as const;\nexport const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = \"athena:asset-embed-config\" as const;\nexport const ATHENA_ASSET_CITATION_CLICK_MESSAGE = \"athena:asset-citation-click\" as const;\nexport const ATHENA_ASSET_CITATION_ACTION_MESSAGE = \"athena:asset-citation-action\" as const;\n\nexport type AthenaAssetCitationBehavior = \"browser\" | \"host\";\nexport type AthenaAssetCitationAction = \"open-in-spaces\";\n\nexport interface AthenaAssetCitationReference {\n  id: string;\n  /**\n   * Where in the asset the citation points. Either the anchor's raw query string as Athena links,\n   * citations and search results carry it (`anchor=slide&slide_index=3`, `anchor=time&time=0:42`,\n   * `asset_x?anchor=pm_node&node_id=…`), which an embed receives as written whatever kind of\n   * place it names, or a typed page or sheet anchor (`{ type: 'page', page: 34 }`).\n   */\n  anchor?: unknown;\n  meta?: Record<string, unknown>;\n}\n\nexport interface AthenaAssetCitationClickEvent {\n  type: typeof ATHENA_ASSET_CITATION_CLICK_MESSAGE;\n  version: 1;\n  sourceAssetId?: string;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetCitationActionEvent {\n  type: typeof ATHENA_ASSET_CITATION_ACTION_MESSAGE;\n  version: 1;\n  action: AthenaAssetCitationAction;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetEmbedReadyEvent {\n  type: typeof ATHENA_ASSET_EMBED_READY_MESSAGE;\n  version: 1;\n}\n\nexport interface AthenaAssetEmbedConfigEvent {\n  type: typeof ATHENA_ASSET_EMBED_CONFIG_MESSAGE;\n  version: 1;\n  token?: string;\n  citationBehavior: AthenaAssetCitationBehavior;\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n}\n\nexport function resolveAthenaAssetCitationBehavior({\n  citationBehavior,\n  hasCitationClickHandler,\n}: {\n  citationBehavior?: AthenaAssetCitationBehavior;\n  hasCitationClickHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationBehavior === \"host\" && !hasCitationClickHandler) return \"browser\";\n  return citationBehavior ?? (hasCitationClickHandler ? \"host\" : \"browser\");\n}\n\nexport function resolveAthenaAssetCitationActionBehavior({\n  citationActionBehavior,\n  hasCitationActionHandler,\n}: {\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  hasCitationActionHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationActionBehavior === \"host\" && !hasCitationActionHandler) return \"browser\";\n  return citationActionBehavior ?? (hasCitationActionHandler ? \"host\" : \"browser\");\n}\n\nexport function isAthenaAssetEmbedReadyEvent(value: unknown): value is AthenaAssetEmbedReadyEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_EMBED_READY_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1\n  );\n}\n\nexport function isAthenaAssetCitationClickEvent(value: unknown): value is AthenaAssetCitationClickEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_CLICK_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n\nexport function isAthenaAssetCitationActionEvent(value: unknown): value is AthenaAssetCitationActionEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"action\" in value &&\n    value.action === \"open-in-spaces\" &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n"],"names":[],"mappings":";;AAAO,MAAM,mCAAmC;AACzC,MAAM,oCAAoC;AAC1C,MAAM,sCAAsC;AAC5C,MAAM,uCAAuC;AA4C7C,SAAS,mCAAmC;AAAA,EACjD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,qBAAqB,UAAU,CAAC,wBAAyB,QAAO;AACpE,SAAO,qBAAqB,0BAA0B,SAAS;AACjE;AAEO,SAAS,yCAAyC;AAAA,EACvD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,2BAA2B,UAAU,CAAC,yBAA0B,QAAO;AAC3E,SAAO,2BAA2B,2BAA2B,SAAS;AACxE;AAEO,SAAS,6BAA6B,OAAqD;AAChG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,oCACf,aAAa,SACb,MAAM,YAAY;AAEtB;AAEO,SAAS,gCAAgC,OAAwD;AACtG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,uCACf,aAAa,SACb,MAAM,YAAY,KAClB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;AAEO,SAAS,iCAAiC,OAAyD;AACxG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,wCACf,aAAa,SACb,MAAM,YAAY,KAClB,YAAY,SACZ,MAAM,WAAW,oBACjB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;;;;;;;;;;"}
+{"version":3,"file":"asset-embed-messages.cjs","sources":["../../src/assets/asset-embed-messages.ts"],"sourcesContent":["export const ATHENA_ASSET_EMBED_READY_MESSAGE = \"athena:asset-embed-ready\" as const;\nexport const ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE = \"athena:asset-embed-content-ready\" as const;\nexport const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = \"athena:asset-embed-config\" as const;\nexport const ATHENA_ASSET_CITATION_CLICK_MESSAGE = \"athena:asset-citation-click\" as const;\nexport const ATHENA_ASSET_CITATION_ACTION_MESSAGE = \"athena:asset-citation-action\" as const;\n\nexport type AthenaAssetCitationBehavior = \"browser\" | \"host\";\nexport type AthenaAssetCitationAction = \"open-in-spaces\";\n\nexport interface AthenaAssetCitationReference {\n  id: string;\n  /**\n   * Where in the asset the citation points. Either the anchor's raw query string as Athena links,\n   * citations and search results carry it (`anchor=slide&slide_index=3`, `anchor=time&time=0:42`,\n   * `asset_x?anchor=pm_node&node_id=…`), which an embed receives as written whatever kind of\n   * place it names, or a typed page or sheet anchor (`{ type: 'page', page: 34 }`).\n   */\n  anchor?: unknown;\n  meta?: Record<string, unknown>;\n}\n\nexport interface AthenaAssetCitationClickEvent {\n  type: typeof ATHENA_ASSET_CITATION_CLICK_MESSAGE;\n  version: 1;\n  sourceAssetId?: string;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetCitationActionEvent {\n  type: typeof ATHENA_ASSET_CITATION_ACTION_MESSAGE;\n  version: 1;\n  action: AthenaAssetCitationAction;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetEmbedReadyEvent {\n  type: typeof ATHENA_ASSET_EMBED_READY_MESSAGE;\n  version: 1;\n}\n\nexport interface AthenaAssetEmbedConfigEvent {\n  type: typeof ATHENA_ASSET_EMBED_CONFIG_MESSAGE;\n  version: 1;\n  token?: string;\n  citationBehavior: AthenaAssetCitationBehavior;\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n}\n\nexport function resolveAthenaAssetCitationBehavior({\n  citationBehavior,\n  hasCitationClickHandler,\n}: {\n  citationBehavior?: AthenaAssetCitationBehavior;\n  hasCitationClickHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationBehavior === \"host\" && !hasCitationClickHandler) return \"browser\";\n  return citationBehavior ?? (hasCitationClickHandler ? \"host\" : \"browser\");\n}\n\nexport function resolveAthenaAssetCitationActionBehavior({\n  citationActionBehavior,\n  hasCitationActionHandler,\n}: {\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  hasCitationActionHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationActionBehavior === \"host\" && !hasCitationActionHandler) return \"browser\";\n  return citationActionBehavior ?? (hasCitationActionHandler ? \"host\" : \"browser\");\n}\n\nexport function isAthenaAssetEmbedReadyEvent(value: unknown): value is AthenaAssetEmbedReadyEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_EMBED_READY_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1\n  );\n}\n\nexport function isAthenaAssetCitationClickEvent(value: unknown): value is AthenaAssetCitationClickEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_CLICK_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n\nexport function isAthenaAssetCitationActionEvent(value: unknown): value is AthenaAssetCitationActionEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"action\" in value &&\n    value.action === \"open-in-spaces\" &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n\n/** Content has rendered; bootstrap and iframe load events do not prove an asset opened. */\nexport function isAthenaAssetEmbedContentReadyEvent(value: unknown): value is {\n  type: typeof ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE;\n  version: 1;\n  assetId: string;\n} {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"assetId\" in value &&\n    typeof value.assetId === \"string\" &&\n    value.assetId.length > 0\n  );\n}\n"],"names":[],"mappings":";;AAAO,MAAM,mCAAmC;AACzC,MAAM,2CAA2C;AACjD,MAAM,oCAAoC;AAC1C,MAAM,sCAAsC;AAC5C,MAAM,uCAAuC;AA4C7C,SAAS,mCAAmC;AAAA,EACjD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,qBAAqB,UAAU,CAAC,wBAAyB,QAAO;AACpE,SAAO,qBAAqB,0BAA0B,SAAS;AACjE;AAEO,SAAS,yCAAyC;AAAA,EACvD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,2BAA2B,UAAU,CAAC,yBAA0B,QAAO;AAC3E,SAAO,2BAA2B,2BAA2B,SAAS;AACxE;AAEO,SAAS,6BAA6B,OAAqD;AAChG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,oCACf,aAAa,SACb,MAAM,YAAY;AAEtB;AAEO,SAAS,gCAAgC,OAAwD;AACtG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,uCACf,aAAa,SACb,MAAM,YAAY,KAClB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;AAEO,SAAS,iCAAiC,OAAyD;AACxG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,wCACf,aAAa,SACb,MAAM,YAAY,KAClB,YAAY,SACZ,MAAM,WAAW,oBACjB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;AAGO,SAAS,oCAAoC,OAIlD;AACA,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,4CACf,aAAa,SACb,MAAM,YAAY,KAClB,aAAa,SACb,OAAO,MAAM,YAAY,YACzB,MAAM,QAAQ,SAAS;AAE3B;;;;;;;;;;;;"}

package/dist/assets/asset-embed-messages.d.ts

@@ -1,4 +1,5 @@
 export declare const ATHENA_ASSET_EMBED_READY_MESSAGE: "athena:asset-embed-ready";
+export declare const ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE: "athena:asset-embed-content-ready";
 export declare const ATHENA_ASSET_EMBED_CONFIG_MESSAGE: "athena:asset-embed-config";
 export declare const ATHENA_ASSET_CITATION_CLICK_MESSAGE: "athena:asset-citation-click";
 export declare const ATHENA_ASSET_CITATION_ACTION_MESSAGE: "athena:asset-citation-action";
@@ -49,3 +50,9 @@ export declare function resolveAthenaAssetCitationActionBehavior({ citationActio
 export declare function isAthenaAssetEmbedReadyEvent(value: unknown): value is AthenaAssetEmbedReadyEvent;
 export declare function isAthenaAssetCitationClickEvent(value: unknown): value is AthenaAssetCitationClickEvent;
 export declare function isAthenaAssetCitationActionEvent(value: unknown): value is AthenaAssetCitationActionEvent;
+/** Content has rendered; bootstrap and iframe load events do not prove an asset opened. */
+export declare function isAthenaAssetEmbedContentReadyEvent(value: unknown): value is {
+    type: typeof ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE;
+    version: 1;
+    assetId: string;
+};

package/dist/assets/asset-embed-messages.js

@@ -1,4 +1,5 @@
 const ATHENA_ASSET_EMBED_READY_MESSAGE = "athena:asset-embed-ready";
+const ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE = "athena:asset-embed-content-ready";
 const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = "athena:asset-embed-config";
 const ATHENA_ASSET_CITATION_CLICK_MESSAGE = "athena:asset-citation-click";
 const ATHENA_ASSET_CITATION_ACTION_MESSAGE = "athena:asset-citation-action";
@@ -25,13 +26,18 @@ function isAthenaAssetCitationClickEvent(value) {
 function isAthenaAssetCitationActionEvent(value) {
   return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE && "version" in value && value.version === 1 && "action" in value && value.action === "open-in-spaces" && "reference" in value && typeof value.reference === "object" && value.reference !== null && "id" in value.reference && typeof value.reference.id === "string";
 }
+function isAthenaAssetEmbedContentReadyEvent(value) {
+  return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE && "version" in value && value.version === 1 && "assetId" in value && typeof value.assetId === "string" && value.assetId.length > 0;
+}
 export {
   ATHENA_ASSET_CITATION_ACTION_MESSAGE,
   ATHENA_ASSET_CITATION_CLICK_MESSAGE,
   ATHENA_ASSET_EMBED_CONFIG_MESSAGE,
+  ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE,
   ATHENA_ASSET_EMBED_READY_MESSAGE,
   isAthenaAssetCitationActionEvent,
   isAthenaAssetCitationClickEvent,
+  isAthenaAssetEmbedContentReadyEvent,
   isAthenaAssetEmbedReadyEvent,
   resolveAthenaAssetCitationActionBehavior,
   resolveAthenaAssetCitationBehavior

package/dist/assets/asset-embed-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-embed-messages.js","sources":["../../src/assets/asset-embed-messages.ts"],"sourcesContent":["export const ATHENA_ASSET_EMBED_READY_MESSAGE = \"athena:asset-embed-ready\" as const;\nexport const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = \"athena:asset-embed-config\" as const;\nexport const ATHENA_ASSET_CITATION_CLICK_MESSAGE = \"athena:asset-citation-click\" as const;\nexport const ATHENA_ASSET_CITATION_ACTION_MESSAGE = \"athena:asset-citation-action\" as const;\n\nexport type AthenaAssetCitationBehavior = \"browser\" | \"host\";\nexport type AthenaAssetCitationAction = \"open-in-spaces\";\n\nexport interface AthenaAssetCitationReference {\n  id: string;\n  /**\n   * Where in the asset the citation points. Either the anchor's raw query string as Athena links,\n   * citations and search results carry it (`anchor=slide&slide_index=3`, `anchor=time&time=0:42`,\n   * `asset_x?anchor=pm_node&node_id=…`), which an embed receives as written whatever kind of\n   * place it names, or a typed page or sheet anchor (`{ type: 'page', page: 34 }`).\n   */\n  anchor?: unknown;\n  meta?: Record<string, unknown>;\n}\n\nexport interface AthenaAssetCitationClickEvent {\n  type: typeof ATHENA_ASSET_CITATION_CLICK_MESSAGE;\n  version: 1;\n  sourceAssetId?: string;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetCitationActionEvent {\n  type: typeof ATHENA_ASSET_CITATION_ACTION_MESSAGE;\n  version: 1;\n  action: AthenaAssetCitationAction;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetEmbedReadyEvent {\n  type: typeof ATHENA_ASSET_EMBED_READY_MESSAGE;\n  version: 1;\n}\n\nexport interface AthenaAssetEmbedConfigEvent {\n  type: typeof ATHENA_ASSET_EMBED_CONFIG_MESSAGE;\n  version: 1;\n  token?: string;\n  citationBehavior: AthenaAssetCitationBehavior;\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n}\n\nexport function resolveAthenaAssetCitationBehavior({\n  citationBehavior,\n  hasCitationClickHandler,\n}: {\n  citationBehavior?: AthenaAssetCitationBehavior;\n  hasCitationClickHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationBehavior === \"host\" && !hasCitationClickHandler) return \"browser\";\n  return citationBehavior ?? (hasCitationClickHandler ? \"host\" : \"browser\");\n}\n\nexport function resolveAthenaAssetCitationActionBehavior({\n  citationActionBehavior,\n  hasCitationActionHandler,\n}: {\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  hasCitationActionHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationActionBehavior === \"host\" && !hasCitationActionHandler) return \"browser\";\n  return citationActionBehavior ?? (hasCitationActionHandler ? \"host\" : \"browser\");\n}\n\nexport function isAthenaAssetEmbedReadyEvent(value: unknown): value is AthenaAssetEmbedReadyEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_EMBED_READY_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1\n  );\n}\n\nexport function isAthenaAssetCitationClickEvent(value: unknown): value is AthenaAssetCitationClickEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_CLICK_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n\nexport function isAthenaAssetCitationActionEvent(value: unknown): value is AthenaAssetCitationActionEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"action\" in value &&\n    value.action === \"open-in-spaces\" &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n"],"names":[],"mappings":"AAAO,MAAM,mCAAmC;AACzC,MAAM,oCAAoC;AAC1C,MAAM,sCAAsC;AAC5C,MAAM,uCAAuC;AA4C7C,SAAS,mCAAmC;AAAA,EACjD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,qBAAqB,UAAU,CAAC,wBAAyB,QAAO;AACpE,SAAO,qBAAqB,0BAA0B,SAAS;AACjE;AAEO,SAAS,yCAAyC;AAAA,EACvD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,2BAA2B,UAAU,CAAC,yBAA0B,QAAO;AAC3E,SAAO,2BAA2B,2BAA2B,SAAS;AACxE;AAEO,SAAS,6BAA6B,OAAqD;AAChG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,oCACf,aAAa,SACb,MAAM,YAAY;AAEtB;AAEO,SAAS,gCAAgC,OAAwD;AACtG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,uCACf,aAAa,SACb,MAAM,YAAY,KAClB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;AAEO,SAAS,iCAAiC,OAAyD;AACxG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,wCACf,aAAa,SACb,MAAM,YAAY,KAClB,YAAY,SACZ,MAAM,WAAW,oBACjB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;"}
+{"version":3,"file":"asset-embed-messages.js","sources":["../../src/assets/asset-embed-messages.ts"],"sourcesContent":["export const ATHENA_ASSET_EMBED_READY_MESSAGE = \"athena:asset-embed-ready\" as const;\nexport const ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE = \"athena:asset-embed-content-ready\" as const;\nexport const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = \"athena:asset-embed-config\" as const;\nexport const ATHENA_ASSET_CITATION_CLICK_MESSAGE = \"athena:asset-citation-click\" as const;\nexport const ATHENA_ASSET_CITATION_ACTION_MESSAGE = \"athena:asset-citation-action\" as const;\n\nexport type AthenaAssetCitationBehavior = \"browser\" | \"host\";\nexport type AthenaAssetCitationAction = \"open-in-spaces\";\n\nexport interface AthenaAssetCitationReference {\n  id: string;\n  /**\n   * Where in the asset the citation points. Either the anchor's raw query string as Athena links,\n   * citations and search results carry it (`anchor=slide&slide_index=3`, `anchor=time&time=0:42`,\n   * `asset_x?anchor=pm_node&node_id=…`), which an embed receives as written whatever kind of\n   * place it names, or a typed page or sheet anchor (`{ type: 'page', page: 34 }`).\n   */\n  anchor?: unknown;\n  meta?: Record<string, unknown>;\n}\n\nexport interface AthenaAssetCitationClickEvent {\n  type: typeof ATHENA_ASSET_CITATION_CLICK_MESSAGE;\n  version: 1;\n  sourceAssetId?: string;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetCitationActionEvent {\n  type: typeof ATHENA_ASSET_CITATION_ACTION_MESSAGE;\n  version: 1;\n  action: AthenaAssetCitationAction;\n  reference: AthenaAssetCitationReference;\n}\n\nexport interface AthenaAssetEmbedReadyEvent {\n  type: typeof ATHENA_ASSET_EMBED_READY_MESSAGE;\n  version: 1;\n}\n\nexport interface AthenaAssetEmbedConfigEvent {\n  type: typeof ATHENA_ASSET_EMBED_CONFIG_MESSAGE;\n  version: 1;\n  token?: string;\n  citationBehavior: AthenaAssetCitationBehavior;\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n}\n\nexport function resolveAthenaAssetCitationBehavior({\n  citationBehavior,\n  hasCitationClickHandler,\n}: {\n  citationBehavior?: AthenaAssetCitationBehavior;\n  hasCitationClickHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationBehavior === \"host\" && !hasCitationClickHandler) return \"browser\";\n  return citationBehavior ?? (hasCitationClickHandler ? \"host\" : \"browser\");\n}\n\nexport function resolveAthenaAssetCitationActionBehavior({\n  citationActionBehavior,\n  hasCitationActionHandler,\n}: {\n  citationActionBehavior?: AthenaAssetCitationBehavior;\n  hasCitationActionHandler: boolean;\n}): AthenaAssetCitationBehavior {\n  if (citationActionBehavior === \"host\" && !hasCitationActionHandler) return \"browser\";\n  return citationActionBehavior ?? (hasCitationActionHandler ? \"host\" : \"browser\");\n}\n\nexport function isAthenaAssetEmbedReadyEvent(value: unknown): value is AthenaAssetEmbedReadyEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_EMBED_READY_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1\n  );\n}\n\nexport function isAthenaAssetCitationClickEvent(value: unknown): value is AthenaAssetCitationClickEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_CLICK_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n\nexport function isAthenaAssetCitationActionEvent(value: unknown): value is AthenaAssetCitationActionEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"action\" in value &&\n    value.action === \"open-in-spaces\" &&\n    \"reference\" in value &&\n    typeof value.reference === \"object\" &&\n    value.reference !== null &&\n    \"id\" in value.reference &&\n    typeof value.reference.id === \"string\"\n  );\n}\n\n/** Content has rendered; bootstrap and iframe load events do not prove an asset opened. */\nexport function isAthenaAssetEmbedContentReadyEvent(value: unknown): value is {\n  type: typeof ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE;\n  version: 1;\n  assetId: string;\n} {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === ATHENA_ASSET_EMBED_CONTENT_READY_MESSAGE &&\n    \"version\" in value &&\n    value.version === 1 &&\n    \"assetId\" in value &&\n    typeof value.assetId === \"string\" &&\n    value.assetId.length > 0\n  );\n}\n"],"names":[],"mappings":"AAAO,MAAM,mCAAmC;AACzC,MAAM,2CAA2C;AACjD,MAAM,oCAAoC;AAC1C,MAAM,sCAAsC;AAC5C,MAAM,uCAAuC;AA4C7C,SAAS,mCAAmC;AAAA,EACjD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,qBAAqB,UAAU,CAAC,wBAAyB,QAAO;AACpE,SAAO,qBAAqB,0BAA0B,SAAS;AACjE;AAEO,SAAS,yCAAyC;AAAA,EACvD;AAAA,EACA;AACF,GAGgC;AAC9B,MAAI,2BAA2B,UAAU,CAAC,yBAA0B,QAAO;AAC3E,SAAO,2BAA2B,2BAA2B,SAAS;AACxE;AAEO,SAAS,6BAA6B,OAAqD;AAChG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,oCACf,aAAa,SACb,MAAM,YAAY;AAEtB;AAEO,SAAS,gCAAgC,OAAwD;AACtG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,uCACf,aAAa,SACb,MAAM,YAAY,KAClB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;AAEO,SAAS,iCAAiC,OAAyD;AACxG,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,wCACf,aAAa,SACb,MAAM,YAAY,KAClB,YAAY,SACZ,MAAM,WAAW,oBACjB,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,MAAM,cAAc,QACpB,QAAQ,MAAM,aACd,OAAO,MAAM,UAAU,OAAO;AAElC;AAGO,SAAS,oCAAoC,OAIlD;AACA,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,4CACf,aAAa,SACb,MAAM,YAAY,KAClB,aAAa,SACb,OAAO,MAAM,YAAY,YACzB,MAAM,QAAQ,SAAS;AAE3B;"}

package/dist/assets/use-asset-embed.cjs

@@ -1,24 +1,30 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactQuery = require("@tanstack/react-query");
 const react = require("react");
 const athenaUrls = require("../lib/athena-urls.cjs");
+const useAthenaRestQuery = require("../lib/use-athena-rest-query.cjs");
 const credentialRenewal = require("../runtime/credential-renewal.cjs");
 const DEFAULT_ASSET_EMBED_READ_ONLY = false;
+const DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT = false;
 const DEFAULT_ASSET_EMBED_DISPLAY_MODE = "full";
 function buildAssetEmbedRequestBody({
   assetId,
   readOnly,
   expiresInSeconds,
-  displayMode
+  displayMode,
+  allowQuickEdit = DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT
 }) {
   return {
     asset_id: assetId,
     read_only: readOnly,
     expires_in_seconds: expiresInSeconds,
-    display_mode: displayMode
+    display_mode: displayMode,
+    // Sent only when asked: an agora that predates it is never handed an unknown field.
+    ...allowQuickEdit && { allow_quick_edit: true }
   };
 }
-const embedCache = /* @__PURE__ */ new Map();
+const embedQueryClient = new reactQuery.QueryClient();
 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_PATTERN = /^.+--(\d+)\.(?:app\.athenaintel\.com|staging-app\.athenaintel\.com)$/;
@@ -294,91 +300,85 @@ function getAssetEmbedAuthContext({ token, apiKey }) {
 function useAssetEmbed(assetId, options = {
   backendUrl: ""
 }) {
+  var _a;
   const {
     readOnly = DEFAULT_ASSET_EMBED_READ_ONLY,
     expiresInSeconds = 60 * 60 * 24 * 30,
     displayMode = DEFAULT_ASSET_EMBED_DISPLAY_MODE,
+    allowQuickEdit = DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT,
     backendUrl,
     appUrl,
     apiKey,
     token,
     getToken
   } = options;
-  const [embedUrl, setEmbedUrl] = react.useState(null);
-  const [isLoading, setIsLoading] = react.useState(false);
-  const [error, setError] = react.useState(null);
-  const abortRef = react.useRef(null);
   const tokenRef = react.useRef(token);
   tokenRef.current = token;
   const getTokenRef = react.useRef(getToken);
   getTokenRef.current = getToken;
   const authContext = getAssetEmbedAuthContext({ token, apiKey });
-  react.useEffect(() => {
-    var _a;
-    if (!assetId || !backendUrl) {
-      setEmbedUrl(null);
-      setIsLoading(false);
-      setError(null);
-      return;
-    }
-    const cacheKey = `${assetId}:${readOnly}:${displayMode}:${authContext}:${backendUrl}:${appUrl ?? ""}`;
-    const cached = embedCache.get(cacheKey);
-    if (cached && cached.expiresAt > Date.now() / 1e3) {
-      setEmbedUrl(cached.url);
-      setIsLoading(false);
-      setError(null);
-      return;
-    }
-    const apiBaseUrl = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
-    const endpoint = `${apiBaseUrl}/api/embed/generate-token`;
-    (_a = abortRef.current) == null ? void 0 : _a.abort();
-    const controller = new AbortController();
-    abortRef.current = controller;
-    setIsLoading(true);
-    setError(null);
-    const heldToken = tokenRef.current;
-    credentialRenewal.sendWithCredentialRenewal(
-      { apiKey, token: heldToken, getToken: heldToken ? getTokenRef.current : void 0 },
-      (headers) => fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", ...headers },
-        body: JSON.stringify(
-          buildAssetEmbedRequestBody({
-            assetId,
-            readOnly,
-            expiresInSeconds,
-            displayMode
+  const enabled = Boolean(assetId && backendUrl);
+  const query = reactQuery.useQuery(
+    {
+      queryKey: [
+        "athena-sdk",
+        "asset-embed",
+        assetId,
+        readOnly,
+        displayMode,
+        allowQuickEdit,
+        // The identity, never the credential: an opaque token or a key is part of `authContext`.
+        useAthenaRestQuery.keyPartFingerprint(authContext),
+        backendUrl,
+        appUrl ?? ""
+      ],
+      queryFn: async ({ signal }) => {
+        const apiBaseUrl = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
+        const heldToken = tokenRef.current;
+        const res = await credentialRenewal.sendWithCredentialRenewal(
+          { apiKey, token: heldToken, getToken: heldToken ? getTokenRef.current : void 0 },
+          (headers) => fetch(`${apiBaseUrl}/api/embed/generate-token`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...headers },
+            body: JSON.stringify(
+              buildAssetEmbedRequestBody({
+                assetId: assetId ?? "",
+                readOnly,
+                expiresInSeconds,
+                displayMode,
+                allowQuickEdit
+              })
+            ),
+            signal
           })
-        ),
-        signal: controller.signal
-      })
-    ).then(async (res) => {
-      if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        throw new Error(`Failed to generate embed token (${res.status}): ${text}`);
-      }
-      return res.json();
-    }).then((data) => {
-      const resolvedEmbedUrl = resolveAssetEmbedUrl({
-        embedUrl: data.embed_url,
-        appUrl,
-        backendUrl
-      });
-      embedCache.set(cacheKey, {
-        url: resolvedEmbedUrl,
-        expiresAt: data.expires_at
-      });
-      setEmbedUrl(resolvedEmbedUrl);
-      setIsLoading(false);
-    }).catch((err) => {
-      if (err.name === "AbortError") return;
-      setError(err.message);
-      setIsLoading(false);
-    });
-    return () => controller.abort();
-  }, [assetId, readOnly, expiresInSeconds, displayMode, backendUrl, appUrl, authContext, apiKey]);
-  return { embedUrl, isLoading, error };
+        );
+        if (!res.ok) {
+          const text = await res.text().catch(() => "");
+          throw new Error(`Failed to generate embed token (${res.status}): ${text}`);
+        }
+        const data = await res.json();
+        return {
+          url: resolveAssetEmbedUrl({ embedUrl: data.embed_url, appUrl, backendUrl }),
+          expiresAt: data.expires_at
+        };
+      },
+      enabled,
+      // A minted link is good until it expires; a new one would reload the frame, so it is never
+      // minted again while the embed shows (no refetch on focus or reconnect) and never retried.
+      staleTime: (cached) => cached.state.data ? Math.max(0, cached.state.data.expiresAt * 1e3 - Date.now()) : 0,
+      refetchOnWindowFocus: false,
+      refetchOnReconnect: false,
+      retry: false
+    },
+    react.useContext(reactQuery.QueryClientContext) ?? embedQueryClient
+  );
+  return {
+    embedUrl: enabled ? ((_a = query.data) == null ? void 0 : _a.url) ?? null : null,
+    isLoading: enabled && query.isLoading,
+    error: enabled && query.error ? query.error.message : null
+  };
 }
+exports.DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT = DEFAULT_ASSET_EMBED_ALLOW_QUICK_EDIT;
 exports.DEFAULT_ASSET_EMBED_DISPLAY_MODE = DEFAULT_ASSET_EMBED_DISPLAY_MODE;
 exports.DEFAULT_ASSET_EMBED_READ_ONLY = DEFAULT_ASSET_EMBED_READ_ONLY;
 exports.appendCitationReferenceParams = appendCitationReferenceParams;