drizzle-cube 0.10.0 → 0.10.1

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"];

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;