drizzle-cube 0.1.14 → 0.1.16

package/dist/client/components/AIAssistant/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Constants for AI Assistant
+ */
+export declare const AI_PROXY_BASE_URL = "/api/ai";
+export declare const GEMINI_MODEL = "gemini-2.0-flash";
+export declare const DEFAULT_SYSTEM_PROMPT_TEMPLATE = "You are a SQL query builder assistant for a semantic layer using Cube.js format.\n\nAvailable cube schema (JSON):\n{CUBE_SCHEMA}\n\nA valid Cube schema can contain things such as below (this is only an example of possible options):\n\n{\n  \"measures\": [\"stories.count\"],\n  \"dimensions\": [\"stories.category\"],\n  \"filters\": [\n    {\n      \"member\": \"stories.isDraft\",\n      \"operator\": \"equals\",\n      \"values\": [\"No\"]\n    }\n  ],\n  \"timeDimensions\": [\n    {\n      \"dimension\": \"stories.time\",\n      \"dateRange\": [\"2015-01-01\", \"2015-12-31\"],\n      \"granularity\": \"month\"\n    }\n  ],\n  \"limit\": 100,\n  \"offset\": 50,\n  \"order\": {\n    \"stories.time\": \"asc\",\n    \"stories.count\": \"desc\"\n  }\n}\n\nUser request: {USER_PROMPT}\n\nCRITICAL: You MUST only use field names that exist in the schema above. Do NOT create or invent field names.\n\nGenerate a JSON query object with this structure:\n{\n  \"measures\": [\"CubeName.measureName\"],\n  \"dimensions\": [\"CubeName.dimensionName\"], \n  \"timeDimensions\": [{\n    \"dimension\": \"CubeName.timeDimensionName\",\n    \"granularity\": \"day|week|month|quarter|year\",\n    \"dateRange\": \"last 30 days\"\n  }],\n  \"filters\": [{\n    \"member\": \"CubeName.fieldName\",\n    \"operator\": \"equals|contains|gt|gte|lt|lte|inDateRange\",\n    \"values\": [\"value1\", \"value2\"]\n  }]\n}\n\nRules:\n1. Only use cube names, measure names, and dimension names from the schema\n2. All field references must be in \"CubeName.fieldName\" format\n3. Verify every field exists in the provided schema before using it\n\nRespond with only the JSON query object, no explanation, no markdown formatting, no code blocks, no backtick wrapper.";
+export declare const AI_STORAGE_KEY = "drizzle-cube-ai-config";
+export declare const DEFAULT_AI_CONFIG: {
+    provider: "gemini";
+    apiKey: string;
+};

package/dist/client/components/AIAssistant/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AI Assistant components export
+ */
+export { default as AIAssistantModal } from './AIAssistantModal';
+export * from './types';
+export * from './constants';
+export * from './utils';

package/dist/client/components/AIAssistant/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Types for AI Assistant functionality
+ */
+export interface AIQueryRequest {
+    text: string;
+}
+export interface GeminiMessageResponse {
+    candidates: Array<{
+        content: {
+            parts: Array<{
+                text: string;
+            }>;
+        };
+        finishReason: string;
+        index: number;
+    }>;
+    usageMetadata: {
+        promptTokenCount: number;
+        candidatesTokenCount: number;
+        totalTokenCount: number;
+    };
+}
+export interface AIQueryResponse {
+    query: string;
+    rateLimit?: {
+        usingServerKey: boolean;
+        dailyLimit: number;
+    };
+}
+export interface AIConfig {
+    provider: 'gemini';
+    apiKey: string;
+}
+export interface AIAssistantState {
+    step: 'api-key' | 'query';
+    apiKey: string;
+    systemPromptTemplate: string;
+    userPrompt: string;
+    isSubmitting: boolean;
+    response: string | null;
+    responseError: string | null;
+    isValidating: boolean;
+    validationResult: 'valid' | 'invalid' | null;
+    validationError: string | null;
+}
+export interface SystemPromptVariables {
+    CUBE_SCHEMA: string;
+    USER_PROMPT: string;
+}

package/dist/client/components/AIAssistant/utils.d.ts

