drizzle-cube 0.5.3 → 0.5.5

package/dist/adapters/utils.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./utils-XPOzzMdY.cjs`);exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.s,exports.generateRequestId=e.c,exports.getDatabaseType=e.l,exports.handleBatchRequest=e.u,exports.handleDiscover=e.d,exports.handleDryRun=e.f,exports.handleLoad=e.p,exports.handleSuggest=e.m,exports.handleValidate=e.h,exports.normalizeQueryFields=e.g;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./utils-CIRA5_JO.cjs`);exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.s,exports.generateRequestId=e.c,exports.getDatabaseType=e.l,exports.handleBatchRequest=e.u,exports.handleDiscover=e.d,exports.handleDryRun=e.f,exports.handleLoad=e.p,exports.handleSuggest=e.m,exports.handleValidate=e.h,exports.normalizeQueryFields=e.g;

package/dist/adapters/utils.d.ts

@@ -1,5 +1,5 @@
 import { SemanticLayerCompiler, SemanticQuery, SecurityContext, CubeDiscoveryResult, QuerySuggestion, AIValidationResult } from '../server';
-import { MCPPromptResolver, MCPResourceResolver } from './mcp-transport';
+import { MCPPromptResolver, MCPResourceResolver, MCPInstructionsResolver } from './mcp-transport';
 /**
  * Calculate query complexity based on query structure
  */
