Add UserSettings global variable resolution. (#207)

Author: cesarParra

docs/src/app/docs/referencing-org-data/page.md

@@ -47,6 +47,7 @@ Object result = expression.Evaluator.run('$Resource.MyStaticResourceName');
 You can reference information about the current user through the `$User` global variable.
 
 Available references are:
+
 * `DefaultCurrency`
 * `FirstName`
 * `Language`
@@ -59,3 +60,26 @@ Available references are:
 ```apex
 Object result = expression.Evaluator.run('$User.FirstName');
 ```
+
+## User Settings
+
+You can reference user settings using the `$UserSettings` global variable.
+
+This global variable wraps all properties of the `ConnectApi.UserSettings` class,
+so please reference
+the [documentation for that class](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_output_usersettings.htm)
+for available properties.
+
+```apex
+Object result = expression.Evaluator.run('$UserSettings.hasChatter');
+```
+
+### Time Zone
+
+The `timeZone` property of the `$UserSettings` global variable returns a map containing
+`name` and `gmtOffset` properties.
+
+```apex
+Object result = expression.Evaluator.run('$UserSettings.timeZone.name');
+Object gmtOffset = expression.Evaluator.run('$UserSettings.timeZone.gmtOffset');
+```

expression-src/main/src/interpreter/Environment.cls

@@ -22,6 +22,7 @@ public with sharing class Environment {
         GLOBAL_VARIABLES.put('$resource', new StaticResourceVariableResolver());
         GLOBAL_VARIABLES.put('$action', new ActionVariableResolver());
         GLOBAL_VARIABLES.put('$user', new UserVariableResolver());
+        GLOBAL_VARIABLES.put('$usersettings', new UserSettingsVariableResolver());
 
         // Placeholder value for whatever the called Action returned. Not used by language,
         // but can be used by the caller to get the return value of the Action.
@@ -46,11 +47,11 @@ public with sharing class Environment {
         // First try and find it locally
         Object possibleFunction = getVariables().get(lowercasedName);
         if (possibleFunction != null && possibleFunction instanceof Expr.FunctionDeclaration) {
-            return (Expr.FunctionDeclaration) possibleFunction;
+            return (Expr.FunctionDeclaration)possibleFunction;
         }
 
         // Otherwise, look in the global variables
-        return (Expr.FunctionDeclaration) GLOBAL_VARIABLES.get(functionName.toLowerCase());
+        return (Expr.FunctionDeclaration)GLOBAL_VARIABLES.get(functionName.toLowerCase());
     }
 
     /**
@@ -167,7 +168,7 @@ public with sharing class Environment {
     }
 
     public Boolean equals(Object obj) {
-        Environment other = (Environment) obj;
+        Environment other = (Environment)obj;
         return parentEnvironment == other.parentEnvironment && context == other.context && variables.equals(other.variables);
     }
 

…erpreter/CustomLabelVariableResolver.cls …esolvers/CustomLabelVariableResolver.clsexpression-src/main/src/interpreter/CustomLabelVariableResolver.cls renamed to expression-src/main/src/interpreter/variable-resolvers/CustomLabelVariableResolver.cls expression-src/main/src/interpreter/CustomLabelVariableResolver.cls renamed to expression-src/main/src/interpreter/variable-resolvers/CustomLabelVariableResolver.cls

@@ -0,0 +1,100 @@
+public with sharing class UserSettingsVariableResolver implements IGlobalVariableResolver {
+    public Object get(String referenceName, List<Object> args) {
+        switch on referenceName.toLowerCase() {
+            when 'approvalposts' {
+                return getUserSettings().approvalPosts;
+            }
+            when 'canAccesspersonalstreams' {
+                return getUserSettings().canAccessPersonalStreams;
+            }
+            when 'canfollow' {
+                return getUserSettings().canFollow;
+            }
+            when 'canmodifyallData' {
+                return getUserSettings().canModifyAllData;
+            }
+            when 'canowngroups' {
+                return getUserSettings().canOwnGroups;
+            }
+            when 'canviewalldata' {
+                return getUserSettings().canViewAllData;
+            }
+            when 'canviewallgroups' {
+                return getUserSettings().canViewAllGroups;
+            }
+            when 'canviewallusers' {
+                return getUserSettings().canViewAllUsers;
+            }
+            when 'canviewcommunityswitcher' {
+                return getUserSettings().canViewCommunitySwitcher;
+            }
+            when 'canviewfulluserprofile' {
+                return getUserSettings().canViewFullUserProfile;
+            }
+            when 'canviewpublicfiles' {
+                return getUserSettings().canViewPublicFiles;
+            }
+            when 'currencysymbol' {
+                return getUserSettings().currencySymbol;
+            }
+            when 'externaluser' {
+                return getUserSettings().externalUser;
+            }
+            when 'filesynclimit' {
+                return getUserSettings().fileSyncLimit;
+            }
+            when 'filesyncstoragelimit' {
+                return getUserSettings().fileSyncStorageLimit;
+            }
+            when 'foldersynclimit' {
+                return getUserSettings().folderSyncLimit;
+            }
+            when 'hasaccesstointernalorg' {
+                return getUserSettings().hasAccessToInternalOrg;
+            }
+            when 'haschatter' {
+                return getUserSettings().hasChatter;
+            }
+            when 'hasfilesync' {
+                return getUserSettings().hasFileSync;
+            }
+            when 'hasfieldservicelocationtracking' {
+                return getUserSettings().hasFieldServiceLocationTracking;
+            }
+            when 'hasfieldservicemobileaccess' {
+                return getUserSettings().hasFieldServiceMobileAccess;
+            }
+            when 'hasfilesyncmanagedclientautoupdate' {
+                return getUserSettings().hasFileSyncManagedClientAutoUpdate;
+            }
+            when 'hasrestdataapiaccess' {
+                return getUserSettings().hasRestDataApiAccess;
+            }
+            when 'timezone' {
+                ConnectApi.TimeZone timeZone = getUserSettings().timeZone;
+                return new Map<String, Object> {
+                    'name' => timeZone.name,
+                    'gmtOffset' => timeZone.gmtOffset
+                };
+            }
+            when 'userdefaultcurrencyisocode' {
+                return getUserSettings().userDefaultCurrencyIsoCode;
+            }
+            when 'userid' {
+                return getUserSettings().userId;
+            }
+            when 'userlocale' {
+                return getUserSettings().userLocale;
+            }
+            when else {
+                throw new UserSettingsVariableResolverException('Unknown reference name: ' + referenceName);
+            }
+        }
+    }
+
+    private static ConnectApi.UserSettings getUserSettings() {
+        return ConnectApi.Organization.getSettings().userSettings;
+    }
+
+    public class UserSettingsVariableResolverException extends Exception {}
+}