Release v6.0.0 (#194)

* Feature/soql evaluator (#193)

* evaluate

* Evaluate

* Evaluate

* SOQL Evaluator

* SOQLEvaluator_Test

* SOQLEvaluator_Test

* SOQLEvaluator_Test

* SOQLEvaluator_Test

* Refactoring

* Caching improvements (#195)

* Multiple conditions possibility

* SOQLCache

* ignore conditions

* additionalAllowedConditionFields

* toIdOf

* Refactoring

* Refactoring

* Refactoring

* Refactoring

* query relationship fields support

* Examples improvement

* docusaurus update

* documentation

* documentation update

* Documentation Update

* Documentation

* documentation

* dark mode

* documentation

* soql cache documentation

* Fix links

* Documentation

* links

* Fix links

* installation

* documentation

* documentation

* documentation

* fix link

* SOQL_Cache code coverage

* SOQLEvaluator_Test code coverage

* SOQL_Test code coverage

* Fix SOQLEvaluator_Test

* documentation update

Author: pgajek2

README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <a href="https://nextjs.org">
+  <a href="https://soql.beyondthecloud.dev">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="https://soql.beyondthecloud.dev/img/logo.png">
       <img alt="SOQL Lib logo" src="https://soql.beyondthecloud.dev/img/logo.png" height="98">
@@ -13,8 +13,6 @@
 
 ![Deploy to Scratch Org and run tests](https://github.com/beyond-the-cloud-dev/soql-lib/actions/workflows/ci.yml/badge.svg)
 [![codecov](https://codecov.io/gh/beyond-the-cloud-dev/soql-lib/branch/main/graph/badge.svg)](https://codecov.io/gh/beyond-the-cloud-dev/soql-lib)
-
-
 </div>
 
 # Getting Started

force-app/main/default/classes/examples/ExampleController.cls

@@ -9,7 +9,10 @@ public with sharing class ExampleController {
 
     @AuraEnabled
     public static List<Contact> getContactsRelatedToAccount(Id accountId) {
-        return SOQL_Contact.query().byAccountId(accountId).toList();
+        return SOQL_Contact.query()
+            .byAccountId(accountId)
+            .with(Contact.Email, Contact.Title)
+            .toList();
     }
 
     @AuraEnabled
@@ -43,11 +46,19 @@ public with sharing class ExampleController {
 
     @AuraEnabled
     public static List<Opportunity> getOpportunitiesRelatedToAccount(Id accountId) {
-        return SOQL_Opportunity.query().byAccountId(accountId).toList();
+        return SOQL_Opportunity.query()
+            .byAccountId(accountId)
+            .with(Opportunity.Name, Opportunity.StageName)
+            .toList();
     }
 
     @AuraEnabled
     public static Integer getOpportunityAmount(Id opportunityId) {
         return (Integer) SOQL_Opportunity.query().byId(opportunityId).toValueOf(Opportunity.Amount);
     }
+
+    @AuraEnabled
+    public static List<Account> getAllAccount() {
+        return SOQLEvaluator.of([SELECT Id, Name FROM Account WITH USER_MODE]).toList();
+    }
 }

force-app/main/default/classes/examples/cached-selectors/SOQL_CachedOrgWideEmailAddress.cls

@@ -12,6 +12,10 @@ public without sharing class SOQL_CachedOrgWideEmailAddress extends SOQLCache im
         return SOQL.of(OrgWideEmailAddress.SObjectType);
     }
 
+    public override List<SObjectField> additionalAllowedConditionFields() {
+        return new List<SObjectField>{ OrgWideEmailAddress.Address };
+    }
+
     public SOQL_CachedOrgWideEmailAddress byAddress(String address) {
         whereEqual(OrgWideEmailAddress.Address, address);
         return this;

force-app/main/default/classes/examples/cached-selectors/SOQL_CachedUser.cls

@@ -13,6 +13,10 @@ public without sharing class SOQL_CachedUser extends SOQLCache implements SOQLCa
         return SOQL.of(User.SObjectType).whereAre(SOQL.Filter.id().equal(UserInfo.getUserId()));
     }
 
+    public override List<SObjectField> additionalAllowedConditionFields() {
+        return new List<SObjectField>{ User.Username };
+    }
+
     public SOQL_CachedUser byUsername(String username) {
         whereEqual(User.Username, username);
         return this;

force-app/main/default/classes/examples/standard-selectors/SOQL_Account.cls

@@ -1,5 +1,6 @@
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
-    public static final String MOCK_ID = 'SOQL_Account';
+    @TestVisible
+    private static final String MOCK_ID = 'SOQL_Account';
 
     public static SOQL_Account query() {
         return new SOQL_Account();

force-app/main/default/classes/examples/standard-selectors/SOQL_Contact.cls

@@ -1,5 +1,6 @@
 public inherited sharing class SOQL_Contact extends SOQL implements SOQL.Selector {
-    public static final String MOCK_ID = 'SOQL_Contact';
+    @TestVisible
+    private static final String MOCK_ID = 'SOQL_Contact';
 
     public static SOQL_Contact query() {
         return new SOQL_Contact();

force-app/main/default/classes/examples/standard-selectors/SOQL_Opportunity.cls

@@ -1,5 +1,6 @@
 public inherited sharing class SOQL_Opportunity extends SOQL implements SOQL.Selector {
-    public static final String MOCK_ID = 'SOQL_Opportunity';
+    @TestVisible
+    private static final String MOCK_ID = 'SOQL_Opportunity';
 
     public static SOQL_Opportunity query() {
         return new SOQL_Opportunity();

force-app/main/default/classes/main/cached-soql/CacheManager.cls

@@ -7,7 +7,7 @@
  * - PropertyNamingConventions: It was intentional to make the lib more fluent and readable
  * - FieldNamingConventions: It was intentional to make the lib more fluent and readable
 **/
-@SuppressWarnings('PMD.CognitiveComplexity, PMD.PropertyNamingConventions, PMD.FieldNamingConventions')
+@SuppressWarnings('PMD.CognitiveComplexity,PMD.PropertyNamingConventions,PMD.FieldNamingConventions')
 public with sharing class CacheManager {
     public interface Cacheable {
         Boolean contains(String key);