drizzle-cube 0.1.3 → 0.1.5

package/dist/server/index.d.ts

@@ -1,9 +1,4 @@
 import { AnyColumn } from 'drizzle-orm';
-import { Many } from 'drizzle-orm';
-import { One } from 'drizzle-orm';
-import { PgColumn } from 'drizzle-orm/pg-core';
-import { PgTableWithColumns } from 'drizzle-orm/pg-core';
-import { Relations } from 'drizzle-orm';
 import { SQL } from 'drizzle-orm';
 
 /**
@@ -13,7 +8,7 @@ export declare abstract class BaseDatabaseExecutor<TSchema extends Record<string
     db: DrizzleDatabase<TSchema>;
     schema?: TSchema | undefined;
     constructor(db: DrizzleDatabase<TSchema>, schema?: TSchema | undefined);
-    abstract execute<T = any[]>(query: SQL | any): Promise<T>;
+    abstract execute<T = any[]>(query: SQL | any, measureFields?: string[]): Promise<T>;
     abstract getEngineType(): 'postgres' | 'mysql' | 'sqlite';
 }
 
@@ -106,6 +101,8 @@ export declare interface Cube<TSchema extends Record<string, any> = Record<strin
     dimensions: Record<string, Dimension<TSchema>>;
     /** Cube measures using direct column references */
     measures: Record<string, Measure<TSchema>>;
+    /** Optional joins to other cubes for multi-cube queries */
+    joins?: Record<string, CubeJoin<TSchema>>;
 }
 
 /**
@@ -150,14 +147,6 @@ export declare interface CubeMetadata {
     segments: any[];
 }
 
-/**
- * Enhanced Cube with join definitions for multi-cube support
- */
-export declare interface CubeWithJoins<TSchema extends Record<string, any> = Record<string, any>> extends Cube<TSchema> {
-    /** Joins to other cubes for multi-cube queries */
-    joins?: Record<string, CubeJoin<TSchema>>;
-}
-
 /**
  * Database executor that wraps Drizzle ORM
  * Provides type-safe SQL execution with engine-specific implementations
@@ -168,7 +157,7 @@ export declare interface DatabaseExecutor<TSchema extends Record<string, any> =
     /** Optional schema for type inference */
     schema?: TSchema;
     /** Execute a Drizzle SQL query or query object */
-    execute<T = any[]>(query: SQL | any): Promise<T>;
+    execute<T = any[]>(query: SQL | any, measureFields?: string[]): Promise<T>;
     /** Get the database engine type */
     getEngineType(): 'postgres' | 'mysql' | 'sqlite';
 }
@@ -194,121 +183,6 @@ export declare function defineLegacyCube<TSchema extends Record<string, any>>(_s
     name: string;
 }): SemanticCube<TSchema>;
 