@@ -0,0 +1,17 @@
+import { AIQueryResponse, AIConfig } from './types';
+/**
+ * Send a user prompt to AI proxy (server builds system prompt)
+ */
+export declare function sendGeminiMessage(apiKey: string, userPrompt: string, endpoint?: string): Promise<AIQueryResponse>;
+/**
+ * Save AI configuration to localStorage
+ */
+export declare function saveAIConfig(config: AIConfig): void;
+/**
+ * Load AI configuration from localStorage
+ */
+export declare function loadAIConfig(): AIConfig;
+/**
+ * Extract query text from simplified AI response and clean up formatting
+ */
+export declare function extractTextFromResponse(response: AIQueryResponse): string;

package/dist/client/components/QueryBuilder/DateRangeFilter.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { DateRangeFilterProps } from './types';
+declare const DateRangeFilter: React.FC<DateRangeFilterProps>;
+export default DateRangeFilter;

package/dist/client/components/QueryBuilder/DateRangeSelector.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+interface DateRangeSelectorProps {
+    timeDimension: string;
+    availableTimeDimensions: string[];
+    currentDateRange?: string | string[];
+    onDateRangeChange: (timeDimension: string, dateRange: string | string[]) => void;
+    onTimeDimensionChange: (oldTimeDimension: string, newTimeDimension: string) => void;
+    onRemove: (timeDimension: string) => void;
+}
+declare const DateRangeSelector: React.FC<DateRangeSelectorProps>;
+export default DateRangeSelector;

package/dist/client/components/QueryBuilder/types.d.ts

