Added plugin framework + re-added Slack integration

README.md

@@ -338,6 +338,35 @@ The class `LogMessage` provides the ability to generate string messages on deman
 
 For more details, check out the `LogMessage` class [documentation](https://jongpie.github.io/NebulaLogger/logger-engine/LogMessage).
 
+### Adding Custom Post-Processors for Log\_\_c and LogEntry\_\_c
+
+If you want to add your own automation to the `Log__c` or `LogEntry__c` objects, you can leverage Apex or Flow to define "post-processors" - the logger system will then automatically run the post-processors after each trigger event (BEFORE_INSERT, BEFORE_UPDATE, AFTER_INSERT, AFTER_UPDATE, and so on)
+
+-   Flow post-processors: your Flow should be built with these input parameters:
+    1. `records` - The list of logger records being processed (`Log__c` or `LogEntry__c` records)
+    2. `oldRecords` - The list of logger records as they exist in the datatabase - this is only populated when running in the context of `Trigger.isUpdate`
+    3. `triggerOperation` - The name of the current trigger operation (such as BEFORE_INSERT, BEFORE_UPDATE, etc.)
+-   Apex post-processors: your Apex class should implement `LoggerPostProcessor`. For example:
+
+    ```java
+    public class ExamplePostProcessor implements LoggerPostProcessor {
+        public void execute(Trigger.operationType triggerOperation, List<Log__c> logs, Map<Id, SObject> oldLoggerRecordsById) {
+            switch on triggerOperation {
+                when BEFORE_INSERT {
+                    for (Log__c log : logs) {
+                        log.Status__c = 'On Hold';
+                    }
+                }
+            }
+        }
+    }
+
+    ```
+
+Once you've created your Apex or Flow post-processor(s), you will also need to configure the custom metadata type `LoggerHandlerConfiguration__mdt` to specify the name(s) of Apex class and Flow to run.
+
+![Logger Handler Configuration](./content/logger-handler-configuration.png)
+
 ## Managing Logs
 
 To help development and support teams better manage logs (and any underlying code or config issues), some fields on `Log__c` are provided to track the owner, priority and status of a log. These fields are optional, but are helpful in critical environments (production, QA sandboxes, UAT sandboxes, etc.) for monitoring ongoing user activities.

nebula-logger/main/log-management/classes/LogEntryEventHandler.cls

@@ -7,7 +7,7 @@
  * @group Log Management
  * @description Subscribes to `LogEntryEvent__e` platform events and normalizes the data into `Log__c` and `LogEntry__c` records
  */
-public without sharing class LogEntryEventHandler {
+public without sharing class LogEntryEventHandler extends LoggerHandler {
     private static final Map<String, Log__c> TRANSACTION_ID_TO_LOG = new Map<String, Log__c>();
 
     @testVisible

nebula-logger/main/log-management/classes/LogEntryHandler.cls

@@ -7,15 +7,18 @@
  * @group Log Management
  * @description Manages setting fields on `LogEntry__c` before insert & before update
  */
-public without sharing class LogEntryHandler {
+public without sharing class LogEntryHandler extends LoggerHandler {
     // Trigger-based variables - tests can override these with mock objects
     @testVisible
     private List<LogEntry__c> logEntries;
     @testVisible
+    private Map<Id, LogEntry__c> oldLogEntriesById;
+    @testVisible
     private TriggerOperation triggerOperationType;
 
     public LogEntryHandler() {
         this.logEntries = (List<LogEntry__c>) Trigger.new;
+        this.oldLogEntriesById = (Map<Id, LogEntry__c>) Trigger.oldMap;
         this.triggerOperationType = Trigger.operationType;
     }
 
@@ -39,6 +42,9 @@ public without sharing class LogEntryHandler {
                 this.setCheckboxFields();
             }
         }
+
+        // Run any post-processors
+        super.executePostProcessors(this.logEntries, this.oldLogEntriesById);
     }
 
     private void setCheckboxFields() {

nebula-logger/main/log-management/classes/LogHandler.cls

@@ -7,7 +7,7 @@
  * @group Log Management
  * @description Manages setting fields on `Log__c` before insert & before update
  */
-public without sharing class LogHandler {
+public without sharing class LogHandler extends LoggerHandler {
     private static final Organization ORGANIZATION = [SELECT Id, InstanceName, IsSandbox FROM Organization];
 
     @testVisible
@@ -58,6 +58,9 @@ public without sharing class LogHandler {
                 this.shareLogsWithLoggingUsers();
             }
         }
+
+        // Run any post-processors
+        super.executePostProcessors(this.logs, this.oldLogsById);
     }
 
     private void setOrgReleaseCycle() {

nebula-logger/main/log-management/classes/LoggerHandler.cls

@@ -0,0 +1,53 @@
+//------------------------------------------------------------------------------------------------//
+// This file is part of the Nebula Logger project, released under the MIT License.                //
+// See LICENSE file or go to https://github.com/jongpie/NebulaLogger for full license details.    //
+//------------------------------------------------------------------------------------------------//
+
+/**
+ * @group Log Management
+ * @description Abstract class used by trigger handlers for shared logic
+ */
+ public abstract class LoggerHandler {
+
+    protected void executePostProcessors(List<SObject> loggerRecords, Map<Id, SObject> oldLoggerRecordsById) {
+        if (loggerRecords == null) {
+            return;
+        }
+
+        String sobjectTypeCmdtName = loggerRecords.getSObjectType().getDescribe().getName().replace('__c', '');
+
+        List<LoggerHandlerConfiguration__mdt> loggerHandlerConfigurations = [
+            SELECT ApexClassName__c, FlowName__c
+            FROM LoggerHandlerConfiguration__mdt
+            WHERE LoggerSObject__r.DeveloperName = :sobjectTypeCmdtName AND IsActive__c = TRUE
+        ];
+        LoggerHandlerConfiguration__mdt loggerHandlerConfiguration = loggerHandlerConfigurations.isEmpty() ? null : loggerHandlerConfigurations.get(0);
+
+        executeApexClass(loggerHandlerConfiguration?.ApexClassName__c, loggerRecords, oldLoggerRecordsById);
+        executeFlow(loggerHandlerConfiguration?.FlowName__c, loggerRecords, oldLoggerRecordsById);
+    }
+
+    private void executeApexClass(String apexClassName, List<SObject> loggerRecords, Map<Id, SObject> oldLoggerRecordsById) {
+        if (String.isBlank(apexClassName)) {
+            return;
+        }
+
+        Type postProcessorType = Type.forName(apexClassName);
+        LoggerPostProcessor recordPostProcessor = (LoggerPostProcessor) postProcessorType.newInstance();
+        recordPostProcessor.execute(Trigger.operationType, loggerRecords, oldLoggerRecordsById);
+    }
+
+    private void executeFlow(String flowName, List<SObject> loggerRecords, Map<Id, SObject> oldLoggerRecordsById) {
+        if (String.isBlank(flowName)) {
+            return;
+        }
+
+        Map<String, Object> flowInputs = new Map<String, Object>();
+        flowInputs.put('records', loggerRecords);
+        flowInputs.put('oldRecords', oldLoggerRecordsById?.values());
+        flowInputs.put('triggerOperation', Trigger.operationType);
+
+        Flow.Interview recordFlow = Flow.Interview.createInterview(flowName, flowInputs);
+        recordFlow.start();
+    }
+}

nebula-logger/main/log-management/classes/LoggerHandler.cls-meta.xml

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

nebula-logger/main/log-management/classes/LoggerPostProcessor.cls

@@ -0,0 +1,13 @@
+//------------------------------------------------------------------------------------------------//
+// This file is part of the Nebula Logger project, released under the MIT License.                //
+// See LICENSE file or go to https://github.com/jongpie/NebulaLogger for full license details.    //
+//------------------------------------------------------------------------------------------------//
+
+
+/**
+ * @group Log Management
+ * @description Interface used to define custom logic to run when DML statements occur on `Log__c` or `LogEntry__c`
+ */
+ global interface LoggerPostProcessor {
+    void execute(TriggerOperation triggerOperation, List<SObject> loggerRecords, Map<Id, SObject> oldLoggerRecordsById);
+}

nebula-logger/main/log-management/classes/LoggerPostProcessor.cls-meta.xml

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

nebula-logger/main/log-management/layouts/LoggerHandlerConfiguration__mdt-Logger Handler Configuration Layout.layout-meta.xml

@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Layout xmlns="http://soap.sforce.com/2006/04/metadata">
+    <layoutSections>
+        <customLabel>false</customLabel>
+        <detailHeading>false</detailHeading>
+        <editHeading>true</editHeading>
+        <label>Information</label>
+        <layoutColumns>
+            <layoutItems>
+                <behavior>Required</behavior>
+                <field>MasterLabel</field>
+            </layoutItems>
+            <layoutItems>
+                <behavior>Required</behavior>
+                <field>DeveloperName</field>
+            </layoutItems>
+            <layoutItems>
+                <behavior>Edit</behavior>
+                <field>IsActive__c</field>
+            </layoutItems>
+        </layoutColumns>
+        <layoutColumns>
+            <layoutItems>
+                <behavior>Required</behavior>
+                <field>LoggerSObject__c</field>
+            </layoutItems>
+            <layoutItems>
+                <behavior>Edit</behavior>
+                <field>ApexClassName__c</field>
+            </layoutItems>
+            <layoutItems>
+                <behavior>Edit</behavior>
+                <field>FlowName__c</field>
+            </layoutItems>
+        </layoutColumns>
+        <style>TwoColumnsTopToBottom</style>
+    </layoutSections>
+    <layoutSections>
+        <customLabel>false</customLabel>
+        <detailHeading>false</detailHeading>
+        <editHeading>true</editHeading>
+        <label>System Information</label>
+        <layoutColumns>
+            <layoutItems>
+                <behavior>Required</behavior>
+                <field>NamespacePrefix</field>
+            </layoutItems>
+            <layoutItems>
+                <behavior>Readonly</behavior>
+                <field>CreatedById</field>
+            </layoutItems>
+        </layoutColumns>
+        <layoutColumns>
+            <layoutItems>
+                <behavior>Edit</behavior>
+                <field>IsProtected</field>
+            </layoutItems>
+            <layoutItems>
+                <behavior>Readonly</behavior>
+                <field>LastModifiedById</field>
+            </layoutItems>
+        </layoutColumns>
+        <style>TwoColumnsTopToBottom</style>
+    </layoutSections>
+    <layoutSections>
+        <customLabel>true</customLabel>
+        <detailHeading>false</detailHeading>
+        <editHeading>false</editHeading>
+        <label>Custom Links</label>
+        <layoutColumns/>
+        <layoutColumns/>
+        <layoutColumns/>
+        <style>CustomLinks</style>
+    </layoutSections>
+    <showEmailCheckbox>false</showEmailCheckbox>
+    <showHighlightsPanel>false</showHighlightsPanel>
+    <showInteractionLogPanel>false</showInteractionLogPanel>
+    <showRunAssignmentRulesCheckbox>false</showRunAssignmentRulesCheckbox>
+    <showSubmitAndAttachButton>false</showSubmitAndAttachButton>
+    <summaryLayout>
+        <masterLabel>00h3F0000048LpM</masterLabel>
+        <sizeX>4</sizeX>
+        <sizeY>0</sizeY>
+        <summaryLayoutStyle>Default</summaryLayoutStyle>
+    </summaryLayout>
+</Layout>

nebula-logger/main/log-management/objects/LoggerHandlerConfiguration__mdt/LoggerHandlerConfiguration__mdt.object-meta.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
+    <description>Used to configure additional Apex classes that should be executed by Logger after creating or updating records in Log__c or LogEntry__c</description>
+    <label>Logger Handler Config</label>
+    <pluralLabel>Logger Handler Configs</pluralLabel>
+    <visibility>Public</visibility>
+</CustomObject>

nebula-logger/main/log-management/objects/LoggerHandlerConfiguration__mdt/fields/ApexClassName__c.field-meta.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomField xmlns="http://soap.sforce.com/2006/04/metadata">
+    <fullName>ApexClassName__c</fullName>
+    <description>The name of an Apex class that implements LoggerPostProcessor.Handler</description>
+    <externalId>false</externalId>
+    <fieldManageability>DeveloperControlled</fieldManageability>
+    <inlineHelpText>The name of an Apex class that implements LoggerPostProcessor.Handler</inlineHelpText>
+    <label>Apex Class Name</label>
+    <length>255</length>
+    <required>false</required>
+    <type>Text</type>
+    <unique>false</unique>
+</CustomField>

nebula-logger/main/log-management/objects/LoggerHandlerConfiguration__mdt/fields/FlowName__c.field-meta.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomField xmlns="http://soap.sforce.com/2006/04/metadata">
+    <fullName>FlowName__c</fullName>
+    <externalId>false</externalId>
+    <fieldManageability>DeveloperControlled</fieldManageability>
+    <label>Flow Name</label>
+    <length>255</length>
+    <required>false</required>
+    <type>Text</type>
+    <unique>false</unique>
+</CustomField>

nebula-logger/main/log-management/objects/LoggerHandlerConfiguration__mdt/fields/IsActive__c.field-meta.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomField xmlns="http://soap.sforce.com/2006/04/metadata">
+    <fullName>IsActive__c</fullName>
+    <defaultValue>true</defaultValue>
+    <externalId>false</externalId>
+    <fieldManageability>SubscriberControlled</fieldManageability>
+    <label>Is Active</label>
+    <type>Checkbox</type>
+</CustomField>

nebula-logger/main/log-management/objects/LoggerHandlerConfiguration__mdt/fields/LoggerSObject__c.field-meta.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomField xmlns="http://soap.sforce.com/2006/04/metadata">
+    <fullName>LoggerSObject__c</fullName>
+    <description>The Logger object to process - Log__c or LogEntry__c</description>
+    <externalId>false</externalId>
+    <fieldManageability>DeveloperControlled</fieldManageability>
+    <inlineHelpText>The Logger object to process - Log__c or LogEntry__c</inlineHelpText>
+    <label>Logger Object</label>
+    <referenceTo>EntityDefinition</referenceTo>
+    <relationshipLabel>Logger Post Processors</relationshipLabel>
+    <relationshipName>LoggerPostProcessors</relationshipName>
+    <required>true</required>
+    <type>MetadataRelationship</type>
+    <unique>true</unique>
+</CustomField>

nebula-logger/main/log-management/objects/LoggerHandlerConfiguration__mdt/listViews/All.listView-meta.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ListView xmlns="http://soap.sforce.com/2006/04/metadata">
+    <fullName>All</fullName>
+    <columns>MasterLabel</columns>
+    <columns>DeveloperName</columns>
+    <columns>IsActive__c</columns>
+    <columns>LoggerSObject__c</columns>
+    <columns>ApexClassName__c</columns>
+    <columns>FlowName__c</columns>
+    <filterScope>Everything</filterScope>
+    <label>All</label>
+</ListView>

nebula-logger/main/log-management/triggers/Log.trigger

@@ -2,6 +2,6 @@
 // This file is part of the Nebula Logger project, released under the MIT License.                //
 // See LICENSE file or go to https://github.com/jongpie/NebulaLogger for full license details.    //
 //------------------------------------------------------------------------------------------------//
-trigger Log on Log__c(before insert, before update, after insert) {
+trigger Log on Log__c(before insert, before update, before delete, after insert, after update, after delete, after undelete) {
     new LogHandler().execute();
 }

nebula-logger/main/log-management/triggers/LogEntry.trigger

@@ -2,6 +2,6 @@
 // This file is part of the Nebula Logger project, released under the MIT License.                //
 // See LICENSE file or go to https://github.com/jongpie/NebulaLogger for full license details.    //
 //------------------------------------------------------------------------------------------------//
-trigger LogEntry on LogEntry__c(before insert, before update) {
+trigger LogEntry on LogEntry__c(before insert, before update, before delete, after insert, after update, after delete, after undelete) {
     new LogEntryHandler().execute();
 }