drizzle-cube 0.4.42 → 0.4.44

package/dist/client/chunks/{useExplainAI-CxdzY2N0.js → useExplainAI-DBIfYwz-.js}

@@ -1,6 +1,6 @@
-import { c as e, l as t } from "./vendor-BoWEubRu.js";
-import { J as n, V as r, Z as i, ot as a } from "./chart-data-table-BZ7StNWv.js";
-import { S as o, x as s } from "./useDebounce-Bel8J05v.js";
+import { c as e, l as t } from "./vendor-BRlsCGnK.js";
+import { V as n, Z as r, et as i, lt as a } from "./chart-data-table-2iCsn0CF.js";
+import { S as o, x as s } from "./useDebounce-CKqkM42n.js";
 import { useCallback as c, useMemo as l, useState as u } from "react";
 //#region src/client/hooks/queries/useDryRunQuery.ts
 function d(e) {
@@ -33,7 +33,7 @@ function p(e) {
 	};
 }
 function m(e, t = {}) {
-	let { skip: r = !1, staleTime: a = 300 * 1e3 } = t, { cubeApi: s } = n(), c = l(() => {
+	let { skip: n = !1, staleTime: a = 300 * 1e3 } = t, { cubeApi: s } = r(), c = l(() => {
 		if (!e) return null;
 		let t = e;
 		return t.funnel || t.flow || t.retention ? e : o(e);
@@ -43,7 +43,7 @@ function m(e, t = {}) {
 			if (!c) throw Error("No query provided");
 			return p(await s.dryRun(c));
 		},
-		enabled: !!c && !r,
+		enabled: !!c && !n,
 		staleTime: a
 	});
 	return {
@@ -63,8 +63,8 @@ function m(e, t = {}) {
 		refetch: () => u.refetch()
 	};
 }
-function h(e, r = {}) {
-	let { skip: i = !1, staleTime: a = 300 * 1e3 } = r, { cubeApi: s } = n(), c = t({ queries: l(() => e.map((e) => o(e)), [e]).map((e) => ({
+function h(e, n = {}) {
+	let { skip: i = !1, staleTime: a = 300 * 1e3 } = n, { cubeApi: s } = r(), c = t({ queries: l(() => e.map((e) => o(e)), [e]).map((e) => ({
 		queryKey: d(e),
 		queryFn: async () => p(await s.dryRun(e)),
 		enabled: !i,
@@ -122,7 +122,7 @@ function b(e) {
 	return !e || typeof e != "object" ? !1 : Object.prototype.hasOwnProperty.call(e, "retention");
 }
 function x(e, t = {}) {
-	let { skip: r = !1 } = t, { cubeApi: a } = n(), [s, d] = u(null), [f, p] = u(!1), m = l(() => e ? v(e) || y(e) || b(e) ? e : o(e) : null, [e]), h = !!m && !r && f, g = i({
+	let { skip: n = !1 } = t, { cubeApi: a } = r(), [s, d] = u(null), [f, p] = u(!1), m = l(() => e ? v(e) || y(e) || b(e) ? e : o(e) : null, [e]), h = !!m && !n && f, g = i({
 		queryKey: _(m, s ?? void 0),
 		queryFn: async () => {
 			if (!m) throw Error("No query provided");
@@ -135,9 +135,9 @@ function x(e, t = {}) {
 		refetchOnReconnect: !1,
 		refetchOnMount: !1
 	}), x = c((e) => {
-		r || !m || (d(e ?? null), p(!0), f && g.refetch());
+		n || !m || (d(e ?? null), p(!0), f && g.refetch());
 	}, [
-		r,
+		n,
 		m,
 		f,
 		g
@@ -161,7 +161,7 @@ var S = [
 	"ai"
 ];
 function C(t = {}) {
-	let { features: i } = r(), { apiOptions: o } = n(), s = i.enableAI ?? !0, l = a(), u = t.aiEndpoint ?? "/api/ai/explain/analyze", d = e({
+	let { features: i } = n(), { apiOptions: o } = r(), s = i.enableAI ?? !0, l = a(), u = t.aiEndpoint ?? "/api/ai/explain/analyze", d = e({
 		mutationKey: S,
 		mutationFn: async ({ explainResult: e, query: t }) => {
 			if (!s) throw Error("AI features are disabled");
@@ -203,4 +203,4 @@ function C(t = {}) {
 //#endregion
 export { m as a, g as i, _ as n, h as o, x as r, C as t };
 
-//# sourceMappingURL=useExplainAI-CxdzY2N0.js.map
+//# sourceMappingURL=useExplainAI-DBIfYwz-.js.map

package/dist/client/chunks/{useExplainAI-CxdzY2N0.js.map → useExplainAI-DBIfYwz-.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useExplainAI-CxdzY2N0.js","names":[],"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  if (!query || typeof query !== 'object') return false\n  return Object.prototype.hasOwnProperty.call(query, 'funnel')\n}\n\n/**\n * Check if query is a flow query\n */\nfunction isFlowQuery(query: unknown): query is { flow: unknown } {\n  if (!query || typeof query !== 'object') return false\n  return Object.prototype.hasOwnProperty.call(query, 'flow')\n}\n\n/**\n * Check if query is a retention query\n */\nfunction isRetentionQuery(query: unknown): query is { retention: unknown } {\n  if (!query || typeof query !== 'object') return false\n  return Object.prototype.hasOwnProperty.call(query, 'retention')\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'\nimport { useCubeApi } from '../../providers/CubeApiProvider'\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 { apiOptions } = useCubeApi()\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          ...apiOptions?.headers,\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"],"mappings":"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"}
+{"version":3,"file":"useExplainAI-DBIfYwz-.js","names":[],"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  if (!query || typeof query !== 'object') return false\n  return Object.prototype.hasOwnProperty.call(query, 'funnel')\n}\n\n/**\n * Check if query is a flow query\n */\nfunction isFlowQuery(query: unknown): query is { flow: unknown } {\n  if (!query || typeof query !== 'object') return false\n  return Object.prototype.hasOwnProperty.call(query, 'flow')\n}\n\n/**\n * Check if query is a retention query\n */\nfunction isRetentionQuery(query: unknown): query is { retention: unknown } {\n  if (!query || typeof query !== 'object') return false\n  return Object.prototype.hasOwnProperty.call(query, 'retention')\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'\nimport { useCubeApi } from '../../providers/CubeApiProvider'\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 { apiOptions } = useCubeApi()\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          ...apiOptions?.headers,\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"],"mappings":"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"}

package/dist/client/chunks/{utils-CMkS7h9x.js → utils--qCr8Yn5.js}

@@ -1,4 +1,4 @@
-import { P as e } from "./chart-data-table-BZ7StNWv.js";
+import { P as e } from "./chart-data-table-2iCsn0CF.js";
 import "react";
 import { jsx as t } from "react/jsx-runtime";
 //#region src/client/utils/measureIcons.tsx
@@ -125,4 +125,4 @@ function u() {
 //#endregion
 export { s as a, r as c, o as i, n as l, u as n, a as o, c as r, l as s, i as t };
 
-//# sourceMappingURL=utils-CMkS7h9x.js.map
+//# sourceMappingURL=utils--qCr8Yn5.js.map

package/dist/client/chunks/utils--qCr8Yn5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils--qCr8Yn5.js","names":[],"sources":["../../../src/client/utils/measureIcons.tsx","../../../src/client/utils/index.ts"],"sourcesContent":["import React from 'react'\nimport { getMeasureTypeIcon } from '../icons'\n\n/**\n * Get the appropriate icon component for a given measure type\n * All icons use amber coloring for consistency\n */\nexport function getMeasureIcon(\n  measureType: string | undefined,\n  className: string = 'w-4 h-4'\n): React.ReactElement {\n  const IconComponent = getMeasureTypeIcon(measureType)\n  return <IconComponent className={className} />\n}\n\n/**\n * Get all available measure type icons\n * Useful for documentation or UI that shows all measure types\n */\nexport function getAllMeasureIcons(): Record<string, React.ReactElement> {\n  const types = ['count', 'countDistinct', 'countDistinctApprox', 'sum', 'avg', 'min', 'max', 'runningTotal', 'calculated', 'number']\n  const icons: Record<string, React.ReactElement> = {}\n\n  for (const type of types) {\n    const IconComponent = getMeasureTypeIcon(type)\n    icons[type] = <IconComponent className=\"dc:w-4 dc:h-4\" />\n  }\n\n  return icons\n}\n","/**\n * Utility functions for drizzle-cube client\n */\n\nimport type { PortletConfig, DashboardConfig } from '../types'\n\n// Re-export chart utilities\nexport * from './chartUtils'\nexport * from './chartConstants'\nexport * from './measureIcons'\nexport * from './periodUtils'\nexport * from './pivotUtils'\nexport * from './syntaxHighlighting'\nexport * from './comparisonUtils'\n\n// Thumbnail utilities (requires html2canvas peer dependency)\nexport { captureThumbnail, isThumbnailCaptureAvailable } from './thumbnail'\n\n// XLSX export utilities (requires exceljs peer dependency)\nexport { exportPortletToXlsx, isExportAvailable } from './exportXlsx'\n\n/**\n * Create a dashboard layout from portlet configurations\n */\nexport function createDashboardLayout(portlets: PortletConfig[]): DashboardConfig {\n  const layouts = generateResponsiveLayouts(portlets)\n  \n  return {\n    portlets,\n    layouts\n  }\n}\n\n/**\n * Generate responsive layouts for different breakpoints\n */\nexport function generateResponsiveLayouts(portlets: PortletConfig[]) {\n  const gridLayout = portlets.map(portlet => ({\n    i: portlet.id,\n    x: portlet.x,\n    y: portlet.y,\n    w: portlet.w,\n    h: portlet.h,\n    minW: 3,\n    minH: 3\n  }))\n\n  return {\n    lg: gridLayout,\n    md: gridLayout.map(item => ({ ...item, w: Math.min(item.w, 8) })),\n    sm: gridLayout.map(item => ({ ...item, w: Math.min(item.w, 6) })),\n    xs: gridLayout.map(item => ({ ...item, w: Math.min(item.w, 4) })),\n    xxs: gridLayout.map(item => ({ ...item, w: 2 }))\n  }\n}\n\n/**\n * Format chart data for display\n */\nexport function formatChartData(data: any[], options: {\n  formatNumbers?: boolean\n  precision?: number\n} = {}): any[] {\n  const { formatNumbers = true, precision = 2 } = options\n\n  if (!formatNumbers) return data\n\n  return data.map(row => {\n    const formattedRow: any = {}\n    \n    for (const [key, value] of Object.entries(row)) {\n      if (typeof value === 'number') {\n        formattedRow[key] = Number(value.toFixed(precision))\n      } else {\n        formattedRow[key] = value\n      }\n    }\n    \n    return formattedRow\n  })\n}\n\n/**\n * Generate a unique ID for new portlets\n */\nexport function generatePortletId(): string {\n  return `portlet-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n}\n\n/**\n * Find the next available position in a grid\n */\nexport function findNextPosition(existingPortlets: PortletConfig[], _w: number = 6, _h: number = 4): { x: number; y: number } {\n  if (existingPortlets.length === 0) {\n    return { x: 0, y: 0 }\n  }\n\n  // Find the maximum Y position and height\n  const maxY = Math.max(...existingPortlets.map(p => p.y + p.h))\n  \n  return { x: 0, y: maxY }\n}\n\n/**\n * Validate a cube query JSON string\n */\nexport function validateCubeQuery(queryString: string): { valid: boolean; error?: string; query?: any } {\n  try {\n    const query = JSON.parse(queryString)\n    \n    // Basic validation\n    if (typeof query !== 'object' || query === null) {\n      return { valid: false, error: 'Query must be a JSON object' }\n    }\n\n    // Check for required fields\n    if (!query.measures && !query.dimensions) {\n      return { valid: false, error: 'Query must have at least measures or dimensions' }\n    }\n\n    return { valid: true, query }\n  } catch {\n    return { valid: false, error: 'Invalid JSON format' }\n  }\n}\n\n/**\n * Create a sample portlet configuration\n */\nexport function createSamplePortlet(): Omit<PortletConfig, 'id'> {\n  return {\n    title: 'Sample Chart',\n    query: JSON.stringify({\n      measures: ['count'],\n      dimensions: ['category']\n    }, null, 2),\n    chartType: 'bar',\n    chartConfig: {\n      x: 'category',\n      y: ['count']\n    },\n    displayConfig: {\n      showLegend: true,\n      showGrid: true,\n      showTooltip: true\n    },\n    w: 6,\n    h: 4,\n    x: 0,\n    y: 0\n  }\n}"],"mappings":";;;;AAOA,SAAgB,EACd,GACA,IAAoB,WACA;AAEpB,QAAO,kBADe,EAAmB,EAAY,EAC9C,EAA0B,cAAa,CAAA;;AAOhD,SAAgB,IAAyD;CACvE,IAAM,IAAQ;EAAC;EAAS;EAAiB;EAAuB;EAAO;EAAO;EAAO;EAAO;EAAgB;EAAc;EAAS,EAC7H,IAA4C,EAAE;AAEpD,MAAK,IAAM,KAAQ,EAEjB,GAAM,KAAQ,kBADQ,EAAmB,EAAK,EAChC,EAAe,WAAU,iBAAkB,CAAA;AAG3D,QAAO;;;;ACJT,SAAgB,EAAsB,GAA4C;AAGhF,QAAO;EACL;EACA,SAJc,EAA0B,EAAS;EAKlD;;AAMH,SAAgB,EAA0B,GAA2B;CACnE,IAAM,IAAa,EAAS,KAAI,OAAY;EAC1C,GAAG,EAAQ;EACX,GAAG,EAAQ;EACX,GAAG,EAAQ;EACX,GAAG,EAAQ;EACX,GAAG,EAAQ;EACX,MAAM;EACN,MAAM;EACP,EAAE;AAEH,QAAO;EACL,IAAI;EACJ,IAAI,EAAW,KAAI,OAAS;GAAE,GAAG;GAAM,GAAG,KAAK,IAAI,EAAK,GAAG,EAAE;GAAE,EAAE;EACjE,IAAI,EAAW,KAAI,OAAS;GAAE,GAAG;GAAM,GAAG,KAAK,IAAI,EAAK,GAAG,EAAE;GAAE,EAAE;EACjE,IAAI,EAAW,KAAI,OAAS;GAAE,GAAG;GAAM,GAAG,KAAK,IAAI,EAAK,GAAG,EAAE;GAAE,EAAE;EACjE,KAAK,EAAW,KAAI,OAAS;GAAE,GAAG;GAAM,GAAG;GAAG,EAAE;EACjD;;AAMH,SAAgB,EAAgB,GAAa,IAGzC,EAAE,EAAS;CACb,IAAM,EAAE,mBAAgB,IAAM,eAAY,MAAM;AAIhD,QAFK,IAEE,EAAK,KAAI,MAAO;EACrB,IAAM,IAAoB,EAAE;AAE5B,OAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,EAAI,CAC5C,CAAI,OAAO,KAAU,WACnB,EAAa,KAAO,OAAO,EAAM,QAAQ,EAAU,CAAC,GAEpD,EAAa,KAAO;AAIxB,SAAO;GACP,GAdyB;;AAoB7B,SAAgB,IAA4B;AAC1C,QAAO,WAAW,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,OAAO,GAAG,EAAE;;AAMzE,SAAgB,EAAiB,GAAmC,IAAa,GAAG,IAAa,GAA6B;AAQ5H,QAPI,EAAiB,WAAW,IACvB;EAAE,GAAG;EAAG,GAAG;EAAG,GAMhB;EAAE,GAAG;EAAG,GAFF,KAAK,IAAI,GAAG,EAAiB,KAAI,MAAK,EAAE,IAAI,EAAE,EAAE,CAAC;EAEtC;;AAM1B,SAAgB,EAAkB,GAAsE;AACtG,KAAI;EACF,IAAM,IAAQ,KAAK,MAAM,EAAY;AAYrC,SATI,OAAO,KAAU,aAAY,IACxB;GAAE,OAAO;GAAO,OAAO;GAA+B,GAI3D,CAAC,EAAM,YAAY,CAAC,EAAM,aACrB;GAAE,OAAO;GAAO,OAAO;GAAmD,GAG5E;GAAE,OAAO;GAAM;GAAO;SACvB;AACN,SAAO;GAAE,OAAO;GAAO,OAAO;GAAuB;;;AAOzD,SAAgB,IAAiD;AAC/D,QAAO;EACL,OAAO;EACP,OAAO,KAAK,UAAU;GACpB,UAAU,CAAC,QAAQ;GACnB,YAAY,CAAC,WAAW;GACzB,EAAE,MAAM,EAAE;EACX,WAAW;EACX,aAAa;GACX,GAAG;GACH,GAAG,CAAC,QAAQ;GACb;EACD,eAAe;GACb,YAAY;GACZ,UAAU;GACV,aAAa;GACd;EACD,GAAG;EACH,GAAG;EACH,GAAG;EACH,GAAG;EACJ"}

package/dist/client/chunks/{vendor-BoWEubRu.js → vendor-BRlsCGnK.js}

@@ -1,5 +1,5 @@
-import { t as e } from "./rolldown-runtime-lc2dmIiU.js";
-import { $ as t, Q as n, at as r, ct as i, dt as a, et as o, ft as s, ht as c, it as l, lt as u, mt as d, nt as f, ot as p, pt as m, rt as h, st as g, tt as _, ut as v } from "./chart-data-table-BZ7StNWv.js";
+import { t as e } from "./rolldown-runtime-CCl2IeXn.js";
+import { _t as t, at as n, ct as r, dt as i, ft as a, gt as o, ht as s, it as c, lt as l, mt as u, nt as d, ot as f, pt as p, rt as m, st as h, tt as g, ut as _, vt as v } from "./chart-data-table-2iCsn0CF.js";
 import * as y from "react";
 import b from "react";
 //#region node_modules/react-intersection-observer/dist/index.mjs
@@ -96,7 +96,7 @@ function k({ threshold: e, delay: t, trackVisibility: n, rootMargin: r, root: i,
 "useInsertionEffect" in y;
 //#endregion
 //#region node_modules/@tanstack/query-core/build/modern/mutationObserver.js
-var A = class extends c {
+var A = class extends v {
 	#e;
 	#t = void 0;
 	#n;
@@ -109,11 +109,11 @@ var A = class extends c {
 	}
 	setOptions(e) {
 		let t = this.options;
-		this.options = this.#e.defaultMutationOptions(e), m(this.options, t) || this.#e.getMutationCache().notify({
+		this.options = this.#e.defaultMutationOptions(e), o(this.options, t) || this.#e.getMutationCache().notify({
 			type: "observerOptionsUpdated",
 			mutation: this.#n,
 			observer: this
-		}), t?.mutationKey && this.options.mutationKey && v(t.mutationKey) !== v(this.options.mutationKey) ? this.reset() : this.#n?.state.status === "pending" && this.#n.setOptions(this.options);
+		}), t?.mutationKey && this.options.mutationKey && p(t.mutationKey) !== p(this.options.mutationKey) ? this.reset() : this.#n?.state.status === "pending" && this.#n.setOptions(this.options);
 	}
 	onUnsubscribe() {
 		this.hasListeners() || this.#n?.removeObserver(this);
@@ -131,7 +131,7 @@ var A = class extends c {
 		return this.#r = t, this.#n?.removeObserver(this), this.#n = this.#e.getMutationCache().build(this.#e, this.options), this.#n.addObserver(this), this.#n.execute(e);
 	}
 	#i() {
-		let e = this.#n?.state ?? g();
+		let e = this.#n?.state ?? _();
 		this.#t = {
 			...e,
 			isPending: e.status === "pending",
@@ -143,7 +143,7 @@ var A = class extends c {
 		};
 	}
 	#a(e) {
-		u.batch(() => {
+		a.batch(() => {
 			if (this.#r && this.hasListeners()) {
 				let t = this.#t.variables, n = this.#t.context, r = {
 					client: this.#e,
@@ -190,7 +190,7 @@ function M(e, t, n) {
 	let r = e.slice(0);
 	return r[t] = n, r;
 }
-var N = class extends c {
+var N = class extends v {
 	#e;
 	#t;
 	#n;
@@ -224,14 +224,14 @@ var N = class extends c {
 			let t = e.map((e) => this.#e.defaultQueryOptions(e).queryHash);
 			new Set(t).size !== t.length && console.warn("[QueriesObserver]: Duplicate Queries found. This might result in unexpected behavior.");
 		}
-		u.batch(() => {
+		a.batch(() => {
 			let e = this.#i, t = this.#f(this.#n);
 			t.forEach((e) => e.observer.setOptions(e.defaultedQueryOptions));
-			let n = t.map((e) => e.observer), r = n.map((e) => e.getCurrentResult()), i = e.length !== n.length, a = n.some((t, n) => t !== e[n]), o = i || a, s = o ? !0 : r.some((e, t) => {
+			let n = t.map((e) => e.observer), r = n.map((e) => e.getCurrentResult()), i = e.length !== n.length, a = n.some((t, n) => t !== e[n]), s = i || a, c = s ? !0 : r.some((e, t) => {
 				let n = this.#t[t];
-				return !n || !m(e, n);
+				return !n || !o(e, n);
 			});
-			!o && !s || (o && (this.#l = t, this.#i = n), this.#t = r, this.hasListeners() && (o && (j(e, n).forEach((e) => {
+			!s && !c || (s && (this.#l = t, this.#i = n), this.#t = r, this.hasListeners() && (s && (j(e, n).forEach((e) => {
 				e.destroy();
 			}), j(n, e).forEach((e) => {
 				e.subscribe((t) => {
@@ -298,7 +298,7 @@ var N = class extends c {
 	#m() {
 		if (this.hasListeners()) {
 			let e = this.#a, t = this.#u(this.#t, this.#l);
-			e !== this.#d(t, this.#r?.combine) && u.batch(() => {
+			e !== this.#d(t, this.#r?.combine) && a.batch(() => {
 				this.listeners.forEach((e) => {
 					e(this.#t);
 				});
@@ -308,39 +308,39 @@ var N = class extends c {
 };
 //#endregion
 //#region node_modules/@tanstack/react-query/build/modern/useQueries.js
-function P({ queries: e, ...s }, c) {
-	let d = p(c), m = r(), g = l(), v = y.useMemo(() => e.map((e) => {
-		let t = d.defaultQueryOptions(e);
-		return t._optimisticResults = m ? "isRestoring" : "optimistic", t;
+function P({ queries: e, ...t }, o) {
+	let s = l(o), p = r(), _ = h(), v = y.useMemo(() => e.map((e) => {
+		let t = s.defaultQueryOptions(e);
+		return t._optimisticResults = p ? "isRestoring" : "optimistic", t;
 	}), [
 		e,
-		d,
-		m
+		s,
+		p
 	]);
 	v.forEach((e) => {
-		n(e), _(e, g, d.getQueryCache().get(e.queryHash));
-	}), h(g);
-	let [b] = y.useState(() => new N(d, v, s)), [x, S, C] = b.getOptimisticResult(v, s.combine), w = !m && s.subscribed !== !1;
-	y.useSyncExternalStore(y.useCallback((e) => w ? b.subscribe(u.batchCalls(e)) : a, [b, w]), () => b.getCurrentResult(), () => b.getCurrentResult()), y.useEffect(() => {
-		b.setQueries(v, s);
+		g(e), c(e, _, s.getQueryCache().get(e.queryHash));
+	}), f(_);
+	let [b] = y.useState(() => new N(s, v, t)), [x, S, C] = b.getOptimisticResult(v, t.combine), w = !p && t.subscribed !== !1;
+	y.useSyncExternalStore(y.useCallback((e) => w ? b.subscribe(a.batchCalls(e)) : u, [b, w]), () => b.getCurrentResult(), () => b.getCurrentResult()), y.useEffect(() => {
+		b.setQueries(v, t);
 	}, [
 		v,
-		s,
+		t,
 		b
 	]);
-	let T = x.some((e, t) => o(v[t], e)) ? x.flatMap((e, n) => {
-		let r = v[n];
-		return r && o(r, e) ? t(r, new i(d, r), g) : [];
+	let T = x.some((e, t) => m(v[t], e)) ? x.flatMap((e, t) => {
+		let n = v[t];
+		return n && m(n, e) ? d(n, new i(s, n), _) : [];
 	}) : [];
 	if (T.length > 0) throw Promise.all(T);
 	let E = x.find((e, t) => {
-		let n = v[t];
-		return n && f({
+		let r = v[t];
+		return r && n({
 			result: e,
-			errorResetBoundary: g,
-			throwOnError: n.throwOnError,
-			query: d.getQueryCache().get(n.queryHash),
-			suspense: n.suspense
+			errorResetBoundary: _,
+			throwOnError: r.throwOnError,
+			query: s.getQueryCache().get(r.queryHash),
+			suspense: r.suspense
 		});
 	});
 	if (E?.error) throw E.error;
@@ -348,19 +348,19 @@ function P({ queries: e, ...s }, c) {
 }
 //#endregion
 //#region node_modules/@tanstack/react-query/build/modern/useMutation.js
-function F(e, t) {
-	let n = p(t), [r] = y.useState(() => new A(n, e));
+function F(e, n) {
+	let r = l(n), [i] = y.useState(() => new A(r, e));
 	y.useEffect(() => {
-		r.setOptions(e);
-	}, [r, e]);
-	let i = y.useSyncExternalStore(y.useCallback((e) => r.subscribe(u.batchCalls(e)), [r]), () => r.getCurrentResult(), () => r.getCurrentResult()), o = y.useCallback((e, t) => {
-		r.mutate(e, t).catch(a);
-	}, [r]);
-	if (i.error && d(r.options.throwOnError, [i.error])) throw i.error;
+		i.setOptions(e);
+	}, [i, e]);
+	let o = y.useSyncExternalStore(y.useCallback((e) => i.subscribe(a.batchCalls(e)), [i]), () => i.getCurrentResult(), () => i.getCurrentResult()), s = y.useCallback((e, t) => {
+		i.mutate(e, t).catch(u);
+	}, [i]);
+	if (o.error && t(i.options.throwOnError, [o.error])) throw o.error;
 	return {
-		...i,
-		mutate: o,
-		mutateAsync: i.mutate
+		...o,
+		mutate: s,
+		mutateAsync: o.mutate
 	};
 }
 //#endregion
@@ -825,4 +825,4 @@ var ie = /* @__PURE__ */ e(((e, t) => {
 //#endregion
 export { q as a, F as c, X as i, P as l, re as n, R as o, G as r, ee as s, ie as t, k as u };
 
-//# sourceMappingURL=vendor-BoWEubRu.js.map
+//# sourceMappingURL=vendor-BRlsCGnK.js.map