Summer '24 release (#552)

* build: bump to API v61.0 (#544)

* build: bump dependencies

* feat: platform event publish callback recipe (#545)

* feat: platform event publish callback recipe

* build: bump API version

* build: bump dependencies

* fix: case-sensitive field renaming

* doc: warning about automation user

* feat: explicit system mode insert

* fix: test SOQL is more accurate

force-app/main/default/classes/Async Apex Recipes/AtFutureRecipes.cls-meta.xml

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

force-app/main/default/classes/Async Apex Recipes/BatchApexRecipes.cls-meta.xml

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

force-app/main/default/classes/Async Apex Recipes/QueueableChainingRecipes.cls-meta.xml

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

force-app/main/default/classes/Async Apex Recipes/QueueableRecipes.cls-meta.xml

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

force-app/main/default/classes/Async Apex Recipes/QueueableWithCalloutRecipes.cls-meta.xml

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

force-app/main/default/classes/Async Apex Recipes/ScheduledApexDemo.cls-meta.xml

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

force-app/main/default/classes/Async Apex Recipes/ScheduledApexRecipes.cls-meta.xml

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

force-app/main/default/classes/Collection Recipes/AccountNumberOfEmployeesComparator.cls-meta.xml

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

force-app/main/default/classes/Collection Recipes/AccountShippingCountryComparator.cls-meta.xml

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

force-app/main/default/classes/Collection Recipes/CollectionUtils.cls-meta.xml

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

force-app/main/default/classes/Collection Recipes/IterableApiClient.cls-meta.xml

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

force-app/main/default/classes/Collection Recipes/IterationRecipes.cls-meta.xml

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

force-app/main/default/classes/Collection Recipes/ListSortingRecipes.cls-meta.xml

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

force-app/main/default/classes/Custom Metadata Recipes/CustomMetadataUtilties.cls-meta.xml

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

force-app/main/default/classes/Data Recipes/DMLRecipes.cls-meta.xml

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

force-app/main/default/classes/Data Recipes/DynamicSOQLRecipes.cls-meta.xml

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

force-app/main/default/classes/Data Recipes/MetadataCatalogRecipes.cls-meta.xml

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

force-app/main/default/classes/Data Recipes/SOQLRecipes.cls-meta.xml

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

force-app/main/default/classes/Data Recipes/SOSLRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/BasicDataWeaveInApexRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/CsvData.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/CsvToJsonConversionRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/DataWeaveErrorRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/FormattingRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/LoggingRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/MultipleInputRecipes.cls-meta.xml

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

force-app/main/default/classes/DataWeaveInApex Recipes/ObjectConversionRecipes.cls-meta.xml

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

force-app/main/default/classes/Email Recipes/InboundEmailHandlerRecipes.cls-meta.xml

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

force-app/main/default/classes/Encryption Recipes/EncryptionRecipes.cls-meta.xml

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

force-app/main/default/classes/Encryption Recipes/EncryptionRecipesTest.cls-meta.xml

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

force-app/main/default/classes/Files Recipes/FilesRecipes.cls-meta.xml

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

force-app/main/default/classes/Integration Recipes/ApiServiceRecipes.cls-meta.xml

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

force-app/main/default/classes/Integration Recipes/ApiServiceRecipesDataModel.cls-meta.xml

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

force-app/main/default/classes/Integration Recipes/AuraEnabledRecipes.cls-meta.xml

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

force-app/main/default/classes/Integration Recipes/CalloutRecipes.cls-meta.xml

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

force-app/main/default/classes/Integration Recipes/CustomRestEndpointRecipes.cls-meta.xml

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

force-app/main/default/classes/Integration Recipes/NamedCredentialRecipes.cls-meta.xml

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

force-app/main/default/classes/Invocable Recipes/InvocableMethodRecipes.cls-meta.xml

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

force-app/main/default/classes/Platform Cache Recipes/PlatformCacheBuilderRecipes.cls-meta.xml

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

force-app/main/default/classes/Platform Cache Recipes/PlatformCacheRecipes.cls-meta.xml

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

force-app/main/default/classes/Platform Event Recipes/PlatformEventPublishCallback.cls

@@ -0,0 +1,86 @@
+/**
+ * @description Demonstrates how to write Platform Event publish success and failure callbacks
+ * @group Platform Event Recipes
+ * @see PlatformEventRecipes
+ */
+public with sharing class PlatformEventPublishCallback implements EventBus.EventPublishFailureCallback, EventBus.EventPublishSuccessCallback {
+    /**
+     * Map that correlates event UUIDs with events
+     */
+    private Map<String, Event_Recipes_Demo__e> eventMap;
+
+    public PlatformEventPublishCallback(List<Event_Recipes_Demo__e> events) {
+        this.eventMap = new Map<String, Event_Recipes_Demo__e>();
+        for (Event_Recipes_Demo__e event : events) {
+            this.eventMap.put(event.EventUuid, event);
+        }
+    }
+
+    /**
+     * Callback for events that failed to publish
+     * Note: this method is always called by the automation user
+     */
+    public void onFailure(EventBus.FailureResult result) {
+        // Get event UUIDs from the result
+        List<String> eventUuids = result.getEventUuids();
+
+        // Sample use case: create a follow-up task for failed events
+        insertTask(eventUuids, false);
+    }
+
+    /**
+     * Callback for events that were successfully published
+     * Note: this method is always called by the automation user
+     */
+    public void onSuccess(EventBus.SuccessResult result) {
+        // Get event UUIDs from the result
+        List<String> eventUuids = result.getEventUuids();
+
+        // Sample use case: create a follow-up task for success events
+        insertTask(eventUuids, true);
+    }
+
+    private void insertTask(List<String> eventUuids, Boolean isSuccess) {
+        // Load accounts related to events
+        Set<Id> relatedAccountIds = new Set<Id>();
+        for (String eventUuid : eventUuids) {
+            Event_Recipes_Demo__e originalEvent = this.eventMap.get(eventUuid);
+            relatedAccountIds.add(originalEvent.AccountId__c);
+        }
+        Map<Id, Account> relatedAccounts = new Map<Id, Account>(
+            [
+                SELECT OwnerId
+                FROM Account
+                WHERE Id = :relatedAccountIds
+                WITH SYSTEM_MODE
+            ]
+        );
+
+        // Prepare and insert tasks
+        List<Task> tasks = new List<Task>();
+        for (String eventUuid : eventUuids) {
+            // Retrieve event data
+            Event_Recipes_Demo__e originalEvent = this.eventMap.get(eventUuid);
+
+            // Create a task on the related account
+            Task t = new Task();
+            t.WhatId = originalEvent.AccountId__c;
+            t.ActivityDate = Date.today().addDays(1);
+            if (isSuccess == true) {
+                t.Subject = 'Follow up on successful event publishing.';
+                t.Description =
+                    'Events published successfully. Event UUID: ' +
+                    eventUuid +
+                    ' User: ' +
+                    UserInfo.getName();
+            } else {
+                t.Subject = 'Follow up on event publishing failure.';
+                t.Description =
+                    'Events failed to publish. Event UUID: ' + eventUuid;
+            }
+            t.OwnerId = relatedAccounts.get(originalEvent.AccountId__c).OwnerId;
+            tasks.add(t);
+        }
+        insert as system tasks;
+    }
+}

force-app/main/default/classes/Platform Event Recipes/PlatformEventPublishCallback.cls-meta.xml

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