drizzle-cube 0.10.0 → 0.10.1

package/dist/adapters/utils.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-Du_UZbn5.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.x,exports.generateRequestId=e.s,exports.getDatabaseType=e.c,exports.handleBatchRequest=e.l,exports.handleDiscover=e.p,exports.handleDryRun=e.u,exports.handleLoad=e.m,exports.handleSuggest=e.d,exports.handleValidate=e.f,exports.normalizeQueryFields=e.h;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-CvC1czqb.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.x,exports.generateRequestId=e.s,exports.getDatabaseType=e.c,exports.handleBatchRequest=e.l,exports.handleDiscover=e.p,exports.handleDryRun=e.u,exports.handleLoad=e.m,exports.handleSuggest=e.d,exports.handleValidate=e.f,exports.normalizeQueryFields=e.h;

package/dist/adapters/utils.js

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

package/dist/cjs/client/components/DashboardFilters/useCompactFilterBar.d.ts

@@ -1,4 +1,9 @@
 import { DashboardFilter } from '../../types.js';
+/**
+ * Find the dashboard filter the date control is bound to: the universal time
+ * filter when present, otherwise the first simple `inDateRange` filter.
+ */
+export declare function findDateControlFilter(filters: DashboardFilter[]): DashboardFilter | undefined;
 export declare function useCompactFilterBar(dashboardFilters: DashboardFilter[], onDashboardFiltersChange: (filters: DashboardFilter[]) => void): {
     localFilters: DashboardFilter[];
     showCustomDropdown: boolean;

package/dist/cjs/client/components/dashboardPortletCard/PortletCardHeader.d.ts

@@ -17,6 +17,8 @@ interface PortletCardHeaderProps {
     xlsExportAvailable: boolean;
     exportInProgress: boolean;
     showCacheBustIndicator: boolean;
+    /** Labels of mapped dashboard date filters that cannot narrow this portlet */
+    unreachableDateFilterLabels?: string[];
     icons: CardIcons;
     onRefresh: (options?: {
         bustCache?: boolean;

package/dist/cjs/client/utils/filterUtils.d.ts

@@ -43,6 +43,21 @@ export declare function shouldIncludeFilter(filter: Filter): boolean;
  * @returns Array of filters that should be applied to the portlet
  */
 export declare function getApplicableDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): Filter[];
+/**
+ * Whether a dashboard filter is applied to a portlet as a regular filter.
+ *
+ * Non-universal filters always are. A universal time filter normally reaches a
+ * portlet through its timeDimensions, but when the portlet's mapping pins it to
+ * a field (a member override) it becomes a plain inDateRange filter on that
+ * field - which is how a KPI or breakdown without time dimensions is narrowed
+ * by the dashboard date control.
+ */
+export declare function isAppliedAsRegularFilter(dashboardFilter: DashboardFilter, filterMapping: DashboardFilterMapping | undefined): boolean;
+/**
+ * Dashboard filters that reach a portlet through its `filters` (as opposed to
+ * universal time filters applied to its timeDimensions).
+ */
+export declare function getRegularDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): DashboardFilter[] | undefined;
 /**
  * Filter format for merge operation:
  * - 'server': Returns {and: [...]} or {or: [...]} format (for API queries)
@@ -94,6 +109,21 @@ type TimeDimension = {
     granularity?: string;
     dateRange?: string[] | string;
 };
+/**
+ * Universal time filters mapped to a portlet that apply through its
+ * timeDimensions - i.e. mapped without a member override.
+ */
+export declare function getTimeDimensionUniversalFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): DashboardFilter[];
+/**
+ * Universal time filters mapped to a portlet that cannot narrow it: they apply
+ * only through timeDimensions, but some query in the portlet has none. Such a
+ * portlet would otherwise silently render all-time values while the dashboard
+ * date control shows a narrower range.
+ *
+ * Only plain and multi-query portlets are checked; funnel, flow and retention
+ * queries handle dashboard time filters separately.
+ */
+export declare function getUnreachableUniversalTimeFilters(query: string, dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): DashboardFilter[];
 /**
  * Apply universal time filters to a portlet's timeDimensions
  * Universal time filters apply their dateRange to ALL time dimensions in the portlet

package/dist/cjs/client/utils/joinReachability.d.ts

@@ -24,4 +24,5 @@ export interface ReachableDimensionGroup {
  */
 export declare function getReachableDimensionOptions(meta: CubeMeta | null, portlet: PortletConfig, options?: {
     sameTypeAs?: string;
+    type?: string;
 }): ReachableDimensionGroup[];

package/dist/cjs/server/ai/query-schema.d.ts

@@ -44,8 +44,13 @@ export declare const QUERY_PARAMS_SCHEMA: {
                 };
                 readonly values: {
                     readonly type: "array";
-                    readonly items: {};
-                    readonly description: "Filter values. Omit for set/notSet/isEmpty/isNotEmpty. inDateRange: [\"last 3 months\"] (one relative string) or [\"YYYY-MM-DD\", \"YYYY-MM-DD\"].";
+                    readonly items: {
+                        readonly type: readonly ["string", "number", "boolean"];
+                    };
+                    readonly description: "Filter values. Omit for set/notSet/isEmpty/isNotEmpty. inDateRange accepts ONLY a flat two-date array (strings or finite numeric timestamps): [\"2024-01-01\", \"2024-03-31\"], or a one-item array holding one relative expression or one date (that whole day): [\"last 3 months\"], [\"2024-01-15\"]. Never nest the two-date array.";
+                };
+                readonly dateRange: {
+                    readonly description: "inDateRange only: alternative to values. A supported relative string, one absolute date string, or flat two-date array. Prefer values: [] when using dateRange; if values are also given they must hold the same range.";
                 };
             };
             readonly required: readonly ["member", "operator"];

