drizzle-cube 0.10.0 → 0.11.0

package/dist/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"];
@@ -71,7 +76,7 @@ export declare const QUERY_PARAMS_SCHEMA: {
                 };
                 readonly fillMissingDates: {
                     readonly type: "boolean";
-                    readonly description: "Fill gaps in time series with fillMissingDatesValue (default: true). Requires granularity + dateRange.";
+                    readonly description: "Fill gaps in time series with fillMissingDatesValue. Default: off (observed rows only) unless the cube time dimension enables it. Requires granularity + dateRange.";
                 };
                 readonly compareDateRange: {
                     readonly type: "array";

package/dist/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/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/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/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/server/chartConfigHelpers-BhME7ow_.cjs

@@ -0,0 +1 @@
+function e({measureCount:e,dimensionCount:t}){return e<1?{available:!1,reason:`chart.availability.requiresMeasure`}:t<1?{available:!1,reason:`chart.availability.requiresDimension`}:{available:!0}}function t({measureCount:e}){return e<1?{available:!1,reason:`chart.availability.requiresMeasure`}:{available:!0}}var n={key:`target`,label:`chart.option.target.label`,type:`string`,placeholder:`e.g., 100 or 50,75 for spread`,description:`chart.option.target.description`},r={key:`connectNulls`,label:`chart.option.connectNulls.label`,type:`boolean`,defaultValue:!1,description:`chart.option.connectNulls.description`},i={key:`fillMissingDates`,label:`chart.option.fillMissingDates.label`,type:`buttonGroup`,defaultValue:`auto`,options:[{value:`auto`,label:`chart.option.fillMissingDates.auto`},{value:!0,label:`chart.option.fillMissingDates.on`},{value:!1,label:`chart.option.fillMissingDates.off`}],description:`chart.option.fillMissingDates.description`},a={key:`leftYAxisFormat`,label:`chart.option.leftYAxisFormat.label`,type:`axisFormat`,description:`chart.option.leftYAxisFormat.description`},o={key:`rightYAxisFormat`,label:`chart.option.rightYAxisFormat.label`,type:`axisFormat`,description:`chart.option.rightYAxisFormat.description`};function s(e=`chart.option.valueFormat.description`){return{key:`leftYAxisFormat`,label:`chart.option.valueFormat.label`,type:`axisFormat`,description:e}}function c(e){return{key:`stackType`,label:`chart.option.stacking.label`,type:`select`,defaultValue:`none`,options:[{value:`none`,label:`chart.option.accentBorder.none`},{value:`normal`,label:`chart.option.stacking.stacked`},{value:`percent`,label:`chart.option.stacking.percent`}],description:e}}var l={key:`layout`,label:`chart.option.kpiLayout.label`,type:`buttonGroup`,defaultValue:`auto`,options:[{value:`auto`,label:`chart.option.kpiLayout.auto`},{value:`compact`,label:`chart.option.kpiLayout.compact`}],description:`chart.option.kpiLayout.description`},u={key:`showSummary`,label:`chart.option.showSummary.label`,type:`boolean`,defaultValue:!1,description:`chart.option.showSummary.description`};function d(e=!0){return{key:`showPoints`,label:`chart.option.showPoints.label`,type:`boolean`,defaultValue:e,description:`chart.option.showPoints.description`}}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return c}});

package/dist/server/{chartConfigHelpers-BsnbxA2c.js → chartConfigHelpers-BsviVhEw.js}

@@ -27,17 +27,37 @@ var n = {
 	defaultValue: !1,
 	description: "chart.option.connectNulls.description"
 }, i = {
+	key: "fillMissingDates",
+	label: "chart.option.fillMissingDates.label",
+	type: "buttonGroup",
+	defaultValue: "auto",
+	options: [
+		{
+			value: "auto",
+			label: "chart.option.fillMissingDates.auto"
+		},
+		{
+			value: !0,
+			label: "chart.option.fillMissingDates.on"
+		},
+		{
+			value: !1,
+			label: "chart.option.fillMissingDates.off"
+		}
+	],
+	description: "chart.option.fillMissingDates.description"
+}, a = {
 	key: "leftYAxisFormat",
 	label: "chart.option.leftYAxisFormat.label",
 	type: "axisFormat",
 	description: "chart.option.leftYAxisFormat.description"
-}, a = {
+}, o = {
 	key: "rightYAxisFormat",
 	label: "chart.option.rightYAxisFormat.label",
 	type: "axisFormat",
 	description: "chart.option.rightYAxisFormat.description"
 };
