drizzle-cube 0.6.2 → 0.6.4

package/dist/cjs/client/shared/types.d.ts

@@ -1,4 +1,4 @@
-import { CubeQuery, FilterOperator } from '../types.js';
+import { CubeQuery } from '../types.js';
 export interface MetaField {
     name: string;
     title: string;
@@ -162,15 +162,8 @@ export interface ValidationResult {
     joinType?: string;
     analysis?: QueryAnalysis;
 }
-export interface FilterOperatorMeta {
-    label: string;
-    description: string;
-    requiresValues: boolean;
-    supportsMultipleValues: boolean;
-    valueType: 'string' | 'number' | 'date' | 'boolean' | 'any';
-    fieldTypes: string[];
-}
-export declare const FILTER_OPERATORS: Record<FilterOperator, FilterOperatorMeta>;
+export type { FilterOperatorMeta } from './filters/operators.js';
+export { FILTER_OPERATORS } from './filters/operators.js';
 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;

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

@@ -1,58 +1,7 @@
-import { CubeQuery, Filter, SimpleFilter, GroupFilter } from '../types.js';
+import { CubeQuery } from '../types.js';
 import { MetaField, MetaResponse } from './types.js';
 import { cleanQuery } from './queryTransforms.js';
 export { cleanQuery };
-/**
- * Check if a filter is a simple filter
- */
-export declare function isSimpleFilter(filter: Filter): filter is SimpleFilter;
-/**
- * Check if a filter is a group filter
- */
-export declare function isGroupFilter(filter: Filter): filter is GroupFilter;
-/**
- * Check if a filter is an AND filter
- */
-export declare function isAndFilter(filter: Filter): filter is GroupFilter;
-/**
- * Check if a filter is an OR filter
- */
-export declare function isOrFilter(filter: Filter): filter is GroupFilter;
-/**
- * Flatten all simple filters from a hierarchical filter structure
- */
-export declare function flattenFilters(filters: Filter[]): SimpleFilter[];
-/**
- * Count total filters in hierarchical structure
- */
-export declare function countFilters(filters: Filter[]): number;
-/**
- * Create a new simple filter
- */
-export declare function createSimpleFilter(member: string, operator?: string, values?: any[]): SimpleFilter;
-/**
- * Create a new AND filter group
- */
-export declare function createAndFilter(filters?: Filter[]): GroupFilter;
-/**
- * Create a new OR filter group
- */
-export declare function createOrFilter(filters?: Filter[]): GroupFilter;
-/**
- * Clean up filters - backward compatible (returns filters unchanged)
- * @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[];
-/**
- * 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[];
-/**
- * Transform filters from server/API format to UI format
- * Converts {and: [...]} and {or: [...]} to {type: 'and', filters: [...]} format
- */
-export declare function transformFiltersFromServer(filters: any[]): Filter[];
 /**
  * Check if query has any content (measures, dimensions, or timeDimensions)
  */
@@ -79,13 +28,6 @@ export declare function getFieldType(fieldName: string, schema: MetaResponse): s
  * Get field title from schema metadata, falling back to field name
  */
 export declare function getFieldTitle(fieldName: string, schema: MetaResponse | null): string;
-/**
- * Get available operators for a field type
- */
-export declare function getAvailableOperators(fieldType: string): Array<{
-    operator: string;
-    label: string;
-}>;
 /**
  * Get ALL filterable fields from schema
  */

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

@@ -1,4 +1,6 @@
 import { Filter, DashboardFilter, DashboardFilterMapping, DashboardFilterMappingEntry, CubeMeta, DashboardConfig } from '../types.js';
+import { validateFilterForCube } from '../shared/filters/index.js';
+export { validateFilterForCube };
 /**
  * Normalize a portlet filter mapping to entry objects.
  * Plain string entries (the legacy format) become { filterId } with no override.
@@ -61,14 +63,6 @@ export declare function mergeDashboardAndPortletFilters(dashboardFilters: Filter
  * @deprecated Use mergeDashboardAndPortletFilters(filters, portletFilters, 'client') instead
  */
 export declare function mergeDashboardAndPortletFiltersClientFormat(dashboardFilters: Filter[], portletFilters: Filter[] | undefined): Filter[] | undefined;
-/**
- * Check if a filter field exists in the cube metadata
- * This helps identify filters that might not apply to a specific portlet's data
- * @param filter - The filter to validate
- * @param cubeMeta - Cube metadata to validate against
- * @returns true if the filter field exists in any cube's measures or dimensions
- */
-export declare function validateFilterForCube(filter: Filter, cubeMeta: CubeMeta | null): boolean;
 /**
  * Validate that all dashboard filters in a portlet's mapping exist and are valid
  * @param dashboardFilters - All available dashboard filters
@@ -110,4 +104,3 @@ type TimeDimension = {
  * @returns Updated timeDimensions array with date ranges applied
  */
 export declare function applyUniversalTimeFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined, portletTimeDimensions: TimeDimension[] | undefined): TimeDimension[] | undefined;
