drizzle-cube 0.3.32 → 0.4.0

package/dist/client/chunks/hooks-CdyIO1-j.js

@@ -1,236 +0,0 @@
-import { t as w, B as y } from "./useDirtyStateTracking-CTS_m9mg.js";
-import { f as d, g as A } from "./providers-D2xswCYu.js";
-import { a as p, i as D, u as F, j as x } from "./vendor-DfDLOfBe.js";
-import { useMemo as h, useState as m, useCallback as g } from "react";
-function E(e) {
-  return e ? ["cube", "dryRun", y(e)] : ["cube", "dryRun", null];
-}
-function O(e, r = {}) {
-  const { skip: l = !1, staleTime: u = 300 * 1e3 } = r, { cubeApi: i } = d(), n = h(() => e ? w(e) : null, [e]), t = p({
-    queryKey: E(n),
-    queryFn: async () => {
-      if (!n) throw new Error("No query provided");
-      const o = await i.dryRun(n);
-      return {
-        sql: o.sql,
-        analysis: o.analysis
-      };
-    },
-    enabled: !!n && !l,
-    staleTime: u
-  });
-  return {
-    debugData: {
-      sql: t.data?.sql ?? null,
-      analysis: t.data?.analysis ?? null,
-      loading: t.isLoading,
-      error: t.error ?? null
-    },
-    refetch: () => t.refetch()
-  };
-}
-function M(e, r = {}) {
-  const { skip: l = !1, staleTime: u = 300 * 1e3 } = r, { cubeApi: i } = d(), n = h(() => e.map((a) => w(a)), [e]), t = D({
-    queries: n.map((a) => ({
-      queryKey: E(a),
-      queryFn: async () => {
-        const f = await i.dryRun(a);
-        return {
-          sql: f.sql,
-          analysis: f.analysis
-        };
-      },
-      enabled: !l,
-      staleTime: u
-    }))
-  }), s = t.map((a) => ({
-    sql: a.data?.sql ?? null,
-    analysis: a.data?.analysis ?? null,
-    loading: a.isLoading,
-    error: a.error ?? null
-  })), o = t.some((a) => a.isLoading);
-  return {
-    debugDataPerQuery: s,
-    isLoading: o,
-    refetchAll: () => {
-      t.forEach((a) => a.refetch());
-    }
-  };
-}
-function C(e) {
-  const { queries: r, isMultiQueryMode: l, skip: u = !1, staleTime: i } = e, n = l ? r : r.slice(0, 1);
-  return M(n, { skip: u, staleTime: i });
-}
-function S(e, r = {}) {
-  const { skip: l = !1, staleTime: u = 300 * 1e3 } = r, { cubeApi: i } = d(), n = p({
-    queryKey: ["cube", "dryRun", "funnel", e ? y(e) : null],
-    queryFn: async () => {
-      if (!e) throw new Error("No funnel query provided");
-      const s = await i.dryRun(e);
-      return {
-        sql: s.sql,
-        analysis: s.analysis,
-        funnelMetadata: s.funnel
-      };
-    },
-    enabled: !!e && !l,
-    staleTime: u
-  });
-  return {
-    debugData: {
-      sql: n.data?.sql ?? null,
-      analysis: n.data?.analysis ?? null,
-      loading: n.isLoading,
-      error: n.error ?? null,
-      funnelMetadata: n.data?.funnelMetadata
-    },
-    refetch: () => n.refetch()
-  };
-}
-function z(e, r = {}) {
-  const { skip: l = !1, staleTime: u = 300 * 1e3 } = r, { cubeApi: i } = d(), n = p({
-    queryKey: ["cube", "dryRun", "flow", e ? y(e) : null],
-    queryFn: async () => {
-      if (!e) throw new Error("No flow query provided");
-      const s = await i.dryRun(e);
-      return {
-        sql: s.sql,
-        analysis: s.analysis,
-        flowMetadata: s.flow
-      };
-    },
-    enabled: !!e && !l,
-    staleTime: u
-  });
-  return {
-    debugData: {
-      sql: n.data?.sql ?? null,
-      analysis: n.data?.analysis ?? null,
-      loading: n.isLoading,
-      error: n.error ?? null,
-      flowMetadata: n.data?.flowMetadata
-    },
-    refetch: () => n.refetch()
-  };
-}
-function P(e, r = {}) {
-  const { skip: l = !1, staleTime: u = 300 * 1e3 } = r, { cubeApi: i } = d(), n = p({
-    queryKey: ["cube", "dryRun", "retention", e ? y(e) : null],
-    queryFn: async () => {
-      if (!e) throw new Error("No retention query provided");
-      const s = await i.dryRun(e);
-      return {
-        sql: s.sql,
-        analysis: s.analysis,
-        retentionMetadata: s.retention
-      };
-    },
-    enabled: !!e && !l,
-    staleTime: u
-  });
-  return {
-    debugData: {
-      sql: n.data?.sql ?? null,
-      analysis: n.data?.analysis ?? null,
-      loading: n.isLoading,
-      error: n.error ?? null,
-      retentionMetadata: n.data?.retentionMetadata
-    },
-    refetch: () => n.refetch()
-  };
-}
-function T(e, r) {
-  return e ? ["cube", "explain", y(e), r?.analyze ?? !1] : ["cube", "explain", null, null];
-}
-function K(e) {
-  return typeof e == "object" && e !== null && "funnel" in e;
-}
-function Q(e) {
-  return typeof e == "object" && e !== null && "flow" in e;
-}
-function L(e) {
-  return typeof e == "object" && e !== null && "retention" in e;
-}
-function _(e, r = {}) {
-  const { skip: l = !1 } = r, { cubeApi: u } = d(), [i, n] = m(null), [t, s] = m(!1), o = h(() => e ? K(e) || Q(e) || L(e) ? e : w(e) : null, [e]), c = !!o && !l && t, a = p({
-    queryKey: T(o, i ?? void 0),
-    queryFn: async () => {
-      if (!o) throw new Error("No query provided");
-      return await u.explain(o, i ?? void 0);
-    },
-    enabled: c,
-    // EXPLAIN queries should never be cached - always fetch fresh data
-    // This ensures users see the latest execution plan after schema/index changes
-    staleTime: 0,
-    gcTime: 0,
-    // Don't refetch automatically - this is manually triggered
-    refetchOnWindowFocus: !1,
-    refetchOnReconnect: !1,
-    refetchOnMount: !1
-  }), f = g((q) => {
-    l || !o || (n(q ?? null), s(!0), t && a.refetch());
-  }, [l, o, t, a]), b = g(() => {
-    s(!1), n(null);
-  }, []);
-  return {
-    explainResult: a.data ?? null,
-    isLoading: a.isLoading || a.isFetching,
-    hasRun: t,
-    error: a.error ?? null,
-    runExplain: f,
-    clearExplain: b
-  };
-}
-const R = ["cube", "explain", "ai"];
-function Y(e = {}) {
-  const { features: r } = A(), l = r.enableAI ?? !0, u = F(), i = e.aiEndpoint ?? "/api/ai/explain/analyze", n = x({
-    mutationKey: R,
-    mutationFn: async ({ explainResult: o, query: c }) => {
-      if (!l)
-        throw new Error("AI features are disabled");
-      const a = await fetch(i, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        credentials: "include",
-        body: JSON.stringify({
-          explainResult: o,
-          query: c
-        })
-      });
-      if (!a.ok) {
-        const b = await a.json().catch(() => ({}));
-        throw new Error(
-          b.error || b.message || `AI analysis failed: ${a.status} ${a.statusText}`
-        );
-      }
-      return await a.json();
-    },
-    // No caching - each mutation is independent
-    gcTime: 0
-  }), t = g((o, c) => {
-    n.mutate({ explainResult: o, query: c });
-  }, [n]), s = g(() => {
-    n.reset(), u.removeQueries({ queryKey: R });
-  }, [n, u]);
-  return {
-    analysis: n.data ?? null,
-    isAnalyzing: n.isPending,
-    error: n.error ?? null,
-    analyze: t,
-    clearAnalysis: s
-  };
-}
-export {
-  M as a,
-  C as b,
-  _ as c,
-  T as d,
-  Y as e,
-  S as f,
-  z as g,
-  P as h,
-  O as u
-};
-//# sourceMappingURL=hooks-CdyIO1-j.js.map