package/dist/cjs/server/builders/date-time-builder.d.ts

@@ -11,7 +11,7 @@ export declare class DateTimeBuilder {
     /**
      * Build date range condition for time dimensions
      */
-    buildDateRangeCondition(fieldExpr: AnyColumn | SQL, dateRange: string | string[]): SQL | null;
+    buildDateRangeCondition(fieldExpr: AnyColumn | SQL, dateRange: unknown): SQL | null;
     private rangeBetween;
     /** Shift a normalized end value to end-of-day when its source was a date-only string. */
     private endOfDayValue;

package/dist/cjs/server/builders/date-time-helpers.d.ts

@@ -17,6 +17,8 @@ export declare function dateToEngineValue(databaseAdapter: DatabaseAdapter, date
 export declare function engineValueToDate(databaseAdapter: DatabaseAdapter, value: string | number): Date;
 /** Detect a date-only string (YYYY-MM-DD). */
 export declare function isDateOnlyString(value: unknown): value is string;
+/** Parse a string/number/Date into a validated Date, or null if invalid. */
+export declare function toValidDate(value: unknown): Date | null;
 /**
  * Normalize a date value to the engine's wire format, or null when falsy or
  * unparseable.

package/dist/cjs/server/builders/filter-builder.d.ts

@@ -9,7 +9,7 @@ export declare class FilterBuilder {
     /**
      * Build filter condition using Drizzle operators
      */
-    buildFilterCondition(fieldExpr: AnyColumn | SQL, operator: FilterOperator, values: any[], field?: any, dateRange?: string | string[]): SQL | null;
+    buildFilterCondition(fieldExpr: AnyColumn | SQL, operator: FilterOperator, values: any[], field?: any, dateRangeInput?: string | string[] | null): SQL | null;
     /**
      * Build a logical filter (AND/OR) - used by executor for cache preloading
      * This handles nested filter structures and builds combined SQL

package/dist/cjs/server/builders/in-date-range-validation.d.ts

@@ -0,0 +1,25 @@
+export type DateRangeReason = 'missing' | 'shape' | 'invalidDate' | 'invalidRelative' | 'reverseOrder' | 'conflict';
+export type DateRangeValidation = {
+    valid: true;
+} | {
+    valid: false;
+    reason: DateRangeReason;
+    input: 'values' | 'dateRange';
+    value?: string;
+};
+/** Validate an exact absolute tuple without accepting JS Date rollover or nested arrays. */
+export declare function validateDateTuple(value: unknown): DateRangeReason | null;
+/**
+ * Validate a standalone date range (`filter.dateRange` or `timeDimensions[].dateRange`):
+ * a relative expression, one absolute day, or a flat `[start, end]` pair.
+ */
+export declare function validateDateRangeInput(dateRange: unknown): DateRangeValidation;
+export declare function validateInDateRange(values: unknown, dateRange?: unknown): DateRangeValidation;
+/**
+ * Diagnostic for SQL builders, which only see a field expression. Queries are
+ * validated before they reach the builders, so this only surfaces for callers
+ * that bypass validation.
+ */
+export declare function dateRangeInputDiagnostic(result: DateRangeValidation): string;
+export declare function timeDimensionDateRangeDiagnostic(member: string, result: DateRangeValidation): string;
+export declare function inDateRangeDiagnostic(member: string, result: DateRangeValidation): string;

package/dist/client/charts.js

@@ -1,14 +1,14 @@
-import { dt as e, ft as t, gt as n, ht as r, lt as i, mt as a, pt as o, t as s, ut as c } from "./chunks/chart-data-table-BdMo3zVh.js";
-import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-DGazwi4C.js";
-import { t as p } from "./chunks/chart-funnel-BRyZS6ie.js";
-import { a as m, i as h, n as g, o as _, r as v, s as y, t as b } from "./chunks/charts-loader-BTI0UPK4.js";
-import { t as x } from "./chunks/chart-area-zyLGD-ym.js";
+import { dt as e, ft as t, gt as n, ht as r, lt as i, mt as a, pt as o, t as s, ut as c } from "./chunks/chart-data-table-zSjYEy0r.js";
+import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-Bbc58UJD.js";
+import { t as p } from "./chunks/chart-funnel-CuOSCsbt.js";
+import { a as m, i as h, n as g, o as _, r as v, s as y, t as b } from "./chunks/charts-loader-Bz9yHkW1.js";
+import { t as x } from "./chunks/chart-area-9uCXIvMN.js";
 import { i as S } from "./chunks/utils-CToHkuhU.js";
-import { t as C } from "./chunks/chart-bar-DMCBq8qJ.js";
-import { t as w } from "./chunks/chart-line-IEgiF8Nv.js";
-import { t as T } from "./chunks/chart-pie-BEB2sCXF.js";
-import { t as E } from "./chunks/chart-scatter-CSWF6-lx.js";
-import { t as D } from "./chunks/chart-radar-BbSbXKbP.js";
-import { t as O } from "./chunks/chart-radial-bar-CNYD7tkM.js";
-import { t as k } from "./chunks/chart-tree-map-BiXB7EiM.js";
+import { t as C } from "./chunks/chart-bar-C5a1T9Ce.js";
+import { t as w } from "./chunks/chart-line-CjW9Yo03.js";
+import { t as T } from "./chunks/chart-pie-BTb5nKd7.js";
+import { t as E } from "./chunks/chart-scatter-Bdj95OeV.js";
+import { t as D } from "./chunks/chart-radar-8384sPlX.js";
+import { t as O } from "./chunks/chart-radial-bar-CuBmmOTU.js";
+import { t as k } from "./chunks/chart-tree-map-CtJADX87.js";
 export { d as CHART_COLORS, u as CHART_MARGINS, s as DataTable, p as FunnelChart, b as LazyChart, f as NEGATIVE_COLOR, l as POSITIVE_COLOR, x as RechartsAreaChart, C as RechartsBarChart, w as RechartsLineChart, T as RechartsPieChart, D as RechartsRadarChart, O as RechartsRadialBarChart, E as RechartsScatterChart, k as RechartsTreeMapChart, i as clearChartConfigCache, S as formatChartData, g as getAvailableChartTypes, c as getChartConfigAsync, e as getChartConfigSync, v as getUnavailableChartTypes, t as isChartConfigLoaded, h as isChartTypeAvailable, m as isValidChartType, o as loadAllChartConfigs, _ as preloadChart, a as preloadChartConfig, r as preloadChartConfigs, y as preloadCharts, n as useChartConfig };