Bugfix for UserInfo.getSessionId() exception in connected apps with JWT enabled (#604)

* Fixed #598 by adding a try-catch block around the call to System.UserInfo.getSessionId()

* Optimized how Logger.TRANSACTION_QUIDDITY is loaded so it doesn't repeatedly try to load in transactions where there isn't an active quiddity

* Removed some extra copy-pasta in the new LoggerParameter__mdt record DefaultLogEntryRelatedListFieldSet

Author: jongpie

README.md

@@ -5,15 +5,15 @@
 
 The most robust logger for Salesforce. Works with Apex, Lightning Components, Flow, Process Builder & Integrations. Designed for Salesforce admins, developers & architects.
 
-## Unlocked Package - v4.12.2
+## Unlocked Package - v4.12.3
 
-[![Install Unlocked Package in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y000001Mk55QAC)
-[![Install Unlocked Package in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y000001Mk55QAC)
+[![Install Unlocked Package in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y000001Mk5AQAS)
+[![Install Unlocked Package in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y000001Mk5AQAS)
 [![View Documentation](./images/btn-view-documentation.png)](https://jongpie.github.io/NebulaLogger/)
 
-`sf package install --wait 20 --security-type AdminsOnly --package 04t5Y000001Mk55QAC`
+`sf package install --wait 20 --security-type AdminsOnly --package 04t5Y000001Mk5AQAS`
 
-`sfdx force:package:install --wait 20 --securitytype AdminsOnly --package 04t5Y000001Mk55QAC`
+`sfdx force:package:install --wait 20 --securitytype AdminsOnly --package 04t5Y000001Mk5AQAS`
 
 ---
 

nebula-logger/core/main/configuration/customMetadata/LoggerParameter.DefaultLogEntryRelatedListFieldSet.md-meta.xml

@@ -12,7 +12,7 @@
             xsi:type="xsd:string"
         >The name of the LogEntry__c field set to use as the default field set when configuring the LWC <c-related-log-entries> within App Builder.
 
-By default, the included field set partition &apos;Related_List_Defaults&apos; is used.</value>
+By default, the included field set &apos;Related_List_Defaults&apos; is used.</value>
     </values>
     <values>
         <field>Value__c</field>

nebula-logger/core/main/logger-engine/classes/Logger.cls

@@ -15,14 +15,15 @@
 global with sharing class Logger {
     // There's no reliable way to get the version number dynamically in Apex
     @TestVisible
-    private static final String CURRENT_VERSION_NUMBER = 'v4.12.2';
+    private static final String CURRENT_VERSION_NUMBER = 'v4.12.3';
     private static final System.LoggingLevel FALLBACK_LOGGING_LEVEL = System.LoggingLevel.DEBUG;
     private static final Set<String> IGNORED_APEX_CLASSES = initializeIgnoredApexClasses();
     private static final List<LogEntryEventBuilder> LOG_ENTRIES_BUFFER = new List<LogEntryEventBuilder>();
     private static final String ORGANIZATION_DOMAIN_URL = System.URL.getOrgDomainUrl()?.toExternalForm();
     private static final String REQUEST_ID = System.Request.getCurrent().getRequestId();
     private static final Map<String, SaveMethod> SAVE_METHOD_NAME_TO_SAVE_METHOD = new Map<String, SaveMethod>();
     private static final String TRANSACTION_ID = new Uuid().getValue();
+    private static final Quiddity TRANSACTION_QUIDDITY = loadTransactionQuiddity();
 
     private static AsyncContext currentAsyncContext;
     private static String currentEntryScenario;
@@ -53,20 +54,16 @@ global with sharing class Logger {
         set;
     }
 
-    private static final Quiddity TRANSACTION_QUIDDITY {
-        get {
-            if (TRANSACTION_QUIDDITY == null) {
-                TRANSACTION_QUIDDITY = getTransactionQuiddity();
-            }
-            return TRANSACTION_QUIDDITY;
-        }
-        set;
-    }
-
     private static final String USER_SESSION_ID {
         get {
             if (USER_SESSION_ID == null) {
-                USER_SESSION_ID = System.UserInfo.getSessionId();
+                // TODO Spring '24 release - simplify this (and other lazy-loaded values)
+                // by switching to the fancy, new ?? null coalescing operator
+                try {
+                    USER_SESSION_ID = System.UserInfo.getSessionId();
+                } catch (Exception ex) {
+                    USER_SESSION_ID = '';
+                }
                 // If System.UserInfo.getSessionId() returns null, set to an empty string to
                 // avoid calling System.UserInfo.getSessionId() again
                 USER_SESSION_ID = USER_SESSION_ID == null ? '' : USER_SESSION_ID;
@@ -3385,7 +3382,7 @@ global with sharing class Logger {
         return isStartTimeValid && isEndTimeValid;
     }
 
-    private static Quiddity getTransactionQuiddity() {
+    private static Quiddity loadTransactionQuiddity() {
         // An error can sometimes occur when calling System.Request.getCurrent(), such as when logging
         // from an Auth Provider class (that implements Auth.RegistrationHandler). As a workaround,
         // skip calling System.Request.getCurrent() if there is no user session.

nebula-logger/core/main/logger-engine/lwc/logger/logger.js

@@ -6,7 +6,7 @@
 import { LightningElement, api } from 'lwc';
 import { createLoggerService } from './loggerService';
 
-const CURRENT_VERSION_NUMBER = 'v4.12.2';
+const CURRENT_VERSION_NUMBER = 'v4.12.3';
 
 export default class Logger extends LightningElement {
     #loggerService = createLoggerService();

package.json

@@ -1,6 +1,6 @@
 {
     "name": "nebula-logger",
-    "version": "4.12.2",
+    "version": "4.12.3",
     "description": "The most robust logger for Salesforce. Works with Apex, Lightning Components, Flow, Process Builder & Integrations. Designed for Salesforce admins, developers & architects.",
     "author": "Jonathan Gillespie",
     "license": "MIT",

sfdx-project.json

@@ -13,9 +13,9 @@
             "package": "Nebula Logger - Core",
             "path": "./nebula-logger/core",
             "definitionFile": "./config/scratch-orgs/base-scratch-def.json",
-            "versionNumber": "4.12.2.NEXT",
-            "versionName": "Automatically Select Default Field Set in relatedLogEntries LWC",
-            "versionDescription": "Updated the relatedLogEntries LWC to automatically select the default field set when the component is added to a FlexiPage. The default field set name is configurable via LoggerParameter__mdt record DefaultLogEntryRelatedListFieldSet.",
+            "versionNumber": "4.12.3.NEXT",
+            "versionName": "Bugfix for UserInfo.getSessionId() Exception",
+            "versionDescription": "Added a try-catch block to usage of UserInfo.getSessionId() to handle a platform-thrown exception that occurs in some transactions (such as connected apps with JWT).",
             "releaseNotesUrl": "https://github.com/jongpie/NebulaLogger/releases",
             "unpackagedMetadata": {
                 "path": "./nebula-logger/extra-tests"
@@ -163,6 +163,7 @@
         "Nebula Logger - Core@4.12.0-winter-'24-release": "04t5Y000001Mk1wQAC",
         "Nebula Logger - Core@4.12.1-improved-error-emails": "04t5Y000001Mk4bQAC",
         "Nebula Logger - Core@4.12.2-automatically-select-default-field-set-in-relatedlogentries-lwc": "04t5Y000001Mk55QAC",
+        "Nebula Logger - Core@4.12.3-bugfix-for-userinfo.getsessionid()-exception": "04t5Y000001Mk5AQAS",
         "Nebula Logger - Core Plugin - Async Failure Additions": "0Ho5Y000000blO4SAI",
         "Nebula Logger - Core Plugin - Async Failure Additions@1.0.0": "04t5Y0000015lhiQAA",
         "Nebula Logger - Core Plugin - Async Failure Additions@1.0.1": "04t5Y0000015lhsQAA",
@@ -180,5 +181,6 @@
         "Nebula Logger - Core Plugin - Slack@0.10.0": "04t5Y0000015lgQQAQ",
         "Nebula Logger - Core Plugin - Slack@1.5.0": "04t5Y0000015lvVQAQ",
         "Nebula Logger - Core Plugin - Slack@1.5.1": "04t5Y0000023Qu8QAE"
-    }
+    },
+    "target-dev-hub": "sf.nebula.logger.package.bot@jongpie.com"
 }