@salesforce/lds-runtime-aura 1.273.0 → 1.274.0

package/dist/ldsEngineCreator.js

@@ -15,7 +15,7 @@
 import { HttpStatusCode, InMemoryStore, Environment, Luvio, InMemoryStoreQueryEvaluator } from 'force/luvioEngine';
 import ldsTrackedFieldsBehaviorGate from '@salesforce/gate/lds.useNewTrackedFieldBehavior';
 import usePredictiveLoading from '@salesforce/gate/lds.usePredictiveLoading';
-import { getRecordAvatarsAdapterFactory, getRecordAdapterFactory, getRecordsAdapterFactory, getRecordActionsAdapterFactory, getObjectInfoAdapterFactory, getObjectInfosAdapterFactory, getRelatedListsActionsAdapterFactory, instrument, configuration, InMemoryRecordRepresentationQueryEvaluator, UiApiNamespace, RecordRepresentationRepresentationType, registerPrefetcher } from 'force/ldsAdaptersUiapi';
+import { getRecordAvatarsAdapterFactory, getRecordAdapterFactory, getRecordsAdapterFactory, getRecordActionsAdapterFactory, getObjectInfoAdapterFactory, getObjectInfosAdapterFactory, getRelatedListsActionsAdapterFactory, getRelatedListInfoBatchAdapterFactory, getRelatedListRecordsAdapterFactory, getRelatedListRecordsBatchAdapterFactory, instrument, configuration, InMemoryRecordRepresentationQueryEvaluator, UiApiNamespace, RecordRepresentationRepresentationType, registerPrefetcher } from 'force/ldsAdaptersUiapi';
 import { createStorage, clearStorages } from 'force/ldsStorage';
 import { withRegistration, register, setDefaultLuvio } from 'force/ldsEngine';
 import { REFRESH_ADAPTER_EVENT, ADAPTER_UNFULFILLED_ERROR, instrument as instrument$2 } from 'force/ldsBindings';
@@ -61,70 +61,25 @@ class RecordHomePage extends PredictivePrefetchPage {
         const { adapterName } = request;
         switch (adapterName) {
             case 'getRecord':
-                return this.buildGetRecordSaveRequestData(request);
+                return this.requestStrategies.getRecord.buildSaveRequestData(this.similarContext, this.context, request);
             case 'getRecords':
-                return this.buildGetRecordsSaveRequestData(request);
+                return this.requestStrategies.getRecords.buildSaveRequestData(this.similarContext, this.context, request);
             case 'getRecordActions':
-                return this.requestStrategies.getRecordActions.buildGetRecordActionsSaveRequestData(this.similarContext, this.context, request);
+                return this.requestStrategies.getRecordActions.buildSaveRequestData(this.similarContext, this.context, request);
             case 'getRecordAvatars':
-                return this.requestStrategies.getRecordAvatars.buildGetRecordAvatarsSaveRequestData(this.similarContext, this.context, request);
+                return this.requestStrategies.getRecordAvatars.buildSaveRequestData(this.similarContext, this.context, request);
             case 'getObjectInfo':
-                return this.requestStrategies.getObjectInfo.buildGetObjectInfoSaveRequestData(this.similarContext, this.context, request);
+                return this.requestStrategies.getObjectInfo.buildSaveRequestData(this.similarContext, this.context, request);
             case 'getRelatedListsActions':
-                return this.requestStrategies.getRelatedListsActions.buildGetRelatedListsActionsSaveRequestData(this.similarContext, this.context, request);
+                return this.requestStrategies.getRelatedListsActions.buildSaveRequestData(this.similarContext, this.context, request);
+            case 'getRelatedListRecords':
+                return this.requestStrategies.getRelatedListRecords.buildSaveRequestData(this.similarContext, this.context, request);
+            case 'getRelatedListRecordsBatch':
+                return this.requestStrategies.getRelatedListRecordsBatch.buildSaveRequestData(this.similarContext, this.context, request);
             default:
                 return { request, context: this.context };
         }
     }