package/dist/client/chunks/hooks-CdyIO1-j.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks-CdyIO1-j.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\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  /** 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\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    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 {\n        sql: result.sql,\n        analysis: result.analysis,\n      }\n    },\n    enabled: !!serverQuery && !skip,\n    staleTime,\n  })\n\n  const debugData: DebugDataEntry = {\n    sql: queryResult.data?.sql ?? null,\n    analysis: queryResult.data?.analysis ?? null,\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 {\n          sql: result.sql,\n          analysis: result.analysis,\n        }\n      },\n      enabled: !skip,\n      staleTime,\n    })),\n  })\n\n  // Transform results to DebugDataEntry array\n  const debugDataPerQuery: DebugDataEntry[] = queryResults.map((result) => ({\n    sql: result.data?.sql ?? null,\n    analysis: result.data?.analysis ?? null,\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\n/**\n * Debug data entry for funnel queries\n */\nexport interface FunnelDebugDataEntry extends DebugDataEntry {\n  /** Funnel-specific metadata from server */\n  funnelMetadata?: {\n    stepCount: number\n    steps: Array<{\n      index: number\n      name: string\n      timeToConvert?: string\n      cube?: string\n    }>\n    bindingKey: unknown\n    timeDimension: unknown\n  }\n}\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  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  const queryResult = useQuery({\n    queryKey: ['cube', 'dryRun', 'funnel', serverQuery ? stableStringify(serverQuery) : null] as const,\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No funnel query provided')\n      // Send the funnel query to dry-run endpoint\n      // The server will detect it's a funnel query and use dryRunFunnel\n      const result = await cubeApi.dryRun(serverQuery as CubeQuery)\n      return {\n        sql: result.sql,\n        analysis: result.analysis,\n        funnelMetadata: (result as unknown as { funnel?: unknown }).funnel,\n      }\n    },\n    enabled: !!serverQuery && !skip,\n    staleTime,\n  })\n\n  const debugData: FunnelDebugDataEntry = {\n    sql: queryResult.data?.sql ?? null,\n    analysis: queryResult.data?.analysis ?? null,\n    loading: queryResult.isLoading,\n    error: queryResult.error ?? null,\n    funnelMetadata: queryResult.data?.funnelMetadata as FunnelDebugDataEntry['funnelMetadata'],\n  }\n\n  return {\n    debugData,\n    refetch: () => queryResult.refetch(),\n  }\n}\n\n/**\n * Debug data entry for flow queries\n */\nexport interface FlowDebugDataEntry extends DebugDataEntry {\n  /** Flow-specific metadata from server */\n  flowMetadata?: {\n    stepsBefore: number\n    stepsAfter: number\n    bindingKey: unknown\n    timeDimension: unknown\n    eventDimension: string\n    startingStep: {\n      name: string\n      filter: unknown\n    }\n  }\n}\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  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  const queryResult = useQuery({\n    queryKey: ['cube', 'dryRun', 'flow', serverQuery ? stableStringify(serverQuery) : null] as const,\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No flow query provided')\n      // Send the flow query to dry-run endpoint\n      // The server will detect it's a flow query and use dryRunFlow\n      const result = await cubeApi.dryRun(serverQuery as CubeQuery)\n      return {\n        sql: result.sql,\n        analysis: result.analysis,\n        flowMetadata: (result as unknown as { flow?: unknown }).flow,\n      }\n    },\n    enabled: !!serverQuery && !skip,\n    staleTime,\n  })\n\n  const debugData: FlowDebugDataEntry = {\n    sql: queryResult.data?.sql ?? null,\n    analysis: queryResult.data?.analysis ?? null,\n    loading: queryResult.isLoading,\n    error: queryResult.error ?? null,\n    flowMetadata: queryResult.data?.flowMetadata as FlowDebugDataEntry['flowMetadata'],\n  }\n\n  return {\n    debugData,\n    refetch: () => queryResult.refetch(),\n  }\n}\n\n/**\n * Debug data entry for retention queries\n */\nexport interface RetentionDebugDataEntry extends DebugDataEntry {\n  /** Retention-specific metadata from server */\n  retentionMetadata?: {\n    totalCohorts: number\n    totalUsers: number\n    periods: number\n    cohortGranularity: string\n    periodGranularity: string\n    retentionType: string\n  }\n}\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  const { skip = false, staleTime = 5 * 60 * 1000 } = options\n  const { cubeApi } = useCubeApi()\n\n  const queryResult = useQuery({\n    queryKey: ['cube', 'dryRun', 'retention', serverQuery ? stableStringify(serverQuery) : null] as const,\n    queryFn: async () => {\n      if (!serverQuery) throw new Error('No retention query provided')\n      // Send the retention query to dry-run endpoint\n      // The server will detect it's a retention query and use dryRunRetention\n      const result = await cubeApi.dryRun(serverQuery as CubeQuery)\n      return {\n        sql: result.sql,\n        analysis: result.analysis,\n        retentionMetadata: (result as unknown as { retention?: unknown }).retention,\n      }\n    },\n    enabled: !!serverQuery && !skip,\n    staleTime,\n  })\n\n  const debugData: RetentionDebugDataEntry = {\n    sql: queryResult.data?.sql ?? null,\n    analysis: queryResult.data?.analysis ?? null,\n    loading: queryResult.isLoading,\n    error: queryResult.error ?? null,\n    retentionMetadata: queryResult.data?.retentionMetadata as RetentionDebugDataEntry['retentionMetadata'],\n  }\n\n  return {\n    debugData,\n    refetch: () => queryResult.refetch(),\n  }\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","useDryRunQuery","options","skip","staleTime","cubeApi","useCubeApi","serverQuery","useMemo","cleanQueryForServer","queryResult","useQuery","result","useMultiDryRunQueries","queries","serverQueries","q","queryResults","useQueries","debugDataPerQuery","isLoading","r","useDryRunQueries","isMultiQueryMode","queriesToFetch","useFunnelDryRunQuery","useFlowDryRunQuery","useRetentionDryRunQuery","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":";;;;AAqCO,SAASA,EACdC,GACoB;AACpB,SAAKA,IACE,CAAC,QAAQ,UAAUC,EAAgBD,CAAK,CAAC,IAD7B,CAAC,QAAQ,UAAU,IAAI;AAE5C;AA8BO,SAASE,EACdF,GACAG,IAAiC,IACX;AACtB,QAAM,EAAE,MAAAC,IAAO,IAAO,WAAAC,IAAY,MAAS,QAASF,GAC9C,EAAE,SAAAG,EAAA,IAAYC,EAAA,GAGdC,IAAcC,EAAQ,MACrBT,IACEU,EAAoBV,CAAK,IADb,MAElB,CAACA,CAAK,CAAC,GAEJW,IAAcC,EAAS;AAAA,IAC3B,UAAUb,EAAqBS,CAAW;AAAA,IAC1C,SAAS,YAAY;AACnB,UAAI,CAACA,EAAa,OAAM,IAAI,MAAM,mBAAmB;AACrD,YAAMK,IAAS,MAAMP,EAAQ,OAAOE,CAAW;AAC/C,aAAO;AAAA,QACL,KAAKK,EAAO;AAAA,QACZ,UAAUA,EAAO;AAAA,MAAA;AAAA,IAErB;AAAA,IACA,SAAS,CAAC,CAACL,KAAe,CAACJ;AAAA,IAC3B,WAAAC;AAAA,EAAA,CACD;AASD,SAAO;AAAA,IACL,WARgC;AAAA,MAChC,KAAKM,EAAY,MAAM,OAAO;AAAA,MAC9B,UAAUA,EAAY,MAAM,YAAY;AAAA,MACxC,SAASA,EAAY;AAAA,MACrB,OAAOA,EAAY,SAAS;AAAA,IAAA;AAAA,IAK5B,SAAS,MAAMA,EAAY,QAAA;AAAA,EAAQ;AAEvC;AAoCO,SAASG,EACdC,GACAZ,IAAwC,IACX;AAC7B,QAAM,EAAE,MAAAC,IAAO,IAAO,WAAAC,IAAY,MAAS,QAASF,GAC9C,EAAE,SAAAG,EAAA,IAAYC,EAAA,GAGdS,IAAgBP,EAAQ,MACrBM,EAAQ,IAAI,CAACE,MAAMP,EAAoBO,CAAC,CAAC,GAC/C,CAACF,CAAO,CAAC,GAGNG,IAAeC,EAAW;AAAA,IAC9B,SAASH,EAAc,IAAI,CAAChB,OAAW;AAAA,MACrC,UAAUD,EAAqBC,CAAK;AAAA,MACpC,SAAS,YAAY;AACnB,cAAMa,IAAS,MAAMP,EAAQ,OAAON,CAAK;AACzC,eAAO;AAAA,UACL,KAAKa,EAAO;AAAA,UACZ,UAAUA,EAAO;AAAA,QAAA;AAAA,MAErB;AAAA,MACA,SAAS,CAACT;AAAA,MACV,WAAAC;AAAA,IAAA,EACA;AAAA,EAAA,CACH,GAGKe,IAAsCF,EAAa,IAAI,CAACL,OAAY;AAAA,IACxE,KAAKA,EAAO,MAAM,OAAO;AAAA,IACzB,UAAUA,EAAO,MAAM,YAAY;AAAA,IACnC,SAASA,EAAO;AAAA,IAChB,OAAOA,EAAO,SAAS;AAAA,EAAA,EACvB,GAGIQ,IAAYH,EAAa,KAAK,CAACI,MAAMA,EAAE,SAAS;AAOtD,SAAO;AAAA,IACL,mBAAAF;AAAA,IACA,WAAAC;AAAA,IACA,YAPiB,MAAM;AACvB,MAAAH,EAAa,QAAQ,CAACI,MAAMA,EAAE,SAAS;AAAA,IACzC;AAAA,EAKE;AAEJ;AAiBO,SAASC,EAAiBpB,GAKD;AAC9B,QAAM,EAAE,SAAAY,GAAS,kBAAAS,GAAkB,MAAApB,IAAO,IAAO,WAAAC,MAAcF,GAGzDsB,IAAiBD,IAAmBT,IAAUA,EAAQ,MAAM,GAAG,CAAC;AAEtE,SAAOD,EAAsBW,GAAgB,EAAE,MAAArB,GAAM,WAAAC,GAAW;AAClE;AA4BO,SAASqB,EACdlB,GACAL,IAAiC,IACyB;AAC1D,QAAM,EAAE,MAAAC,IAAO,IAAO,WAAAC,IAAY,MAAS,QAASF,GAC9C,EAAE,SAAAG,EAAA,IAAYC,EAAA,GAEdI,IAAcC,EAAS;AAAA,IAC3B,UAAU,CAAC,QAAQ,UAAU,UAAUJ,IAAcP,EAAgBO,CAAW,IAAI,IAAI;AAAA,IACxF,SAAS,YAAY;AACnB,UAAI,CAACA,EAAa,OAAM,IAAI,MAAM,0BAA0B;AAG5D,YAAMK,IAAS,MAAMP,EAAQ,OAAOE,CAAwB;AAC5D,aAAO;AAAA,QACL,KAAKK,EAAO;AAAA,QACZ,UAAUA,EAAO;AAAA,QACjB,gBAAiBA,EAA2C;AAAA,MAAA;AAAA,IAEhE;AAAA,IACA,SAAS,CAAC,CAACL,KAAe,CAACJ;AAAA,IAC3B,WAAAC;AAAA,EAAA,CACD;AAUD,SAAO;AAAA,IACL,WATsC;AAAA,MACtC,KAAKM,EAAY,MAAM,OAAO;AAAA,MAC9B,UAAUA,EAAY,MAAM,YAAY;AAAA,MACxC,SAASA,EAAY;AAAA,MACrB,OAAOA,EAAY,SAAS;AAAA,MAC5B,gBAAgBA,EAAY,MAAM;AAAA,IAAA;AAAA,IAKlC,SAAS,MAAMA,EAAY,QAAA;AAAA,EAAQ;AAEvC;AA4BO,SAASgB,EACdnB,GACAL,IAAiC,IACuB;AACxD,QAAM,EAAE,MAAAC,IAAO,IAAO,WAAAC,IAAY,MAAS,QAASF,GAC9C,EAAE,SAAAG,EAAA,IAAYC,EAAA,GAEdI,IAAcC,EAAS;AAAA,IAC3B,UAAU,CAAC,QAAQ,UAAU,QAAQJ,IAAcP,EAAgBO,CAAW,IAAI,IAAI;AAAA,IACtF,SAAS,YAAY;AACnB,UAAI,CAACA,EAAa,OAAM,IAAI,MAAM,wBAAwB;AAG1D,YAAMK,IAAS,MAAMP,EAAQ,OAAOE,CAAwB;AAC5D,aAAO;AAAA,QACL,KAAKK,EAAO;AAAA,QACZ,UAAUA,EAAO;AAAA,QACjB,cAAeA,EAAyC;AAAA,MAAA;AAAA,IAE5D;AAAA,IACA,SAAS,CAAC,CAACL,KAAe,CAACJ;AAAA,IAC3B,WAAAC;AAAA,EAAA,CACD;AAUD,SAAO;AAAA,IACL,WAToC;AAAA,MACpC,KAAKM,EAAY,MAAM,OAAO;AAAA,MAC9B,UAAUA,EAAY,MAAM,YAAY;AAAA,MACxC,SAASA,EAAY;AAAA,MACrB,OAAOA,EAAY,SAAS;AAAA,MAC5B,cAAcA,EAAY,MAAM;AAAA,IAAA;AAAA,IAKhC,SAAS,MAAMA,EAAY,QAAA;AAAA,EAAQ;AAEvC;AAyBO,SAASiB,EACdpB,GACAL,IAAiC,IAC4B;AAC7D,QAAM,EAAE,MAAAC,IAAO,IAAO,WAAAC,IAAY,MAAS,QAASF,GAC9C,EAAE,SAAAG,EAAA,IAAYC,EAAA,GAEdI,IAAcC,EAAS;AAAA,IAC3B,UAAU,CAAC,QAAQ,UAAU,aAAaJ,IAAcP,EAAgBO,CAAW,IAAI,IAAI;AAAA,IAC3F,SAAS,YAAY;AACnB,UAAI,CAACA,EAAa,OAAM,IAAI,MAAM,6BAA6B;AAG/D,YAAMK,IAAS,MAAMP,EAAQ,OAAOE,CAAwB;AAC5D,aAAO;AAAA,QACL,KAAKK,EAAO;AAAA,QACZ,UAAUA,EAAO;AAAA,QACjB,mBAAoBA,EAA8C;AAAA,MAAA;AAAA,IAEtE;AAAA,IACA,SAAS,CAAC,CAACL,KAAe,CAACJ;AAAA,IAC3B,WAAAC;AAAA,EAAA,CACD;AAUD,SAAO;AAAA,IACL,WATyC;AAAA,MACzC,KAAKM,EAAY,MAAM,OAAO;AAAA,MAC9B,UAAUA,EAAY,MAAM,YAAY;AAAA,MACxC,SAASA,EAAY;AAAA,MACrB,OAAOA,EAAY,SAAS;AAAA,MAC5B,mBAAmBA,EAAY,MAAM;AAAA,IAAA;AAAA,IAKrC,SAAS,MAAMA,EAAY,QAAA;AAAA,EAAQ;AAEvC;AC5XO,SAASkB,EACd7B,GACAG,GACoB;AACpB,SAAKH,IACE,CAAC,QAAQ,WAAWC,EAAgBD,CAAK,GAAGG,GAAS,WAAW,EAAK,IADzD,CAAC,QAAQ,WAAW,MAAM,IAAI;AAEnD;AA+BA,SAAS2B,EAAc9B,GAA8C;AACnE,SAAO,OAAOA,KAAU,YAAYA,MAAU,QAAQ,YAAYA;AACpE;AAKA,SAAS+B,EAAY/B,GAA4C;AAC/D,SAAO,OAAOA,KAAU,YAAYA,MAAU,QAAQ,UAAUA;AAClE;AAKA,SAASgC,EAAiBhC,GAAiD;AACzE,SAAO,OAAOA,KAAU,YAAYA,MAAU,QAAQ,eAAeA;AACvE;AAwBO,SAASiC,EACdjC,GACAG,IAAkC,IACX;AACvB,QAAM,EAAE,MAAAC,IAAO,GAAA,IAAUD,GACnB,EAAE,SAAAG,EAAA,IAAYC,EAAA,GAGd,CAAC2B,GAAgBC,CAAiB,IAAIC,EAAgC,IAAI,GAC1E,CAACC,GAAcC,CAAe,IAAIF,EAAS,EAAK,GAIhD5B,IAAcC,EAAQ,MACrBT,IAED8B,EAAc9B,CAAK,KAAK+B,EAAY/B,CAAK,KAAKgC,EAAiBhC,CAAK,IAC/DA,IAGFU,EAAoBV,CAAkB,IAN1B,MAOlB,CAACA,CAAK,CAAC,GAMJuC,IAAe,CAAC,CAAC/B,KAAe,CAACJ,KAAQiC,GAEzC1B,IAAcC,EAAS;AAAA,IAC3B,UAAUiB,EAAsBrB,GAAa0B,KAAkB,MAAS;AAAA,IACxE,SAAS,YAAY;AACnB,UAAI,CAAC1B,EAAa,OAAM,IAAI,MAAM,mBAAmB;AAErD,aADe,MAAMF,EAAQ,QAAQE,GAAa0B,KAAkB,MAAS;AAAA,IAE/E;AAAA,IACA,SAASK;AAAA;AAAA;AAAA,IAGT,WAAW;AAAA,IACX,QAAQ;AAAA;AAAA,IAER,sBAAsB;AAAA,IACtB,oBAAoB;AAAA,IACpB,gBAAgB;AAAA,EAAA,CACjB,GAGKC,IAAaC,EAAY,CAACC,MAA0B;AACxD,IAAItC,KAAQ,CAACI,MACb2B,EAAkBO,KAAQ,IAAI,GAC9BJ,EAAgB,EAAI,GAEhBD,KACF1B,EAAY,QAAA;AAAA,EAEhB,GAAG,CAACP,GAAMI,GAAa6B,GAAc1B,CAAW,CAAC,GAG3CgC,IAAeF,EAAY,MAAM;AACrC,IAAAH,EAAgB,EAAK,GACrBH,EAAkB,IAAI;AAAA,EACxB,GAAG,CAAA,CAAE;AAEL,SAAO;AAAA,IACL,eAAexB,EAAY,QAAQ;AAAA,IACnC,WAAWA,EAAY,aAAaA,EAAY;AAAA,IAChD,QAAQ0B;AAAA,IACR,OAAO1B,EAAY,SAAS;AAAA,IAC5B,YAAA6B;AAAA,IACA,cAAAG;AAAA,EAAA;AAEJ;AClIO,MAAMC,IAAuB,CAAC,QAAQ,WAAW,IAAI;AAmCrD,SAASC,EAAa1C,IAA+B,IAAwB;AAClF,QAAM,EAAE,UAAA2C,EAAA,IAAaC,EAAA,GACfC,IAAWF,EAAS,YAAY,IAChCG,IAAcC,EAAA,GAIdC,IAAahD,EAAQ,cAAc,2BAEnCiD,IAAWC,EAAY;AAAA,IAC3B,aAAaT;AAAA,IACb,YAAY,OAAO,EAAE,eAAAU,GAAe,OAAAtD,QAA8D;AAEhG,UAAI,CAACgD;AACH,cAAM,IAAI,MAAM,0BAA0B;AAG5C,YAAMO,IAAW,MAAM,MAAMJ,GAAY;AAAA,QACvC,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,QAAA;AAAA,QAElB,aAAa;AAAA,QACb,MAAM,KAAK,UAAU;AAAA,UACnB,eAAAG;AAAA,UACA,OAAAtD;AAAA,QAAA,CACD;AAAA,MAAA,CACF;AAED,UAAI,CAACuD,EAAS,IAAI;AAChB,cAAMC,IAAY,MAAMD,EAAS,KAAA,EAAO,MAAM,OAAO,CAAA,EAAG;AACxD,cAAM,IAAI;AAAA,UACRC,EAAU,SACRA,EAAU,WACV,uBAAuBD,EAAS,MAAM,IAAIA,EAAS,UAAU;AAAA,QAAA;AAAA,MAEnE;AAGA,aADkC,MAAMA,EAAS,KAAA;AAAA,IAEnD;AAAA;AAAA,IAEA,QAAQ;AAAA,EAAA,CACT,GAEKE,IAAUhB,EAAY,CAACa,GAA8BtD,MAAmB;AAC5E,IAAAoD,EAAS,OAAO,EAAE,eAAAE,GAAe,OAAAtD,EAAA,CAAO;AAAA,EAC1C,GAAG,CAACoD,CAAQ,CAAC,GAEPM,IAAgBjB,EAAY,MAAM;AACtC,IAAAW,EAAS,MAAA,GAETH,EAAY,cAAc,EAAE,UAAUL,EAAA,CAAsB;AAAA,EAC9D,GAAG,CAACQ,GAAUH,CAAW,CAAC;AAE1B,SAAO;AAAA,IACL,UAAUG,EAAS,QAAQ;AAAA,IAC3B,aAAaA,EAAS;AAAA,IACtB,OAAOA,EAAS,SAAS;AAAA,IACzB,SAAAK;AAAA,IACA,eAAAC;AAAA,EAAA;AAEJ;"}