-export declare const departments: PgTableWithColumns<    {
-name: "departments";
-schema: undefined;
-columns: {
-id: PgColumn<    {
-name: "id";
-tableName: "departments";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: true;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-name: PgColumn<    {
-name: "name";
-tableName: "departments";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-description: PgColumn<    {
-name: "description";
-tableName: "departments";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-organisation: PgColumn<    {
-name: "organisation";
-tableName: "departments";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-createdAt: PgColumn<    {
-name: "created_at";
-tableName: "departments";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-updatedAt: PgColumn<    {
-name: "updated_at";
-tableName: "departments";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-};
-dialect: "pg";
-}>;
-
-export declare const departmentsRelations: Relations<"departments", {
-organisation: One<"organisations", true>;
-employees: Many<"employees">;
-}>;
-
 /**
  * Dimension definition
  */
@@ -374,785 +248,6 @@ export declare type DrizzleDatabase<TSchema extends Record<string, any> = Record
     schema?: TSchema;
 };
 
-export declare const employees: PgTableWithColumns<    {
-name: "employees";
-schema: undefined;
-columns: {
-id: PgColumn<    {
-name: "id";
-tableName: "employees";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: true;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-name: PgColumn<    {
-name: "name";
-tableName: "employees";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-email: PgColumn<    {
-name: "email";
-tableName: "employees";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-active: PgColumn<    {
-name: "active";
-tableName: "employees";
-dataType: "boolean";
-columnType: "PgBoolean";
-data: boolean;
-driverParam: boolean;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-fteBasis: PgColumn<    {
-name: "fte_basis";
-tableName: "employees";
-dataType: "string";
-columnType: "PgNumeric";
-data: string;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-startDate: PgColumn<    {
-name: "start_date";
-tableName: "employees";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-endDate: PgColumn<    {
-name: "end_date";
-tableName: "employees";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-department: PgColumn<    {
-name: "department";
-tableName: "employees";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-supplier: PgColumn<    {
-name: "supplier";
-tableName: "employees";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-organisation: PgColumn<    {
-name: "organisation";
-tableName: "employees";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-createdAt: PgColumn<    {
-name: "created_at";
-tableName: "employees";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-updatedAt: PgColumn<    {
-name: "updated_at";
-tableName: "employees";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-};
-dialect: "pg";
-}>;
-
-export declare const employeesRelations: Relations<"employees", {
-organisation: One<"organisations", true>;
-department: One<"departments", false>;
-supplier: One<"suppliers", false>;
-}>;
-
-export declare type ExampleSchema = typeof exampleSchema;
-
-export declare const exampleSchema: {
-    organisations: PgTableWithColumns<    {
-    name: "organisations";
-    schema: undefined;
-    columns: {
-    id: PgColumn<    {
-    name: "id";
-    tableName: "organisations";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: true;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    name: PgColumn<    {
-    name: "name";
-    tableName: "organisations";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    description: PgColumn<    {
-    name: "description";
-    tableName: "organisations";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    createdAt: PgColumn<    {
-    name: "created_at";
-    tableName: "organisations";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    updatedAt: PgColumn<    {
-    name: "updated_at";
-    tableName: "organisations";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    };
-    dialect: "pg";
-    }>;
-    departments: PgTableWithColumns<    {
-    name: "departments";
-    schema: undefined;
-    columns: {
-    id: PgColumn<    {
-    name: "id";
-    tableName: "departments";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: true;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    name: PgColumn<    {
-    name: "name";
-    tableName: "departments";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    description: PgColumn<    {
-    name: "description";
-    tableName: "departments";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    organisation: PgColumn<    {
-    name: "organisation";
-    tableName: "departments";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    createdAt: PgColumn<    {
-    name: "created_at";
-    tableName: "departments";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    updatedAt: PgColumn<    {
-    name: "updated_at";
-    tableName: "departments";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    };
-    dialect: "pg";
-    }>;
-    suppliers: PgTableWithColumns<    {
-    name: "suppliers";
-    schema: undefined;
-    columns: {
-    id: PgColumn<    {
-    name: "id";
-    tableName: "suppliers";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: true;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    name: PgColumn<    {
-    name: "name";
-    tableName: "suppliers";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    description: PgColumn<    {
-    name: "description";
-    tableName: "suppliers";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    internal: PgColumn<    {
-    name: "internal";
-    tableName: "suppliers";
-    dataType: "boolean";
-    columnType: "PgBoolean";
-    data: boolean;
-    driverParam: boolean;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    organisation: PgColumn<    {
-    name: "organisation";
-    tableName: "suppliers";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    createdAt: PgColumn<    {
-    name: "created_at";
-    tableName: "suppliers";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    updatedAt: PgColumn<    {
-    name: "updated_at";
-    tableName: "suppliers";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    };
-    dialect: "pg";
-    }>;
-    employees: PgTableWithColumns<    {
-    name: "employees";
-    schema: undefined;
-    columns: {
-    id: PgColumn<    {
-    name: "id";
-    tableName: "employees";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: true;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    name: PgColumn<    {
-    name: "name";
-    tableName: "employees";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    email: PgColumn<    {
-    name: "email";
-    tableName: "employees";
-    dataType: "string";
-    columnType: "PgText";
-    data: string;
-    driverParam: string;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: [string, ...string[]];
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    active: PgColumn<    {
-    name: "active";
-    tableName: "employees";
-    dataType: "boolean";
-    columnType: "PgBoolean";
-    data: boolean;
-    driverParam: boolean;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    fteBasis: PgColumn<    {
-    name: "fte_basis";
-    tableName: "employees";
-    dataType: "string";
-    columnType: "PgNumeric";
-    data: string;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    startDate: PgColumn<    {
-    name: "start_date";
-    tableName: "employees";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    endDate: PgColumn<    {
-    name: "end_date";
-    tableName: "employees";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    department: PgColumn<    {
-    name: "department";
-    tableName: "employees";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    supplier: PgColumn<    {
-    name: "supplier";
-    tableName: "employees";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: false;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    organisation: PgColumn<    {
-    name: "organisation";
-    tableName: "employees";
-    dataType: "number";
-    columnType: "PgInteger";
-    data: number;
-    driverParam: string | number;
-    notNull: true;
-    hasDefault: false;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    createdAt: PgColumn<    {
-    name: "created_at";
-    tableName: "employees";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    updatedAt: PgColumn<    {
-    name: "updated_at";
-    tableName: "employees";
-    dataType: "date";
-    columnType: "PgTimestamp";
-    data: Date;
-    driverParam: string;
-    notNull: false;
-    hasDefault: true;
-    isPrimaryKey: false;
-    isAutoincrement: false;
-    hasRuntimeDefault: false;
-    enumValues: undefined;
-    baseColumn: never;
-    identity: undefined;
-    generated: undefined;
-    }, {}, {}>;
-    };
-    dialect: "pg";
-    }>;
-    organisationsRelations: Relations<"organisations", {
-    departments: Many<"departments">;
-    suppliers: Many<"suppliers">;
-    employees: Many<"employees">;
-    }>;
-    departmentsRelations: Relations<"departments", {
-    organisation: One<"organisations", true>;
-    employees: Many<"employees">;
-    }>;
-    suppliersRelations: Relations<"suppliers", {
-    organisation: One<"organisations", true>;
-    employees: Many<"employees">;
-    }>;
-    employeesRelations: Relations<"employees", {
-    organisation: One<"organisations", true>;
-    department: One<"departments", false>;
-    supplier: One<"suppliers", false>;
-    }>;
-};
-
 /**
  * Filter definitions with logical operators
  */
@@ -1263,7 +358,7 @@ export declare class MultiCubeBuilder<TSchema extends Record<string, any> = Reco
     /**
      * Build a multi-cube query plan
      */
-    buildMultiCubeQueryPlan(cubes: Map<string, CubeWithJoins<TSchema>>, query: SemanticQuery, ctx: QueryContext<TSchema>): MultiCubeQueryPlan<TSchema>;
+    buildMultiCubeQueryPlan(cubes: Map<string, Cube<TSchema>>, query: SemanticQuery, ctx: QueryContext<TSchema>): MultiCubeQueryPlan<TSchema>;
     /**
      * Choose the primary cube based on query analysis
      */
@@ -1334,113 +429,18 @@ export declare interface MultiCubeQueryPlan<TSchema extends Record<string, any>
  * Works with mysql2 driver
  */
 export declare class MySQLExecutor<TSchema extends Record<string, any> = Record<string, any>> extends BaseDatabaseExecutor<TSchema> {
-    execute<T = any[]>(query: SQL | any): Promise<T>;
+    execute<T = any[]>(query: SQL | any, measureFields?: string[]): Promise<T>;
+    /**
+     * Convert numeric string fields to numbers (only for measure fields)
+     */
+    private convertNumericFields;
+    /**
+     * Coerce a value to a number if it represents a numeric type
+     */
+    private coerceToNumber;
     getEngineType(): 'mysql';
 }
 
-/**
- * Example schema for demonstrating Drizzle cube definitions
- * This shows how to define cubes using actual Drizzle schema
- */
-export declare const organisations: PgTableWithColumns<    {
-name: "organisations";
-schema: undefined;
-columns: {
-id: PgColumn<    {
-name: "id";
-tableName: "organisations";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: true;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-name: PgColumn<    {
-name: "name";
-tableName: "organisations";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-description: PgColumn<    {
-name: "description";
-tableName: "organisations";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-createdAt: PgColumn<    {
-name: "created_at";
-tableName: "organisations";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-updatedAt: PgColumn<    {
-name: "updated_at";
-tableName: "organisations";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-};
-dialect: "pg";
-}>;
-
-export declare const organisationsRelations: Relations<"organisations", {
-departments: Many<"departments">;
-suppliers: Many<"suppliers">;
-employees: Many<"employees">;
-}>;
-
 /**
  * Parse YAML content and return validation result with converted cubes
  */
@@ -1451,11 +451,15 @@ export declare function parseYamlCubes(yamlContent: string): YamlValidationResul
  * Works with postgres.js and Neon drivers
  */
 export declare class PostgresExecutor<TSchema extends Record<string, any> = Record<string, any>> extends BaseDatabaseExecutor<TSchema> {
-    execute<T = any[]>(query: SQL | any): Promise<T>;
+    execute<T = any[]>(query: SQL | any, measureFields?: string[]): Promise<T>;
     /**
-     * Convert numeric string fields to numbers
+     * Convert numeric string fields to numbers (only for measure fields)
      */
     private convertNumericFields;
+    /**
+     * Coerce a value to a number if it represents a numeric type
+     */
+    private coerceToNumber;
     getEngineType(): 'postgres';
 }
 
@@ -1478,7 +482,7 @@ export declare class QueryExecutor<TSchema extends Record<string, any> = Record<
     /**
      * Unified query execution method that handles both single and multi-cube queries
      */
-    execute(cubes: Map<string, CubeWithJoins<TSchema>>, query: SemanticQuery, securityContext: SecurityContext): Promise<QueryResult>;
+    execute(cubes: Map<string, Cube<TSchema>>, query: SemanticQuery, securityContext: SecurityContext): Promise<QueryResult>;
     /**
      * Legacy interface for single cube queries
      */
@@ -1502,6 +506,17 @@ export declare class QueryExecutor<TSchema extends Record<string, any> = Record<
         sql: string;
         params?: any[];
     }>;
+    /**
+     * Generate raw SQL for multi-cube queries without execution
+     */
+    generateMultiCubeSQL(cubes: Map<string, Cube<TSchema>>, query: SemanticQuery, securityContext: SecurityContext): Promise<{
+        sql: string;
+        params?: any[];
+    }>;
+    /**
+     * Build multi-cube query (extracted from executeMultiCube for reuse)
+     */
+    private buildMultiCubeQuery;
     /**
      * Generate SQL for Cube
      */
@@ -1530,12 +545,25 @@ export declare class QueryExecutor<TSchema extends Record<string, any> = Record<
      * Build filter condition using Drizzle operators
      */
     private buildFilterCondition;
+    /**
+     * Build date range condition for time dimensions
+     */
+    private buildDateRangeCondition;
+    /**
+     * Parse relative date range expressions like "last 7 days", "this month"
+     */
+    private parseRelativeDateRange;
+    /**
+     * Normalize date values to handle both string and Date objects
+     * For PostgreSQL timestamp fields, Drizzle expects Date objects
+     */
+    private normalizeDate;
     /**
      * Build GROUP BY fields from dimensions and time dimensions (Cube)
      */
     private buildGroupByFields;
     /**
-     * Build ORDER BY clause
+     * Build ORDER BY clause with automatic time dimension sorting
      */
     private buildOrderBy;
     /**
@@ -1648,6 +676,9 @@ export declare const semanticLayer: SemanticLayerCompiler<Record<string, any>>;
 export declare class SemanticLayerCompiler<TSchema extends Record<string, any> = Record<string, any>> {
     private cubes;
     private dbExecutor?;
+    private metadataCache?;
+    private metadataCacheTimestamp?;
+    private readonly METADATA_CACHE_TTL;
     constructor(options?: {
         drizzle?: DatabaseExecutor<TSchema>['db'];
         schema?: TSchema;
@@ -1669,19 +700,19 @@ export declare class SemanticLayerCompiler<TSchema extends Record<string, any> =
     /**
      * Register a simplified cube with dynamic query building
      */
-    registerCube(cube: CubeWithJoins<TSchema>): void;
+    registerCube(cube: Cube<TSchema>): void;
     /**
      * Get a cube by name
      */
-    getCube(name: string): CubeWithJoins<TSchema> | undefined;
+    getCube(name: string): Cube<TSchema> | undefined;
     /**
      * Get all registered cubes
      */
-    getAllCubes(): CubeWithJoins<TSchema>[];
+    getAllCubes(): Cube<TSchema>[];
     /**
      * Get all cubes as a Map for multi-cube queries
      */
-    getAllCubesMap(): Map<string, CubeWithJoins<TSchema>>;
+    getAllCubesMap(): Map<string, Cube<TSchema>>;
     /**
      * Unified query execution method that handles both single and multi-cube queries
      */
@@ -1696,10 +727,12 @@ export declare class SemanticLayerCompiler<TSchema extends Record<string, any> =
     executeQuery(cubeName: string, query: SemanticQuery, securityContext: SecurityContext): Promise<QueryResult>;
     /**
      * Get metadata for all cubes (for API responses)
+     * Uses caching to improve performance for repeated requests
      */
     getMetadata(): CubeMetadata[];
     /**
      * Generate cube metadata for API responses from cubes
+     * Optimized version that minimizes object iterations
      */
     private generateCubeMetadata;
     /**
@@ -1709,6 +742,13 @@ export declare class SemanticLayerCompiler<TSchema extends Record<string, any> =
         sql: string;
         params?: any[];
     }>;
+    /**
+     * Get SQL for a multi-cube query without executing it (debugging)
+     */
+    generateMultiCubeSQL(query: SemanticQuery, securityContext: SecurityContext): Promise<{
+        sql: string;
+        params?: any[];
+    }>;
     /**
      * Check if a cube exists
      */
@@ -1721,10 +761,23 @@ export declare class SemanticLayerCompiler<TSchema extends Record<string, any> =
      * Clear all cubes
      */
     clearCubes(): void;
+    /**
+     * Invalidate the metadata cache
+     * Called whenever cubes are modified
+     */
+    private invalidateMetadataCache;
     /**
      * Get cube names
      */
     getCubeNames(): string[];
+    /**
+     * Validate a query against registered cubes
+     * Ensures all referenced cubes and fields exist
+     */
+    validateQuery(query: SemanticQuery): {
+        isValid: boolean;
+        errors: string[];
+    };
 }
 
 /**
@@ -2061,7 +1114,15 @@ export { SQL }
  * Works with better-sqlite3 driver
  */
 export declare class SQLiteExecutor<TSchema extends Record<string, any> = Record<string, any>> extends BaseDatabaseExecutor<TSchema> {
-    execute<T = any[]>(query: SQL | any): Promise<T>;
+    execute<T = any[]>(query: SQL | any, measureFields?: string[]): Promise<T>;
+    /**
+     * Convert numeric string fields to numbers (only for measure fields)
+     */
+    private convertNumericFields;
+    /**
+     * Coerce a value to a number if it represents a numeric type
+     */
+    private coerceToNumber;
     getEngineType(): 'sqlite';
 }
 
@@ -2073,138 +1134,6 @@ export declare interface SqlResult {
     params?: any[];
 }
 
-export declare const suppliers: PgTableWithColumns<    {
-name: "suppliers";
-schema: undefined;
-columns: {
-id: PgColumn<    {
-name: "id";
-tableName: "suppliers";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: true;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-name: PgColumn<    {
-name: "name";
-tableName: "suppliers";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-description: PgColumn<    {
-name: "description";
-tableName: "suppliers";
-dataType: "string";
-columnType: "PgText";
-data: string;
-driverParam: string;
-notNull: false;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: [string, ...string[]];
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-internal: PgColumn<    {
-name: "internal";
-tableName: "suppliers";
-dataType: "boolean";
-columnType: "PgBoolean";
-data: boolean;
-driverParam: boolean;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-organisation: PgColumn<    {
-name: "organisation";
-tableName: "suppliers";
-dataType: "number";
-columnType: "PgInteger";
-data: number;
-driverParam: string | number;
-notNull: true;
-hasDefault: false;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-createdAt: PgColumn<    {
-name: "created_at";
-tableName: "suppliers";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-updatedAt: PgColumn<    {
-name: "updated_at";
-tableName: "suppliers";
-dataType: "date";
-columnType: "PgTimestamp";
-data: Date;
-driverParam: string;
-notNull: false;
-hasDefault: true;
-isPrimaryKey: false;
-isAutoincrement: false;
-hasRuntimeDefault: false;
-enumValues: undefined;
-baseColumn: never;
-identity: undefined;
-generated: undefined;
-}, {}, {}>;
-};
-dialect: "pg";
-}>;
-
-export declare const suppliersRelations: Relations<"suppliers", {
-organisation: One<"organisations", true>;
-employees: Many<"employees">;
-}>;
-
 /**
  * Time dimension with granularity
  */