feat(tesseract): Support calendar cubes and custom sql granularities (cube-js#9698)

* add support for calendar prop and sql in granularities in schema validator

* fix resolveGranularity() for calendar td granularities

* support granularities sql() in tesseract

* fix td symbol deps

* cargo fmt

* add tests for calendar cubes in schema compiler

* add calendar tests

Author: KSDaemon

packages/cubejs-schema-compiler/src/compiler/CubeSymbols.ts

@@ -31,6 +31,7 @@ interface CubeDefinition {
   excludes?: any;
   cubes?: any;
   isView?: boolean;
+  calendar?: boolean;
   isSplitView?: boolean;
   includedMembers?: any[];
 }
@@ -982,8 +983,17 @@ export class CubeSymbols {
     const [cubeName, dimName, gr, granName] = Array.isArray(path) ? path : path.split('.');
     const cube = refCube || this.symbols[cubeName];
 
-    // Predefined granularity
+    // Calendar cubes time dimensions may define custom sql for predefined granularities,
+    // so we need to check if such granularity exists in cube definition.
     if (typeof granName === 'string' && /^(second|minute|hour|day|week|month|quarter|year)$/i.test(granName)) {
+      const customGranularity = cube?.[dimName]?.[gr]?.[granName];
+      if (customGranularity) {
+        return {
+          ...customGranularity,
+          interval: `1 ${granName}`, // It's still important to have interval for granularity math
+        };
+      }
+
       return { interval: `1 ${granName}` };
     }
 

packages/cubejs-schema-compiler/src/compiler/CubeValidator.ts

@@ -185,6 +185,10 @@ const BaseDimensionWithoutSubQuery = {
             return isValid ? value : helper.message(msg);
           }),
           offset: GranularityOffset.optional(),
+        }),
+        Joi.object().keys({
+          title: Joi.string(),
+          sql: Joi.func().required()
         })
       ])).optional(),
     otherwise: Joi.forbidden()
@@ -786,6 +790,7 @@ const baseSchema = {
 const cubeSchema = inherit(baseSchema, {
   sql: Joi.func(),
   sqlTable: Joi.func(),
+  calendar: Joi.boolean().strict(),
 }).xor('sql', 'sqlTable').messages({
   'object.xor': 'You must use either sql or sqlTable within a model, but not both'
 });