-function o(e = "chart.option.valueFormat.description") {
+function s(e = "chart.option.valueFormat.description") {
 	return {
 		key: "leftYAxisFormat",
 		label: "chart.option.valueFormat.label",
@@ -45,7 +65,7 @@ function o(e = "chart.option.valueFormat.description") {
 		description: e
 	};
 }
-function s(e) {
+function c(e) {
 	return {
 		key: "stackType",
 		label: "chart.option.stacking.label",
@@ -68,7 +88,7 @@ function s(e) {
 		description: e
 	};
 }
-var c = {
+var l = {
 	key: "layout",
 	label: "chart.option.kpiLayout.label",
 	type: "buttonGroup",
@@ -81,14 +101,14 @@ var c = {
 		label: "chart.option.kpiLayout.compact"
 	}],
 	description: "chart.option.kpiLayout.description"
-}, l = {
+}, u = {
 	key: "showSummary",
 	label: "chart.option.showSummary.label",
 	type: "boolean",
 	defaultValue: !1,
 	description: "chart.option.showSummary.description"
 };
-function u(e = !0) {
+function d(e = !0) {
 	return {
 		key: "showPoints",
 		label: "chart.option.showPoints.label",
@@ -98,4 +118,4 @@ function u(e = !0) {
 	};
 }
 //#endregion
-export { e as a, l as c, o as d, t as i, s as l, c as n, a as o, i as r, u as s, r as t, n as u };
+export { t as a, d as c, n as d, s as f, a as i, u as l, i as n, e as o, l as r, o as s, r as t, c as u };

package/dist/server/execution/result-post-processor.d.ts

@@ -1,4 +1,4 @@
-import { SemanticQuery } from '../types/index.js';
+import { Cube, SemanticQuery } from '../types/index.js';
 import { DatabaseAdapter } from '../adapters/base-adapter.js';
 /**
  * Normalise time-dimension values in result rows and apply gap filling.
@@ -6,5 +6,7 @@ import { DatabaseAdapter } from '../adapters/base-adapter.js';
  * @param data Raw rows from the database executor
  * @param query The semantic query (for timeDimensions + measures)
  * @param databaseAdapter Adapter used to convert engine-specific date results
+ * @param cubes Cube definitions, for each time dimension's `fillMissingDates`
+ * @param fillByDefault Gap-fill time dimensions neither the query nor the cube configures
  */
-export declare function postProcessResultRows(data: unknown, query: SemanticQuery, databaseAdapter: DatabaseAdapter): Record<string, unknown>[];
+export declare function postProcessResultRows(data: unknown, query: SemanticQuery, databaseAdapter: DatabaseAdapter, cubes?: Map<string, Cube>, fillByDefault?: boolean): Record<string, unknown>[];

package/dist/server/executor.d.ts

@@ -93,6 +93,8 @@ export declare class QueryExecutor {
      * @param cacheKey - When provided (and a cache provider is configured), the
      *   fresh result is written to the cache. Pass `undefined` to skip caching
      *   (e.g. comparison period sub-queries cache at the comparison level).
+     * @param fillByDefault - Gap-fill time dimensions that neither the query nor
+     *   the cube configures. Only comparison period sub-queries pass `true`.
      */
     private executeStandardQuery;
     /**

package/dist/server/gap-filler.d.ts

@@ -1,48 +1,13 @@
+import { Cube } from './types/cube.js';
 import { SemanticQuery } from './types/query.js';
-import { TimeGranularity } from './types/core.js';
+export { generateTimeBuckets, fillTimeSeriesGaps, parseDateRange, MAX_GAP_FILL_BUCKETS, type GapFillerConfig } from '../shared/gap-filler.js';
 /**
- * Maximum number of time buckets gap filling will generate. Beyond this, gap
- * filling is skipped entirely (data is returned unmodified) to avoid both
- * runaway memory use and silent truncation of real rows.
- */
-export declare const MAX_GAP_FILL_BUCKETS = 10000;
-export interface GapFillerConfig {
-    /** The time dimension key (e.g., 'Sales.date') */
-    timeDimensionKey: string;
-    /** Time granularity for bucket generation */
-    granularity: TimeGranularity;
-    /** Date range [start, end] */
-    dateRange: [Date, Date];
-    /** Value to fill for missing measures (default: 0) */
-    fillValue: number | null;
-    /** List of measure keys in the data */
-    measures: string[];
-    /** List of dimension keys in the data (excluding time dimensions) */
-    dimensions: string[];
-}
-/**
- * Generate all time buckets for a given date range and granularity
- */
-export declare function generateTimeBuckets(startDate: Date, endDate: Date, granularity: TimeGranularity): Date[];
-/**
- * Fill time series gaps in query result data
+ * Apply server-side gap filling to query result rows.
  *
- * @param data - Original query result data
- * @param config - Gap filling configuration
- * @returns Data with gaps filled
- */
-export declare function fillTimeSeriesGaps(data: Record<string, unknown>[], config: GapFillerConfig): Record<string, unknown>[];
-/**
- * Parse date range from query time dimension
- * Handles both array format ['2024-01-01', '2024-01-31'] and string format
- */
-export declare function parseDateRange(dateRange: string | string[] | undefined): [Date, Date] | null;
-/**
- * Apply gap filling to query result data based on query configuration
+ * Precedence per time dimension: the query's `fillMissingDates`, then the cube
+ * dimension's, then `fillByDefault`. Ungrouped queries are never filled.
  *
- * @param data - Original query result data
- * @param query - The semantic query
- * @param measures - List of measure names in the result
- * @returns Data with gaps filled (if applicable)
+ * @param fillByDefault - Fill when neither the query nor the cube says. Only
+ *   comparison-period sub-queries pass `true`, to keep periods aligned.
  */
-export declare function applyGapFilling(data: Record<string, unknown>[], query: SemanticQuery, measures: string[]): Record<string, unknown>[];
+export declare function applyServerGapFilling(data: Record<string, unknown>[], query: SemanticQuery, cubes?: Map<string, Cube>, fillByDefault?: boolean): Record<string, unknown>[];