-    buildGetRecordSaveRequestData(request) {
-        if (this.isGetRecordRequestContextDependent(request)) {
-            return {
-                request: this.requestStrategies.getRecord.transformForSave({
-                    ...request,
-                    config: {
-                        ...request.config,
-                        recordId: '*',
-                    },
-                }),
-                context: this.similarContext,
-            };
-        }
-        return {
-            request: this.requestStrategies.getRecord.transformForSave(request),
-            context: this.context,
-        };
-    }
-    buildGetRecordsSaveRequestData(request) {
-        if (this.isGetRecordsRequestContextDependent(request)) {
-            return {
-                request: this.requestStrategies.getRecords.transformForSave({
-                    ...request,
-                    config: {
-                        ...request.config,
-                        records: [
-                            {
-                                ...request.config.records[0],
-                                recordIds: ['*'],
-                            },
-                        ],
-                    },
-                }),
-                context: this.similarContext,
-            };
-        }
-        return {
-            request: this.requestStrategies.getRecords.transformForSave(request),
-            context: this.context,
-        };
-    }
-    isGetRecordRequestContextDependent(request) {
-        return request.config.recordId === this.context.recordId;
-    }
-    isGetRecordsRequestContextDependent(request) {
-        const isSingleRecordRequest = request.config.records.length === 1 && request.config.records[0].recordIds.length === 1;
-        return (isSingleRecordRequest &&
-            request.config.records[0].recordIds[0] === this.context.recordId);
-    }
     resolveSimilarRequest(similarRequest) {
         if (similarRequest.adapterName === 'getRecord') {
             return this.requestStrategies.getRecord.buildConcreteRequest(similarRequest, this.context);
@@ -147,6 +102,12 @@ class RecordHomePage extends PredictivePrefetchPage {
         if (similarRequest.adapterName === 'getRelatedListsActions') {
             return this.requestStrategies.getRelatedListsActions.buildConcreteRequest(similarRequest, this.context);
         }
+        if (similarRequest.adapterName === 'getRelatedListRecords') {
+            return this.requestStrategies.getRelatedListRecords.buildConcreteRequest(similarRequest, this.context);
+        }
+        if (similarRequest.adapterName === 'getRelatedListRecordsBatch') {
+            return this.requestStrategies.getRelatedListRecordsBatch.buildConcreteRequest(similarRequest, this.context);
+        }
         return similarRequest;
     }
     // Record Home performs best when we always do a minimal getRecord alongside the other requests.
@@ -407,12 +368,33 @@ class RequestStrategy {
 }
 
 class LuvioAdapterRequestStrategy extends RequestStrategy {
+    /**
+     * Perform any transformations required to prepare the request for saving.
+     *
+     * e.g. If the request is for a record, we move all fields in the fields array
+     * into the optionalFields array
+     *
+     * @param request - The request to transform
+     * @returns
+     */
     transformForSave(request) {
         return request;
     }
+    /**
+     * Filter requests to only those that are for this strategy.
+     *
+     * @param unfilteredRequests array of requests to filter
+     * @returns
+     */
     filterRequests(unfilteredRequests) {
         return unfilteredRequests.filter((request) => request.adapterName === this.adapterName);
     }
+    /**
+     * Reduce requests by combining those based on a strategies implementations
+     * of canCombine and combineRequests.
+     * @param unfilteredRequests array of requests to filter
+     * @returns
+     */
     reduce(unfilteredRequests) {
         const requests = this.filterRequests(unfilteredRequests);
         const visitedRequests = new Set();
@@ -435,10 +417,24 @@ class LuvioAdapterRequestStrategy extends RequestStrategy {
         }
         return reducedRequests;
     }
+    /**
+     * Check if two requests can be combined.
+     *
+     * By default, requests are not combinable.
+     * @param reqA config of request A
+     * @param reqB config of request B
+     * @returns
+     */
     canCombine(_reqA, _reqB) {
-        // By default, all requests are not comibinable
         return false;
     }
+    /**
+     * Takes two request configs and combines them into a single request config.
+     *
+     * @param reqA config of request A
+     * @param reqB config of request B
+     * @returns
+     */
     combineRequests(reqA, _reqB) {
         // By default, this should never be called since requests aren't combinable
         if (process.env.NODE_ENV !== 'production') {
@@ -446,6 +442,31 @@ class LuvioAdapterRequestStrategy extends RequestStrategy {
         }
         return reqA;
     }
+    /**
+     * Checks adapter config against request context to determine if the request is context dependent.
+     *
+     * By default, requests are not context dependent.
+     * @param request
+     * @returns
+     */
+    isContextDependent(_context, _request) {
+        return false;
+    }
+    /**
+     * Builds request for saving,
+     *  - transforming the request
+     *  - handling the cases where the request is context dependent (this is homework for the subclass)
+     * @param _similarContext Context with at least one parameter as a wildcard '*'
+     * @param context Exact context for a given page
+     * @param request
+     * @returns
+     */
+    buildSaveRequestData(_similarContext, context, request) {
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
+    }
 }
 
 function normalizeRecordIds$1(recordIds) {
@@ -469,8 +490,8 @@ class GetRecordAvatarsRequestStrategy extends LuvioAdapterRequestStrategy {
             },
         };
     }
-    buildGetRecordAvatarsSaveRequestData(similarContext, context, request) {
-        if (this.isGetRecordAvatarsRequestContextDependent(context, request)) {
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
             return {
                 request: this.transformForSave({
                     ...request,
@@ -487,7 +508,7 @@ class GetRecordAvatarsRequestStrategy extends LuvioAdapterRequestStrategy {
             context,
         };
     }
-    isGetRecordAvatarsRequestContextDependent(context, request) {
+    isContextDependent(context, request) {
         return (request.config.recordIds &&
             (context.recordId === request.config.recordIds || // some may set this as string instead of array
                 (request.config.recordIds.length === 1 &&
@@ -563,6 +584,27 @@ class GetRecordRequestStrategy extends LuvioAdapterRequestStrategy {
             optionalFields: Array.from(optionalFields),
         };
     }
+    isContextDependent(context, request) {
+        return request.config.recordId === context.recordId;
+    }
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
+            return {
+                request: this.transformForSave({
+                    ...request,
+                    config: {
+                        ...request.config,
+                        recordId: '*',
+                    },
+                }),
+                context: similarContext,
+            };
+        }
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
+    }
 }
 
 class GetRecordsRequestStrategy extends LuvioAdapterRequestStrategy {
@@ -580,6 +622,33 @@ class GetRecordsRequestStrategy extends LuvioAdapterRequestStrategy {
             },
         };
     }
+    isContextDependent(context, request) {
+        const isSingleRecordRequest = request.config.records.length === 1 && request.config.records[0].recordIds.length === 1;
+        return isSingleRecordRequest && request.config.records[0].recordIds[0] === context.recordId;
+    }
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
+            return {
+                request: this.transformForSave({
+                    ...request,
+                    config: {
+                        ...request.config,
+                        records: [
+                            {
+                                ...request.config.records[0],
+                                recordIds: ['*'],
+                            },
+                        ],
+                    },
+                }),
+                context: similarContext,
+            };
+        }
+        return {
+            request: this.transformForSave(request),
+            context: context,
+        };
+    }
 }
 
 function normalizeRecordIds(recordIds) {
@@ -603,8 +672,8 @@ class GetRecordActionsRequestStrategy extends LuvioAdapterRequestStrategy {
             },
         };
     }
-    buildGetRecordActionsSaveRequestData(similarContext, context, request) {
-        if (this.isGetRecordActionsRequestContextDependent(context, request)) {
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
             return {
                 request: this.transformForSave({
                     ...request,
@@ -637,7 +706,7 @@ class GetRecordActionsRequestStrategy extends LuvioAdapterRequestStrategy {
         }
         return combined;
     }
-    isGetRecordActionsRequestContextDependent(context, request) {
+    isContextDependent(context, request) {
         return (request.config.recordIds &&
             (context.recordId === request.config.recordIds || // some may set this as string instead of array
                 (request.config.recordIds.length === 1 &&
@@ -660,8 +729,8 @@ class GetObjectInfoRequestStrategy extends LuvioAdapterRequestStrategy {
             },
         };
     }
-    buildGetObjectInfoSaveRequestData(similarContext, context, request) {
-        if (this.isGetObjectInfoContextDependent(context, request)) {
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
             return {
                 request: this.transformForSave(request),
                 context: similarContext,
@@ -672,8 +741,9 @@ class GetObjectInfoRequestStrategy extends LuvioAdapterRequestStrategy {
             context,
         };
     }
-    isGetObjectInfoContextDependent(context, request) {
-        return (request.config.objectApiName && context.objectApiName === request.config.objectApiName);
+    isContextDependent(context, request) {
+        return (request.config.objectApiName !== undefined &&
+            context.objectApiName === request.config.objectApiName);
     }
 }
 
@@ -710,8 +780,8 @@ class GetRelatedListsActionsRequestStrategy extends LuvioAdapterRequestStrategy
             },
         };
     }
-    buildGetRelatedListsActionsSaveRequestData(similarContext, context, request) {
-        if (this.isGetRelatedListsActionsRequestContextDependent(context, request)) {
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
             return {
                 request: this.transformForSave({
                     ...request,
@@ -728,7 +798,7 @@ class GetRelatedListsActionsRequestStrategy extends LuvioAdapterRequestStrategy
             context,
         };
     }
-    isGetRelatedListsActionsRequestContextDependent(context, request) {
+    isContextDependent(context, request) {
         const isForContext = request.config.recordIds &&
             (context.recordId === request.config.recordIds || // some may set this as string instead of array
                 (request.config.recordIds.length === 1 &&
@@ -770,6 +840,129 @@ class GetRelatedListsActionsRequestStrategy extends LuvioAdapterRequestStrategy
     }
 }
 
+class GetRelatedListInfoBatchRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getRelatedListInfoBatch';
+        this.adapterFactory = getRelatedListInfoBatchAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest, _context) {
+        return similarRequest;
+    }
+    canCombine(reqA, reqB) {
+        return reqA.parentObjectApiName === reqB.parentObjectApiName;
+    }
+    combineRequests(reqA, reqB) {
+        const combined = { ...reqA };
+        combined.relatedListNames = Array.from(new Set([...reqA.relatedListNames, ...reqB.relatedListNames]));
+        return combined;
+    }
+}
+
+class GetRelatedListRecordsRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getRelatedListRecords';
+        this.adapterFactory = getRelatedListRecordsAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                parentRecordId: context.recordId,
+            },
+        };
+    }
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
+            return {
+                request: this.transformForSave({
+                    ...request,
+                    config: {
+                        ...request.config,
+                        parentRecordId: '*',
+                    },
+                }),
+                context: similarContext,
+            };
+        }
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
+    }
+    // ADG currently handles the batching of GetRelatedListRecords -> GetRelatedListRecordsBatch
+    // https://gitcore.soma.salesforce.com/core-2206/core-public/blob/p4/main/core/ui-laf-components/modules/laf/batchingPortable/reducers/RelatedListRecordsBatchReducer.js
+    // Adding reducing is outside of the scope of this PR, but this could potentially be added in the future
+    isContextDependent(context, request) {
+        return context.recordId === request.config.parentRecordId;
+    }
+}
+
+class GetRelatedListRecordsBatchRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getRelatedListRecordsBatch';
+        this.adapterFactory = getRelatedListRecordsBatchAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                parentRecordId: context.recordId,
+            },
+        };
+    }
+    buildSaveRequestData(similarContext, context, request) {
+        if (this.isContextDependent(context, request)) {
+            return {
+                request: this.transformForSave({
+                    ...request,
+                    config: {
+                        ...request.config,
+                        parentRecordId: '*',
+                    },
+                }),
+                context: similarContext,
+            };
+        }
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
+    }
+    isContextDependent(context, request) {
+        return context.recordId === request.config.parentRecordId;
+    }
+    /**
+     * Can combine two seperate batch requests if the parentRecordId is the same.
+     * @param reqA The first GetRelatedListRecordsBatchConfig.
+     * @param reqB The first GetRelatedListRecordsBatchConfig.
+     * @returns true if the requests can be combined, otherwise false.
+     */
+    canCombine(reqA, reqB) {
+        return reqA.parentRecordId === reqB.parentRecordId;
+    }
+    /**
+     * Merge the relatedListParameters together between two combinable batch requests.
+     * @param reqA The first GetRelatedListRecordsBatchConfig.
+     * @param reqB The first GetRelatedListRecordsBatchConfig.
+     * @returns The combined request.
+     */
+    combineRequests(reqA, reqB) {
+        const relatedListParametersMap = new Set(reqA.relatedListParameters.map((relatedListParameter) => {
+            return stableJSONStringify$1(relatedListParameter);
+        }));
+        const reqBRelatedListParametersToAdd = reqB.relatedListParameters.filter((relatedListParameter) => {
+            return !relatedListParametersMap.has(stableJSONStringify$1(relatedListParameter));
+        });
+        reqA.relatedListParameters = reqA.relatedListParameters.concat(reqBRelatedListParametersToAdd);
+        return reqA;
+    }
+}
+
 class LexRequestRunner {
     constructor(luvio) {
         this.luvio = luvio;
@@ -781,6 +974,9 @@ class LexRequestRunner {
             getObjectInfo: new GetObjectInfoRequestStrategy(),
             getObjectInfos: new GetObjectInfosRequestStrategy(),
             getRelatedListsActions: new GetRelatedListsActionsRequestStrategy(),
+            getRelatedListInfoBatch: new GetRelatedListInfoBatchRequestStrategy(),
+            getRelatedListRecords: new GetRelatedListRecordsRequestStrategy(),
+            getRelatedListRecordsBatch: new GetRelatedListRecordsBatchRequestStrategy(),
         };
     }
     reduceRequests(requests) {
@@ -1606,6 +1802,9 @@ function setupPredictivePrefetcher(luvio) {
         getObjectInfo: new GetObjectInfoRequestStrategy(),
         getObjectInfos: new GetObjectInfosRequestStrategy(),
         getRelatedListsActions: new GetRelatedListsActionsRequestStrategy(),
+        getRelatedListRecords: new GetRelatedListRecordsRequestStrategy(),
+        getRelatedListRecordsBatch: new GetRelatedListRecordsBatchRequestStrategy(),
+        getRelatedListInfoBatch: new GetRelatedListInfoBatchRequestStrategy(),
     });
     registerPrefetcher(luvio, prefetcher);
     __lexPrefetcher = prefetcher;
@@ -1709,4 +1908,4 @@ function ldsEngineCreator() {
 }
 
 export { buildPredictorForContext, ldsEngineCreator as default, initializeLDS, predictiveLoadPage };
-// version: 1.273.0-f97941e01
+// version: 1.274.0-67da496e8

package/dist/types/predictive-loading/pages/record-home-page.d.ts

@@ -1,5 +1,5 @@
 import type { LexContext } from '../prefetcher';
-import type { GetRecordRequest, GetRecordsRequest, GetRecordRequestStrategy, GetRecordsRequestStrategy, GetRecordActionsRequestStrategy, GetRecordActionsRequest, GetRecordAvatarsRequest, GetRecordAvatarsRequestStrategy, GetObjectInfoRequest, GetObjectInfosRequest, GetObjectInfoRequestStrategy, GetObjectInfosRequestStrategy, GetRelatedListsActionsRequestStrategy, GetRelatedListsActionsRequest } from '../request-strategy';
+import type { GetRecordRequest, GetRecordsRequest, GetRecordRequestStrategy, GetRecordsRequestStrategy, GetRecordActionsRequestStrategy, GetRecordActionsRequest, GetRecordAvatarsRequest, GetRecordAvatarsRequestStrategy, GetObjectInfoRequest, GetObjectInfosRequest, GetObjectInfoRequestStrategy, GetObjectInfosRequestStrategy, GetRelatedListsActionsRequestStrategy, GetRelatedListsActionsRequest, GetRelatedListInfoBatchRequestStrategy, GetRelatedListInfoBatchRequest, GetRelatedListRecordsRequestStrategy, GetRelatedListRecordsRequest, GetRelatedListRecordsBatchRequestStrategy, GetRelatedListRecordsBatchRequest } from '../request-strategy';
 import { PredictivePrefetchPage } from './predictive-prefetch-page';
 export type RecordHomePageContext = {
     objectApiName: string;
@@ -7,7 +7,7 @@ export type RecordHomePageContext = {
     actionName: string;
     type: 'recordPage';
 };
-export type RecordHomePageRequest = GetRecordRequest | GetRecordsRequest | GetRecordActionsRequest | GetRecordAvatarsRequest | GetObjectInfoRequest | GetObjectInfosRequest | GetRelatedListsActionsRequest;
+export type RecordHomePageRequest = GetRecordRequest | GetRecordsRequest | GetRecordActionsRequest | GetRecordAvatarsRequest | GetObjectInfoRequest | GetObjectInfosRequest | GetRelatedListsActionsRequest | GetRelatedListInfoBatchRequest | GetRelatedListRecordsRequest | GetRelatedListRecordsBatchRequest;
 export declare class RecordHomePage extends PredictivePrefetchPage<RecordHomePageRequest, RecordHomePageContext> {
     private requestStrategies;
     similarContext: RecordHomePageContext;
@@ -19,6 +19,9 @@ export declare class RecordHomePage extends PredictivePrefetchPage<RecordHomePag
         getObjectInfo: GetObjectInfoRequestStrategy;
         getObjectInfos: GetObjectInfosRequestStrategy;
         getRelatedListsActions: GetRelatedListsActionsRequestStrategy;
+        getRelatedListInfoBatch: GetRelatedListInfoBatchRequestStrategy;
+        getRelatedListRecords: GetRelatedListRecordsRequestStrategy;
+        getRelatedListRecordsBatch: GetRelatedListRecordsBatchRequestStrategy;
     });
     buildSaveRequestData(request: RecordHomePageRequest): {
         request: GetRecordRequest;
@@ -39,19 +42,15 @@ export declare class RecordHomePage extends PredictivePrefetchPage<RecordHomePag
         request: GetRelatedListsActionsRequest;
         context: RecordHomePageContext;
     } | {
-        request: GetObjectInfosRequest;
+        request: GetRelatedListRecordsRequest;
         context: RecordHomePageContext;
-    };
-    buildGetRecordSaveRequestData(request: GetRecordRequest): {
-        request: GetRecordRequest;
+    } | {
+        request: GetRelatedListRecordsBatchRequest;
         context: RecordHomePageContext;
-    };
-    buildGetRecordsSaveRequestData(request: GetRecordsRequest): {
-        request: GetRecordsRequest;
+    } | {
+        request: GetObjectInfosRequest | GetRelatedListInfoBatchRequest;
         context: RecordHomePageContext;
     };
-    isGetRecordRequestContextDependent(request: GetRecordRequest): boolean;
-    isGetRecordsRequestContextDependent(request: GetRecordsRequest): boolean;
     resolveSimilarRequest(similarRequest: RecordHomePageRequest): RecordHomePageRequest;
     getAlwaysRunRequests(): RecordHomePageRequest[];
     static handlesContext(context: LexContext): context is RecordHomePageContext;

package/dist/types/predictive-loading/prefetcher/lex-predictive-prefetcher.d.ts

@@ -1,6 +1,6 @@
 import type { DefaultPageContext, PredictivePrefetchPage } from '../pages';
 import { ApplicationPredictivePrefetcher } from './predictive-prefetcher';
-import type { GetRecordActionsRequestStrategy, GetRecordAvatarsRequestStrategy, GetRecordRequestStrategy, GetRecordsRequestStrategy, GetObjectInfoRequestStrategy, GetObjectInfosRequestStrategy, GetRelatedListsActionsRequestStrategy } from '../request-strategy';
+import type { GetRecordActionsRequestStrategy, GetRecordAvatarsRequestStrategy, GetRecordRequestStrategy, GetRecordsRequestStrategy, GetObjectInfoRequestStrategy, GetObjectInfosRequestStrategy, GetRelatedListsActionsRequestStrategy, GetRelatedListInfoBatchRequestStrategy, GetRelatedListRecordsRequestStrategy, GetRelatedListRecordsBatchRequestStrategy } from '../request-strategy';
 import type { RequestRunner } from '../request-runner';
 import type { PrefetchRepository } from '../repository/prefetch-repository';
 import type { RecordHomePageContext, RecordHomePageRequest } from '../pages/record-home-page';
@@ -16,6 +16,9 @@ export declare class LexPredictivePrefetcher extends ApplicationPredictivePrefet
         getObjectInfo: GetObjectInfoRequestStrategy;
         getObjectInfos: GetObjectInfosRequestStrategy;
         getRelatedListsActions: GetRelatedListsActionsRequestStrategy;
+        getRelatedListInfoBatch: GetRelatedListInfoBatchRequestStrategy;
+        getRelatedListRecords: GetRelatedListRecordsRequestStrategy;
+        getRelatedListRecordsBatch: GetRelatedListRecordsBatchRequestStrategy;
     });
     getPage(): PredictivePrefetchPage<LexRequest, LexContext>;
 }