@@ -297,6 +297,18 @@ export interface MCPOptions {
      * The live schema resource is always appended automatically.
      */
     resources?: MCPResourceResolver;
+    /**
+     * Override the `InitializeResult.instructions` string returned by the
+     * MCP `initialize` handshake. Per the MCP spec, this is the only
+     * server-authored guidance that clients are expected to surface to the
+     * model (it is typically merged into the system prompt).
+     *
+     * Pass a string to replace the defaults entirely, or a function to
+     * derive from / extend them. Use this to append project-specific
+     * guidance (e.g. cube semantics, naming conventions) without losing
+     * the built-in workflow rules.
+     */
+    instructions?: MCPInstructionsResolver;
     /**
      * OAuth 2.1 Protected Resource Metadata URL (RFC 9728).
      * When set, MCP endpoints require a Bearer token in the Authorization header.
@@ -347,11 +359,41 @@ export interface LoadRequest {
     query: SemanticQuery;
 }
 /**
- * Handle /discover endpoint - find relevant cubes based on topic/intent
+ * Discovery response shape returned by `handleDiscover`.
+ *
+ * In addition to the matched cubes, the response embeds the full query
+ * language reference and the date filtering decision tree. This is the
+ * primary delivery mechanism for query-construction guidance: clients
+ * cannot be relied upon to forward `prompts/*` content to the model, so
+ * we piggyback on `discover` (the mandated first call in our workflow)
+ * to guarantee the model sees the rules before it builds a query.
+ *
+ * The fields are stable strings — consumers may render or strip them as
+ * they see fit, but the MCP `discover` tool relies on them being present.
  */
-export declare function handleDiscover(semanticLayer: SemanticLayerCompiler, body: DiscoverRequest): Promise<{
+export interface DiscoverResponse {
+    /** Matched cubes (possibly empty) with measures, dimensions, and joins */
     cubes: CubeDiscoveryResult[];
-}>;
+    /**
+     * Complete TypeScript DSL reference for query construction. Source of
+     * truth for field naming, filter operators, time dimensions, and
+     * analysis modes (funnel/flow/retention).
+     */
+    queryLanguageReference: string;
+    /**
+     * Decision tree for date filtering vs time grouping. The single most
+     * common source of incorrect queries — read this whenever the user
+     * mentions a time period.
+     */
+    dateFilteringGuide: string;
+}
+/**
+ * Handle /discover endpoint - find relevant cubes based on topic/intent.
+ *
+ * Always returns `queryLanguageReference` and `dateFilteringGuide` alongside
+ * the matched cubes. See `DiscoverResponse` for the rationale.
+ */
+export declare function handleDiscover(semanticLayer: SemanticLayerCompiler, body: DiscoverRequest): Promise<DiscoverResponse>;
 /**
  * Handle /suggest endpoint - generate query from natural language
  */
@@ -359,7 +401,12 @@ export declare function handleSuggest(semanticLayer: SemanticLayerCompiler, body
 /**
  * Handle /validate endpoint - validate query with corrections
  */
-export declare function handleValidate(semanticLayer: SemanticLayerCompiler, body: ValidateRequest): Promise<AIValidationResult>;
+export declare function handleValidate(semanticLayer: SemanticLayerCompiler, body: ValidateRequest, securityContext?: SecurityContext): Promise<AIValidationResult & {
+    sql?: {
+        sql: string;
+        params?: any[];
+    };
+}>;
 /**
  * Normalize AI-generated query fields before validation/execution.
  * Fixes common LLM mistakes:

package/dist/adapters/utils.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-CTYvfZ3I.js";
+import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-hC7Z8V39.js";
 export { m as buildTransformedQuery, l as calculateQueryComplexity, f as formatCubeResponse, o as formatErrorResponse, e as formatMetaResponse, u as formatSqlResponse, p as formatSqlString, t as generateRequestId, s as getDatabaseType, h as handleBatchRequest, n as handleDiscover, r as handleDryRun, d as handleLoad, c as handleSuggest, a as handleValidate, i as normalizeQueryFields };

package/dist/client/charts/chartConfigs.d.ts

@@ -47,6 +47,35 @@ export interface DisplayOptionConfig {
     /** Step value for number inputs */
     step?: number;
 }
+/**
+ * Whether a chart type can be rendered with the current query shape.
+ * Each chart's .config.ts declares its own `isAvailable` to keep requirements
+ * co-located with the chart itself (rather than in a central switch).
+ */
+export interface ChartAvailability {
+    /** Whether the chart type can be used with the current selections */
+    available: boolean;
+    /** Translation key explaining why the chart is unavailable (for tooltip) */
+    reason?: string;
+}
+/**
+ * Snapshot of the current query shape passed to each chart's `isAvailable`.
+ */
+export interface ChartAvailabilityContext {
+    /** Number of measures selected */
+    measureCount: number;
+    /**
+     * Number of dimension-like breakdowns (regular dimensions + time dimensions).
+     * A time dimension can serve any role a regular dimension does (categories,
+     * axes, heatmap rows/columns, pie slices, etc.), so they are counted together.
+     */
+    dimensionCount: number;
+    /**
+     * Number of time dimensions specifically. Only needed by charts that *require*
+     * a time dimension (e.g. activityGrid).
+     */
+    timeDimensionCount: number;
+}
 /**
  * Configuration for which elements in a chart support clicking (for drill-down)
  */
@@ -91,6 +120,11 @@ export interface ChartTypeConfig {
     skipQuery?: boolean;
     /** Configuration for which elements support clicking (for drill-down) */
     clickableElements?: ClickableElementsConfig;
+    /**
+     * Whether this chart type can render with the given query shape.
+     * Omit to mean "always available".
+     */
+    isAvailable?: (ctx: ChartAvailabilityContext) => ChartAvailability;
 }
 /**
  * Registry of all chart type configurations

package/dist/client/charts.js

@@ -1,13 +1,13 @@
-import { C as e, D as t, E as n, S as r, T as i, _ as a, b as o, g as s, h as c, m as l, p as u, t as d, v as f, w as p, x as m, y as h } from "./chunks/chart-data-table-Qrt6EAno.js";
-import { t as g } from "./chunks/chart-funnel-C7pgktN5.js";
-import { a as _, i as v, n as y, o as b } from "./chunks/chart-activity-grid-CWT0gLv4.js";
-import { t as x } from "./chunks/chart-area-DDti9Qtp.js";
-import { i as S } from "./chunks/utils-BHZdKxua.js";
-import { t as C } from "./chunks/chart-line-RdZwtk27.js";
-import { t as w } from "./chunks/chart-bar-B3s9qDlh.js";
-import { t as T } from "./chunks/chart-pie-BvY4FY__.js";
-import { t as E } from "./chunks/chart-scatter-DwXnI0rr.js";
-import { t as D } from "./chunks/chart-radar-DjiiEAmc.js";
-import { t as O } from "./chunks/chart-radial-bar-lla_JEYu.js";
-import { t as k } from "./chunks/chart-tree-map-DJHoA26f.js";
+import { C as e, D as t, E as n, S as r, T as i, _ as a, b as o, g as s, h as c, m as l, p as u, t as d, v as f, w as p, x as m, y as h } from "./chunks/chart-data-table-BRXHT2H-.js";
+import { t as g } from "./chunks/chart-funnel-aQ7G_CqU.js";
+import { a as _, i as v, n as y, o as b } from "./chunks/chart-activity-grid-BnY-jaoa.js";
+import { t as x } from "./chunks/chart-area-G3OvLLK4.js";
+import { i as S } from "./chunks/utils-Ctl_cVNR.js";
+import { t as C } from "./chunks/chart-line-C0IHQteu.js";
+import { t as w } from "./chunks/chart-bar-MLIWiLrc.js";
+import { t as T } from "./chunks/chart-pie-DSIekr7p.js";
+import { t as E } from "./chunks/chart-scatter-Doeox4OP.js";
+import { t as D } from "./chunks/chart-radar-SGl62hK8.js";
+import { t as O } from "./chunks/chart-radial-bar-C42EykOa.js";
+import { t as k } from "./chunks/chart-tree-map-DvuSCIc8.js";
 export { y as CHART_COLORS, v as CHART_MARGINS, d as DataTable, g as FunnelChart, m as LazyChart, _ as NEGATIVE_COLOR, b as POSITIVE_COLOR, x as RechartsAreaChart, w as RechartsBarChart, C as RechartsLineChart, T as RechartsPieChart, D as RechartsRadarChart, O as RechartsRadialBarChart, E as RechartsScatterChart, k as RechartsTreeMapChart, u as clearChartConfigCache, S as formatChartData, r as getAvailableChartTypes, l as getChartConfigAsync, c as getChartConfigSync, e as getUnavailableChartTypes, s as isChartConfigLoaded, p as isChartTypeAvailable, i as isValidChartType, a as loadAllChartConfigs, n as preloadChart, f as preloadChartConfig, h as preloadChartConfigs, t as preloadCharts, o as useChartConfig };

package/dist/client/chunks/{DashboardEditModal-IU_0dgfC.js → DashboardEditModal-DayTXEH0.js}

@@ -1,13 +1,13 @@
-import { a as e, n as t, o as n, r, s as i, u as a } from "./vendor-CBD_Olr0.js";
-import { A as o, G as s, H as c, K as l, T as u, U as d, V as f, b as p, lt as m, q as h, x as g } from "./chart-data-table-Qrt6EAno.js";
-import { C as _, D as v, E as y, O as b, S as x, T as S, a as C, b as w, c as T, l as E, n as D, r as ee, s as te, t as O, w as k, y as ne } from "./useDebounce-DyJVREop.js";
-import { r as re } from "./chart-sankey-WwkZAhLy.js";
+import { a as e, n as t, o as n, r, s as i, u as a } from "./vendor-BcLQ6iVZ.js";
+import { A as o, G as s, H as c, K as l, T as u, U as d, V as f, b as p, lt as m, q as h, x as g } from "./chart-data-table-BRXHT2H-.js";
+import { C as _, D as v, E as y, O as b, S as x, T as S, a as C, b as w, c as T, l as E, n as D, r as ee, s as te, t as O, w as k, y as ne } from "./useDebounce-NEZQbfxN.js";
+import { r as re } from "./chart-sankey-DguImp0W.js";
 import { n as A, t as j } from "./providers-DX3Vw5kc.js";
-import { F as ie, M, k as N } from "./chart-activity-grid-CWT0gLv4.js";
-import { u as ae } from "./chart-area-DDti9Qtp.js";
+import { F as ie, M, k as N } from "./chart-activity-grid-BnY-jaoa.js";
+import { u as ae } from "./chart-area-G3OvLLK4.js";
 import { l as oe } from "./retention-YhT1Oohi.js";
-import { S as P, _ as se, a as F, b as ce, c as le, g as I, h as L, i as R, l as z, m as B, n as V, o as H, p as ue, r as de, s as fe, t as U, v as pe, y as W } from "./FieldSearchModal-BCWanpPX.js";
-import { t as G } from "./chart-markdown-CiGRZdJj.js";
+import { S as P, _ as se, a as F, b as ce, c as le, g as I, h as L, i as R, l as z, m as B, n as V, o as H, p as ue, r as de, s as fe, t as U, v as pe, y as W } from "./FieldSearchModal-B7Mr8UNT.js";
+import { t as G } from "./chart-markdown-BmgSMqPg.js";
 import { n as me, t as he } from "./useDirtyStateTracking-KAjwj1Ht.js";
 import ge, { Component as _e, Suspense as ve, createContext as ye, forwardRef as be, lazy as xe, startTransition as Se, useCallback as K, useContext as Ce, useEffect as q, useImperativeHandle as we, useMemo as J, useRef as Y, useState as X } from "react";
 import { Fragment as Z, jsx as Q, jsxs as $ } from "react/jsx-runtime";
@@ -2459,7 +2459,7 @@ function Zt({ position: e, currentPalette: t, onPaletteChange: n }) {
 }
 //#endregion
 //#region src/client/components/AnalysisBuilderLazy.tsx
-var Qt = xe(() => import("./analysis-builder-Dm6eD_AX.js")), $t = be((e, t) => /* @__PURE__ */ Q(ve, {
+var Qt = xe(() => import("./analysis-builder-lcGl099d.js")), $t = be((e, t) => /* @__PURE__ */ Q(ve, {
 	fallback: /* @__PURE__ */ Q("div", {
 		className: "dc:flex dc:items-center dc:justify-center dc:w-full dc:py-6",
 		children: /* @__PURE__ */ Q(ae, {})
@@ -6693,4 +6693,4 @@ function Ar({ isOpen: e, onClose: t, onSave: n, title: r, submitText: i, initial
 //#endregion
 export { at as A, Ct as C, ct as D, lt as E, Re as M, ke as N, ot as O, St as S, ut as T, At as _, cr as a, Nt as b, bt as c, Dt as d, Mt as f, Et as g, jt as h, Dr as i, Ue as j, st as k, gt as l, wt as m, kr as n, en as o, kt as p, Or as r, $t as s, Ar as t, Pt as u, Tt as v, ft as w, xt as x, Ot as y };
 
-//# sourceMappingURL=DashboardEditModal-IU_0dgfC.js.map
+//# sourceMappingURL=DashboardEditModal-DayTXEH0.js.map