drizzle-cube 0.4.24 → 0.4.26

package/dist/client/chunks/{useExplainAI-IiW55BaQ.js → useExplainAI-CfQ_JmF1.js}

@@ -1,7 +1,7 @@
 import { a as h, c as x, u as A, d as q } from "./vendor-B2EH3V58.js";
 import { useMemo as p, useState as Q, useCallback as d } from "react";
-import { f as m, g as F } from "./providers-CCw8Kjlc.js";
-import { c as b, s as w } from "./useDirtyStateTracking-CjhwBXRw.js";
+import { f as m, g as F } from "./providers-Ds7DRmnO.js";
+import { c as b, s as w } from "./useDirtyStateTracking-CyAXd07d.js";
 function R(e) {
   return e ? ["cube", "dryRun", w(e)] : ["cube", "dryRun", null];
 }
@@ -179,4 +179,4 @@ export {
   U as e,
   z as u
 };
-//# sourceMappingURL=useExplainAI-IiW55BaQ.js.map
+//# sourceMappingURL=useExplainAI-CfQ_JmF1.js.map

package/dist/client/chunks/{useExplainAI-IiW55BaQ.js.map → useExplainAI-CfQ_JmF1.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useExplainAI-IiW55BaQ.js","sources":["../../../src/client/hooks/queries/useDryRunQuery.ts","../../../src/client/hooks/queries/useExplainQuery.ts","../../../src/client/hooks/queries/useExplainAI.ts"],"sourcesContent":["/**\n * useDryRunQuery - TanStack Query hook for dry-run (debug) data\n *\n * Features:\n * - Fetch SQL and analysis data for query debugging\n * - Support for single and multi-query modes\n * - Built-in caching with TanStack Query\n * - Parallel fetching for multiple queries\n *\n * This hook replaces the debug data useEffect in AnalysisBuilder.\n */\n\nimport { useQuery, useQueries } from '@tanstack/react-query'\nimport { useMemo } from 'react'\nimport { useCubeApi } from '../../providers/CubeApiProvider'\nimport type { CubeQuery } from '../../types'\nimport type { QueryAnalysis } from '../../components/AnalysisBuilder/types'\nimport { cleanQueryForServer } from '../../shared/utils'\nimport { stableStringify } from '../../shared/queryKey'\n\nexport type DryRunMode = 'regular' | 'comparison' | 'funnel' | 'flow' | 'retention'\n\ninterface DryRunResponsePayload {\n  sql?: { sql: string; params?: unknown[] }\n  analysis?: QueryAnalysis | null\n  mode?: DryRunMode\n  queryType?: string\n  joinType?: string\n  cubesUsed?: string[]\n  modeMetadata?: unknown\n}\n\n/**\n * Debug data entry for a single query\n */\nexport interface DebugDataEntry {\n  /** Generated SQL and parameters */\n  sql: { sql: string; params: unknown[] } | null\n  /** Query analysis (dimensions, measures, complexity, etc.) */\n  analysis: QueryAnalysis | null\n  /** Server-reported dry-run mode */\n  mode?: DryRunMode | null\n  /** Query type label from server */\n  queryType?: string | null\n  /** Join strategy label from server */\n  joinType?: string | null\n  /** Referenced cubes from server */\n  cubesUsed?: string[]\n  /** Mode-specific metadata (replaces funnel/flow/retention split) */\n  modeMetadata?: unknown\n  /** Whether this entry is loading */\n  loading: boolean\n  /** Error if fetch failed */\n  error: Error | null\n}\n\n/**\n * Create a stable query key for dry-run\n */\nexport function createDryRunQueryKey(\n  query: CubeQuery | null\n): readonly unknown[] {\n  if (!query) return ['cube', 'dryRun', null] as const\n  return ['cube', 'dryRun', stableStringify(query)] as const\n}\n\nexport interface UseDryRunQueryOptions {\n  /**\n   * Whether to skip the query\n   * @default false\n   */\n  skip?: boolean\n  /**\n   * Stale time in milliseconds\n   * @default 5 * 60 * 1000 (5 minutes)\n   */\n  staleTime?: number\n}\n\nexport interface UseDryRunQueryResult {\n  /** Debug data for the query */\n  debugData: DebugDataEntry\n  /** Manually refetch */\n  refetch: () => void\n}\n\nfunction inferModeFromPayload(payload: DryRunResponsePayload): DryRunMode | null {\n  if (payload.mode) return payload.mode\n  if (payload.queryType === 'comparisonQuery') return 'comparison'\n  if (payload.queryType === 'funnelQuery') return 'funnel'\n  if (payload.queryType === 'flowQuery') return 'flow'\n  if (payload.queryType === 'retentionQuery') return 'retention'\n  if (payload.queryType === 'regularQuery') return 'regular'\n  return null\n}\n\nfunction normalizeDryRunResult(payload: DryRunResponsePayload): Omit<DebugDataEntry, 'loading' | 'error'> {\n  const mode = inferModeFromPayload(payload)\n  return {\n    sql: payload.sql ? { sql: payload.sql.sql, params: payload.sql.params || [] } : null,\n    analysis: (payload.analysis || null) as QueryAnalysis | null,\n    mode,\n    queryType: payload.queryType || null,\n    joinType: payload.joinType || null,\n    cubesUsed: payload.cubesUsed || [],\n    modeMetadata: payload.modeMetadata\n  }\n}\n\n/**\n * TanStack Query hook for single query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useDryRunQuery(query, { skip: !isValidQuery })\n * ```\n */\nexport function useDryRunQuery(\n  query: CubeQuery | null,\n  options: UseDryRunQueryOptions = {}\n): UseDryRunQueryResult {\n  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  // Transform query for server\n  const serverQuery = useMemo(() => {\n    if (!query) return null\n    const modeQuery = query as CubeQuery & { funnel?: unknown; flow?: unknown; retention?: unknown }\n    // Preserve specialized mode payloads as-is; cleanQueryForServer strips non-Cube.js keys.\n    if (modeQuery.funnel || modeQuery.flow || modeQuery.retention) {\n      return query\n    }\n    return cleanQueryForServer(query)\n  }, [query])\n\n  const queryResult = useQuery({\n    queryKey: createDryRunQueryKey(serverQuery),\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No query provided')\n      const result = await cubeApi.dryRun(serverQuery)\n      return normalizeDryRunResult(result as DryRunResponsePayload)\n    },\n    enabled: !!serverQuery && !skip,\n    staleTime,\n  })\n\n  const debugData: DebugDataEntry = {\n    ...(queryResult.data || {\n      sql: null,\n      analysis: null,\n      mode: null,\n      queryType: null,\n      joinType: null,\n      cubesUsed: [],\n      modeMetadata: undefined\n    }),\n    loading: queryResult.isLoading,\n    error: queryResult.error ?? null,\n  }\n\n  return {\n    debugData,\n    refetch: () => queryResult.refetch(),\n  }\n}\n\nexport interface UseMultiDryRunQueriesOptions {\n  /**\n   * Whether to skip all queries\n   * @default false\n   */\n  skip?: boolean\n  /**\n   * Stale time in milliseconds\n   * @default 5 * 60 * 1000 (5 minutes)\n   */\n  staleTime?: number\n}\n\nexport interface UseMultiDryRunQueriesResult {\n  /** Debug data for each query */\n  debugDataPerQuery: DebugDataEntry[]\n  /** Whether any query is loading */\n  isLoading: boolean\n  /** Manually refetch all */\n  refetchAll: () => void\n}\n\n/**\n * TanStack Query hook for multiple query dry-runs (debug) data\n *\n * Fetches debug data for multiple queries in parallel.\n *\n * Usage:\n * ```tsx\n * const { debugDataPerQuery, isLoading } = useMultiDryRunQueries(queries, {\n *   skip: !isMultiQueryMode\n * })\n * ```\n */\nexport function useMultiDryRunQueries(\n  queries: CubeQuery[],\n  options: UseMultiDryRunQueriesOptions = {}\n): UseMultiDryRunQueriesResult {\n  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  // Transform queries for server\n  const serverQueries = useMemo(() => {\n    return queries.map((q) => cleanQueryForServer(q))\n  }, [queries])\n\n  // Use useQueries for parallel fetching\n  const queryResults = useQueries({\n    queries: serverQueries.map((query) => ({\n      queryKey: createDryRunQueryKey(query),\n      queryFn: async () => {\n        const result = await cubeApi.dryRun(query)\n        return normalizeDryRunResult(result as DryRunResponsePayload)\n      },\n      enabled: !skip,\n      staleTime,\n    })),\n  })\n\n  // Transform results to DebugDataEntry array\n  const debugDataPerQuery: DebugDataEntry[] = queryResults.map((result) => ({\n    ...(result.data || {\n      sql: null,\n      analysis: null,\n      mode: null,\n      queryType: null,\n      joinType: null,\n      cubesUsed: [],\n      modeMetadata: undefined\n    }),\n    loading: result.isLoading,\n    error: result.error ?? null,\n  }))\n\n  // Check if any query is loading\n  const isLoading = queryResults.some((r) => r.isLoading)\n\n  // Refetch all queries\n  const refetchAll = () => {\n    queryResults.forEach((r) => r.refetch())\n  }\n\n  return {\n    debugDataPerQuery,\n    isLoading,\n    refetchAll,\n  }\n}\n\n/**\n * Combined hook for single or multi-query dry-run based on mode\n *\n * This is a convenience wrapper that automatically chooses between\n * single and multi-query dry-run based on the number of queries.\n *\n * Usage:\n * ```tsx\n * const { debugDataPerQuery } = useDryRunQueries({\n *   queries: isMultiQueryMode ? allQueries : [currentQuery],\n *   isMultiQueryMode,\n *   skip: !isValidQuery\n * })\n * ```\n */\nexport function useDryRunQueries(options: {\n  queries: CubeQuery[]\n  isMultiQueryMode: boolean\n  skip?: boolean\n  staleTime?: number\n}): UseMultiDryRunQueriesResult {\n  const { queries, isMultiQueryMode, skip = false, staleTime } = options\n\n  // For single query mode, wrap in array for consistent interface\n  const queriesToFetch = isMultiQueryMode ? queries : queries.slice(0, 1)\n\n  return useMultiDryRunQueries(queriesToFetch, { skip, staleTime })\n}\n\nexport type FunnelDebugDataEntry = DebugDataEntry\n\n/**\n * TanStack Query hook for funnel query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useFunnelDryRunQuery(serverQuery, { skip: !isFunnelMode })\n * ```\n */\nexport function useFunnelDryRunQuery(\n  serverQuery: unknown | null,\n  options: UseDryRunQueryOptions = {}\n): { debugData: FunnelDebugDataEntry; refetch: () => void } {\n  return useDryRunQuery(serverQuery as CubeQuery | null, options)\n}\n\nexport type FlowDebugDataEntry = DebugDataEntry\n\n/**\n * TanStack Query hook for flow query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useFlowDryRunQuery(serverQuery, { skip: !isFlowMode })\n * ```\n */\nexport function useFlowDryRunQuery(\n  serverQuery: unknown | null,\n  options: UseDryRunQueryOptions = {}\n): { debugData: FlowDebugDataEntry; refetch: () => void } {\n  return useDryRunQuery(serverQuery as CubeQuery | null, options)\n}\n\nexport type RetentionDebugDataEntry = DebugDataEntry\n\n/**\n * TanStack Query hook for retention query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useRetentionDryRunQuery(serverQuery, { skip: !isRetentionMode })\n * ```\n */\nexport function useRetentionDryRunQuery(\n  serverQuery: unknown | null,\n  options: UseDryRunQueryOptions = {}\n): { debugData: RetentionDebugDataEntry; refetch: () => void } {\n  return useDryRunQuery(serverQuery as CubeQuery | null, options)\n}\n","/**\n * useExplainQuery - TanStack Query hook for EXPLAIN PLAN execution\n *\n * Features:\n * - Manually triggered (not automatic like useCubeLoadQuery)\n * - Returns normalized execution plan across PostgreSQL, MySQL, and SQLite\n * - Supports EXPLAIN ANALYZE for actual timing data\n * - No caching - always fetches fresh data to reflect schema/index changes\n *\n * Usage:\n * ```tsx\n * const { explainResult, isLoading, error, runExplain } = useExplainQuery(query)\n *\n * // Trigger explain manually\n * <button onClick={() => runExplain({ analyze: true })}>Explain with Timing</button>\n * ```\n */\n\nimport { useQuery } from '@tanstack/react-query'\nimport { useCallback, useMemo, useState } from 'react'\nimport { useCubeApi } from '../../providers/CubeApiProvider'\nimport type { CubeQuery, ExplainResult, ExplainOptions } from '../../types'\nimport { cleanQueryForServer } from '../../shared/utils'\nimport { stableStringify } from '../../shared/queryKey'\n\n/**\n * Query type that can be explained - includes standard queries, funnel queries, flow queries, and retention queries\n */\nexport type ExplainableQuery = CubeQuery | { funnel: unknown } | { flow: unknown } | { retention: unknown } | unknown\n\n/**\n * Create a stable query key for explain\n */\nexport function createExplainQueryKey(\n  query: ExplainableQuery | null,\n  options?: ExplainOptions\n): readonly unknown[] {\n  if (!query) return ['cube', 'explain', null, null] as const\n  return ['cube', 'explain', stableStringify(query), options?.analyze ?? false] as const\n}\n\nexport interface UseExplainQueryOptions {\n  /**\n   * Whether to skip the query (prevent execution even when triggered)\n   * @default false\n   */\n  skip?: boolean\n}\n\nexport interface UseExplainQueryResult {\n  /** The explain result from the server */\n  explainResult: ExplainResult | null\n  /** Whether the explain query is loading */\n  isLoading: boolean\n  /** Whether an explain has been triggered */\n  hasRun: boolean\n  /** Error if explain failed */\n  error: Error | null\n  /**\n   * Manually trigger the explain query\n   * @param options - Optional explain options (e.g., { analyze: true } for actual timing)\n   */\n  runExplain: (options?: ExplainOptions) => void\n  /** Clear the explain result */\n  clearExplain: () => void\n}\n\n/**\n * Check if query is a funnel query\n */\nfunction isFunnelQuery(query: unknown): query is { funnel: unknown } {\n  return typeof query === 'object' && query !== null && 'funnel' in query\n}\n\n/**\n * Check if query is a flow query\n */\nfunction isFlowQuery(query: unknown): query is { flow: unknown } {\n  return typeof query === 'object' && query !== null && 'flow' in query\n}\n\n/**\n * Check if query is a retention query\n */\nfunction isRetentionQuery(query: unknown): query is { retention: unknown } {\n  return typeof query === 'object' && query !== null && 'retention' in query\n}\n\n/**\n * TanStack Query hook for EXPLAIN PLAN execution\n *\n * Unlike useDryRunQuery, this hook is manually triggered via `runExplain()`.\n * This is intentional because:\n * 1. EXPLAIN queries have performance overhead\n * 2. EXPLAIN ANALYZE actually executes the query\n * 3. Users should explicitly choose when to run explain\n *\n * Supports standard queries, funnel queries, and flow queries.\n *\n * Usage:\n * ```tsx\n * const { explainResult, isLoading, runExplain } = useExplainQuery(query, { skip: !isValidQuery })\n *\n * // Trigger explain\n * <button onClick={() => runExplain()}>Explain Plan</button>\n *\n * // Trigger explain with timing\n * <button onClick={() => runExplain({ analyze: true })}>Explain with Timing</button>\n * ```\n */\nexport function useExplainQuery(\n  query: ExplainableQuery | null,\n  options: UseExplainQueryOptions = {}\n): UseExplainQueryResult {\n  const { skip = false } = options\n  const { cubeApi } = useCubeApi()\n\n  // Track whether explain has been triggered and with what options\n  const [explainOptions, setExplainOptions] = useState<ExplainOptions | null>(null)\n  const [hasTriggered, setHasTriggered] = useState(false)\n\n  // Transform query for server\n  // For funnel/flow/retention queries, pass them directly without cleaning\n  const serverQuery = useMemo(() => {\n    if (!query) return null\n    // Funnel, flow, and retention queries have their own format, don't clean them\n    if (isFunnelQuery(query) || isFlowQuery(query) || isRetentionQuery(query)) {\n      return query\n    }\n    // Standard queries get cleaned\n    return cleanQueryForServer(query as CubeQuery)\n  }, [query])\n\n  // Query is enabled only when:\n  // 1. We have a query\n  // 2. Skip is false\n  // 3. User has triggered the explain\n  const queryEnabled = !!serverQuery && !skip && hasTriggered\n\n  const queryResult = useQuery({\n    queryKey: createExplainQueryKey(serverQuery, explainOptions ?? undefined),\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No query provided')\n      const result = await cubeApi.explain(serverQuery, explainOptions ?? undefined)\n      return result\n    },\n    enabled: queryEnabled,\n    // EXPLAIN queries should never be cached - always fetch fresh data\n    // This ensures users see the latest execution plan after schema/index changes\n    staleTime: 0,\n    gcTime: 0,\n    // Don't refetch automatically - this is manually triggered\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n    refetchOnMount: false,\n  })\n\n  // Manual trigger function\n  const runExplain = useCallback((opts?: ExplainOptions) => {\n    if (skip || !serverQuery) return\n    setExplainOptions(opts ?? null)\n    setHasTriggered(true)\n    // If already triggered with same options, refetch\n    if (hasTriggered) {\n      queryResult.refetch()\n    }\n  }, [skip, serverQuery, hasTriggered, queryResult])\n\n  // Clear function\n  const clearExplain = useCallback(() => {\n    setHasTriggered(false)\n    setExplainOptions(null)\n  }, [])\n\n  return {\n    explainResult: queryResult.data ?? null,\n    isLoading: queryResult.isLoading || queryResult.isFetching,\n    hasRun: hasTriggered,\n    error: queryResult.error ?? null,\n    runExplain,\n    clearExplain,\n  }\n}\n","/**\n * useExplainAI - TanStack Query hook for AI analysis of EXPLAIN plans\n *\n * Features:\n * - Manually triggered via useMutation (not automatic)\n * - Analyzes execution plans and provides actionable recommendations\n * - Returns structured recommendations (indexes, table changes, cube improvements)\n * - No caching - always fetches fresh analysis\n * - Uses the /api/ai/explain/analyze endpoint\n *\n * Usage:\n * ```tsx\n * const { analysis, isAnalyzing, error, analyze, clearAnalysis } = useExplainAI()\n *\n * // After getting an explain result, trigger AI analysis\n * <button onClick={() => analyze(explainResult, query)}>Analyze with AI</button>\n * ```\n */\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { useCallback } from 'react'\nimport type { ExplainResult, AIExplainAnalysis } from '../../types'\nimport { useCubeFeatures } from '../../providers/CubeFeaturesProvider'\n\nexport interface UseExplainAIOptions {\n  /**\n   * Custom AI endpoint for explain analysis\n   * @default '/api/ai/explain/analyze'\n   */\n  aiEndpoint?: string\n}\n\nexport interface UseExplainAIResult {\n  /** The AI analysis result */\n  analysis: AIExplainAnalysis | null\n  /** Whether AI analysis is in progress */\n  isAnalyzing: boolean\n  /** Error if AI analysis failed */\n  error: Error | null\n  /**\n   * Trigger AI analysis of an explain result\n   * @param explainResult - The EXPLAIN result to analyze\n   * @param query - The original semantic query\n   */\n  analyze: (explainResult: ExplainResult, query: unknown) => void\n  /** Clear the analysis result */\n  clearAnalysis: () => void\n}\n\n/**\n * Query key for AI explain analysis\n */\nexport const EXPLAIN_AI_QUERY_KEY = ['cube', 'explain', 'ai'] as const\n\n/**\n * TanStack Query hook for AI analysis of EXPLAIN plans\n *\n * This hook uses useMutation to call the AI endpoint and analyze execution plans,\n * providing actionable recommendations for performance improvement.\n *\n * Recommendations focus on what users CAN control:\n * - Index creation (with CREATE INDEX statements)\n * - Table structure changes\n * - Cube definition improvements (segments, pre-aggregations, joins)\n *\n * Usage:\n * ```tsx\n * const { analysis, isAnalyzing, analyze } = useExplainAI()\n *\n * // After running EXPLAIN\n * if (explainResult) {\n *   <button onClick={() => analyze(explainResult, query)}>\n *     {isAnalyzing ? 'Analyzing...' : 'Analyze with AI'}\n *   </button>\n * }\n *\n * // Display recommendations\n * {analysis?.recommendations.map(rec => (\n *   <div key={rec.title}>\n *     <h4>{rec.title}</h4>\n *     <p>{rec.description}</p>\n *     {rec.sql && <pre>{rec.sql}</pre>}\n *     {rec.cubeCode && <pre>{rec.cubeCode}</pre>}\n *   </div>\n * ))}\n * ```\n */\nexport function useExplainAI(options: UseExplainAIOptions = {}): UseExplainAIResult {\n  const { features } = useCubeFeatures()\n  const enableAI = features.enableAI ?? true\n  const queryClient = useQueryClient()\n\n  // AI endpoint - defaults to /api/ai/explain/analyze\n  // This is the standard path for AI routes in the dev server\n  const aiEndpoint = options.aiEndpoint ?? '/api/ai/explain/analyze'\n\n  const mutation = useMutation({\n    mutationKey: EXPLAIN_AI_QUERY_KEY,\n    mutationFn: async ({ explainResult, query }: { explainResult: ExplainResult; query: unknown }) => {\n      // Check if AI is enabled\n      if (!enableAI) {\n        throw new Error('AI features are disabled')\n      }\n\n      const response = await fetch(aiEndpoint, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        credentials: 'include',\n        body: JSON.stringify({\n          explainResult,\n          query,\n        }),\n      })\n\n      if (!response.ok) {\n        const errorData = await response.json().catch(() => ({}))\n        throw new Error(\n          errorData.error ||\n            errorData.message ||\n            `AI analysis failed: ${response.status} ${response.statusText}`\n        )\n      }\n\n      const result: AIExplainAnalysis = await response.json()\n      return result\n    },\n    // No caching - each mutation is independent\n    gcTime: 0,\n  })\n\n  const analyze = useCallback((explainResult: ExplainResult, query: unknown) => {\n    mutation.mutate({ explainResult, query })\n  }, [mutation])\n\n  const clearAnalysis = useCallback(() => {\n    mutation.reset()\n    // Also invalidate any cached queries\n    queryClient.removeQueries({ queryKey: EXPLAIN_AI_QUERY_KEY })\n  }, [mutation, queryClient])\n\n  return {\n    analysis: mutation.data ?? null,\n    isAnalyzing: mutation.isPending,\n    error: mutation.error ?? null,\n    analyze,\n    clearAnalysis,\n  }\n}\n"],"names":["createDryRunQueryKey","query","stableStringify","inferModeFromPayload","payload","normalizeDryRunResult","mode","useDryRunQuery","options","skip","staleTime","cubeApi","useCubeApi","serverQuery","useMemo","modeQuery","cleanQueryForServer","queryResult","useQuery","result","useMultiDryRunQueries","queries","serverQueries","q","queryResults","useQueries","debugDataPerQuery","isLoading","r","useDryRunQueries","isMultiQueryMode","queriesToFetch","createExplainQueryKey","isFunnelQuery","isFlowQuery","isRetentionQuery","useExplainQuery","explainOptions","setExplainOptions","useState","hasTriggered","setHasTriggered","queryEnabled","runExplain","useCallback","opts","clearExplain","EXPLAIN_AI_QUERY_KEY","useExplainAI","features","useCubeFeatures","enableAI","queryClient","useQueryClient","aiEndpoint","mutation","useMutation","explainResult","response","errorData","analyze","clearAnalysis"],"mappings":"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"}
+{"version":3,"file":"useExplainAI-CfQ_JmF1.js","sources":["../../../src/client/hooks/queries/useDryRunQuery.ts","../../../src/client/hooks/queries/useExplainQuery.ts","../../../src/client/hooks/queries/useExplainAI.ts"],"sourcesContent":["/**\n * useDryRunQuery - TanStack Query hook for dry-run (debug) data\n *\n * Features:\n * - Fetch SQL and analysis data for query debugging\n * - Support for single and multi-query modes\n * - Built-in caching with TanStack Query\n * - Parallel fetching for multiple queries\n *\n * This hook replaces the debug data useEffect in AnalysisBuilder.\n */\n\nimport { useQuery, useQueries } from '@tanstack/react-query'\nimport { useMemo } from 'react'\nimport { useCubeApi } from '../../providers/CubeApiProvider'\nimport type { CubeQuery } from '../../types'\nimport type { QueryAnalysis } from '../../components/AnalysisBuilder/types'\nimport { cleanQueryForServer } from '../../shared/utils'\nimport { stableStringify } from '../../shared/queryKey'\n\nexport type DryRunMode = 'regular' | 'comparison' | 'funnel' | 'flow' | 'retention'\n\ninterface DryRunResponsePayload {\n  sql?: { sql: string; params?: unknown[] }\n  analysis?: QueryAnalysis | null\n  mode?: DryRunMode\n  queryType?: string\n  joinType?: string\n  cubesUsed?: string[]\n  modeMetadata?: unknown\n}\n\n/**\n * Debug data entry for a single query\n */\nexport interface DebugDataEntry {\n  /** Generated SQL and parameters */\n  sql: { sql: string; params: unknown[] } | null\n  /** Query analysis (dimensions, measures, complexity, etc.) */\n  analysis: QueryAnalysis | null\n  /** Server-reported dry-run mode */\n  mode?: DryRunMode | null\n  /** Query type label from server */\n  queryType?: string | null\n  /** Join strategy label from server */\n  joinType?: string | null\n  /** Referenced cubes from server */\n  cubesUsed?: string[]\n  /** Mode-specific metadata (replaces funnel/flow/retention split) */\n  modeMetadata?: unknown\n  /** Whether this entry is loading */\n  loading: boolean\n  /** Error if fetch failed */\n  error: Error | null\n}\n\n/**\n * Create a stable query key for dry-run\n */\nexport function createDryRunQueryKey(\n  query: CubeQuery | null\n): readonly unknown[] {\n  if (!query) return ['cube', 'dryRun', null] as const\n  return ['cube', 'dryRun', stableStringify(query)] as const\n}\n\nexport interface UseDryRunQueryOptions {\n  /**\n   * Whether to skip the query\n   * @default false\n   */\n  skip?: boolean\n  /**\n   * Stale time in milliseconds\n   * @default 5 * 60 * 1000 (5 minutes)\n   */\n  staleTime?: number\n}\n\nexport interface UseDryRunQueryResult {\n  /** Debug data for the query */\n  debugData: DebugDataEntry\n  /** Manually refetch */\n  refetch: () => void\n}\n\nfunction inferModeFromPayload(payload: DryRunResponsePayload): DryRunMode | null {\n  if (payload.mode) return payload.mode\n  if (payload.queryType === 'comparisonQuery') return 'comparison'\n  if (payload.queryType === 'funnelQuery') return 'funnel'\n  if (payload.queryType === 'flowQuery') return 'flow'\n  if (payload.queryType === 'retentionQuery') return 'retention'\n  if (payload.queryType === 'regularQuery') return 'regular'\n  return null\n}\n\nfunction normalizeDryRunResult(payload: DryRunResponsePayload): Omit<DebugDataEntry, 'loading' | 'error'> {\n  const mode = inferModeFromPayload(payload)\n  return {\n    sql: payload.sql ? { sql: payload.sql.sql, params: payload.sql.params || [] } : null,\n    analysis: (payload.analysis || null) as QueryAnalysis | null,\n    mode,\n    queryType: payload.queryType || null,\n    joinType: payload.joinType || null,\n    cubesUsed: payload.cubesUsed || [],\n    modeMetadata: payload.modeMetadata\n  }\n}\n\n/**\n * TanStack Query hook for single query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useDryRunQuery(query, { skip: !isValidQuery })\n * ```\n */\nexport function useDryRunQuery(\n  query: CubeQuery | null,\n  options: UseDryRunQueryOptions = {}\n): UseDryRunQueryResult {\n  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  // Transform query for server\n  const serverQuery = useMemo(() => {\n    if (!query) return null\n    const modeQuery = query as CubeQuery & { funnel?: unknown; flow?: unknown; retention?: unknown }\n    // Preserve specialized mode payloads as-is; cleanQueryForServer strips non-Cube.js keys.\n    if (modeQuery.funnel || modeQuery.flow || modeQuery.retention) {\n      return query\n    }\n    return cleanQueryForServer(query)\n  }, [query])\n\n  const queryResult = useQuery({\n    queryKey: createDryRunQueryKey(serverQuery),\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No query provided')\n      const result = await cubeApi.dryRun(serverQuery)\n      return normalizeDryRunResult(result as DryRunResponsePayload)\n    },\n    enabled: !!serverQuery && !skip,\n    staleTime,\n  })\n\n  const debugData: DebugDataEntry = {\n    ...(queryResult.data || {\n      sql: null,\n      analysis: null,\n      mode: null,\n      queryType: null,\n      joinType: null,\n      cubesUsed: [],\n      modeMetadata: undefined\n    }),\n    loading: queryResult.isLoading,\n    error: queryResult.error ?? null,\n  }\n\n  return {\n    debugData,\n    refetch: () => queryResult.refetch(),\n  }\n}\n\nexport interface UseMultiDryRunQueriesOptions {\n  /**\n   * Whether to skip all queries\n   * @default false\n   */\n  skip?: boolean\n  /**\n   * Stale time in milliseconds\n   * @default 5 * 60 * 1000 (5 minutes)\n   */\n  staleTime?: number\n}\n\nexport interface UseMultiDryRunQueriesResult {\n  /** Debug data for each query */\n  debugDataPerQuery: DebugDataEntry[]\n  /** Whether any query is loading */\n  isLoading: boolean\n  /** Manually refetch all */\n  refetchAll: () => void\n}\n\n/**\n * TanStack Query hook for multiple query dry-runs (debug) data\n *\n * Fetches debug data for multiple queries in parallel.\n *\n * Usage:\n * ```tsx\n * const { debugDataPerQuery, isLoading } = useMultiDryRunQueries(queries, {\n *   skip: !isMultiQueryMode\n * })\n * ```\n */\nexport function useMultiDryRunQueries(\n  queries: CubeQuery[],\n  options: UseMultiDryRunQueriesOptions = {}\n): UseMultiDryRunQueriesResult {\n  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  // Transform queries for server\n  const serverQueries = useMemo(() => {\n    return queries.map((q) => cleanQueryForServer(q))\n  }, [queries])\n\n  // Use useQueries for parallel fetching\n  const queryResults = useQueries({\n    queries: serverQueries.map((query) => ({\n      queryKey: createDryRunQueryKey(query),\n      queryFn: async () => {\n        const result = await cubeApi.dryRun(query)\n        return normalizeDryRunResult(result as DryRunResponsePayload)\n      },\n      enabled: !skip,\n      staleTime,\n    })),\n  })\n\n  // Transform results to DebugDataEntry array\n  const debugDataPerQuery: DebugDataEntry[] = queryResults.map((result) => ({\n    ...(result.data || {\n      sql: null,\n      analysis: null,\n      mode: null,\n      queryType: null,\n      joinType: null,\n      cubesUsed: [],\n      modeMetadata: undefined\n    }),\n    loading: result.isLoading,\n    error: result.error ?? null,\n  }))\n\n  // Check if any query is loading\n  const isLoading = queryResults.some((r) => r.isLoading)\n\n  // Refetch all queries\n  const refetchAll = () => {\n    queryResults.forEach((r) => r.refetch())\n  }\n\n  return {\n    debugDataPerQuery,\n    isLoading,\n    refetchAll,\n  }\n}\n\n/**\n * Combined hook for single or multi-query dry-run based on mode\n *\n * This is a convenience wrapper that automatically chooses between\n * single and multi-query dry-run based on the number of queries.\n *\n * Usage:\n * ```tsx\n * const { debugDataPerQuery } = useDryRunQueries({\n *   queries: isMultiQueryMode ? allQueries : [currentQuery],\n *   isMultiQueryMode,\n *   skip: !isValidQuery\n * })\n * ```\n */\nexport function useDryRunQueries(options: {\n  queries: CubeQuery[]\n  isMultiQueryMode: boolean\n  skip?: boolean\n  staleTime?: number\n}): UseMultiDryRunQueriesResult {\n  const { queries, isMultiQueryMode, skip = false, staleTime } = options\n\n  // For single query mode, wrap in array for consistent interface\n  const queriesToFetch = isMultiQueryMode ? queries : queries.slice(0, 1)\n\n  return useMultiDryRunQueries(queriesToFetch, { skip, staleTime })\n}\n\nexport type FunnelDebugDataEntry = DebugDataEntry\n\n/**\n * TanStack Query hook for funnel query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useFunnelDryRunQuery(serverQuery, { skip: !isFunnelMode })\n * ```\n */\nexport function useFunnelDryRunQuery(\n  serverQuery: unknown | null,\n  options: UseDryRunQueryOptions = {}\n): { debugData: FunnelDebugDataEntry; refetch: () => void } {\n  return useDryRunQuery(serverQuery as CubeQuery | null, options)\n}\n\nexport type FlowDebugDataEntry = DebugDataEntry\n\n/**\n * TanStack Query hook for flow query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useFlowDryRunQuery(serverQuery, { skip: !isFlowMode })\n * ```\n */\nexport function useFlowDryRunQuery(\n  serverQuery: unknown | null,\n  options: UseDryRunQueryOptions = {}\n): { debugData: FlowDebugDataEntry; refetch: () => void } {\n  return useDryRunQuery(serverQuery as CubeQuery | null, options)\n}\n\nexport type RetentionDebugDataEntry = DebugDataEntry\n\n/**\n * TanStack Query hook for retention query dry-run (debug) data\n *\n * Usage:\n * ```tsx\n * const { debugData } = useRetentionDryRunQuery(serverQuery, { skip: !isRetentionMode })\n * ```\n */\nexport function useRetentionDryRunQuery(\n  serverQuery: unknown | null,\n  options: UseDryRunQueryOptions = {}\n): { debugData: RetentionDebugDataEntry; refetch: () => void } {\n  return useDryRunQuery(serverQuery as CubeQuery | null, options)\n}\n","/**\n * useExplainQuery - TanStack Query hook for EXPLAIN PLAN execution\n *\n * Features:\n * - Manually triggered (not automatic like useCubeLoadQuery)\n * - Returns normalized execution plan across PostgreSQL, MySQL, and SQLite\n * - Supports EXPLAIN ANALYZE for actual timing data\n * - No caching - always fetches fresh data to reflect schema/index changes\n *\n * Usage:\n * ```tsx\n * const { explainResult, isLoading, error, runExplain } = useExplainQuery(query)\n *\n * // Trigger explain manually\n * <button onClick={() => runExplain({ analyze: true })}>Explain with Timing</button>\n * ```\n */\n\nimport { useQuery } from '@tanstack/react-query'\nimport { useCallback, useMemo, useState } from 'react'\nimport { useCubeApi } from '../../providers/CubeApiProvider'\nimport type { CubeQuery, ExplainResult, ExplainOptions } from '../../types'\nimport { cleanQueryForServer } from '../../shared/utils'\nimport { stableStringify } from '../../shared/queryKey'\n\n/**\n * Query type that can be explained - includes standard queries, funnel queries, flow queries, and retention queries\n */\nexport type ExplainableQuery = CubeQuery | { funnel: unknown } | { flow: unknown } | { retention: unknown } | unknown\n\n/**\n * Create a stable query key for explain\n */\nexport function createExplainQueryKey(\n  query: ExplainableQuery | null,\n  options?: ExplainOptions\n): readonly unknown[] {\n  if (!query) return ['cube', 'explain', null, null] as const\n  return ['cube', 'explain', stableStringify(query), options?.analyze ?? false] as const\n}\n\nexport interface UseExplainQueryOptions {\n  /**\n   * Whether to skip the query (prevent execution even when triggered)\n   * @default false\n   */\n  skip?: boolean\n}\n\nexport interface UseExplainQueryResult {\n  /** The explain result from the server */\n  explainResult: ExplainResult | null\n  /** Whether the explain query is loading */\n  isLoading: boolean\n  /** Whether an explain has been triggered */\n  hasRun: boolean\n  /** Error if explain failed */\n  error: Error | null\n  /**\n   * Manually trigger the explain query\n   * @param options - Optional explain options (e.g., { analyze: true } for actual timing)\n   */\n  runExplain: (options?: ExplainOptions) => void\n  /** Clear the explain result */\n  clearExplain: () => void\n}\n\n/**\n * Check if query is a funnel query\n */\nfunction isFunnelQuery(query: unknown): query is { funnel: unknown } {\n  return typeof query === 'object' && query !== null && 'funnel' in query\n}\n\n/**\n * Check if query is a flow query\n */\nfunction isFlowQuery(query: unknown): query is { flow: unknown } {\n  return typeof query === 'object' && query !== null && 'flow' in query\n}\n\n/**\n * Check if query is a retention query\n */\nfunction isRetentionQuery(query: unknown): query is { retention: unknown } {\n  return typeof query === 'object' && query !== null && 'retention' in query\n}\n\n/**\n * TanStack Query hook for EXPLAIN PLAN execution\n *\n * Unlike useDryRunQuery, this hook is manually triggered via `runExplain()`.\n * This is intentional because:\n * 1. EXPLAIN queries have performance overhead\n * 2. EXPLAIN ANALYZE actually executes the query\n * 3. Users should explicitly choose when to run explain\n *\n * Supports standard queries, funnel queries, and flow queries.\n *\n * Usage:\n * ```tsx\n * const { explainResult, isLoading, runExplain } = useExplainQuery(query, { skip: !isValidQuery })\n *\n * // Trigger explain\n * <button onClick={() => runExplain()}>Explain Plan</button>\n *\n * // Trigger explain with timing\n * <button onClick={() => runExplain({ analyze: true })}>Explain with Timing</button>\n * ```\n */\nexport function useExplainQuery(\n  query: ExplainableQuery | null,\n  options: UseExplainQueryOptions = {}\n): UseExplainQueryResult {\n  const { skip = false } = options\n  const { cubeApi } = useCubeApi()\n\n  // Track whether explain has been triggered and with what options\n  const [explainOptions, setExplainOptions] = useState<ExplainOptions | null>(null)\n  const [hasTriggered, setHasTriggered] = useState(false)\n\n  // Transform query for server\n  // For funnel/flow/retention queries, pass them directly without cleaning\n  const serverQuery = useMemo(() => {\n    if (!query) return null\n    // Funnel, flow, and retention queries have their own format, don't clean them\n    if (isFunnelQuery(query) || isFlowQuery(query) || isRetentionQuery(query)) {\n      return query\n    }\n    // Standard queries get cleaned\n    return cleanQueryForServer(query as CubeQuery)\n  }, [query])\n\n  // Query is enabled only when:\n  // 1. We have a query\n  // 2. Skip is false\n  // 3. User has triggered the explain\n  const queryEnabled = !!serverQuery && !skip && hasTriggered\n\n  const queryResult = useQuery({\n    queryKey: createExplainQueryKey(serverQuery, explainOptions ?? undefined),\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No query provided')\n      const result = await cubeApi.explain(serverQuery, explainOptions ?? undefined)\n      return result\n    },\n    enabled: queryEnabled,\n    // EXPLAIN queries should never be cached - always fetch fresh data\n    // This ensures users see the latest execution plan after schema/index changes\n    staleTime: 0,\n    gcTime: 0,\n    // Don't refetch automatically - this is manually triggered\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n    refetchOnMount: false,\n  })\n\n  // Manual trigger function\n  const runExplain = useCallback((opts?: ExplainOptions) => {\n    if (skip || !serverQuery) return\n    setExplainOptions(opts ?? null)\n    setHasTriggered(true)\n    // If already triggered with same options, refetch\n    if (hasTriggered) {\n      queryResult.refetch()\n    }\n  }, [skip, serverQuery, hasTriggered, queryResult])\n\n  // Clear function\n  const clearExplain = useCallback(() => {\n    setHasTriggered(false)\n    setExplainOptions(null)\n  }, [])\n\n  return {\n    explainResult: queryResult.data ?? null,\n    isLoading: queryResult.isLoading || queryResult.isFetching,\n    hasRun: hasTriggered,\n    error: queryResult.error ?? null,\n    runExplain,\n    clearExplain,\n  }\n}\n","/**\n * useExplainAI - TanStack Query hook for AI analysis of EXPLAIN plans\n *\n * Features:\n * - Manually triggered via useMutation (not automatic)\n * - Analyzes execution plans and provides actionable recommendations\n * - Returns structured recommendations (indexes, table changes, cube improvements)\n * - No caching - always fetches fresh analysis\n * - Uses the /api/ai/explain/analyze endpoint\n *\n * Usage:\n * ```tsx\n * const { analysis, isAnalyzing, error, analyze, clearAnalysis } = useExplainAI()\n *\n * // After getting an explain result, trigger AI analysis\n * <button onClick={() => analyze(explainResult, query)}>Analyze with AI</button>\n * ```\n */\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { useCallback } from 'react'\nimport type { ExplainResult, AIExplainAnalysis } from '../../types'\nimport { useCubeFeatures } from '../../providers/CubeFeaturesProvider'\n\nexport interface UseExplainAIOptions {\n  /**\n   * Custom AI endpoint for explain analysis\n   * @default '/api/ai/explain/analyze'\n   */\n  aiEndpoint?: string\n}\n\nexport interface UseExplainAIResult {\n  /** The AI analysis result */\n  analysis: AIExplainAnalysis | null\n  /** Whether AI analysis is in progress */\n  isAnalyzing: boolean\n  /** Error if AI analysis failed */\n  error: Error | null\n  /**\n   * Trigger AI analysis of an explain result\n   * @param explainResult - The EXPLAIN result to analyze\n   * @param query - The original semantic query\n   */\n  analyze: (explainResult: ExplainResult, query: unknown) => void\n  /** Clear the analysis result */\n  clearAnalysis: () => void\n}\n\n/**\n * Query key for AI explain analysis\n */\nexport const EXPLAIN_AI_QUERY_KEY = ['cube', 'explain', 'ai'] as const\n\n/**\n * TanStack Query hook for AI analysis of EXPLAIN plans\n *\n * This hook uses useMutation to call the AI endpoint and analyze execution plans,\n * providing actionable recommendations for performance improvement.\n *\n * Recommendations focus on what users CAN control:\n * - Index creation (with CREATE INDEX statements)\n * - Table structure changes\n * - Cube definition improvements (segments, pre-aggregations, joins)\n *\n * Usage:\n * ```tsx\n * const { analysis, isAnalyzing, analyze } = useExplainAI()\n *\n * // After running EXPLAIN\n * if (explainResult) {\n *   <button onClick={() => analyze(explainResult, query)}>\n *     {isAnalyzing ? 'Analyzing...' : 'Analyze with AI'}\n *   </button>\n * }\n *\n * // Display recommendations\n * {analysis?.recommendations.map(rec => (\n *   <div key={rec.title}>\n *     <h4>{rec.title}</h4>\n *     <p>{rec.description}</p>\n *     {rec.sql && <pre>{rec.sql}</pre>}\n *     {rec.cubeCode && <pre>{rec.cubeCode}</pre>}\n *   </div>\n * ))}\n * ```\n */\nexport function useExplainAI(options: UseExplainAIOptions = {}): UseExplainAIResult {\n  const { features } = useCubeFeatures()\n  const enableAI = features.enableAI ?? true\n  const queryClient = useQueryClient()\n\n  // AI endpoint - defaults to /api/ai/explain/analyze\n  // This is the standard path for AI routes in the dev server\n  const aiEndpoint = options.aiEndpoint ?? '/api/ai/explain/analyze'\n\n  const mutation = useMutation({\n    mutationKey: EXPLAIN_AI_QUERY_KEY,\n    mutationFn: async ({ explainResult, query }: { explainResult: ExplainResult; query: unknown }) => {\n      // Check if AI is enabled\n      if (!enableAI) {\n        throw new Error('AI features are disabled')\n      }\n\n      const response = await fetch(aiEndpoint, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        credentials: 'include',\n        body: JSON.stringify({\n          explainResult,\n          query,\n        }),\n      })\n\n      if (!response.ok) {\n        const errorData = await response.json().catch(() => ({}))\n        throw new Error(\n          errorData.error ||\n            errorData.message ||\n            `AI analysis failed: ${response.status} ${response.statusText}`\n        )\n      }\n\n      const result: AIExplainAnalysis = await response.json()\n      return result\n    },\n    // No caching - each mutation is independent\n    gcTime: 0,\n  })\n\n  const analyze = useCallback((explainResult: ExplainResult, query: unknown) => {\n    mutation.mutate({ explainResult, query })\n  }, [mutation])\n\n  const clearAnalysis = useCallback(() => {\n    mutation.reset()\n    // Also invalidate any cached queries\n    queryClient.removeQueries({ queryKey: EXPLAIN_AI_QUERY_KEY })\n  }, [mutation, queryClient])\n\n  return {\n    analysis: mutation.data ?? null,\n    isAnalyzing: mutation.isPending,\n    error: mutation.error ?? null,\n    analyze,\n    clearAnalysis,\n  }\n}\n"],"names":["createDryRunQueryKey","query","stableStringify","inferModeFromPayload","payload","normalizeDryRunResult","mode","useDryRunQuery","options","skip","staleTime","cubeApi","useCubeApi","serverQuery","useMemo","modeQuery","cleanQueryForServer","queryResult","useQuery","result","useMultiDryRunQueries","queries","serverQueries","q","queryResults","useQueries","debugDataPerQuery","isLoading","r","useDryRunQueries","isMultiQueryMode","queriesToFetch","createExplainQueryKey","isFunnelQuery","isFlowQuery","isRetentionQuery","useExplainQuery","explainOptions","setExplainOptions","useState","hasTriggered","setHasTriggered","queryEnabled","runExplain","useCallback","opts","clearExplain","EXPLAIN_AI_QUERY_KEY","useExplainAI","features","useCubeFeatures","enableAI","queryClient","useQueryClient","aiEndpoint","mutation","useMutation","explainResult","response","errorData","analyze","clearAnalysis"],"mappings":"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"}

package/dist/client/components/AnalysisBuilder/types.d.ts

@@ -525,6 +525,10 @@ export interface AnalysisResultsPanelProps {
      * Displayed as a banner above results.
      */
     warnings?: import('../../shared/types').QueryWarning[];
+    /** Fields currently selected in the query (for highlighting in schema diagram) */
+    highlightedFields?: string[];
+    /** Callback when a field is clicked in the schema diagram */
+    onSchemaFieldClick?: (cubeName: string, fieldName: string, fieldType: 'measure' | 'dimension') => void;
 }
 /**
  * Props for the MetricsSection component
@@ -728,6 +732,8 @@ export interface AnalysisBuilderProps {
     colorPalette?: ColorPalette;
     /** Disable localStorage persistence */
     disableLocalStorage?: boolean;
+    /** Custom localStorage key (for scoping persistence per connection/context) */
+    storageKey?: string;
     /** Hide settings button */
     hideSettings?: boolean;
     /** Callback when query changes (for modal integration) */

package/dist/client/components/SchemaVisualization/CubeNode.d.ts

@@ -0,0 +1,14 @@
+import { CubeMetaCube } from '../../types';
+interface CubeNodeData {
+    cube: CubeMetaCube;
+    onFieldClick?: (cubeName: string, fieldName: string, fieldType: 'measure' | 'dimension') => void;
+    isHighlighted: boolean;
+    highlightedFields: string[];
+    searchTerm?: string;
+    [key: string]: unknown;
+}
+interface CubeNodeProps {
+    data: CubeNodeData;
+}
+export declare function CubeNode({ data }: CubeNodeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/client/components/SchemaVisualization/RelationshipEdge.d.ts

@@ -0,0 +1,13 @@
+import { Edge, EdgeProps } from '@xyflow/react';
+import { CubeMetaRelationship } from '../../types';
+interface RelationshipEdgeData {
+    relationship: CubeMetaRelationship;
+    joinFields: Array<{
+        sourceField: string;
+        targetField: string;
+    }>;
+    [key: string]: unknown;
+}
+export type RelationshipEdgeType = Edge<RelationshipEdgeData, 'relationshipEdge'>;
+export declare function RelationshipEdge({ sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, style, data, markerEnd, }: EdgeProps<RelationshipEdgeType>): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/client/components/SchemaVisualization/SchemaVisualizationLazy.d.ts

@@ -0,0 +1,3 @@
+import { SchemaVisualizationProps } from './index';
+export declare function SchemaVisualizationLazy(props: SchemaVisualizationProps): import("react/jsx-runtime").JSX.Element;
+export declare function isSchemaVisualizationAvailable(): boolean;

package/dist/client/components/SchemaVisualization/index.d.ts

@@ -0,0 +1,10 @@
+export interface SchemaVisualizationProps {
+    className?: string;
+    onFieldClick?: (cubeName: string, fieldName: string, fieldType: 'measure' | 'dimension') => void;
+    highlightedCubes?: string[];
+    highlightedFields?: string[];
+    searchTerm?: string;
+    height?: string | number;
+}
+export declare function SchemaVisualization({ className, onFieldClick, highlightedCubes, highlightedFields, searchTerm, height, }: SchemaVisualizationProps): import("react/jsx-runtime").JSX.Element;
+export default SchemaVisualization;

package/dist/client/components/SchemaVisualization/useERDLayout.d.ts

@@ -0,0 +1,39 @@
+import { Node, Edge } from '@xyflow/react';
+export interface LayoutOptions {
+    direction: 'TB' | 'LR';
+    nodeWidth: number;
+    nodeSep: number;
+    rankSep: number;
+}
+export declare const defaultLayoutOptions: LayoutOptions;
+/**
+ * Layout state machine phases:
+ *  waiting   → ELK not loaded yet, nothing to show
+ *  computing → ELK loaded, running layout algorithm
+ *  ready     → layout complete, node positions available
+ */
+export type LayoutPhase = 'waiting' | 'computing' | 'ready';
+interface ELKInstance {
+    layout(graph: unknown): Promise<unknown>;
+}
+declare const elkLoadPromise: Promise<ELKInstance | null>;
+export { elkLoadPromise as _elkLoadPromise };
+export interface ElkLayoutResult {
+    nodes: Node[];
+    edges: Edge[];
+}
+/**
+ * Layout hook with explicit state machine.
+ *
+ * - Waits for ELK to load (phase: 'waiting')
+ * - Runs layout once per unique node/edge structure (phase: 'computing')
+ * - Returns stable result (phase: 'ready')
+ *
+ * The effect only depends on a string structure key, NOT object references.
+ * This prevents re-renders from cancelling in-flight computations.
+ */
+export declare function useERDLayout(nodes: Node[], edges: Edge[], options?: Partial<LayoutOptions>): {
+    nodes: Node[];
+    edges: Edge[];
+    phase: LayoutPhase;
+};

package/dist/client/components.js

@@ -1,4 +1,4 @@
-import { ab as e, a as t, A as o, h as r, b as i, M as l, c as d } from "./chunks/components-Dz6XHgnZ.js";
+import { ab as e, a as t, A as o, h as r, b as i, M as l, c as d } from "./chunks/components-CPqnw8o8.js";
 import { c as b, d as y, b as c, a as P, g as h, v as p } from "./chunks/index-CApFCBF9.js";
 export {
   e as AnalysisDisplayConfigPanel,

package/dist/client/hooks.js

@@ -1,7 +1,7 @@
-import { f as p, d as m, u as x, u as W, q as v, x as D, t as E, e as C, b as L, a as F, y as z, p as M } from "./chunks/useDirtyStateTracking-CjhwBXRw.js";
+import { f as p, d as m, u as x, u as W, q as v, x as D, t as E, e as C, b as L, a as F, y as z, p as M } from "./chunks/useDirtyStateTracking-CyAXd07d.js";
 import { useState as y, useRef as a, useCallback as w, useEffect as c } from "react";
-import { j as k } from "./chunks/providers-CCw8Kjlc.js";
-import { d as O, b as S, u as A, e as H, c as I, a as N } from "./chunks/useExplainAI-IiW55BaQ.js";
+import { j as k } from "./chunks/providers-Ds7DRmnO.js";
+import { d as O, b as S, u as A, e as H, c as I, a as N } from "./chunks/useExplainAI-CfQ_JmF1.js";
 const d = 768;
 function Q() {
   const [o, s] = y(

package/dist/client/icons/types.d.ts

@@ -63,6 +63,7 @@ export interface IconRegistry {
     camera: IconDefinition;
     thumbUp: IconDefinition;
     thumbDown: IconDefinition;
+    schemaGraph: IconDefinition;
     measure: IconDefinition;
     dimension: IconDefinition;
     timeDimension: IconDefinition;

package/dist/client/icons.js

@@ -1,4 +1,4 @@
-import { D as a, b as t, i as o, a as c, c as g, f as I, h as n, g as r, r as y, e as i, s as p } from "./chunks/icons-DFJw-2HU.js";
+import { D as a, b as t, i as o, g as c, c as g, f as I, h as n, a as r, r as y, e as i, s as p } from "./chunks/icons-CwvgmdIP.js";
 export {
   a as DEFAULT_ICONS,
   t as getChartTypeIcon,

package/dist/client/index.d.ts

@@ -22,6 +22,8 @@ export { default as AnalysisBuilder } from './components/AnalysisBuilderLazy';
 export type { AnalysisBuilderRef } from './components/AnalysisBuilder/types';
 export { ExecutionPlanPanel } from './components/AnalysisBuilder/ExecutionPlanPanel';
 export { ExplainAIPanel } from './components/AnalysisBuilder/ExplainAIPanel';
+export { SchemaVisualizationLazy as SchemaVisualization } from './components/SchemaVisualization/SchemaVisualizationLazy';
+export type { SchemaVisualizationProps } from './components/SchemaVisualization/index';
 export { CubeProvider, useCubeContext, useCubeApi, // Only re-renders on API/auth changes
 useCubeMeta, // Only re-renders on metadata changes
 useCubeFeatures } from './providers/CubeProvider';

package/dist/client/index.js

@@ -1,26 +1,27 @@
-import { D as ve, A as Ce, e as we, g as Ne, P as ke } from "./chunks/components-Dz6XHgnZ.js";
-import { j as Lt, a as Qt, C as Ft, i as _t, h as Vt, b as jt, k as Ut, f as Ot, d as $t, M as qt, c as Kt, o as zt, U as Wt, S as Jt, R as Xt, Q as Yt, T as Gt, W as Ht, J as Zt, I as es, L as ts, X as ss, H as cs, K as rs, Y as ns, N as as, O as os, V as ds, Z as ls, _ as is, B as us, r as ms, y as hs, v as fs, s as ps, x as gs, q as bs, w as xs, p as ys, t as vs, z as Cs, u as ws, l as Ns, m as ks, n as Ss, G as Ts, F as Ds, E as As } from "./chunks/components-Dz6XHgnZ.js";
+import { D as ve, A as Ce, e as we, g as Ne, P as ke } from "./chunks/components-CPqnw8o8.js";
+import { j as Lt, a as Qt, C as Ft, i as _t, h as Vt, b as jt, k as Ut, f as Ot, d as $t, M as qt, c as Kt, o as zt, U as Wt, S as Jt, R as Xt, Q as Yt, T as Gt, W as Ht, J as Zt, I as es, L as ts, X as ss, H as cs, K as rs, Y as ns, N as as, O as os, V as ds, Z as ls, _ as is, B as us, r as ms, y as hs, v as fs, s as ps, x as gs, q as bs, w as xs, p as ys, t as vs, z as Cs, u as ws, l as Ns, m as ks, n as Ss, G as Ts, F as Ds, E as As } from "./chunks/components-CPqnw8o8.js";
 import { jsx as e, jsxs as u, Fragment as ae } from "react/jsx-runtime";
 import G, { useRef as x, createContext as Se, useContext as Te, useState as _, useCallback as p, useEffect as F } from "react";
 import { e as De, f as Ae, h as Ie, s as Me, i as le } from "./chunks/vendor-B2EH3V58.js";
-import { a as M, b as Ee } from "./chunks/icons-DFJw-2HU.js";
-import { D as Ms, i as Es, c as Rs, f as Bs, h as Ps, g as Ls, r as Qs, e as Fs, s as _s } from "./chunks/icons-DFJw-2HU.js";
+import { g as M, b as Ee } from "./chunks/icons-CwvgmdIP.js";
+import { D as Ms, i as Es, c as Rs, f as Bs, h as Ps, a as Ls, r as Qs, e as Fs, s as _s } from "./chunks/icons-CwvgmdIP.js";
 import { Q as Re } from "./chunks/chart-markdown-Du4Z2iqK.js";
-import { f as Be } from "./chunks/providers-CCw8Kjlc.js";
-import { h as js, a as Us, S as Os, e as $s, d as qs, i as Ks, b as zs, g as Ws, u as Js, j as Xs, c as Ys, w as Gs } from "./chunks/providers-CCw8Kjlc.js";
-import { L as he } from "./chunks/charts-core-B4Rbfdcn.js";
-import { u as Zs } from "./chunks/charts-core-B4Rbfdcn.js";
+import { f as Be } from "./chunks/providers-Ds7DRmnO.js";
+import { h as js, b as Us, S as Os, e as $s, d as qs, i as Ks, u as zs, g as Ws, a as Js, j as Xs, c as Ys, w as Gs } from "./chunks/providers-Ds7DRmnO.js";
+import { L as he } from "./chunks/charts-core-BUUO36OM.js";
+import { u as Zs } from "./chunks/charts-core-BUUO36OM.js";
 import { useNotebookLayout as Pe } from "./hooks.js";
-import { L as tc, g as sc, c as cc, b as rc, i as nc, p as ac, a as oc } from "./chunks/charts-loader-DbrwgvCK.js";
-import { E as lc, a as ic, p as uc, q as mc, m as hc, l as fc, r as pc, C as gc, D as bc, o as xc, B as yc, n as vc, w as Cc, t as wc, d as Nc, f as kc, s as Sc, e as Tc, i as Dc, c as Ac, h as Ic, g as Mc, u as Ec, b as Rc, y as Bc, A as Pc, x as Lc, k as Qc, v as Fc, z as _c, j as Vc } from "./chunks/analysis-builder-shared-KSvGUzx6.js";
-import { u as Uc } from "./chunks/chart-bubble-ZfNe8t5k.js";
-import { c as $c, f as qc } from "./chunks/index-CApFCBF9.js";
-import { f as zc, d as Wc, n as Jc, j as Xc, l as Yc, k as Gc, i as Hc, m as Zc, h as er, g as tr, u as sr, u as cr, e as rr, b as nr, a as ar, v as or } from "./chunks/useDirtyStateTracking-CjhwBXRw.js";
-import { c as lr, b as ir, f as ur, g as mr, a as hr, i as fr, t as pr } from "./chunks/funnel-utils-CyonoNeC.js";
-import { T as br, c as xr, g as yr, a as vr, i as Cr, r as wr, s as Nr, b as kr, w as Sr } from "./chunks/theme-Dp3hFed1.js";
-import { d as Dr, b as Ar, u as Ir, e as Mr, c as Er, a as Rr } from "./chunks/useExplainAI-IiW55BaQ.js";
-import { i as Pr, a as Lr } from "./chunks/flow-utils-CjQZG5qq.js";
-import { h as Fr } from "./chunks/syntaxHighlighting-DAMSW_A6.js";
+import { L as tc, g as sc, c as cc, b as rc, i as nc, p as ac, a as oc } from "./chunks/charts-loader-Bv-IWHVd.js";
+import { E as lc, a as ic, p as uc, q as mc, m as hc, l as fc, r as pc, C as gc, D as bc, o as xc, B as yc, n as vc, w as Cc, t as wc, d as Nc, f as kc, s as Sc, e as Tc, i as Dc, c as Ac, h as Ic, g as Mc, u as Ec, b as Rc, y as Bc, A as Pc, x as Lc, k as Qc, v as Fc, z as _c, j as Vc } from "./chunks/analysis-builder-shared-Bz9oSywd.js";
+import { S as Uc } from "./chunks/schema-visualization-CzOuTQDu.js";
+import { u as $c } from "./chunks/chart-bubble-BF8Z52eW.js";
+import { c as Kc, f as zc } from "./chunks/index-CApFCBF9.js";
+import { f as Jc, d as Xc, n as Yc, j as Gc, l as Hc, k as Zc, i as er, m as tr, h as sr, g as cr, u as rr, u as nr, e as ar, b as or, a as dr, v as lr } from "./chunks/useDirtyStateTracking-CyAXd07d.js";
+import { c as ur, b as mr, f as hr, g as fr, a as pr, i as gr, t as br } from "./chunks/funnel-utils-CyonoNeC.js";
+import { T as yr, c as vr, g as Cr, a as wr, i as Nr, r as kr, s as Sr, b as Tr, w as Dr } from "./chunks/theme-Dp3hFed1.js";
+import { d as Ir, b as Mr, u as Er, e as Rr, c as Br, a as Pr } from "./chunks/useExplainAI-CfQ_JmF1.js";
+import { i as Qr, a as Fr } from "./chunks/flow-utils-CjQZG5qq.js";
+import { h as Vr } from "./chunks/syntaxHighlighting-DAMSW_A6.js";
 const fe = () => ({
   blocks: [],
   messages: [],
@@ -1161,15 +1162,16 @@ export {
   Fe as NotebookStoreProvider,
   ke as PortletAnalysisModal,
   Kt as PortletContainer,
+  Uc as SchemaVisualization,
   Os as ScrollContainerProvider,
-  br as THEME_PRESETS,
-  xr as applyTheme,
-  lr as buildFunnelConfigFromQueries,
-  ir as buildServerFunnelQuery,
+  yr as THEME_PRESETS,
+  vr as applyTheme,
+  ur as buildFunnelConfigFromQueries,
+  mr as buildServerFunnelQuery,
   $s as captureThumbnail,
   uc as compressAndEncode,
   qs as createCubeClient,
-  $c as createDashboardLayout,
+  Kc as createDashboardLayout,
   zt as createDashboardStore,
   Wt as createDefaultConfig,
   Jt as createDefaultFlowConfig,
@@ -1177,51 +1179,51 @@ export {
   Yt as createDefaultQueryConfig,
   Gt as createDefaultRetentionConfig,
   Ht as createDefaultWorkspace,
-  Dr as createExplainQueryKey,
-  zc as createFlowQueryKey,
-  Wc as createFunnelQueryKey,
+  Ir as createExplainQueryKey,
+  Jc as createFlowQueryKey,
+  Xc as createFunnelQueryKey,
   Qe as createNotebookStore,
   mc as decodeAndDecompress,
   hc as detectAsymmetricDateRanges,
   fc as detectMeasureCollisions,
-  qc as formatChartData,
-  ur as formatDuration,
-  Jc as generateQueryLabel,
+  zc as formatChartData,
+  hr as formatDuration,
+  Yc as generateQueryLabel,
   pc as generateShareUrl,
   gc as getAvailableBindingKeyDimensions,
   sc as getAvailableChartTypes,
-  mr as getBindingKeyField,
+  fr as getBindingKeyField,
   bc as getBindingKeyLabel,
   Ee as getChartTypeIcon,
-  Xc as getCombinedFields,
-  hr as getCubeNameFromQuery,
+  Gc as getCombinedFields,
+  pr as getCubeNameFromQuery,
   Es as getFieldTypeIcon,
   M as getIcon,
   Rs as getIconData,
   Bs as getIconRegistry,
   Ps as getIconsByCategory,
   Ls as getMeasureTypeIcon,
-  Yc as getQueryIndices,
-  Gc as getQueryLabels,
-  yr as getTheme,
-  vr as getThemeVariable,
+  Hc as getQueryIndices,
+  Zc as getQueryLabels,
+  Cr as getTheme,
+  wr as getThemeVariable,
   cc as getUnavailableChartTypes,
   xc as getValidationSummary,
-  Fr as highlightCodeBlocks,
+  Vr as highlightCodeBlocks,
   rc as isChartTypeAvailable,
-  Cr as isDarkMode,
+  Nr as isDarkMode,
   Zt as isFlowConfig,
   es as isFunnelConfig,
-  fr as isFunnelData,
+  gr as isFunnelData,
   yc as isMinimumFunnelConfigValid,
   ts as isMultiQuery,
   ss as isMultiQueryConfig,
-  Hc as isMultiQueryData,
+  er as isMultiQueryData,
   vc as isMultiQueryValid,
   cs as isQueryConfig,
   rs as isRetentionConfig,
-  Pr as isSankeyData,
-  Lr as isServerFlowQuery,
+  Qr as isSankeyData,
+  Fr as isServerFlowQuery,
   ns as isServerFunnelQuery,
   Cc as isShareableSize,
   as as isSingleQuery,
@@ -1229,9 +1231,9 @@ export {
   os as isValidAnalysisConfig,
   ds as isValidAnalysisWorkspace,
   nc as isValidChartType,
-  Zc as mergeQueryResults,
-  er as mergeResultsByKey,
-  tr as mergeResultsConcat,
+  tr as mergeQueryResults,
+  sr as mergeResultsByKey,
+  cr as mergeResultsConcat,
   ls as migrateConfig,
   is as migrateLegacyPortlet,
   wc as parseShareUrl,
@@ -1239,7 +1241,7 @@ export {
   oc as preloadCharts,
   Qs as registerIcons,
   Fs as resetIcons,
-  wr as resetTheme,
+  kr as resetTheme,
   us as selectAllActions,
   Ue as selectBlockActions,
   _e as selectBlocks,
@@ -1268,9 +1270,9 @@ export {
   Cs as selectThumbnailDirty,
   Mc as selectUIState,
   _s as setIcon,
-  Nr as setTheme,
-  kr as setThemeVariable,
-  pr as transformServerFunnelResult,
+  Sr as setTheme,
+  Tr as setThemeVariable,
+  br as transformServerFunnelResult,
   tt as useAgentChat,
   Ec as useAnalysisBuilder,
   Rc as useAnalysisBuilderStore,
@@ -1278,37 +1280,37 @@ export {
   zs as useCubeContext,
   Ws as useCubeFeatures,
   Zs as useCubeFieldLabel,
-  sr as useCubeLoadQuery,
+  rr as useCubeLoadQuery,
   Js as useCubeMeta,
   Xs as useCubeMetaQuery,
-  cr as useCubeQuery,
+  nr as useCubeQuery,
   ws as useDashboard,
   Ns as useDashboardStore,
   ks as useDashboardStoreApi,
   Ss as useDashboardStoreOptional,
   Ts as useDrillInteraction,
-  Ar as useDryRunQueries,
-  Ir as useDryRunQuery,
+  Mr as useDryRunQueries,
+  Er as useDryRunQuery,
   Ds as useElementVisibility,
-  Mr as useExplainAI,
-  Er as useExplainQuery,
-  rr as useFlowQuery,
-  nr as useFunnelQuery,
-  ar as useMultiCubeLoadQuery,
-  Rr as useMultiDryRunQueries,
+  Rr as useExplainAI,
+  Br as useExplainQuery,
+  ar as useFlowQuery,
+  or as useFunnelQuery,
+  dr as useMultiCubeLoadQuery,
+  Pr as useMultiDryRunQueries,
   B as useNotebookStore,
   Ys as useScrollContainer,
   As as useScrollDetection,
-  Uc as useTheme,
+  $c as useTheme,
   Bc as validateBindingKeyExists,
   Pc as validateBindingKeyForSteps,
   Lc as validateFunnelConfig,
-  or as validateMergeKey,
+  lr as validateMergeKey,
   Qc as validateMergeKeys,
   Fc as validateMultiQueryConfig,
   _c as validateStepQueries,
   Vc as validateTimeDimensionAlignment,
   Gs as warnIfScreenshotLibMissing,
-  Sr as watchThemeChanges
+  Dr as watchThemeChanges
 };
 //# sourceMappingURL=index.js.map