package/dist/types/predictive-loading/request-strategy/get-object-info-request-strategy.d.ts

@@ -11,9 +11,9 @@ export declare class GetObjectInfoRequestStrategy extends LuvioAdapterRequestStr
     adapterName: string;
     adapterFactory: import("@luvio/engine").AdapterFactory<GetObjectInfoConfig, import("@salesforce/lds-adapters-uiapi").ObjectInfoRepresentation>;
     buildConcreteRequest(similarRequest: GetObjectInfoRequest, context: GetObjectInfoContext): GetObjectInfoRequest;
-    buildGetObjectInfoSaveRequestData<C extends GetObjectInfoContext>(similarContext: C, context: C, request: GetObjectInfoRequest): {
+    buildSaveRequestData<C extends GetObjectInfoContext>(similarContext: C, context: C, request: GetObjectInfoRequest): {
         request: GetObjectInfoRequest;
         context: C;
     };
-    private isGetObjectInfoContextDependent;
+    isContextDependent(context: GetObjectInfoContext, request: GetObjectInfoRequest): boolean;
 }

package/dist/types/predictive-loading/request-strategy/get-record-actions-request-strategy.d.ts

@@ -11,12 +11,12 @@ export declare class GetRecordActionsRequestStrategy extends LuvioAdapterRequest
     adapterName: string;
     adapterFactory: import("@luvio/engine").AdapterFactory<GetRecordActionsConfig, import("packages/lds-adapters-uiapi/dist/es/es2018/types/src/generated/types/ActionRepresentation").ActionRepresentation>;
     buildConcreteRequest(similarRequest: GetRecordActionsRequest, context: GetRecordActionsContext): GetRecordActionsRequest;