-export {};

package/dist/cjs/server/logical-plan/logical-plan-builder.d.ts

@@ -49,10 +49,5 @@ export declare class LogicalPlanBuilder {
     private deduplicateColumnRefs;
     private buildQueryNode;
     private buildPreAggregationAnalysis;
-    private buildMeasureRefs;
-    private buildDimensionRefs;
-    private buildTimeDimensionRefs;
     private buildOrderByRefs;
-    private toCubeRef;
-    private buildCTESchema;
 }

package/dist/cjs/server/logical-plan/schema-builder.d.ts

@@ -0,0 +1,19 @@
+import { Cube, PhysicalQueryPlan } from '../types/index.js';
+import { SemanticQuery } from '../types/query.js';
+import { CubeRef, MeasureRef, DimensionRef, TimeDimensionRef, LogicalSchema } from './types.js';
+export declare function toCubeRef(cube: Cube): CubeRef;
+export declare function buildMeasureRefs(query: SemanticQuery, cubes: Map<string, Cube>): MeasureRef[];
+export declare function buildDimensionRefs(query: SemanticQuery, cubes: Map<string, Cube>): DimensionRef[];
+export declare function buildTimeDimensionRefs(query: SemanticQuery, cubes: Map<string, Cube>): TimeDimensionRef[];
+/**
+ * Compose the full logical schema (measures, dimensions, time dimensions) for a
+ * query. This is the primary public interface: `(query, cubes) => LogicalSchema`.
+ */
+export declare function buildLogicalSchema(query: SemanticQuery, cubes: Map<string, Cube>): LogicalSchema;
+/**
+ * Derive the measures-only schema for a pre-aggregation CTE. Unlike the
+ * query-driven builders above, this intentionally does NOT throw on a missing
+ * cube (the cube is guaranteed present by the planner that produced the CTE
+ * descriptor) — preserving exact prior behavior keeps generated SQL unchanged.
+ */
+export declare function buildCTESchema(cteInfo: NonNullable<PhysicalQueryPlan['preAggregationCTEs']>[number], cubes: Map<string, Cube>): LogicalSchema;

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

@@ -1,17 +1,9 @@
 import { ComponentType, LazyExoticComponent } from 'react';
-import { BuiltInChartType, ChartType, ChartProps } from '../types.js';
+import { ChartType, ChartProps } from '../types.js';
 export type LazyChartComponent = ComponentType<ChartProps>;
 export declare const chartLoaderCache: Map<ChartType, LazyExoticComponent<LazyChartComponent>>;
 export declare const failedChartTypes: Set<ChartType>;
 export declare const customChartMap: Map<string, LazyExoticComponent<LazyChartComponent>>;
-/**
- * Maps chart types to their optional peer dependencies.
- * Charts not listed here have no external dependencies (table, KPIs, markdown).
- */
-export declare const chartDependencyMap: Partial<Record<BuiltInChartType, {
-    packageName: string;
-    installCommand: string;
-}>>;
 /**
  * Creates a fallback component for an unknown/unregistered chart type.
  */

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

@@ -1,6 +1,10 @@
 import { ChartTypeConfig, ChartConfigRegistry } from './chartConfigs.js';
 /**
- * Registry of all chart type configurations
+ * Registry of all chart type configurations (the eager / full / server source).
+ *
+ * Every built-in is composed from its `chartRegistry` entry's metadata (single
+ * source of truth) laid over its full config shape. Drop zones / display options
+ * stay here in full because the server agent reads them synchronously.
  */
 export declare const chartConfigRegistry: ChartConfigRegistry;
 /**

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

@@ -37,7 +37,6 @@ export interface ChartDefinition {
 declare class ChartPluginRegistry {
     private customCharts;
     private builtInBackups;
-    private iconMap;
     private version;
     private listeners;
     /**
@@ -51,7 +50,7 @@ declare class ChartPluginRegistry {
      * If the chart type was a built-in override, the original built-in is restored.
      */
     unregister(type: string): void;
-    /** Get the custom icon for a chart type, if registered */
+    /** Get the custom icon component for a chart type, if one was registered. */
     getIcon(type: string): ComponentType<IconProps> | undefined;
     /** Get all registered custom chart type strings */
     getCustomTypes(): string[];

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

