@athenaintel/react 0.9.18 → 0.9.20

package/dist/index.d.ts

@@ -48,8 +48,10 @@ export declare interface AssetPanelState {
     autoOpenedAssets: Map<string, number>;
     registerAssetPanelHost: () => void;
     unregisterAssetPanelHost: () => void;
-    openAsset: (assetId: string, meta?: AssetTabMeta) => void;
-    updateTabMeta: (assetId: string, meta: AssetTabMeta) => void;
+    openAsset: (assetId: string, meta?: {
+        name?: string;
+        type?: AssetType;
+    }) => void;
     closeTab: (assetId: string) => void;
     setActiveTab: (assetId: string) => void;
     setViewMode: (mode: ViewMode) => void;
@@ -65,13 +67,6 @@ export declare interface AssetTab {
     id: string;
     name: string | null;
     type: AssetType;
-    embedSearchParams: Record<string, string> | null;
-}
-
-declare interface AssetTabMeta {
-    name?: string | null;
-    type?: AssetType;
-    embedSearchParams?: Record<string, string> | null;
 }
 
 export declare type AssetType = 'presentation' | 'spreadsheet' | 'document' | 'notebook' | 'unknown';
@@ -92,6 +87,24 @@ export declare interface AthenaAssistantMessageProps {
     ActionBarComponent?: FC<AthenaAssistantActionBarProps>;
 }
 
+/**
+ * Auth state exposed by `useAthenaAuth()`.
+ */
+export declare interface AthenaAuthState {
+    /** Whether the user is currently logged in. */
+    isLoggedIn: boolean;
+    /** Whether the auth state is still loading. */
+    isLoading: boolean;
+    /** The authenticated user, or `null` when not logged in. */
+    user: AthenaUser | null;
+    /** The current access token, or `null` when not logged in. */
+    accessToken: string | null;
+    /** Organizations the user belongs to. */
+    orgs: AthenaOrg[];
+    /** Log the user out. Redirects to the login page by default. */
+    logout: (redirectOnLogout?: boolean) => Promise<void>;
+}
+
 export declare const AthenaChat: FC<AthenaChatProps>;
 
 export declare interface AthenaChatComponents {
@@ -151,8 +164,6 @@ export declare interface AthenaCitationLinkMetadata {
     assetId: string;
     assetIds: string[];
     assetType: AssetType | null;
-    assetName: string | null;
-    embedSearchParams: Record<string, string>;
 }
 
 /**
@@ -223,6 +234,15 @@ export declare interface AthenaLinkClickOptions {
 
 export declare type AthenaLinkKind = 'athena-citation' | 'athena-app' | 'external';
 
+/**
+ * Athena organization membership.
+ */
+export declare interface AthenaOrg {
+    orgId: string;
+    orgName: string;
+    urlSafeOrgName: string;
+}
+
 export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, appUrl, environment, workbench, knowledgeBase, systemPrompt, threadId: threadIdProp, enableThreadList, theme, linkClicks, citationLinks, }: AthenaProviderProps): JSX.Element | null;
 
 export declare interface AthenaProviderConfig {
@@ -236,6 +256,8 @@ export declare interface AthenaProviderConfig {
     backendUrl?: string;
     /** URL for the Athena frontend app origin. Defaults to the matching Athena environment. */
     appUrl?: string;
+    /** Exact parent origins allowed to send embedded auth/config via postMessage. */
+    trustedParentOrigins?: string[];
     /** Athena environment preset used when URLs are not explicitly provided. */
     environment?: AthenaEnvironment;
 }
@@ -330,6 +352,38 @@ export declare interface AthenaRuntimeConfig {
     threadId?: string;
 }
 
+/**
+ * Organization membership returned by the SSO endpoint.
+ */
+export declare interface AthenaSSOOrgInfo {
+    orgId: string;
+    orgName: string;
+    urlSafeOrgName: string;
+}
+
+/**
+ * User data returned by the Athena SSO `/api/sso/userinfo` endpoint.
+ * Field names use snake_case to match the backend response format.
+ */
+export declare interface AthenaSSOUserData {
+    user_id: string;
+    email: string;
+    first_name: string;
+    last_name: string;
+    username: string;
+    picture_url: string;
+    properties: Record<string, unknown>;
+}
+
+/**
+ * Full response from the Athena SSO `/api/sso/userinfo` endpoint.
+ */
+export declare interface AthenaSSOUserInfo {
+    user: AthenaSSOUserData;
+    orgMemberInfos: AthenaSSOOrgInfo[];
+    accessToken: string;
+}
+
 /**
  * Athena SDK Theming System
  *
@@ -410,6 +464,19 @@ export declare interface AthenaTheme {
     threadMaxWidth?: string;
 }
 
+/**
+ * Athena user information — a simplified, PropelAuth-agnostic representation.
+ */
+export declare interface AthenaUser {
+    userId: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    username?: string;
+    pictureUrl?: string;
+    properties?: Record<string, unknown>;
+}
+
 export declare const AthenaUserMessage: FC<AthenaUserMessageProps>;
 
 export declare interface AthenaUserMessageProps {
@@ -570,6 +637,14 @@ export declare function normalizeResult(result: unknown): Record<string, unknown
 
 export declare const OpenAssetToolUI: ToolCallMessagePartComponent;
 
+declare interface ParentBridgeOptions {
+    /**
+     * Exact parent origins that are allowed to send auth/config via postMessage.
+     * Useful for private-cloud or custom-domain deployments.
+     */
+    trustedOrigins?: string[];
+}
+
 export declare interface ParentBridgeState {
     /** PropelAuth access token from the parent window. */
     token: string | null;
@@ -593,8 +668,6 @@ export declare interface ParsedAthenaCitationLink {
     assetId: string;
     assetIds: string[];
     assetType: AssetType | null;
-    assetName: string | null;
-    embedSearchParams: Record<string, string>;
 }
 
 declare interface QuoteContextValue {
@@ -1027,15 +1100,12 @@ export declare function useAssetEmbed(assetId: string | null, options?: UseAsset
 export declare interface UseAssetEmbedOptions {
     readOnly?: boolean;
     expiresInSeconds?: number;
-    embedSearchParams?: Record<string, string> | null;
 }
 
 export declare interface UseAssetEmbedResult {
     embedUrl: string | null;
     isLoading: boolean;
     error: string | null;
-    assetTitle: string | null;
-    assetType: AssetType | null;
 }
 
 export declare const useAssetPanelStore: UseBoundStore<Omit<StoreApi<AssetPanelState>, "setState" | "persist"> & {
@@ -1122,7 +1192,7 @@ export declare function useParentAuth(): string | null;
  *   Parent -> iframe: { type: 'athena-auth', token: '<propel-access-token>' }
  *   iframe -> Parent: { type: 'athena-auth-ready' }
  */
-export declare function useParentBridge(): ParentBridgeState;
+export declare function useParentBridge({ trustedOrigins, }?: ParentBridgeOptions): ParentBridgeState;
 
 export declare function useQuote(): QuoteContextValue;