-    buildGetRecordActionsSaveRequestData<C extends GetRecordActionsContext>(similarContext: C, context: C, request: GetRecordActionsRequest): {
+    buildSaveRequestData<C extends GetRecordActionsContext>(similarContext: C, context: C, request: GetRecordActionsRequest): {
         request: GetRecordActionsRequest;
         context: C;
     };
     canCombine(reqA: GetRecordActionsConfig, reqB: GetRecordActionsConfig): boolean;
     combineRequests(reqA: GetRecordActionsConfig, reqB: GetRecordActionsConfig): GetRecordActionsConfig;
-    private isGetRecordActionsRequestContextDependent;
+    isContextDependent(context: GetRecordActionsContext, request: GetRecordActionsRequest): boolean;
 }
 export {};

package/dist/types/predictive-loading/request-strategy/get-record-avatars-request-strategy.d.ts

@@ -11,11 +11,11 @@ export declare class GetRecordAvatarsRequestStrategy extends LuvioAdapterRequest
     adapterName: string;
     adapterFactory: import("@luvio/engine").AdapterFactory<GetRecordAvatarsConfig, import("packages/lds-adapters-uiapi/dist/es/es2018/types/src/generated/types/RecordAvatarBulkMapRepresentation").RecordAvatarBulkMapRepresentation>;
     buildConcreteRequest(similarRequest: GetRecordAvatarsRequest, context: GetRecordAvatarsContext): GetRecordAvatarsRequest;
