drizzle-cube 0.2.13 → 0.2.15

package/dist/server/index.d.ts

@@ -619,6 +619,8 @@ export declare interface PreAggregationCTEInfo {
     joinKeys: JoinKeyInfo[];
     /** List of measure names included in this CTE */
     measures: string[];
+    /** Propagating filters from related cubes (for cross-cube filter propagation) */
+    propagatingFilters?: PropagatingFilter[];
 }
 
 /**
@@ -658,6 +660,25 @@ export declare interface PrimaryCubeCandidate {
  */
 export declare type PrimaryCubeSelectionReason = 'most_dimensions' | 'most_connected' | 'alphabetical_fallback' | 'single_cube';
 
+/**
+ * Propagating filter information for cross-cube filter propagation
+ * When cube A has filters and cube B (with hasMany from A) needs a CTE,
+ * A's filters should propagate into B's CTE via a subquery
+ */
+export declare interface PropagatingFilter {
+    /** The source cube whose filters need to propagate */
+    sourceCube: Cube;
+    /** Filters from the source cube to apply */
+    filters: Filter[];
+    /** Join condition linking source cube PK to target cube FK */
+    joinCondition: {
+        /** Primary key column on source cube */
+        source: AnyColumn;
+        /** Foreign key column on target cube (CTE cube) */
+        target: AnyColumn;
+    };
+}
+
 /**
  * Any queryable relation that can be used in FROM/JOIN clauses
  * Supports tables, views, subqueries, and raw SQL expressions
@@ -840,6 +861,14 @@ export declare class QueryExecutor {
      * Build join condition for CTE
      */
     private buildCTEJoinCondition;
+    /**
+     * Build a subquery filter for propagating filters from related cubes.
+     * This generates: cteCube.FK IN (SELECT sourceCube.PK FROM sourceCube WHERE filters...)
+     *
+     * Example: For Productivity CTE with Employees.createdAt filter:
+     * employee_id IN (SELECT id FROM employees WHERE organisation_id = $1 AND created_at >= $date)
+     */
+    private buildPropagatingFilterSubquery;
     /**
      * Build unified query that works for both single and multi-cube queries
      */
@@ -972,6 +1001,27 @@ export declare class QueryPlanner {
      * Find hasMany join definition from primary cube to target cube
      */
     private findHasManyJoinDef;
+    /**
+     * Find filters that need to propagate from related cubes to a CTE cube.
+     * When cube A has filters and a hasMany relationship to cube B (the CTE cube),
+     * A's filters should propagate into B's CTE via a subquery.
+     *
+     * Example: Employees.createdAt filter should propagate to Productivity CTE
+     * via: employee_id IN (SELECT id FROM employees WHERE created_at >= $date)
+     */
+    private findPropagatingFilters;
+    /**
+     * Extract cube names from filters into a Set (helper for findPropagatingFilters)
+     */
+    private extractFilterCubeNamesToSet;
+    /**
+     * Extract filters for a specific cube from the filter array
+     */
+    private extractFiltersForCube;
+    /**
+     * Extract time dimension date range filters as regular filters for a specific cube
+     */
+    private extractTimeDimensionFiltersForCube;
     /**
      * Analyze query planning decisions without building the full query
      * Returns detailed metadata about how the query plan would be constructed