@@ -0,0 +1,73 @@
+import { ComponentType } from 'react';
+import { BuiltInChartType } from '../types.js';
+import { IconName, IconProps } from '../icons/types.js';
+import { ChartTypeConfig, ChartAvailabilityContext, ChartAvailability } from './chartConfigs.js';
+/**
+ * The single source of truth for one chart type's DOM-free metadata: the eager
+ * picker fields, the lazy config thunk, the icon name, and dependency info.
+ *
+ * The React component thunk is deliberately NOT part of the entry — it is the
+ * one DOM-bearing piece and is owned by the client loader, keeping this entry
+ * (and its consumers, incl. the server agent) free of the chart component graph.
+ */
+export interface ChartRegistryEntry {
+    /** Display label for the picker — an i18n key, resolved at render time. */
+    label: string;
+    /**
+     * The chart's icon. Built-ins use an `IconName` resolved via the icon registry
+     * (override-able via registerIcons/setIcon). Plugins may instead supply a
+     * ready-made icon component — both flow through the same entry field so custom
+     * and built-in charts resolve their icon along one path.
+     */
+    icon: IconName | ComponentType<IconProps>;
+    /** Brief description — i18n key. */
+    description?: string;
+    /** When to use this chart — i18n key. */
+    useCase?: string;
+    /** Whether the chart can render with the current query shape. */
+    isAvailable?: (ctx: ChartAvailabilityContext) => ChartAvailability;
+    /** Optional peer dependency — shows install instructions if the import fails. */
+    dependencies?: {
+        packageName: string;
+        installCommand: string;
+    };
+    /** Lazy config import — resolves the config OBJECT directly (client lazy path). */
+    config: () => Promise<ChartTypeConfig>;
+}
+/**
+ * The unified registry — one entry per built-in chart type, the single source of
+ * truth for its DOM-free metadata. The eager config registry, the lazy config
+ * registry, the icon lookup, and the dependency lookup all derive from this map.
+ *
+ * Adding a chart is now one entry here plus its component/config files.
+ */
+export declare const chartRegistry: Record<BuiltInChartType, ChartRegistryEntry>;
+/**
+ * The single, unified chart-entry lookup. Custom plugin entries take precedence
+ * over built-ins, so a plugin override of a built-in type resolves through the
+ * same path. Returns `undefined` for unknown types.
+ *
+ * Every entry-shaped consumer (icon resolution, dependency fallback, plugin
+ * icon API) reads through this so built-in and custom charts flow as one.
+ */
+export declare function getChartEntry(chartType: string): ChartRegistryEntry | undefined;
+/** Register a custom chart's entry (plugin system). */
+export declare function registerCustomChartEntry(chartType: string, entry: ChartRegistryEntry): void;
+/** Remove a custom chart's entry, falling back to the built-in if one exists. */
+export declare function unregisterCustomChartEntry(chartType: string): void;
+/** The custom entry for a type, if one is registered (no built-in fallback). */
+export declare function getCustomChartEntry(chartType: string): ChartRegistryEntry | undefined;
+/**
+ * Composes a migrated chart's full `ChartTypeConfig` from its entry: the entry's
+ * metadata (its single declaration site) laid over the chart's config shape
+ * (`base` — drop zones, display options, clickable elements, validation).
+ *
+ * Used by BOTH derivation paths so they return the same full shape as a
+ * non-migrated chart's `*.config.ts`:
+ * - eager `chartConfigRegistry` (server/full source — read synchronously for the
+ *   picker AND by the server agent's chart validation + tool guidance), with
+ *   `base` = the statically-imported config;
+ * - lazy `getChartConfigAsync` (client code-split path), with `base` = the
+ *   config resolved from the entry's `config` thunk.
+ */
+export declare function composeChartConfig(entry: ChartRegistryEntry, base: ChartTypeConfig): ChartTypeConfig;

package/dist/client/charts.js

@@ -1,9 +1,9 @@
-import { ct as e, dt as t, ft as n, lt as r, mt as i, pt as a, st as o, t as s, ut as c } from "./chunks/chart-data-table-CKauQXme.js";
+import { ct as e, dt as t, ft as n, lt as r, mt as i, pt as a, st as o, t as s, ut as c } from "./chunks/chart-data-table-D4g5_jfF.js";
 import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-DX0SJbxs.js";
 import { t as p } from "./chunks/chart-funnel-CToKSBaL.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-DdTeCeNo.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-B0DOQMFH.js";
 import { t as x } from "./chunks/chart-area-of01_62R.js";
-import { i as S } from "./chunks/utils-3P6z1vz5.js";
+import { i as S } from "./chunks/utils-Cq-j5E5I.js";
 import { t as C } from "./chunks/chart-bar-BqelQE_I.js";
 import { t as w } from "./chunks/chart-line-DKgrQA6c.js";
 import { t as T } from "./chunks/chart-pie-ByieAX5H.js";