-    buildGetRecordAvatarsSaveRequestData<C extends GetRecordAvatarsContext>(similarContext: C, context: C, request: GetRecordAvatarsRequest): {
+    buildSaveRequestData<C extends GetRecordAvatarsContext>(similarContext: C, context: C, request: GetRecordAvatarsRequest): {
         request: GetRecordAvatarsRequest;
         context: C;
     };
-    private isGetRecordAvatarsRequestContextDependent;
+    isContextDependent<C extends GetRecordAvatarsContext>(context: C, request: GetRecordAvatarsRequest): boolean;
     canCombine(reqA: GetRecordAvatarsConfig, reqB: GetRecordAvatarsConfig): boolean;
     combineRequests(reqA: GetRecordAvatarsConfig, reqB: GetRecordAvatarsConfig): GetRecordAvatarsConfig;
 }

package/dist/types/predictive-loading/request-strategy/get-record-request-strategy.d.ts

@@ -14,5 +14,10 @@ export declare class GetRecordRequestStrategy extends LuvioAdapterRequestStrateg
     transformForSave(request: GetRecordRequest): GetRecordRequest;
     canCombine(reqA: GetRecordConfig, reqB: GetRecordConfig): boolean;
     combineRequests(reqA: GetRecordConfig, reqB: GetRecordConfig): GetRecordConfig;
