drizzle-cube 0.3.32 → 0.4.0

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

@@ -1,3 +1,4 @@
+import { default as React } from 'react';
 import { AnalysisResultsPanelProps } from './types';
 /**
  * AnalysisResultsPanel displays query results with chart/table toggle.
@@ -9,5 +10,5 @@ import { AnalysisResultsPanelProps } from './types';
  * - Stale results indicator
  * - Display limit control for tables
  */
-declare const AnalysisResultsPanel: import('react').NamedExoticComponent<AnalysisResultsPanelProps>;
+declare const AnalysisResultsPanel: React.NamedExoticComponent<AnalysisResultsPanelProps>;
 export default AnalysisResultsPanel;

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

@@ -446,7 +446,7 @@ export interface AnalysisResultsPanelProps {
     funnelServerQuery?: unknown;
     /**
      * Unified debug data for funnel queries (SQL, analysis, loading/error state).
-     * Contains the CTE-based SQL for the entire funnel.
+     * Uses common dry-run fields across all analysis modes.
      */
     funnelDebugData?: {
         sql: {
@@ -454,9 +454,13 @@ export interface AnalysisResultsPanelProps {
             params: unknown[];
         } | null;
         analysis: unknown;
+        mode?: 'regular' | 'comparison' | 'funnel' | 'flow' | 'retention' | null;
+        queryType?: string | null;
+        joinType?: string | null;
+        cubesUsed?: string[];
+        modeMetadata?: unknown;
         loading: boolean;
         error: Error | null;
-        funnelMetadata?: unknown;
     } | null;
     /**
      * The actual server flow query { flow: {...} } sent to the server.
@@ -465,7 +469,7 @@ export interface AnalysisResultsPanelProps {
     flowServerQuery?: unknown;
     /**
      * Unified debug data for flow queries (SQL, analysis, loading/error state).
-     * Contains the CTE-based SQL for the flow analysis.
+     * Uses common dry-run fields across all analysis modes.
      */
     flowDebugData?: {
         sql: {
@@ -473,9 +477,13 @@ export interface AnalysisResultsPanelProps {
             params: unknown[];
         } | null;
         analysis: unknown;
+        mode?: 'regular' | 'comparison' | 'funnel' | 'flow' | 'retention' | null;
+        queryType?: string | null;
+        joinType?: string | null;
+        cubesUsed?: string[];
+        modeMetadata?: unknown;
         loading: boolean;
         error: Error | null;
-        flowMetadata?: unknown;
     } | null;
     /**
      * In retention mode, the actual server query { retention: {...} } sent to the API.
@@ -484,7 +492,7 @@ export interface AnalysisResultsPanelProps {
     retentionServerQuery?: unknown;
     /**
      * Unified debug data for retention queries (SQL, analysis, loading/error state).
-     * Contains the CTE-based SQL for the retention analysis.
+     * Uses common dry-run fields across all analysis modes.
      */
     retentionDebugData?: {
         sql: {
@@ -492,9 +500,13 @@ export interface AnalysisResultsPanelProps {
             params: unknown[];
         } | null;
         analysis: unknown;
+        mode?: 'regular' | 'comparison' | 'funnel' | 'flow' | 'retention' | null;
+        queryType?: string | null;
+        joinType?: string | null;
+        cubesUsed?: string[];
+        modeMetadata?: unknown;
         loading: boolean;
         error: Error | null;
-        retentionMetadata?: unknown;
     } | null;
     /**
      * Retention chart data (cohort × period matrix) for rendering.

package/dist/client/components.js

@@ -1,4 +1,4 @@
-import { a as V, A, e as T, D as P, M as G, P as H } from "./chunks/DashboardEditModal-rLcmZpe_.js";
+import { a as V, A, e as T, D as P, M as G, P as H } from "./chunks/DashboardEditModal-Bv7e3Q7O.js";
 import { jsx as c, jsxs as a } from "react/jsx-runtime";
 import { useState as b, useEffect as o, useCallback as i } from "react";
 import { S as y, A as N } from "./chunks/charts-core-DAF1iT_h.js";

package/dist/client/hooks/queries/useDryRunQuery.d.ts

@@ -1,5 +1,6 @@
 import { CubeQuery } from '../../types';
 import { QueryAnalysis } from '../../components/AnalysisBuilder/types';
+export type DryRunMode = 'regular' | 'comparison' | 'funnel' | 'flow' | 'retention';
 /**
  * Debug data entry for a single query
  */
@@ -11,6 +12,16 @@ export interface DebugDataEntry {
     } | null;
     /** Query analysis (dimensions, measures, complexity, etc.) */
     analysis: QueryAnalysis | null;
+    /** Server-reported dry-run mode */
+    mode?: DryRunMode | null;
+    /** Query type label from server */
+    queryType?: string | null;
+    /** Join strategy label from server */
+    joinType?: string | null;
+    /** Referenced cubes from server */
+    cubesUsed?: string[];
+    /** Mode-specific metadata (replaces funnel/flow/retention split) */
+    modeMetadata?: unknown;
     /** Whether this entry is loading */
     loading: boolean;
     /** Error if fetch failed */
@@ -101,23 +112,7 @@ export declare function useDryRunQueries(options: {
     skip?: boolean;
     staleTime?: number;
 }): UseMultiDryRunQueriesResult;
-/**
- * Debug data entry for funnel queries
- */
-export interface FunnelDebugDataEntry extends DebugDataEntry {
-    /** Funnel-specific metadata from server */
-    funnelMetadata?: {
-        stepCount: number;
-        steps: Array<{
-            index: number;
-            name: string;
-            timeToConvert?: string;
-            cube?: string;
-        }>;
-        bindingKey: unknown;
-        timeDimension: unknown;
-    };
-}
+export type FunnelDebugDataEntry = DebugDataEntry;
 /**
  * TanStack Query hook for funnel query dry-run (debug) data
  *
@@ -130,23 +125,7 @@ export declare function useFunnelDryRunQuery(serverQuery: unknown | null, option
     debugData: FunnelDebugDataEntry;
     refetch: () => void;
 };
-/**
- * Debug data entry for flow queries
- */
-export interface FlowDebugDataEntry extends DebugDataEntry {
-    /** Flow-specific metadata from server */
-    flowMetadata?: {
-        stepsBefore: number;
-        stepsAfter: number;
-        bindingKey: unknown;
-        timeDimension: unknown;
-        eventDimension: string;
-        startingStep: {
-            name: string;
-            filter: unknown;
-        };
-    };
-}
+export type FlowDebugDataEntry = DebugDataEntry;
 /**
  * TanStack Query hook for flow query dry-run (debug) data
  *
@@ -159,20 +138,7 @@ export declare function useFlowDryRunQuery(serverQuery: unknown | null, options?
     debugData: FlowDebugDataEntry;
     refetch: () => void;
 };
-/**
- * Debug data entry for retention queries
- */
-export interface RetentionDebugDataEntry extends DebugDataEntry {
-    /** Retention-specific metadata from server */
-    retentionMetadata?: {
-        totalCohorts: number;
-        totalUsers: number;
-        periods: number;
-        cohortGranularity: string;
-        periodGranularity: string;
-        retentionType: string;
-    };
-}
+export type RetentionDebugDataEntry = DebugDataEntry;
 /**
  * TanStack Query hook for retention query dry-run (debug) data
  *

package/dist/client/hooks/useAnalysisBuilderHook.d.ts

@@ -112,43 +112,16 @@ export interface UseAnalysisBuilderResult {
     funnelExecutedQueries: CubeQuery[] | null;
     /** In funnel mode, the actual server query { funnel: {...} } sent to the API */
     funnelServerQuery: unknown | null;
-    /** In funnel mode, unified debug data (SQL, analysis, funnel metadata) */
-    funnelDebugData: {
-        sql: {
-            sql: string;
-            params: unknown[];
-        } | null;
-        analysis: unknown | null;
-        loading: boolean;
-        error: Error | null;
-        funnelMetadata?: unknown;
-    } | null;
+    /** In funnel mode, unified debug data (SQL, analysis, mode metadata) */
+    funnelDebugData: DebugDataEntry | null;
     /** In flow mode, the actual server query { flow: {...} } sent to the API */
     flowServerQuery: unknown | null;
-    /** In flow mode, unified debug data (SQL, analysis, flow metadata) */
-    flowDebugData: {
-        sql: {
-            sql: string;
-            params: unknown[];
-        } | null;
-        analysis: unknown | null;
-        loading: boolean;
-        error: Error | null;
-        flowMetadata?: unknown;
-    } | null;
+    /** In flow mode, unified debug data (SQL, analysis, mode metadata) */
+    flowDebugData: DebugDataEntry | null;
     /** In retention mode, the actual server query { retention: {...} } sent to the API */
     retentionServerQuery: unknown | null;
-    /** In retention mode, unified debug data (SQL, analysis, retention metadata) */
-    retentionDebugData: {
-        sql: {
-            sql: string;
-            params: unknown[];
-        } | null;
-        analysis: unknown | null;
-        loading: boolean;
-        error: Error | null;
-        retentionMetadata?: unknown;
-    } | null;
+    /** In retention mode, unified debug data (SQL, analysis, mode metadata) */
+    retentionDebugData: DebugDataEntry | null;
     /** In retention mode, the chart data (cohort × period matrix) */
     retentionChartData: import('../types/retention').RetentionChartData | null;
     /** In retention mode, validation result (errors explaining why query cannot be built) */

package/dist/client/hooks/useAnalysisQueryExecution.d.ts

@@ -1,4 +1,4 @@
-import { DebugDataEntry, FunnelDebugDataEntry, FlowDebugDataEntry, RetentionDebugDataEntry } from './queries';
+import { DebugDataEntry } from './queries';
 import { CubeQuery, MultiQueryConfig, FunnelBindingKey, QueryMergeStrategy, AnalysisType } from '../types';
 import { ExecutionStatus } from '../components/AnalysisBuilder/types';
 import { ServerFunnelQuery } from '../types/funnel';
@@ -93,9 +93,9 @@ export interface UseAnalysisQueryExecutionResult {
     funnelServerQuery: ServerFunnelQuery | null;
     /**
      * Debug data specifically for funnel mode
-     * Contains the funnel SQL and funnel-specific metadata
+     * Contains unified dry-run SQL and mode metadata.
      */
-    funnelDebugData: FunnelDebugDataEntry | null;
+    funnelDebugData: DebugDataEntry | null;
     /**
      * The server flow query being executed (when analysisType === 'flow')
      */
@@ -106,9 +106,9 @@ export interface UseAnalysisQueryExecutionResult {
     flowChartData: FlowChartData | null;
     /**
      * Debug data specifically for flow mode
-     * Contains the flow SQL and flow-specific metadata
+     * Contains unified dry-run SQL and mode metadata.
      */
-    flowDebugData: FlowDebugDataEntry | null;
+    flowDebugData: DebugDataEntry | null;
     /**
      * The server retention query being executed (when analysisType === 'retention')
      */
@@ -119,9 +119,9 @@ export interface UseAnalysisQueryExecutionResult {
     retentionChartData: RetentionChartData | null;
     /**
      * Debug data specifically for retention mode
-     * Contains the retention SQL and retention-specific metadata
+     * Contains unified dry-run SQL and mode metadata.
      */
-    retentionDebugData: RetentionDebugDataEntry | null;
+    retentionDebugData: DebugDataEntry | null;
     /**
      * Retention validation result (errors explaining why query cannot be built)
      */

package/dist/client/hooks.js

@@ -1,25 +1,197 @@
-import { e as s, c as a, u as r, u as y, p as n, A as o, r as t, d as Q, b as i, a as l, z as b, o as p } from "./chunks/useDirtyStateTracking-CTS_m9mg.js";
-import { j as x } from "./chunks/providers-D2xswCYu.js";
-import { d, b as F, u as R, e as C, c as f, a as m } from "./chunks/hooks-CdyIO1-j.js";
+import { t as p, B as h } from "./chunks/useDirtyStateTracking-CTS_m9mg.js";
+import { e as Y, c as $, u as B, u as H, p as J, A as V, r as W, d as X, b as G, a as Z, z as ee, o as ne } from "./chunks/useDirtyStateTracking-CTS_m9mg.js";
+import { f as m, g as E } from "./chunks/providers-D2xswCYu.js";
+import { j as te } from "./chunks/providers-D2xswCYu.js";
+import { a as w, i as F, u as A, j as q } from "./chunks/vendor-DfDLOfBe.js";
+import { useMemo as b, useState as g, useCallback as d } from "react";
+function R(e) {
+  return e ? ["cube", "dryRun", h(e)] : ["cube", "dryRun", null];
+}
+function M(e) {
+  return e.mode ? e.mode : e.queryType === "comparisonQuery" ? "comparison" : e.queryType === "funnelQuery" ? "funnel" : e.queryType === "flowQuery" ? "flow" : e.queryType === "retentionQuery" ? "retention" : e.queryType === "regularQuery" ? "regular" : null;
+}
+function x(e) {
+  const s = M(e);
+  return {
+    sql: e.sql ? { sql: e.sql.sql, params: e.sql.params || [] } : null,
+    analysis: e.analysis || null,
+    mode: s,
+    queryType: e.queryType || null,
+    joinType: e.joinType || null,
+    cubesUsed: e.cubesUsed || [],
+    modeMetadata: e.modeMetadata
+  };
+}
+function z(e, s = {}) {
+  const { skip: i = !1, staleTime: a = 300 * 1e3 } = s, { cubeApi: o } = m(), r = b(() => {
+    if (!e) return null;
+    const t = e;
+    return t.funnel || t.flow || t.retention ? e : p(e);
+  }, [e]), u = w({
+    queryKey: R(r),
+    queryFn: async () => {
+      if (!r) throw new Error("No query provided");
+      const t = await o.dryRun(r);
+      return x(t);
+    },
+    enabled: !!r && !i,
+    staleTime: a
+  });
+  return {
+    debugData: {
+      ...u.data || {
+        sql: null,
+        analysis: null,
+        mode: null,
+        queryType: null,
+        joinType: null,
+        cubesUsed: [],
+        modeMetadata: void 0
+      },
+      loading: u.isLoading,
+      error: u.error ?? null
+    },
+    refetch: () => u.refetch()
+  };
+}
+function j(e, s = {}) {
+  const { skip: i = !1, staleTime: a = 300 * 1e3 } = s, { cubeApi: o } = m(), r = b(() => e.map((n) => p(n)), [e]), u = F({
+    queries: r.map((n) => ({
+      queryKey: R(n),
+      queryFn: async () => {
+        const f = await o.dryRun(n);
+        return x(f);
+      },
+      enabled: !i,
+      staleTime: a
+    }))
+  }), l = u.map((n) => ({
+    ...n.data || {
+      sql: null,
+      analysis: null,
+      mode: null,
+      queryType: null,
+      joinType: null,
+      cubesUsed: [],
+      modeMetadata: void 0
+    },
+    loading: n.isLoading,
+    error: n.error ?? null
+  })), t = u.some((n) => n.isLoading);
+  return {
+    debugDataPerQuery: l,
+    isLoading: t,
+    refetchAll: () => {
+      u.forEach((n) => n.refetch());
+    }
+  };
+}
+function S(e) {
+  const { queries: s, isMultiQueryMode: i, skip: a = !1, staleTime: o } = e, r = i ? s : s.slice(0, 1);
+  return j(r, { skip: a, staleTime: o });
+}
+function v(e, s) {
+  return e ? ["cube", "explain", h(e), s?.analyze ?? !1] : ["cube", "explain", null, null];
+}
+function D(e) {
+  return typeof e == "object" && e !== null && "funnel" in e;
+}
+function C(e) {
+  return typeof e == "object" && e !== null && "flow" in e;
+}
+function K(e) {
+  return typeof e == "object" && e !== null && "retention" in e;
+}
+function P(e, s = {}) {
+  const { skip: i = !1 } = s, { cubeApi: a } = m(), [o, r] = g(null), [u, l] = g(!1), t = b(() => e ? D(e) || C(e) || K(e) ? e : p(e) : null, [e]), c = !!t && !i && u, n = w({
+    queryKey: v(t, o ?? void 0),
+    queryFn: async () => {
+      if (!t) throw new Error("No query provided");
+      return await a.explain(t, o ?? 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 = d((Q) => {
+    i || !t || (r(Q ?? null), l(!0), u && n.refetch());
+  }, [i, t, u, n]), y = d(() => {
+    l(!1), r(null);
+  }, []);
+  return {
+    explainResult: n.data ?? null,
+    isLoading: n.isLoading || n.isFetching,
+    hasRun: u,
+    error: n.error ?? null,
+    runExplain: f,
+    clearExplain: y
+  };
+}
+const T = ["cube", "explain", "ai"];
+function U(e = {}) {
+  const { features: s } = E(), i = s.enableAI ?? !0, a = A(), o = e.aiEndpoint ?? "/api/ai/explain/analyze", r = q({
+    mutationKey: T,
+    mutationFn: async ({ explainResult: t, query: c }) => {
+      if (!i)
+        throw new Error("AI features are disabled");
+      const n = await fetch(o, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        credentials: "include",
+        body: JSON.stringify({
+          explainResult: t,
+          query: c
+        })
+      });
+      if (!n.ok) {
+        const y = await n.json().catch(() => ({}));
+        throw new Error(
+          y.error || y.message || `AI analysis failed: ${n.status} ${n.statusText}`
+        );
+      }
+      return await n.json();
+    },
+    // No caching - each mutation is independent
+    gcTime: 0
+  }), u = d((t, c) => {
+    r.mutate({ explainResult: t, query: c });
+  }, [r]), l = d(() => {
+    r.reset(), a.removeQueries({ queryKey: T });
+  }, [r, a]);
+  return {
+    analysis: r.data ?? null,
+    isAnalyzing: r.isPending,
+    error: r.error ?? null,
+    analyze: u,
+    clearAnalysis: l
+  };
+}
 export {
-  d as createExplainQueryKey,
-  s as createFlowQueryKey,
-  a as createFunnelQueryKey,
-  r as useCubeLoadQuery,
-  x as useCubeMetaQuery,
-  y as useCubeQuery,
-  n as useDebounce,
-  o as useDirtyStateTracking,
-  F as useDryRunQueries,
-  R as useDryRunQuery,
-  C as useExplainAI,
-  f as useExplainQuery,
-  t as useFilterValues,
-  Q as useFlowQuery,
-  i as useFunnelQuery,
-  l as useMultiCubeLoadQuery,
-  m as useMultiDryRunQueries,
-  b as useResponsiveDashboard,
-  p as useRetentionQuery
+  v as createExplainQueryKey,
+  Y as createFlowQueryKey,
+  $ as createFunnelQueryKey,
+  B as useCubeLoadQuery,
+  te as useCubeMetaQuery,
+  H as useCubeQuery,
+  J as useDebounce,
+  V as useDirtyStateTracking,
+  S as useDryRunQueries,
+  z as useDryRunQuery,
+  U as useExplainAI,
+  P as useExplainQuery,
+  W as useFilterValues,
+  X as useFlowQuery,
+  G as useFunnelQuery,
+  Z as useMultiCubeLoadQuery,
+  j as useMultiDryRunQueries,
+  ee as useResponsiveDashboard,
+  ne as useRetentionQuery
 };
 //# sourceMappingURL=hooks.js.map

package/dist/client/hooks.js.map

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

package/dist/client/index.js

@@ -1,17 +1,17 @@
-import { g as d, a as y, A as g, C as m, f as b, e as C, D as h, h as f, c as p, b as D, M as x, d as S, P as Q, l as A, R as M, O as F, N as v, L as T, Q as I, T as E, G as L, F as P, I as B, U as w, E as R, H as K, V, J as k, K as N, S as j, W as U, X as z, x as G, o as O, v as W, q, s as H, t as _, n as J, r as X, m as $, p as Y, w as Z, u as ee, i as ae, j as se, k as te, B as re, z as ie, y as le } from "./chunks/DashboardEditModal-rLcmZpe_.js";
+import { g as d, a as y, A as g, C as m, f as b, e as C, D as h, h as f, c as p, b as D, M as x, d as S, P as Q, l as A, R as M, O as F, N as v, L as T, Q as I, T as E, G as L, F as P, I as B, U as w, E as R, H as K, V, J as k, K as N, S as j, W as U, X as z, x as G, o as O, v as W, q, s as H, t as _, n as J, r as X, m as $, p as Y, w as Z, u as ee, i as ae, j as se, k as te, B as re, z as ie, y as le } from "./chunks/DashboardEditModal-Bv7e3Q7O.js";
 import { jsx as e, jsxs as s } from "react/jsx-runtime";
 import { L as ne, u as ue } from "./chunks/charts-core-DAF1iT_h.js";
 import { L as de, g as ye, c as ge, b as me, i as be, p as Ce, a as he } from "./chunks/charts-loader-7pEaEz-f.js";
 import { b as t } from "./chunks/icons-DRreo6m8.js";
 import { D as pe, a as De, i as xe, c as Se, f as Qe, h as Ae, g as Me, r as Fe, e as ve, s as Te } from "./chunks/icons-DRreo6m8.js";
-import { E as Ee, a as Le, p as Pe, q as Be, m as we, l as Re, r as Ke, C as Ve, D as ke, o as Ne, B as je, n as Ue, w as ze, t as Ge, d as Oe, f as We, s as qe, e as He, i as _e, c as Je, h as Xe, g as $e, u as Ye, b as Ze, y as ea, A as aa, x as sa, k as ta, v as ra, z as ia, j as la } from "./chunks/analysis-builder-shared-ysrRYGiU.js";
+import { E as Ee, a as Le, p as Pe, q as Be, m as we, l as Re, r as Ke, C as Ve, D as ke, o as Ne, B as je, n as Ue, w as ze, t as Ge, d as Oe, f as We, s as qe, e as He, i as _e, c as Je, h as Xe, g as $e, u as Ye, b as Ze, y as ea, A as aa, x as sa, k as ta, v as ra, z as ia, j as la } from "./chunks/analysis-builder-shared-DsbdRCzz.js";
 import { h as na, a as ua, S as ca, e as da, d as ya, i as ga, f as ma, b as ba, g as Ca, u as ha, j as fa, c as pa, w as Da } from "./chunks/providers-D2xswCYu.js";
 import { u as Sa } from "./chunks/chart-bubble-D-auWIjP.js";
 import { c as Aa, f as Ma } from "./chunks/index-CApFCBF9.js";
 import { e as va, c as Ta, l as Ia, h as Ea, k as La, j as Pa, i as Ba, m as wa, g as Ra, f as Ka, u as Va, u as ka, d as Na, b as ja, a as Ua, v as za } from "./chunks/useDirtyStateTracking-CTS_m9mg.js";
 import { c as Oa, b as Wa, f as qa, g as Ha, a as _a, i as Ja, t as Xa } from "./chunks/funnel-utils-CyonoNeC.js";
 import { T as Ya, c as Za, g as es, a as as, i as ss, r as ts, s as rs, b as is, w as ls } from "./chunks/theme-Dp3hFed1.js";
-import { d as ns, b as us, u as cs, e as ds, c as ys, a as gs } from "./chunks/hooks-CdyIO1-j.js";
+import { createExplainQueryKey as ns, useDryRunQueries as us, useDryRunQuery as cs, useExplainAI as ds, useExplainQuery as ys, useMultiDryRunQueries as gs } from "./hooks.js";
 import { i as bs, a as Cs } from "./chunks/flow-utils-CjQZG5qq.js";
 import { h as fs } from "./chunks/syntaxHighlighting-DAT9C6Ss.js";
 function o() {

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

@@ -83,6 +83,25 @@ export interface JoinPathAnalysis {
     pathLength?: number;
     error?: string;
     visitedCubes?: string[];
+    selection?: {
+        strategy: 'shortest' | 'preferred' | 'fallbackShortest';
+        preferredCubes?: string[];
+        selectedRank?: number;
+        selectedScore?: number;
+        candidates?: Array<{
+            rank: number;
+            score: number;
+            usesPreferredJoin: boolean;
+            preferredCubesInPath: number;
+            usesProcessed: boolean;
+            scoreBreakdown: {
+                preferredJoinBonus: number;
+                preferredCubeBonus: number;
+                lengthPenalty: number;
+            };
+            path: JoinPathStep[];
+        }>;
+    };
 }
 /**
  * Reason why a cube requires a CTE
@@ -103,6 +122,7 @@ export interface PreAggregationAnalysis {
 }
 export interface QuerySummary {
     queryType: 'single_cube' | 'multi_cube_join' | 'multi_cube_cte';
+    measureStrategy?: 'simple' | 'keysDeduplication' | 'ctePreAggregateFallback' | 'multiFactMerge';
     joinCount: number;
     cteCount: number;
     hasPreAggregation: boolean;
@@ -116,6 +136,13 @@ export interface QueryAnalysis {
     preAggregations: PreAggregationAnalysis[];
     querySummary: QuerySummary;
     warnings?: string[];
+    planningTrace?: {
+        steps: Array<{
+            phase: 'cube_usage' | 'primary_cube_selection' | 'join_planning' | 'cte_planning' | 'measure_strategy' | 'warnings';
+            decision: string;
+            details?: Record<string, unknown>;
+        }>;
+    };
 }
 export interface ValidationResult {
     valid?: boolean;