docs: Multi-tenant scheduled_refresh_time_zones

Author: igorlukanin

docs/pages/product/configuration/advanced/multitenancy.mdx

@@ -9,16 +9,19 @@ Cube supports multitenancy out of the box, both on database and data model
 levels. Multiple drivers are also supported, meaning that you can have one
 customer’s data in MongoDB and others in Postgres with one Cube instance.
 
-There are 6 [configuration options][ref-config-opts] you can leverage to make
+There are several [configuration options][ref-config-opts] you can leverage for
 your multitenancy setup. You can use all of them or just a couple, depending on
 your specific case. The options are:
 
-- `contextToAppId`
-- `contextToOrchestratorId`
-- `driverFactory`
-- `repositoryFactory`
-- `preAggregationsSchema`
-- `queryRewrite`
+- `context_to_app_id`
+- `schema_version`
+- `repository_factory`
+- `driver_factory`
+- `context_to_orchestrator_id`
+- `pre_aggregations_schema`
+- `query_rewrite`
+- `scheduled_refresh_contexts`
+- `scheduled_refresh_time_zones`
 
 All of the above options are functions, which you provide to Cube in the
 [`cube.js` configuration file][ref-config]. The functions accept one argument -
@@ -360,12 +363,12 @@ module.exports = {
 
 If you need scheduled refreshes for your pre-aggregations in a multi-tenant
 deployment, ensure you have configured
-[`scheduledRefreshContexts`][ref-config-refresh-ctx] correctly. You may also
-need to configure [`scheduledRefreshTimeZones`][ref-config-refresh-tz].
+[`scheduled_refresh_contexts`][ref-config-refresh-ctx] correctly. You may also
+need to configure [`scheduled_refresh_time_zones`][ref-config-refresh-tz].
 
 <WarningBox>
 
-Leaving [`scheduledRefreshContexts`][ref-config-refresh-ctx] unconfigured will
+Leaving [`scheduled_refresh_contexts`][ref-config-refresh-ctx] unconfigured will
 lead to issues where the security context will be `undefined`. This is because
 there is no way for Cube to know how to generate a context without the required
 input.

docs/pages/reference/configuration/config.mdx

@@ -654,32 +654,61 @@ You may also need to configure
 This option specifies a list of time zones that pre-aggregations will be built
 for. It has impact on [pre-aggregation matching][ref-matching-preaggs].
 
-You can specify multiple timezones in the [TZ Database Name][link-wiki-tz]
-format, e.g., `America/Los_Angeles`:
+Either an array or function returning an array can be passed. Providing a function
+allows to set the time zones dynamically depending on the security context.
+
+Time zones should be specified in the [TZ Database Name][link-wiki-tz] format,
+e.g., `America/Los_Angeles`.
 
 <CodeTabs>
 
 ```python
 from cube import config
 
+# An array of time zones
 config.scheduled_refresh_time_zones = [
   'America/Vancouver',
   'America/Toronto'
 ]
+
+# Alternatively, a function returning an array of time zones
+@config('scheduled_refresh_time_zones')
+def scheduled_refresh_time_zones(ctx: dict) -> list[str]:
+  time_zones = {
+    'tenant_1': ['America/New_York'],
+    'tenant_2': ['America/Chicago'],
+    'tenant_3': ['America/Los_Angeles']
+  }
+  default_time_zones = ['UTC']
+  tenant_id = ctx['securityContext']['tenant_id']
+  return time_zones.get(tenant_id, default_time_zones)
 ```
 
 ```javascript
 module.exports = {
+  // An array of time zones
   scheduledRefreshTimeZones: [
     'America/Vancouver',
     'America/Toronto'
-  ]
+  ],
+
+  // Alternatively, a function returning an array of time zones
+  scheduledRefreshTimeZones: ({ securityContext }) => {
+    let time_zones = {
+      'tenant_1': ['America/New_York'],
+      'tenant_2': ['America/Chicago'],
+      'tenant_3': ['America/Los_Angeles']
+    }
+    let default_time_zones = ['UTC']  
+    let tenant_id = securityContext.tenant_id
+    return time_zones[tenant_id] || default_time_zones
+  }
 };
 ```
 
 </CodeTabs>
 
-The default value is a list of a single time zone. `UTC`.
+The default value is a list of a single time zone: `UTC`.
 
 This configuration option can also be set using the
 `CUBEJS_SCHEDULED_REFRESH_TIMEZONES` environment variable.