+    isContextDependent(context: GetRecordContext, request: GetRecordRequest): boolean;
+    buildSaveRequestData<C extends GetRecordContext>(similarContext: C, context: C, request: GetRecordRequest): {
+        request: GetRecordRequest;
+        context: C;
+    };
 }
 export {};

package/dist/types/predictive-loading/request-strategy/get-records-request-strategy.d.ts

@@ -11,5 +11,10 @@ export declare class GetRecordsRequestStrategy extends LuvioAdapterRequestStrate
     adapterName: string;
     adapterFactory: import("@luvio/engine").AdapterFactory<GetRecordsConfig, import("@salesforce/lds-adapters-uiapi").BatchRepresentation>;
     buildConcreteRequest(similarRequest: GetRecordsRequest, context: GetRecordsContext): GetRecordsRequest;
+    isContextDependent(context: GetRecordsContext, request: GetRecordsRequest): boolean;
+    buildSaveRequestData<Context extends GetRecordsContext, R extends GetRecordsRequest>(similarContext: Context, context: Context, request: R): {
+        request: GetRecordsRequest;
+        context: Context;
+    };
 }
 export {};

package/dist/types/predictive-loading/request-strategy/get-related-list-info-batch-request-strategy.d.ts

@@ -0,0 +1,17 @@
+import type { GetRelatedListInfoBatchConfig } from 'packages/lds-adapters-uiapi/dist/es/es2018/types/src/generated/adapters/getRelatedListInfoBatch';
+import { LuvioAdapterRequestStrategy } from './luvio-adapter-request-strategy';
+export type GetRelatedListInfoBatchRequest = {
+    adapterName: 'getRelatedListInfoBatch';
+    config: GetRelatedListInfoBatchConfig;
+};
+type GetRelatedListInfoBatchContext = {
+    objectApiName: string;
+};
+export declare class GetRelatedListInfoBatchRequestStrategy extends LuvioAdapterRequestStrategy<GetRelatedListInfoBatchConfig, GetRelatedListInfoBatchRequest, GetRelatedListInfoBatchContext> {
+    adapterName: string;
+    adapterFactory: import("@luvio/engine").AdapterFactory<GetRelatedListInfoBatchConfig, import("packages/lds-adapters-uiapi/dist/es/es2018/types/src/generated/types/RelatedListInfoBatchRepresentation").RelatedListInfoBatchRepresentation>;
+    buildConcreteRequest(similarRequest: GetRelatedListInfoBatchRequest, _context: GetRelatedListInfoBatchContext): GetRelatedListInfoBatchRequest;
+    canCombine(reqA: GetRelatedListInfoBatchConfig, reqB: GetRelatedListInfoBatchConfig): boolean;
+    combineRequests(reqA: GetRelatedListInfoBatchConfig, reqB: GetRelatedListInfoBatchConfig): GetRelatedListInfoBatchConfig;
+}
+export {};

