Approval results logging (#850)

Added new setApprovalResult() methods in LogEntryEventBuilder for logging instances of the standard Apex classes Approval.LockResult, Approval.ProcessResult, Approval.UnlockResult, as well as lists of each class

Co-authored-by: Jonathan Gillespie <jonathan.c.gillespie@gmail.com>
Co-authored-by: James Simone <16430727+jamessimone@users.noreply.github.com>

Author: 3 people

README.md

@@ -5,13 +5,13 @@
 
 The most robust observability solution for Salesforce experts. Built 100% natively on the platform, and designed to work seamlessly with Apex, Lightning Components, Flow, OmniStudio, and integrations.
 
-## Unlocked Package - v4.15.9
+## Unlocked Package - v4.15.10
 
-[![Install Unlocked Package in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015pGKQAY)
-[![Install Unlocked Package in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015pGKQAY)
+[![Install Unlocked Package in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015pGeQAI)
+[![Install Unlocked Package in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015pGeQAI)
 [![View Documentation](./images/btn-view-documentation.png)](https://github.com/jongpie/NebulaLogger/wiki)
 
-`sf package install --wait 20 --security-type AdminsOnly --package 04t5Y0000015pGKQAY`
+`sf package install --wait 20 --security-type AdminsOnly --package 04t5Y0000015pGeQAI`
 
 ---
 

docs/apex/Logger-Engine/LogEntryEventBuilder.md

@@ -30,6 +30,10 @@ Used by `Logger` to instantiate a new instance of `LogEntryEventBuilder`
 
 ### Properties
 
+#### `ENTRY_SAVE_REASON_LOGGING_LEVEL_MET` → `String`
+
+#### `ENTRY_SAVE_REASON_OVERRIDE` → `String`
+
 #### `aggregateQueriesMax` → `Integer`
 
 #### `asyncCallsMax` → `Integer`
@@ -140,6 +144,126 @@ LogEntryEventBuilder
 
 The same instance of `LogEntryEventBuilder`, useful for chaining methods
 
+#### `setApprovalResult(Approval.LockResult lockResult)` → `LogEntryEventBuilder`
+
+Sets the log entry event's database operation result fields
+
+##### Parameters
+
+| Param        | Description                                  |
+| ------------ | -------------------------------------------- |
+| `lockResult` | The instance of `Approval.LockResult` to log |
+
+##### Return
+
+**Type**
+
+LogEntryEventBuilder
+
+**Description**
+
+The same instance of `LogEntryEventBuilder`, useful for chaining methods
+
+#### `setApprovalResult(Approval.ProcessResult processResult)` → `LogEntryEventBuilder`
+
+Sets the log entry event's database operation result fields
+
+##### Parameters
+
+| Param           | Description                                     |
+| --------------- | ----------------------------------------------- |
+| `processResult` | The instance of `Approval.ProcessResult` to log |
+
+##### Return
+
+**Type**
+
+LogEntryEventBuilder
+
+**Description**
+
+The same instance of `LogEntryEventBuilder`, useful for chaining methods
+
+#### `setApprovalResult(Approval.UnlockResult unlockResult)` → `LogEntryEventBuilder`
+
+Sets the log entry event's database operation result fields
+
+##### Parameters
+
+| Param          | Description                                    |
+| -------------- | ---------------------------------------------- |
+| `unlockResult` | The instance of `Approval.UnlockResult` to log |
+
+##### Return
+
+**Type**
+
+LogEntryEventBuilder
+
+**Description**
+
+The same instance of `LogEntryEventBuilder`, useful for chaining methods
+
+#### `setApprovalResult(List<Approval.LockResult> lockResults)` → `LogEntryEventBuilder`
+
+Sets the log entry event&apos;s database operation result fields
+
+##### Parameters
+
+| Param         | Description                                        |
+| ------------- | -------------------------------------------------- |
+| `lockResults` | The list of `Approval.LockResult` instances to log |
+
+##### Return
+
+**Type**
+
+LogEntryEventBuilder
+
+**Description**
+
+The same instance of `LogEntryEventBuilder`, useful for chaining methods
+
+#### `setApprovalResult(List<Approval.ProcessResult> processResults)` → `LogEntryEventBuilder`
+
+Sets the log entry event&apos;s database operation result fields
+
+##### Parameters
+
+| Param            | Description                                           |
+| ---------------- | ----------------------------------------------------- |
+| `processResults` | The list of `Approval.ProcessResult` instances to log |
+
+##### Return
+
+**Type**
+
+LogEntryEventBuilder
+
+**Description**
+
+The same instance of `LogEntryEventBuilder`, useful for chaining methods
+
+#### `setApprovalResult(List<Approval.UnlockResult> unlockResults)` → `LogEntryEventBuilder`
+
+Sets the log entry event&apos;s database operation result fields
+
+##### Parameters
+
+| Param           | Description                                          |
+| --------------- | ---------------------------------------------------- |
+| `unlockResults` | The list of `Approval.UnlockResult` instances to log |
+
+##### Return
+
+**Type**
+
+LogEntryEventBuilder
+
+**Description**
+
+The same instance of `LogEntryEventBuilder`, useful for chaining methods
+
 #### `setDatabaseResult(Database.DeleteResult deleteResult)` → `LogEntryEventBuilder`
 
 Sets the log entry event&apos;s database operation result fields
@@ -306,9 +430,9 @@ Sets the log entry event&apos;s database operation result fields
 
 ##### Parameters
 
-| Param                    | Description                                          |
-| ------------------------ | ---------------------------------------------------- |
-| `emptyRecycleBinResults` | The list of `Database.EmptyRecycleBinResult`s to log |
+| Param                    | Description                                                   |
+| ------------------------ | ------------------------------------------------------------- |
+| `emptyRecycleBinResults` | The list of `Database.EmptyRecycleBinResult` instances to log |
 
 ##### Return
 
@@ -672,7 +796,7 @@ LogEntryEventBuilder
 
 The same instance of `LogEntryEventBuilder`, useful for chaining methods
 
-#### `setRecord(System.Iterable<Id> recordsIds)` → `LogEntryEventBuilder`
+#### `setRecord(System.Iterable<Id> recordIds)` → `LogEntryEventBuilder`
 
 Sets the log entry event&apos;s record fields