Creating an in-memory database so queries don't have to go through Salesforce and instead can be executed through code. (#142)

Author: cesarParra

.idea/inspectionProfiles/Project_Default.xml

@@ -1,7 +1,12 @@
 {
   "orgName": "Expression Dev",
   "edition": "Developer",
-  "features": ["EnableSetPasswordInApi", "Communities", "Sites"],
+  "features": [
+    "EnableSetPasswordInApi",
+    "Communities",
+    "Sites",
+    "AuthorApex"
+  ],
   "settings": {
     "experienceBundleSettings": {
       "enableExperienceBundleMetadata": true

config/dev-communities.json

@@ -85,7 +85,7 @@ Format: `CASE(expression,value1, result1, value2, result2,..., else_result)`
 ```apex
 Account testAccount = new Account(Rating = 'Hot');
 Object result = expression.Evaluator.run(
-    'CASE(Rating, "Hot", "🔥", "Cold", "🧊", "🤷")', 
+    'CASE(Rating, "Hot", "🔥", "Cold", "🧊", "🤷")',
     testAccount); // "🔥"
 ```
 
@@ -176,8 +176,10 @@ expression.Evaluator.run('LEN("Hello World")'); // 11
 
 - `LIKE`
 
-Returns TRUE if a text field matches a given pattern. The pattern can include regular characters and wildcard characters.
-The supported wildcard characters are the percent sign (%), which matches zero or more characters, and the underscore (_),
+Returns TRUE if a text field matches a given pattern. The pattern can include regular characters and wildcard
+characters.
+The supported wildcard characters are the percent sign (%), which matches zero or more characters, and the
+underscore (_),
 which matches exactly one character.
 
 Accepts 2 arguments: the text to evaluate and the pattern to match.
@@ -277,7 +279,9 @@ Inserts a line break in a string of text.
 
 When no arguments are provided, it inserts a line break. When a number is provided, it inserts that number of line
 
-⚠️ Note that the inserted line break depends on the call context based on the [Request Quiddity](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_enum_System_Quiddity.htm). When called from
+⚠️ Note that the inserted line break depends on the call context based on
+the [Request Quiddity](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_enum_System_Quiddity.htm).
+When called from
 an Aura/LWC or Visualforce context it will insert a `<br>` tag, otherwise it will insert a newline character.
 
 ```apex
@@ -372,6 +376,16 @@ Accepts 3 arguments: the year, month, and day.
 expression.Evaluator.run('DATE(2020, 1, 1)'); // 2020-01-01
 ```
 
+- `DATETIME`
+
+Returns a datetime value from the provided year, month, day, hour, minute, and second values.
+
+Accepts 6 arguments: the year, month, day, hour, minute, and second.
+
+```apex
+expression.Evaluator.run('DATETIME(2020, 1, 1, 12, 0, 0)'); // 2020-01-01 12:00:00
+```
+
 - `ADDMONTHS`
 
 Returns a date that is a specified number of months before or after a given date.
@@ -780,7 +794,8 @@ Accepts 2 arguments: List of objects and an expression to evaluate.
 Object result = expression.Evaluator.run('MAP(["a", "b", "c"], UPPER($current))'); // ["A", "B", "C"]
 ```
 
-To work with child records, you can specify the child relationship name as the first argument, and then the expression to evaluate on each
+To work with child records, you can specify the child relationship name as the first argument, and then the expression
+to evaluate on each
 child item as the second argument.
 
 > When referencing child data through the record Id endpoint, the framework will take care of any necessary
@@ -820,12 +835,14 @@ expression.Evaluator.run('RANGE(1, 3)'); // (1, 2, 3)
 
 - `REDUCE`
 
-Reduces a list to a single value using the first argument as the context, the second argument as the expression to evaluate,
+Reduces a list to a single value using the first argument as the context, the second argument as the expression to
+evaluate,
 and the third argument as the initial value.
 
 Accepts 3 arguments: List of objects, an expression to evaluate, and the initial value.
 
 Provides 2 special variables in the inner expression:
+
 - `$current` - the current item being iterated over
 - `$accumulator` - the current value of the accumulator that will be returned
 
@@ -863,22 +880,27 @@ Sorts a list.
 
 Accepts at least one argument: the list to sort.
 When sorting a list of Maps or a list of SObjects,
-two additional arguments can be provided: the field to sort by and the sort direction.
+three additional arguments can be provided: the field to sort by, the sort direction, and
+and the position of nulls (nulls first or nulls last).
 
-The field to sort can either be a field name as a merge field (field name without quotes), or an expression that evaluates to a string
-representing the field name. Merge fields are only supported when sorting SObjects and are useful to get the framework to automatically
+The field to sort can either be a field name as a merge field (field name without quotes), or an expression that
+evaluates to a string
+representing the field name. Merge fields are only supported when sorting SObjects and are useful to get the framework
+to automatically
 query the field for you.
 
 > The merge field must be a field on the SObject being sorted itself, not a relationship field.
 
 The sort direction can either be the literal string (requires quotes) `ASC` or `DESC`.
+The position of nulls can either be the literal string (requires quotes) `NULLS_FIRST` or `NULLS_LAST`.
 
 ```apex
 expression.Evaluator.run('SORT([3, 2, 1])'); // (1, 2, 3)
 expression.Evaluator.run('SORT([{ "a": 3 }, { "a": 2 }, { "a": 1 }], "a")'); // ({ "a": 1 }, { "a": 2 }, { "a": 3 })
 expression.Evaluator.run('SORT([{ "a": 3 }, { "a": 2 }, { "a": 1 }], "a", "DESC")'); // ({ "a": 3 }, { "a": 2 }, { "a": 1 })
 expression.Evaluator.run('QUERY(Account["Name"]) -> SORT("Name")'); // ({"Name": "ACME"}, {"Name": "Another Account"})
 expression.Evaluator.run('SORT(ChildAccounts, NumberOfEmployees, "asc")', parentAccount.Id); // ({"NumberOfEmployees": 1}, {"NumberOfEmployees": 2})
+expression.Evaluator.run('SORT(ChildAccounts, NumberOfEmployees, "asc", "NULLS_LAST")', parentAccount.Id); // ({"NumberOfEmployees": 1}, {"NumberOfEmployees": 2}, {"NumberOfEmployees": null})
 ```
 
 - `SKIP`
@@ -1187,4 +1209,5 @@ Accepts 3 arguments: the first location, the second location, and the unit (eith
 ```apex
 expression.Evaluator.run('DISTANCE(LOCATION(37.7749, 122.4194), LOCATION(40.7128, 74.0060), "mi")'); // 2565.6985207767134
 ```
+
 ---

docs/src/app/docs/functions/page.md

@@ -7,7 +7,7 @@ const variables = {
   tags,
   nodes,
   variables: {
-    packageId: "04tRb000000yvufIAA",
+    packageId: "04tRb000000zZVVIA2",
     componentPackageId: "04tRb000000sGz3IAE",
     urlPrefix: IS_PROD ? "/expression" : "",
   }

docs/src/markdoc/config.js

@@ -27,7 +27,7 @@ private class PlaygroundControllerTest {
     @IsTest
     static void validatesAValidExpressionWithAnId() {
         Account testAccount = new Account(Name = 'Test');
-        insert testAccount;
+        QDB.getInstance().doInsert(testAccount);
 
         PlaygroundController.Result result = PlaygroundController.validate(
             'Name',
@@ -43,9 +43,9 @@ private class PlaygroundControllerTest {
     static void validatesAnExpressionWithManyIdsSeparatedByComma() {
         Account testAccount1 = new Account(Name = 'Test');
         Account testAccount2 = new Account(Name = 'Test');
-        insert new List<Account>{
+        QDB.getInstance().doInsert(new List<Account>{
             testAccount1, testAccount2
-        };
+        });
 
         PlaygroundController.Result result = PlaygroundController.validate(
             'MAP(@Context, Name)',

expression-src/main/editor/controllers/tests/PlaygroundControllerTest.cls

@@ -221,9 +221,9 @@ export const data = [
       {
         "name": "SORT",
         "autoCompleteValue": "SORT(",
-        "description": "Sorts a list.<br/>Accepts at least one argument: the list to sort.<br/>When sorting a list of Maps or a list of SObjects,<br/>two additional arguments can be provided: the field to sort by and the sort direction.<br/>The field to sort can either be a field name as a merge field (field name without quotes), or an expression that evaluates to a string<br/>representing the field name. Merge fields are only supported when sorting SObjects and are useful to get the framework to automatically<br/>query the field for you.<br/>Note: The merge field must be a field on the SObject being sorted itself, not a relationship field.<br/>The sort direction can either be the literal string (requires quotes) `ASC` or `DESC`.",
+        "description": "Sorts a list.<br/>Accepts at least one argument: the list to sort.<br/>When sorting a list of Maps or a list of SObjects,<br/>three additional arguments can be provided: the field to sort by, the sort direction, and the position of nulls<br/>(nulls first or nulls last).<br/>The field to sort can either be a field name as a merge field (field name without quotes), or an expression that evaluates to a string<br/>representing the field name. Merge fields are only supported when sorting SObjects and are useful to get the framework to automatically<br/>query the field for you.<br/>Note: The merge field must be a field on the SObject being sorted itself, not a relationship field.<br/>The sort direction can either be the literal string (requires quotes) `ASC` or `DESC`.<br/>The position of nulls can either be the literal string (requires quotes) `NULLS_FIRST` or `NULLS_LAST`.",
         "examples": [
-          "SORT([{ \"a\": 3 }, { \"a\": 2 }, { \"a\": 1 }], \"a\", \"DESC\") // [{ \"a\": 3 }, { \"a\": 2 }, { \"a\": 1 }]"
+          "SORT([{ \"a\": 3 }, { \"a\": 2 }, { \"a\": 1 }], \"a\", \"DESC\") // [{ \"a\": 3 }, { \"a\": 2 }, { \"a\": 1 }]\nSORT([SObject1, SObject2, SObject3], \"Name\", \"ASC\", \"NULLS_LAST\") // [SObject1, SObject2, SObject3]"
         ],
         "icon": "utility:justify_text"
       },
@@ -327,6 +327,15 @@ export const data = [
         ],
         "icon": "utility:date_input"
       },
+      {
+        "name": "DATETIME",
+        "autoCompleteValue": "DATETIME(",
+        "description": "Returns a datetime value from the provided year, month, day, hour, minute, and second values.<br/>Accepts 6 arguments: the year, month, day, hour, minute, and second.",
+        "examples": [
+          "DATETIME(2020, 1, 1, 12, 0, 0) // 2020-01-01 12:00:00"
+        ],
+        "icon": "utility:date_input"
+      },
       {
         "name": "DATETIMEFORMAT",
         "autoCompleteValue": "DATETIMEFORMAT(",

expression-src/main/editor/lwc/functionLibrary/functions.js

@@ -0,0 +1,22 @@
+public with sharing class SchemaUtils {
+    /**
+     * @description Returns the valid relationship name (accounting for casing) for a child relationship on an SObject.
+     * @param potentiallyInvalidName The potentially invalid relationship name.
+     * @param sType The SObjectType to check the relationship name against.
+     * @return The valid relationship name.
+     * @throws InvalidRelationshipException If the relationship name is not valid for the SObjectType.
+     */
+    public static String getValidChildRelationshipName(String potentiallyInvalidName, SObjectType sType) {
+        for (ChildRelationship relationship : sType.getDescribe().getChildRelationships()) {
+            if (potentiallyInvalidName.equalsIgnoreCase(relationship.getRelationshipName())) {
+                return relationship.getRelationshipName();
+            }
+        }
+
+        throw new InvalidRelationshipException(
+            'The relationship name "' + potentiallyInvalidName + '" is not a valid relationship name for the ' + sType.getDescribe().getName() + ' object.'
+        );
+    }
+
+    public class InvalidRelationshipException extends Exception {}
+}

expression-src/main/src/helpers/QRunner.cls

@@ -1,25 +1,24 @@
 /**
  * @description Q is used to build SOQL statements
  * @author Jean-Philippe Monette
- * @since 2017-03-21
  */
 public class Q {
-    private final String fromText;
-    private Integer numberOfRows;
-    private Integer numberOfRowsToSkip;
+    public final String FromText { get; private set; }
+    public Integer NumberOfRowsToQuery { get; private set; }
+    public Integer NumberOfRowsToSkip { get; private set; }
 
-    private final Set<String> fieldList = new Set<String>();
-    private final List<QOrder> orders = new List<QOrder>();
-    private final List<QICondition> conditions = new List<QICondition>();
-    private final List<Q> subQueries = new List<Q>();
+    public final Set<String> fieldList = new Set<String>();
+    public final List<QOrder> orders = new List<QOrder>();
+    public final List<QICondition> conditions = new List<QICondition>();
+    public final List<Q> subQueries = new List<Q>();
 
     public Q(SObjectType fromType) {
-        this.fromText = String.valueOf(fromType);
-    }
-    public Q(String fromText) {
-        this.fromText = fromText;
+        this.FromText = String.valueOf(fromType);
     }
 
+    public Q(String FromText) {
+        this.FromText = FromText;
+    }
 
     public static QOrder orderBy(String fieldName) {
         QOrder od = new QOrder(fieldName);
@@ -59,12 +58,12 @@ public class Q {
     }
 
     public Q addLimit(Integer i) {
-        this.numberOfRows = i;
+        this.NumberOfRowsToQuery = i;
         return this;
     }
 
     public Q addOffset(Integer i) {
-        this.numberOfRowsToSkip = i;
+        this.NumberOfRowsToSkip = i;
         return this;
     }
 
@@ -77,70 +76,4 @@ public class Q {
         QAndGroup andGroup = new QAndGroup();
         return andGroup;
     }
-
-    public String buildSelect() {
-        for (Q qb : this.subQueries) {
-            this.fieldList.add('(' + qb.build() + ')');
-        }
-
-        if (!this.fieldList.isEmpty()) {
-            return 'SELECT ' + String.join(new List<String>(this.fieldList), ', ');
-        } else {
-            return 'SELECT Id';
-        }
-    }
-
-    public String buildConditions() {
-        List<String> condList = new List<String>();
-
-        for (QICondition cond : this.conditions) {
-            condList.add(cond.build());
-        }
-
-        if (!this.conditions.isEmpty()) {
-            return 'WHERE ' + String.join(condList, ' AND ');
-        } else {
-            return null;
-        }
-    }
-
-    public String buildOrderBy() {
-        List<String> orderList = new List<String>();
-
-        for (QOrder order : this.orders) {
-            orderList.add(order.build());
-        }
-
-        if (!this.orders.isEmpty()) {
-            return 'ORDER BY ' + String.join(orderList, ', ');
-        } else {
-            return '';
-        }
-
-    }
-
-    public String build() {
-        List<String> queryParts = new List<String>();
-
-        queryParts.add(this.buildSelect());
-        queryParts.add('FROM ' + this.fromText);
-
-        if (!this.conditions.isEmpty()) {
-            queryParts.add(this.buildConditions());
-        }
-
-        if (!this.orders.isEmpty()) {
-            queryParts.add(this.buildOrderBy());
-        }
-
-        if (this.numberOfRows != null) {
-            queryParts.add('LIMIT ' + this.numberOfRows);
-        }
-
-        if (this.numberOfRowsToSkip != null) {
-            queryParts.add('OFFSET ' + this.numberOfRowsToSkip);
-        }
-
-        return String.join(queryParts, ' ');
-    }
 }