package/dist/types/predictive-loading/request-strategy/get-related-list-records-batch-request-strategy.d.ts

@@ -0,0 +1,34 @@
+import type { GetRelatedListRecordsBatchConfig } from '@salesforce/lds-adapters-uiapi';
+import { LuvioAdapterRequestStrategy } from './luvio-adapter-request-strategy';
+export type GetRelatedListRecordsBatchRequest = {
+    adapterName: 'getRelatedListRecordsBatch';
+    config: GetRelatedListRecordsBatchConfig;
+};
+type GetRelatedListRecordsBatchContext = {
+    recordId: string;
+};
+export declare class GetRelatedListRecordsBatchRequestStrategy extends LuvioAdapterRequestStrategy<GetRelatedListRecordsBatchConfig, GetRelatedListRecordsBatchRequest, GetRelatedListRecordsBatchContext> {
+    adapterName: string;
+    adapterFactory: import("@luvio/engine").AdapterFactory<GetRelatedListRecordsBatchConfig, import("@salesforce/lds-adapters-uiapi").RelatedListRecordCollectionBatchRepresentation>;
+    buildConcreteRequest(similarRequest: GetRelatedListRecordsBatchRequest, context: GetRelatedListRecordsBatchContext): GetRelatedListRecordsBatchRequest;
+    buildSaveRequestData<C extends GetRelatedListRecordsBatchContext>(similarContext: C, context: C, request: GetRelatedListRecordsBatchRequest): {
+        request: GetRelatedListRecordsBatchRequest;
+        context: C;
+    };
+    isContextDependent(context: GetRelatedListRecordsBatchContext, request: GetRelatedListRecordsBatchRequest): boolean;
+    /**
+     * Can combine two seperate batch requests if the parentRecordId is the same.
+     * @param reqA The first GetRelatedListRecordsBatchConfig.
+     * @param reqB The first GetRelatedListRecordsBatchConfig.
+     * @returns true if the requests can be combined, otherwise false.
+     */
+    canCombine(reqA: GetRelatedListRecordsBatchConfig, reqB: GetRelatedListRecordsBatchConfig): boolean;
+    /**
+     * Merge the relatedListParameters together between two combinable batch requests.
+     * @param reqA The first GetRelatedListRecordsBatchConfig.
+     * @param reqB The first GetRelatedListRecordsBatchConfig.
+     * @returns The combined request.
+     */
+    combineRequests(reqA: GetRelatedListRecordsBatchConfig, reqB: GetRelatedListRecordsBatchConfig): GetRelatedListRecordsBatchConfig;
+}
+export {};

package/dist/types/predictive-loading/request-strategy/get-related-list-records-request-strategy.d.ts

@@ -0,0 +1,20 @@
+import type { GetRelatedListRecordsConfig } from '@salesforce/lds-adapters-uiapi';
+import { LuvioAdapterRequestStrategy } from './luvio-adapter-request-strategy';
+export type GetRelatedListRecordsRequest = {
+    adapterName: 'getRelatedListRecords';
+    config: GetRelatedListRecordsConfig;
+};
+type GetRelatedListRecordsContext = {
+    recordId: string;
+};
+export declare class GetRelatedListRecordsRequestStrategy extends LuvioAdapterRequestStrategy<GetRelatedListRecordsConfig, GetRelatedListRecordsRequest, GetRelatedListRecordsContext> {
+    adapterName: string;
+    adapterFactory: import("@luvio/engine").AdapterFactory<GetRelatedListRecordsConfig, import("@salesforce/lds-adapters-uiapi").RelatedListRecordCollectionRepresentation>;
+    buildConcreteRequest(similarRequest: GetRelatedListRecordsRequest, context: GetRelatedListRecordsContext): GetRelatedListRecordsRequest;
+    buildSaveRequestData<C extends GetRelatedListRecordsContext>(similarContext: C, context: C, request: GetRelatedListRecordsRequest): {
+        request: GetRelatedListRecordsRequest;
+        context: C;
+    };
+    isContextDependent(context: GetRelatedListRecordsContext, request: GetRelatedListRecordsRequest): boolean;
+}
+export {};

package/dist/types/predictive-loading/request-strategy/get-related-lists-actions-request-strategy.d.ts

@@ -11,11 +11,11 @@ export declare class GetRelatedListsActionsRequestStrategy extends LuvioAdapterR
     adapterName: string;
     adapterFactory: import("@luvio/engine").AdapterFactory<GetRelatedListsActionsConfig, import("packages/lds-adapters-uiapi/dist/es/es2018/types/src/generated/types/ActionRelatedListsCollectionBatchRepresentation").ActionRelatedListsCollectionBatchRepresentation>;
     buildConcreteRequest(similarRequest: GetRelatedListsActionsRequest, context: GetRelatedListsActionsContext): GetRelatedListsActionsRequest;
