feat(tesseract): add default value filter schema for views

Adds a view-only top-level `filters` field accepting entries with
`member`, `operator`, `values`, and optional `unless`. Wires the new
member/values/unless paths into the JS and YAML transpilers, and
rejects `filters` on regular cubes via Joi's unknown-key validation.

Author: waralexrom

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

@@ -1130,6 +1130,41 @@ const folderSchema = Joi.object().keys({
   ]).required(),
 }).id('folderSchema');
 
+const ViewFilterSchema = Joi.object().keys({
+  member: Joi.func().required(),
+  operator: Joi.any().valid(
+    'equals',
+    'notEquals',
+    'contains',
+    'notContains',
+    'startsWith',
+    'notStartsWith',
+    'endsWith',
+    'notEndsWith',
+    'in',
+    'notIn',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'set',
+    'notSet',
+    'inDateRange',
+    'notInDateRange',
+    'onTheDate',
+    'beforeDate',
+    'beforeOrOnDate',
+    'afterDate',
+    'afterOrOnDate',
+  ).required(),
+  values: Joi.when('operator', {
+    is: Joi.valid('set', 'notSet'),
+    then: Joi.func().optional(),
+    otherwise: Joi.func().required()
+  }),
+  unless: Joi.func(),
+});
+
 const viewSchema = inherit(baseSchema, {
   isView: Joi.boolean().strict(),
   viewGroup: Joi.alternatives([Joi.string(), Joi.func()]),
@@ -1160,6 +1195,7 @@ const viewSchema = inherit(baseSchema, {
     })
   ),
   folders: Joi.array().items(folderSchema),
+  filters: Joi.array().items(ViewFilterSchema),
 });
 
 function formatErrorMessageFromDetails(explain, d) {

packages/cubejs-schema-compiler/src/compiler/transpilers/CubePropContextTranspiler.ts

@@ -37,6 +37,9 @@ export const transpiledFieldsPatterns: Array<RegExp> = [
   /^(accessPolicy|access_policy)\.[0-9]+\.(rowLevel|row_level)\.filters\.[0-9]+.*\.member$/,
   /^(accessPolicy|access_policy)\.[0-9]+\.(rowLevel|row_level)\.filters\.[0-9]+.*\.values$/,
   /^(accessPolicy|access_policy)\.[0-9]+\.conditions.[0-9]+\.if$/,
+  /^filters\.[0-9]+\.member$/,
+  /^filters\.[0-9]+\.values$/,
+  /^filters\.[0-9]+\.unless$/,
   /^(measures|dimensions)\.[_a-zA-Z][_a-zA-Z0-9]*\.mask\.sql$/,
 ];
 

packages/cubejs-schema-compiler/test/unit/cube-validator.test.ts

@@ -210,6 +210,148 @@ describe('Cube Validation', () => {
     expect(validationResult.error).toBeFalsy();
   });
 
+  describe('view default value filters', () => {
+    const silentReporter = new ConsoleErrorReporter();
+
+    it('view with default value filter - correct', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders_view',
+        isView: true,
+        fileName: 'fileName',
+        filters: [
+          {
+            member: () => 'currency',
+            operator: 'equals',
+            values: () => ['USD'],
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeFalsy();
+    });
+
+    it('view with default value filter and unless - correct', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders_view',
+        isView: true,
+        fileName: 'fileName',
+        filters: [
+          {
+            member: () => 'currency',
+            operator: 'equals',
+            values: () => ['USD'],
+            unless: () => ['currency'],
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeFalsy();
+    });
+
+    it('view filter with set operator does not require values - correct', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders_view',
+        isView: true,
+        fileName: 'fileName',
+        filters: [
+          {
+            member: () => 'currency',
+            operator: 'set',
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeFalsy();
+    });
+
+    it('view filter with missing required values - error', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders_view',
+        isView: true,
+        fileName: 'fileName',
+        filters: [
+          {
+            member: () => 'currency',
+            operator: 'equals',
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeTruthy();
+    });
+
+    it('view filter with missing member - error', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders_view',
+        isView: true,
+        fileName: 'fileName',
+        filters: [
+          {
+            operator: 'equals',
+            values: () => ['USD'],
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeTruthy();
+    });
+
+    it('view filter with invalid operator - error', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders_view',
+        isView: true,
+        fileName: 'fileName',
+        filters: [
+          {
+            member: () => 'currency',
+            operator: 'someInvalidOperator',
+            values: () => ['USD'],
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeTruthy();
+    });
+
+    it('regular cube with default value filter - error', async () => {
+      const cubeValidator = new CubeValidator(new CubeSymbols());
+      const cube = {
+        name: 'orders',
+        sql: () => 'SELECT * FROM orders',
+        fileName: 'fileName',
+        filters: [
+          {
+            member: () => 'currency',
+            operator: 'equals',
+            values: () => ['USD'],
+          },
+        ],
+      };
+
+      const validationResult = cubeValidator.validate(cube, silentReporter);
+
+      expect(validationResult.error).toBeTruthy();
+    });
+  });
+
   it('refreshKey alternatives', async () => {
     const cubeValidator = new CubeValidator(new CubeSymbols());
     const cube = {