Summer '23 Release (API v58.0) - v4.11.0

.forceignore

@@ -4,6 +4,7 @@
 
 nebula-logger/managed-package/sfdx-project.json
 nebula-logger/managed-package/**/*.animationRule-meta.xml
+nebula-logger/managed-package/**/*.indx-meta.xml
 nebula-logger/managed-package/**/*.testSuite-meta.xml
 /**/Admin.profile-meta.xml
 
@@ -17,4 +18,4 @@ nebula-logger/managed-package/**/*.testSuite-meta.xml
 
 # LWC Jest
 **/__tests__/**
-**/jest-mocks/**
+**/jest-mocks/**

.github/workflows/build.yml

@@ -362,7 +362,7 @@ jobs:
                   npx sfdx bummer:package:aliases:sort
                   npx prettier --write ./sfdx-project.json
                   git add ./sfdx-project.json
-                  git commit -m "Created new package version"
+                  git commit -m "Created new core unlocked package version"
                   git push
 
     promote-package-versions:

README.md

@@ -5,21 +5,27 @@
 
 The most robust logger for Salesforce. Works with Apex, Lightning Components, Flow, Process Builder & Integrations. Designed for Salesforce admins, developers & architects.
 
-## Unlocked Package - v4.10.6
+## Unlocked Package - v4.11.0
 
-[![Install Unlocked Package in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000023SCqQAM)
-[![Install Unlocked Package in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000023SCqQAM)
+[![Install Unlocked Package in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000023SI6QAM)
+[![Install Unlocked Package in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000023SI6QAM)
 [![View Documentation](./images/btn-view-documentation.png)](https://jongpie.github.io/NebulaLogger/)
 
-`sfdx package install --wait 20 --security-type AdminsOnly --package 04t5Y0000023SCqQAM`
+`sf package install --wait 20 --security-type AdminsOnly --package 04t5Y0000023SI6QAM`
 
-## Managed Package - v4.10.0
+`sfdx force:package:install --wait 20 --securitytype AdminsOnly --package 04t5Y0000023SI6QAM`
 
-[![Install Managed Package in a Sandbox](./images/btn-install-managed-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?mgd=true&p0=04t5Y0000015nWeQAI)
-[![Install Managed Package in Production](./images/btn-install-managed-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?mgd=true&p0=04t5Y0000015nWeQAI)
-[![View Milestone](./images/btn-view-managed-package-milestone.png)](https://github.com/jongpie/NebulaLogger/milestone/10?closed=1)
+---
+
+## Managed Package - v4.11.0
+
+[![Install Managed Package in a Sandbox](./images/btn-install-managed-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?mgd=true&p0=04t5Y0000023SI1QAM)
+[![Install Managed Package in Production](./images/btn-install-managed-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?mgd=true&p0=04t5Y0000023SI1QAM)
+[![View Milestone](./images/btn-view-managed-package-milestone.png)](https://github.com/jongpie/NebulaLogger/milestone/11?closed=1)
+
+`sf package install --wait 30 --security-type AdminsOnly --package 04t5Y0000023SI1QAM`
 
-`sfdx package install --wait 30 --security-type AdminsOnly --package 04t5Y0000015nWeQAI`
+`sfdx force:package:install --wait 20 --securitytype AdminsOnly --package 04t5Y0000023SI1QAM`
 
 ---
 

config/experience-cloud/classes/ChangePasswordController.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/ChangePasswordControllerTest.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/ForgotPasswordController.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/ForgotPasswordControllerTest.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/MicrobatchSelfRegController.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/MicrobatchSelfRegControllerTest.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/MyProfilePageController.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/MyProfilePageControllerTest.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/SiteLoginController.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/SiteLoginControllerTest.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/SiteRegisterController.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/classes/SiteRegisterControllerTest.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

config/experience-cloud/pages/BandwidthExceeded.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página predeterminada de límite superado de Plataforma Lightning</description>

config/experience-cloud/pages/ChangePassword.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página de cambio de contraseña predeterminada de Sitios de Salesforce</description>

config/experience-cloud/pages/CommunitiesLanding.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página de inicio de experiencias predeterminadas</description>

config/experience-cloud/pages/CommunitiesLogin.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página de inicio de sesión para experiencias predeterminadas</description>

config/experience-cloud/pages/CommunitiesSelfReg.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página de inscripción automática de experiencias predeterminadas</description>

config/experience-cloud/pages/CommunitiesSelfRegConfirm.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página de confirmación de registro de experiencias predeterminadas</description>

config/experience-cloud/pages/Exception.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página predeterminada de Plataforma Lightning para errores post-autenticación</description>

config/experience-cloud/pages/FileNotFound.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página predeterminada de página/datos no encontrados de Plataforma Lightning</description>

config/experience-cloud/pages/ForgotPasswordConfirm.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página Contraseña olvidada predeterminada de Sitios de Salesforce</description>

config/experience-cloud/pages/InMaintenance.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página predeterminada de Plataforma Lightning en mantenimiento</description>

config/experience-cloud/pages/SiteRegisterConfirm.page-meta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <availableInTouch>false</availableInTouch>
     <confirmationTokenRequired>false</confirmationTokenRequired>
     <description>Página Confirmación de registro de usuario predeterminada de Sitios de Salesforce</description>

config/linters/lint-staged.config.js

@@ -2,9 +2,11 @@ module.exports = {
     'sfdx-project.json': () => {
         return `npm run package:version:number:fix`;
     },
-    '*.{cls,cmp,component,css,html,js,json,md,page,trigger,yaml,yml}': filenames => filenames.map(filename => `prettier --write '${filename}'`),
+    '*.{cls,cmp,component,css,html,js,json,md,page,trigger,xml,yaml,yml}': filenames => filenames.map(filename => `prettier --write '${filename}'`),
     '**/lwc/**': filenames => {
-        return [`eslint --config ./config/linters/.eslintrc.json ${filenames.join(' ')} --fix`, `npm run test:lwc`];
+        return [`eslint --config ./config/linters/.eslintrc.json ${filenames.join(' ')} --fix`];
+        // FIXME this command should only run tests for the changed LWCs (instead of running tests for all LWCs)
+        // return [`eslint --config ./config/linters/.eslintrc.json ${filenames.join(' ')} --fix`, `npm run test:lwc`];
     }
     // FIXME this command should only scan the changed Apex files (instead of scanning all Apex files)
     // '*.{cls,trigger}': () => {

docs/apex/Configuration/LoggerParameter.md

@@ -14,6 +14,10 @@ Provides a centralized way to load parameters for SObject handlers & plugins
 
 Indicates if Nebula Logger will make an async callout to `https://api.status.salesforce.com` to get additional details about the current org, which is then stored on the Log\_\_c record. Controlled by the custom metadata record `LoggerParameter.CallStatusApi`, or `false` as the default
 
+#### `ENABLE_LOG_ENTRY_EVENT_STREAM` → `Boolean`
+
+Indicates if Nebula Logger's LWC `logEntryEventStream` is enabled. The component uses the Emp API, which counts towards orgs' daily delivery allocations for platform events. To help reduce usage of the daily allocation limit, orgs can disable the LWC. Controlled by the custom metadata record `LoggerParameter.EnableLogEntryEventStream`, or `true` as the default
+
 #### `ENABLE_STACK_TRACE_PARSING` → `Boolean`
 
 Indicates if Nebula Logger will parse a stack trace for each log entry, which is then used to populate fields like `LogEntry__c.StackTrace__c` and `LogEntry__c.OriginLocation__c`. Controlled by the custom metadata record `LoggerParameter.EnableStackTraceParsing`, or `true` as the default

docs/apex/Configuration/LoggerPlugin.md

@@ -41,6 +41,20 @@ List<LoggerPlugin_t>
 
 The list of matching `LoggerPlugin_t` records
 
+#### `getPluginConfigurations()` → `List<LoggerPlugin_t>`
+
+Returns all enabled `LoggerPlugin_t` records, based on `IsEnabled__c == true`
+
+##### Return
+
+**Type**
+
+List&lt;LoggerPlugin_t&gt;
+
+**Description**
+
+The list of enabled `LoggerPlugin_t` records
+
 #### `newBatchableInstance(String apexClassTypeName)` → `Batchable`
 
 Creates an instance of the class `LoggerPlugin.Batchable` based on the provided `LoggerPlugin_t` configuration

docs/apex/Log-Management/LogEntryEventStreamController.md

@@ -24,4 +24,18 @@ List<String>
 
 The instance of `List<String>`, containing the list of columns to be displayed in
 
+#### `isEnabled()` → `Boolean`
+
+Indicates if the LWC `logEntryEventStream` has been enabled (default) or disabled
+
+##### Return
+
+**Type**
+
+Boolean
+
+**Description**
+
+The `Boolean` value of the `LoggerParameter_t` record `LoggerParameter.EnableLogEntryEventStream`
+
 ---

docs/apex/Log-Management/LoggerHomeHeaderController.md

@@ -34,6 +34,10 @@ An instance of `LoggerHomeHeaderController.Environment`
 
 ##### Properties
 
+###### `loggerEnabledPlugins` → `String`
+
+###### `loggerEnabledPluginsCount` → `Integer`
+
 ###### `loggerNamespacePrefix` → `String`
 
 ###### `loggerVersionNumber` → `String`
@@ -44,8 +48,6 @@ An instance of `LoggerHomeHeaderController.Environment`
 
 ###### `organizationDomainUrl` → `String`
 
-###### `organizationEnvironment` → `String`
-
 ###### `organizationFormattedCreatedDate` → `String`
 
 ###### `organizationId` → `String`
@@ -64,8 +66,6 @@ An instance of `LoggerHomeHeaderController.Environment`
 
 ###### `organizationReleaseVersion` → `String`
 
-###### `organizationStatus` → `String`
-
 ###### `organizationType` → `String`
 
 ---

docs/apex/Logger-Engine/Logger.md

@@ -26,7 +26,7 @@ Enum used to control how LogEntryEvent\_\_e records are inserted
 
 #### `callStatusApi()` → `StatusApiResponse`
 
-**This is only intended to be used internally by Nebula Logger, and is subject to change.** Calls Salesforce's API endpoint https://api.status.salesforce.com/v1/instances/ to get more details about the current org, including the org's release number and release version
+**This is only intended to be used internally by Nebula Logger, and is subject to change.** Calls Salesforce's API endpoint https://api.status.salesforce.com/v1/instances/ to get more details about the current org, including the org's release number and release version. Trust API docs available at https://api.status.salesforce.com/v1/docs/
 
 ##### Return
 

nebula-logger/core/main/configuration/classes/LoggerBatchableContext.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

nebula-logger/core/main/configuration/classes/LoggerCache.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>

nebula-logger/core/main/configuration/classes/LoggerParameter.cls

@@ -30,6 +30,23 @@ public class LoggerParameter {
         private set;
     }
 
+    /**
+     * @description Indicates if Nebula Logger's LWC `logEntryEventStream` is enabled. The component uses
+     *              the Emp API, which counts towards orgs' daily delivery allocations for platform events.
+     *              To help reduce usage of the daily allocation limit, orgs can disable the LWC.
+     *              Controlled by the custom metadata record `LoggerParameter.EnableLogEntryEventStream`,
+     *              or `true` as the default
+     */
+    public static final Boolean ENABLE_LOG_ENTRY_EVENT_STREAM {
+        get {
+            if (ENABLE_LOG_ENTRY_EVENT_STREAM == null) {
+                ENABLE_LOG_ENTRY_EVENT_STREAM = getBoolean('EnableLogEntryEventStream', true);
+            }
+            return ENABLE_LOG_ENTRY_EVENT_STREAM;
+        }
+        private set;
+    }
+
     /**
      * @description Indicates if Nebula Logger will parse a stack trace for each log entry, which is then used to populate
      *              fields like `LogEntry__c.StackTrace__c` and `LogEntry__c.OriginLocation__c`.

nebula-logger/core/main/configuration/classes/LoggerParameter.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>57.0</apiVersion>
+    <apiVersion>58.0</apiVersion>
     <status>Active</status>
 </ApexClass>