drizzle-cube 0.5.0 → 0.5.3

package/dist/client/chunks/{useExplainAI-BKGmejIj.js → useExplainAI-CxSkjocM.js}

@@ -1,6 +1,6 @@
-import { c as e, l as t } from "./vendor-ClXpIiea.js";
-import { V as n, Z as r, et as i, lt as a } from "./chart-data-table-C3Xh9jwL.js";
-import { S as o, x as s } from "./useDebounce-CfmUMFau.js";
+import { c as e, l as t } from "./vendor-CBD_Olr0.js";
+import { V as n, Z as r, et as i, lt as a } from "./chart-data-table-Qrt6EAno.js";
+import { S as o, x as s } from "./useDebounce-DyJVREop.js";
 import { useCallback as c, useMemo as l, useState as u } from "react";
 //#region src/client/hooks/queries/useDryRunQuery.ts
 function d(e) {
@@ -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-BKGmejIj.js.map
+//# sourceMappingURL=useExplainAI-CxSkjocM.js.map

package/dist/client/chunks/{useExplainAI-BKGmejIj.js.map → useExplainAI-CxSkjocM.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useExplainAI-BKGmejIj.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-CxSkjocM.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-BldkcRHv.js → utils-BHZdKxua.js}

@@ -1,4 +1,4 @@
-import { P as e } from "./chart-data-table-C3Xh9jwL.js";
+import { P as e } from "./chart-data-table-Qrt6EAno.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-BldkcRHv.js.map
+//# sourceMappingURL=utils-BHZdKxua.js.map

package/dist/client/chunks/{utils-BldkcRHv.js.map → utils-BHZdKxua.js.map}

@@ -1 +1 @@
-{"version":3,"file":"utils-BldkcRHv.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"}
+{"version":3,"file":"utils-BHZdKxua.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-ClXpIiea.js → vendor-CBD_Olr0.js}

@@ -1,5 +1,5 @@
 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-C3Xh9jwL.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-Qrt6EAno.js";
 import * as y from "react";
 import b from "react";
 //#region node_modules/react-intersection-observer/dist/index.mjs
@@ -781,28 +781,28 @@ var ie = /* @__PURE__ */ e(((e, t) => {
 					index: 1
 				};
 				for (u = 0; u < 3; u += 1) i[u] = u;
-				for (f = 0, m = 2 ** 2, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= (p > 0 ? 1 : 0) * h, h <<= 1;
+				for (f = 0, m = 2 ** 2, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= +(p > 0) * h, h <<= 1;
 				switch (f) {
 					case 0:
-						for (f = 0, m = 2 ** 8, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= (p > 0 ? 1 : 0) * h, h <<= 1;
+						for (f = 0, m = 2 ** 8, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= +(p > 0) * h, h <<= 1;
 						g = e(f);
 						break;
 					case 1:
-						for (f = 0, m = 2 ** 16, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= (p > 0 ? 1 : 0) * h, h <<= 1;
+						for (f = 0, m = 2 ** 16, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= +(p > 0) * h, h <<= 1;
 						g = e(f);
 						break;
 					case 2: return "";
 				}
 				for (i[3] = g, d = g, l.push(g);;) {
 					if (_.index > t) return "";
-					for (f = 0, m = 2 ** s, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= (p > 0 ? 1 : 0) * h, h <<= 1;
+					for (f = 0, m = 2 ** s, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= +(p > 0) * h, h <<= 1;
 					switch (g = f) {
 						case 0:
-							for (f = 0, m = 2 ** 8, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= (p > 0 ? 1 : 0) * h, h <<= 1;
+							for (f = 0, m = 2 ** 8, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= +(p > 0) * h, h <<= 1;
 							i[o++] = e(f), g = o - 1, a--;
 							break;
 						case 1:
-							for (f = 0, m = 2 ** 16, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= (p > 0 ? 1 : 0) * h, h <<= 1;
+							for (f = 0, m = 2 ** 16, h = 1; h != m;) p = _.val & _.position, _.position >>= 1, _.position == 0 && (_.position = n, _.val = r(_.index++)), f |= +(p > 0) * h, h <<= 1;
 							i[o++] = e(f), g = o - 1, a--;
 							break;
 						case 2: return l.join("");
@@ -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-ClXpIiea.js.map
+//# sourceMappingURL=vendor-CBD_Olr0.js.map