-    buildGetRelatedListsActionsSaveRequestData<C extends GetRelatedListsActionsContext>(similarContext: C, context: C, request: GetRelatedListsActionsRequest): {
+    buildSaveRequestData<C extends GetRelatedListsActionsContext>(similarContext: C, context: C, request: GetRelatedListsActionsRequest): {
         request: GetRelatedListsActionsRequest;
         context: C;
     };
-    private isGetRelatedListsActionsRequestContextDependent;
+    isContextDependent(context: GetRelatedListsActionsContext, request: GetRelatedListsActionsRequest): boolean;
     /**
      * Can only reduce two requests when they have the same recordId, and
      * the individual relatedListAction config only have relatedListId.

package/dist/types/predictive-loading/request-strategy/index.d.ts

@@ -5,6 +5,9 @@ export * from './get-record-actions-request-strategy';
 export * from './get-object-info-request-strategy';
 export * from './get-object-infos-request-strategy';
 export * from './get-related-lists-actions-request-strategy';
+export * from './get-related-list-info-batch-request-strategy';
+export * from './get-related-list-records-request-strategy';
+export * from './get-related-list-records-batch-request-strategy';
 export * from './luvio-adapter-request-strategy';
 export * from './luvio-adapter-request';
 export * from './request-strategy';

package/dist/types/predictive-loading/request-strategy/luvio-adapter-request-strategy.d.ts

@@ -2,11 +2,74 @@ import type { AdapterFactory } from '@luvio/engine';
 import { RequestStrategy } from './request-strategy';
 import type { LuvioAdapterRequest } from './luvio-adapter-request';
 export declare abstract class LuvioAdapterRequestStrategy<AdapterConfig, Request extends LuvioAdapterRequest<AdapterConfig>, Context> extends RequestStrategy<Request, Context> {
+    /**
+     * Name of the adapter used in this strategy.
+     */
     abstract adapterName: string;
+    /**
+     * Factory for the adapter used in this strategy.
+     */
     abstract adapterFactory: AdapterFactory<AdapterConfig, any>;
+    /**
+     * Perform any transformations required to prepare the request for saving.
+     *
+     * e.g. If the request is for a record, we move all fields in the fields array
+     * into the optionalFields array
+     *
+     * @param request - The request to transform
+     * @returns
+     */
     transformForSave(request: Request): Request;
+    /**
+     * Filter requests to only those that are for this strategy.
+     *
+     * @param unfilteredRequests array of requests to filter
+     * @returns
+     */
     protected filterRequests(unfilteredRequests: LuvioAdapterRequest<unknown>[]): Request[];
+    /**
+     * Reduce requests by combining those based on a strategies implementations
+     * of canCombine and combineRequests.
+     * @param unfilteredRequests array of requests to filter
+     * @returns
+     */
     reduce(unfilteredRequests: LuvioAdapterRequest<unknown>[]): Request[];
+    /**
+     * Check if two requests can be combined.
+     *
+     * By default, requests are not combinable.
+     * @param reqA config of request A
+     * @param reqB config of request B
+     * @returns
+     */
     canCombine(_reqA: AdapterConfig, _reqB: AdapterConfig): boolean;
+    /**
+     * Takes two request configs and combines them into a single request config.
+     *
+     * @param reqA config of request A
+     * @param reqB config of request B
+     * @returns
+     */
     combineRequests(reqA: AdapterConfig, _reqB: AdapterConfig): AdapterConfig;
+    /**
+     * Checks adapter config against request context to determine if the request is context dependent.
+     *
+     * By default, requests are not context dependent.
+     * @param request
+     * @returns
+     */
+    isContextDependent(_context: Context, _request: Request): boolean;
+    /**
+     * Builds request for saving,
+     *  - transforming the request
+     *  - handling the cases where the request is context dependent (this is homework for the subclass)
+     * @param _similarContext Context with at least one parameter as a wildcard '*'
+     * @param context Exact context for a given page
+     * @param request
+     * @returns
+     */
+    buildSaveRequestData(_similarContext: Context, context: Context, request: Request): {
+        request: Request;
+        context: Context;
+    };
 }

package/dist/types/predictive-loading/request-strategy/luvio-adapter-request.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Luvio adapter used to make the request
+ * @typeParam Config - The config provided for the request
+ */
 export type LuvioAdapterRequest<Config> = {
     adapterName: string;
     config: Config;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-runtime-aura",
-    "version": "1.273.0",
+    "version": "1.274.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "LDS engine for Aura runtime",
     "main": "dist/ldsEngineCreator.js",
@@ -34,13 +34,13 @@
         "release:corejar": "yarn build && ../core-build/scripts/core.js --name=lds-runtime-aura"
     },
     "devDependencies": {
-        "@salesforce/lds-adapters-uiapi": "^1.273.0",
-        "@salesforce/lds-ads-bridge": "^1.273.0",
-        "@salesforce/lds-aura-storage": "^1.273.0",
-        "@salesforce/lds-bindings": "^1.273.0",
-        "@salesforce/lds-instrumentation": "^1.273.0",
-        "@salesforce/lds-network-aura": "^1.273.0",
-        "@salesforce/lds-network-fetch-with-jwt": "^1.273.0"
+        "@salesforce/lds-adapters-uiapi": "^1.274.0",
+        "@salesforce/lds-ads-bridge": "^1.274.0",
+        "@salesforce/lds-aura-storage": "^1.274.0",
+        "@salesforce/lds-bindings": "^1.274.0",
+        "@salesforce/lds-instrumentation": "^1.274.0",
+        "@salesforce/lds-network-aura": "^1.274.0",
+        "@salesforce/lds-network-fetch-with-jwt": "^1.274.0"
     },
     "dependencies": {
         "@luvio/network-adapter-composable": "0.154.9"
@@ -49,9 +49,9 @@
         {
             "path": "./dist/ldsEngineCreator.js",
             "maxSize": {
-                "none": "70 kB",
-                "min": "30 kB",
-                "compressed": "13 kB"
+                "none": "75 kB",
+                "min": "32 kB",
+                "compressed": "15 kB"
             }
         }
     ],