@@ -100,9 +100,13 @@ export interface QueryPanelProps {
     onRemoveField: (fieldName: string, fieldType: 'measures' | 'dimensions' | 'timeDimensions') => void;
     onTimeDimensionGranularityChange: (dimensionName: string, granularity: string) => void;
     onFiltersChange: (filters: Filter[]) => void;
+    onDateRangeChange: (timeDimension: string, dateRange: string | string[]) => void;
+    onDateRangeRemove: (timeDimension: string) => void;
+    onOrderChange: (fieldName: string, direction: 'asc' | 'desc' | null) => void;
     onClearQuery?: () => void;
     showSettings?: boolean;
     onSettingsClick?: () => void;
+    onAIAssistantClick?: () => void;
 }
 export interface ResultsPanelProps {
     executionStatus: ExecutionStatus;
@@ -171,3 +175,31 @@ export interface FilterValueSelectorProps {
     onValuesChange: (values: any[]) => void;
     schema: MetaResponse | null;
 }
+export type DateRangeType = 'custom' | 'today' | 'yesterday' | 'this_week' | 'this_month' | 'this_quarter' | 'this_year' | 'last_7_days' | 'last_30_days' | 'last_week' | 'last_month' | 'last_quarter' | 'last_year' | 'last_12_months' | 'last_n_days' | 'last_n_weeks' | 'last_n_months' | 'last_n_quarters' | 'last_n_years';
+export interface DateRangeOption {
+    value: DateRangeType;
+    label: string;
+}
+export declare const DATE_RANGE_OPTIONS: DateRangeOption[];
+export interface DateRangeFilter {
+    id: string;
+    timeDimension: string;
+    rangeType: DateRangeType;
+    startDate?: string;
+    endDate?: string;
+}
+export interface DateRangeSelectorProps {
+    timeDimensions: string[];
+    onDateRangeChange: (timeDimension: string, dateRange: string | string[]) => void;
+    onDateRangeRemove: (timeDimension: string) => void;
+    currentDateRanges: Record<string, string | string[]>;
+}
+export interface DateRangeFilterProps {
+    timeDimensions: Array<{
+        dimension: string;
+        granularity?: string;
+        dateRange?: string | string[];
+    }>;
+    onDateRangeChange: (timeDimension: string, dateRange: string | string[]) => void;
+    onDateRangeRemove: (timeDimension: string) => void;
+}

package/dist/client/components/QueryBuilder/utils.d.ts

@@ -70,8 +70,20 @@ export declare function isOrFilter(filter: Filter): filter is GroupFilter;
 export declare function flattenFilters(filters: Filter[]): SimpleFilter[];
 /**
  * Get all filterable fields from schema (measures, dimensions, and time dimensions)
+ * Returns ALL fields if no query provided, or only query fields if query provided
  */
 export declare function getFilterableFields(schema: MetaResponse, query?: CubeQuery): MetaField[];
+/**
+ * Get ALL filterable fields from schema, regardless of query selection
+ */
+export declare function getAllFilterableFields(schema: MetaResponse): MetaField[];
+/**
+ * Get organized filter field options with query fields prioritized at top
+ */
+export declare function getOrganizedFilterFields(schema: MetaResponse, query?: CubeQuery): {
+    queryFields: MetaField[];
+    allFields: MetaField[];
+};
 /**
  * Get available operators for a field type
  */
@@ -108,10 +120,67 @@ export declare function createAndFilter(filters?: Filter[]): GroupFilter;
 export declare function createOrFilter(filters?: Filter[]): GroupFilter;
 /**
  * Clean up filters by removing any that reference fields not in the current query
+ * @deprecated This function is no longer used as we now support filtering on any schema field
  */
-export declare function cleanupFilters(filters: Filter[], query: CubeQuery): Filter[];
+export declare function cleanupFilters(filters: Filter[], _query?: CubeQuery): Filter[];
+/**
+ * Clean up filters by removing any that reference fields not in the current query (legacy)
+ * Only used for backward compatibility - filters on non-query fields are now supported
+ */
+export declare function cleanupFiltersLegacy(filters: Filter[], query: CubeQuery): Filter[];
 /**
  * Transform filters from new GroupFilter format to legacy server format
  * Server expects { and: [...] } and { or: [...] } instead of { type: 'and', filters: [...] }
  */
 export declare function transformFiltersForServer(filters: Filter[]): any[];
+/**
+ * Date range utility functions
+ */
+/**
+ * Convert DateRangeType to Cube.js compatible date range format
+ */
+export declare function convertDateRangeTypeToValue(rangeType: string, number?: number): string;
+/**
+ * Check if a date range type requires a number input
+ */
+export declare function requiresNumberInput(rangeType: string): boolean;
+/**
+ * Format date for Cube.js (YYYY-MM-DD)
+ */
+export declare function formatDateForCube(date: Date): string;
+/**
+ * Get the time dimensions that have date ranges applied
+ */
+export declare function getTimeDimensionsWithDateRanges(query: CubeQuery): Record<string, string | string[]>;
+/**
+ * Check if a query has any time dimensions
+ */
+export declare function hasTimeDimensions(query: CubeQuery): boolean;
+/**
+ * Transform a Cube.js query from external format to UI internal format
+ * This handles format differences between server/API queries and QueryBuilder state
+ */
+export declare function transformQueryForUI(query: any): CubeQuery;
+/**
+ * Sorting utility functions
+ */
+/**
+ * Get field title from schema metadata, falling back to field name
+ */
+export declare function getFieldTitle(fieldName: string, schema: MetaResponse | null): string;
+/**
+ * Clean up order object by removing fields that are no longer in the query
+ */
+export declare function cleanupOrder(order: Record<string, 'asc' | 'desc'> | undefined, query: CubeQuery): Record<string, 'asc' | 'desc'> | undefined;
+/**
+ * Get sort direction for a field from the order object
+ */
+export declare function getSortDirection(fieldName: string, order: Record<string, 'asc' | 'desc'> | undefined): 'asc' | 'desc' | null;
+/**
+ * Get tooltip text for sort button based on current direction
+ */
+export declare function getSortTooltip(direction: 'asc' | 'desc' | null): string;
+/**
+ * Get next sort direction in the cycle: null -> asc -> desc -> null
+ */
+export declare function getNextSortDirection(current: 'asc' | 'desc' | null): 'asc' | 'desc' | null;

package/dist/client/components.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Drizzle Cube UI Components
+ *
+ * UI components without charts - for applications that need dashboards,
+ * query builders, and layout components but provide their own charts.
+ */
+export { default as AnalyticsPortlet } from './components/AnalyticsPortlet';
+export { default as AnalyticsDashboard } from './components/AnalyticsDashboard';
+export { default as DashboardGrid } from './components/DashboardGrid';
+export { default as PortletContainer } from './components/PortletContainer';
+export { default as PortletEditModal } from './components/PortletEditModal';
+export { default as DashboardEditModal } from './components/DashboardEditModal';
+export { default as Modal } from './components/Modal';
+export { default as QueryBuilder } from './components/QueryBuilder';
+export { createDashboardLayout, generateResponsiveLayouts, generatePortletId, findNextPosition, validateCubeQuery, createSamplePortlet } from './utils/index';
+export type { PortletConfig, DashboardConfig } from './types';