@salesforce/lds-runtime-aura 1.266.0-dev20 → 1.266.0-dev22

package/dist/ldsEngineCreator.js

@@ -15,16 +15,20 @@
 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, coerceFieldIdArray, getRecordsAdapterFactory, getRecordActionsAdapterFactory, getObjectInfoAdapterFactory, getObjectInfosAdapterFactory, instrument, configuration, InMemoryRecordRepresentationQueryEvaluator, UiApiNamespace, RecordRepresentationRepresentationType, registerPrefetcher } from 'force/ldsAdaptersUiapi';
-import { createStorage, clearStorages } from 'force/ldsStorage';
-import { withRegistration, register, setDefaultLuvio } from 'force/ldsEngine';
+import { instrument, getRecordAvatarsAdapterFactory, getRecordAdapterFactory, coerceFieldIdArray, getRecordsAdapterFactory, getRecordActionsAdapterFactory, getObjectInfoAdapterFactory, getObjectInfosAdapterFactory, configuration, InMemoryRecordRepresentationQueryEvaluator, UiApiNamespace, RecordRepresentationRepresentationType, registerPrefetcher } from 'force/ldsAdaptersUiapi';
+import { LRUCache, instrumentAdapter, instrumentLuvio, setupInstrumentation as setupInstrumentation$1, logObjectInfoChanged as logObjectInfoChanged$1, updatePercentileHistogramMetric, incrementCounterMetric, incrementGetRecordNotifyChangeAllowCount, incrementGetRecordNotifyChangeDropCount, incrementNotifyRecordUpdateAvailableAllowCount, incrementNotifyRecordUpdateAvailableDropCount, setLdsAdaptersUiapiInstrumentation, setLdsNetworkAdapterInstrumentation, executeAsyncActivity, METRIC_KEYS, onIdleDetected } from 'force/ldsInstrumentation';
 import { REFRESH_ADAPTER_EVENT, ADAPTER_UNFULFILLED_ERROR, instrument as instrument$2 } from 'force/ldsBindings';
 import { counter, registerCacheStats, perfStart, perfEnd, registerPeriodicLogger, interaction, timer } from 'instrumentation/service';
-import { LRUCache, instrumentAdapter, instrumentLuvio, setupInstrumentation as setupInstrumentation$1, logObjectInfoChanged as logObjectInfoChanged$1, updatePercentileHistogramMetric, incrementCounterMetric, incrementGetRecordNotifyChangeAllowCount, incrementGetRecordNotifyChangeDropCount, incrementNotifyRecordUpdateAvailableAllowCount, incrementNotifyRecordUpdateAvailableDropCount, setLdsAdaptersUiapiInstrumentation, setLdsNetworkAdapterInstrumentation, onIdleDetected } from 'force/ldsInstrumentation';
 import auraNetworkAdapter, { instrument as instrument$1, forceRecordTransactionsDisabled, ldsNetworkAdapterInstrument, dispatchAuraAction, defaultActionConfig } from 'force/ldsNetwork';
 import { instrument as instrument$3 } from 'force/adsBridge';
+import { withRegistration, register, setDefaultLuvio } from 'force/ldsEngine';
+import { createStorage, clearStorages } from 'force/ldsStorage';
 import { buildJwtNetworkAdapter } from 'force/ldsNetworkFetchWithJwt';
 
+const PDL_EXECUTE_ASYNC_OPTIONS = {
+    LOG_ERROR_ONLY: true,
+};
+
 class PredictivePrefetchPage {
     constructor(context) {
         this.context = context;
@@ -167,94 +171,56 @@ class RecordHomePage extends PredictivePrefetchPage {
     }
 }
 
-class ApplicationPredictivePrefetcher {
-    constructor(context, repository, requestRunner) {
-        this.repository = repository;
-        this.requestRunner = requestRunner;
-        this.isRecording = false;
-        this.queuedPredictionRequests = [];
-        this._context = context;
-        this.page = this.getPage();
-    }
-    set context(value) {
-        this._context = value;
-        this.page = this.getPage();
-    }
-    get context() {
-        return this._context;
-    }
-    async stopRecording() {
-        this.isRecording = false;
-        await this.repository.flushRequestsToStorage();
-    }
-    startRecording() {
-        this.isRecording = true;
-        this.repository.clearRequestBuffer();
-    }
-    saveRequest(request) {
-        if (!this.isRecording) {
-            return Promise.resolve();
-        }
-        const { request: requestToSave, context } = this.page.buildSaveRequestData(request);
-        // No need to diferentiate from predictions requests because these
-        // are made from the adapters factory, which are not prediction aware.
-        return this.repository.saveRequest(context, requestToSave);
-    }
-    async predict() {
-        const exactPageRequests = (await this.repository.getPageRequests(this.context)) || [];
-        const similarPageRequests = await this.getSimilarPageRequests();
-        const alwaysRequests = this.page.getAlwaysRunRequests();
-        const predictedRequests = [
-            ...alwaysRequests,
-            ...this.requestRunner.reduceRequests([
-                ...exactPageRequests,
-                ...similarPageRequests,
-                ...this.page.getAlwaysRunRequests(),
-            ]),
-        ];
-        this.queuedPredictionRequests.push(...predictedRequests);
-        return Promise.all(predictedRequests.map((request) => this.requestRunner.runRequest(request))).then();
-    }
-    hasPredictions() {
-        const exactPageRequests = this.repository.getPageRequests(this.context) || [];
-        const similarPageRequests = this.page.similarContext !== undefined
-            ? this.repository.getPageRequests(this.page.similarContext)
-            : [];
-        return exactPageRequests.length > 0 || similarPageRequests.length > 0;
-    }
-    getSimilarPageRequests() {
-        let resolvedSimilarPageRequests = [];
-        if (this.page.similarContext !== undefined) {
-            const similarPageRequests = this.repository.getPageRequests(this.page.similarContext);
-            if (similarPageRequests !== undefined) {
-                resolvedSimilarPageRequests = similarPageRequests.map((request) => this.page.resolveSimilarRequest(request));
-            }
-        }
-        return resolvedSimilarPageRequests;
-    }
-}
+/**
+ * Observability / Critical Availability Program (230+)
+ *
+ * This file is intended to be used as a consolidated place for all definitions, functions,
+ * and helpers related to "M1"[1].
+ *
+ * Below are the R.E.A.D.S. metrics for the Lightning Data Service, defined here[2].
+ *
+ * [1] Search "[M1] Lightning Data Service Design Spike" in Quip
+ * [2] Search "Lightning Data Service R.E.A.D.S. Metrics" in Quip
+ */
+const OBSERVABILITY_NAMESPACE = 'LIGHTNING.lds.service';
+const ADAPTER_INVOCATION_COUNT_METRIC_NAME = 'request';
+const ADAPTER_ERROR_COUNT_METRIC_NAME = 'error';
+const NETWORK_ADAPTER_RESPONSE_METRIC_NAME = 'network-response';
+/**
+ * W-8379680
+ * Counter for number of getApex requests.
+ */
+const GET_APEX_REQUEST_COUNT = {
+    get() {
+        return {
+            owner: OBSERVABILITY_NAMESPACE,
+            name: ADAPTER_INVOCATION_COUNT_METRIC_NAME + '.' + NORMALIZED_APEX_ADAPTER_NAME,
+        };
+    },
+};
+/**
+ * W-8828410
+ * Counter for the number of UnfulfilledSnapshotErrors the luvio engine has.
+ */
+const TOTAL_ADAPTER_ERROR_COUNT = {
+    get() {
+        return { owner: OBSERVABILITY_NAMESPACE, name: ADAPTER_ERROR_COUNT_METRIC_NAME };
+    },
+};
+/**
+ * W-8828410
+ * Counter for the number of invocations made into LDS by a wire adapter.
+ */
+const TOTAL_ADAPTER_REQUEST_SUCCESS_COUNT = {
+    get() {
+        return { owner: OBSERVABILITY_NAMESPACE, name: ADAPTER_INVOCATION_COUNT_METRIC_NAME };
+    },
+};
 
-class LexPredictivePrefetcher extends ApplicationPredictivePrefetcher {
-    constructor(context, repository, requestRunner, 
-    // These strategies need to be in sync with the "predictiveDataLoadCapable" list
-    // from scripts/lds-uiapi-plugin.js
-    requestStrategies) {
-        super(context, repository, requestRunner);
-        this.requestStrategies = requestStrategies;
-        this.page = this.getPage();
-    }
-    getPage() {
-        if (RecordHomePage.handlesContext(this.context)) {
-            return new RecordHomePage(this.context, this.requestStrategies);
-        }
-        return new LexDefaultPage(this.context);
-    }
-}
+const { create, keys } = Object;
+const { isArray } = Array;
+const { stringify } = JSON;
 
-// Copy-pasted from adapter-utils. This util should be extracted from generated code and imported in prefetch repository.
-const { keys: ObjectKeys$1 } = Object;
-const { stringify: JSONStringify } = JSON;
-const { isArray: ArrayIsArray } = Array;
 /**
  * A deterministic JSON stringify implementation. Heavily adapted from https://github.com/epoberezkin/fast-json-stable-stringify.
  * This is needed because insertion order for JSON.stringify(object) affects output:
@@ -262,6 +228,7 @@ const { isArray: ArrayIsArray } = Array;
  *      "{"a":1,"b":2}"
  * JSON.stringify({b: 2, a: 1})
  *      "{"b":2,"a":1}"
+ * Modified from the apex implementation to sort arrays non-destructively.
  * @param data Data to be JSON-stringified.
  * @returns JSON.stringified value with consistent ordering of keys.
  */
@@ -278,11 +245,14 @@ function stableJSONStringify$1(node) {
         return isFinite(node) ? '' + node : 'null';
     }
     if (typeof node !== 'object') {
-        return JSONStringify(node);
+        return stringify(node);
     }
     let i;
     let out;
-    if (ArrayIsArray(node)) {
+    if (isArray(node)) {
+        // copy any array before sorting so we don't mutate the object.
+        // eslint-disable-next-line no-param-reassign
+        node = node.slice(0).sort();
         out = '[';
         for (i = 0; i < node.length; i++) {
             if (i) {
@@ -295,10 +265,10 @@ function stableJSONStringify$1(node) {
     if (node === null) {
         return 'null';
     }
-    const keys = ObjectKeys$1(node).sort();
+    const keys$1 = keys(node).sort();
     out = '';
-    for (i = 0; i < keys.length; i++) {
-        const key = keys[i];
+    for (i = 0; i < keys$1.length; i++) {
+        const key = keys$1[i];
         const value = stableJSONStringify$1(node[key]);
         if (!value) {
             continue;
@@ -306,532 +276,565 @@ function stableJSONStringify$1(node) {
         if (out) {
             out += ',';
         }
-        out += JSONStringify(key) + ':' + value;
+        out += stringify(key) + ':' + value;
     }
     return '{' + out + '}';
 }
-function isObject(obj) {
-    return obj !== null && typeof obj === 'object';
-}
-function deepEquals(objA, objB) {
-    if (objA === objB)
-        return true;
-    if (objA instanceof Date && objB instanceof Date)
-        return objA.getTime() === objB.getTime();
-    // If one of them is not an object, they are not deeply equal
-    if (!isObject(objA) || !isObject(objB))
-        return false;
-    // Filter out keys set as undefined, we can compare undefined as equals.
-    const keysA = ObjectKeys$1(objA).filter((key) => objA[key] !== undefined);
-    const keysB = ObjectKeys$1(objB).filter((key) => objB[key] !== undefined);
-    // If the objects do not have the same set of keys, they are not deeply equal
-    if (keysA.length !== keysB.length)
-        return false;
-    for (const key of keysA) {
-        const valA = objA[key];
-        const valB = objB[key];
-        const areObjects = isObject(valA) && isObject(valB);
-        // If both values are objects, recursively compare them
-        if (areObjects && !deepEquals(valA, valB))
-            return false;
-        // If only one value is an object or if the values are not strictly equal, they are not deeply equal
-        if (!areObjects && valA !== valB)
-            return false;
-    }
-    return true;
+function isPromise(value) {
+    // check for Thenable due to test frameworks using custom Promise impls
+    return value !== null && value.then !== undefined;
 }
 
-class PrefetchRepository {
-    constructor(storage) {
-        this.storage = storage;
-        this.requestBuffer = new Map();
-    }
-    clearRequestBuffer() {
-        this.requestBuffer.clear();
-    }
-    async flushRequestsToStorage() {
-        for (const [id, batch] of this.requestBuffer) {
-            const rawPage = await this.storage.get(id);
-            const page = rawPage === undefined ? { id, requests: [] } : rawPage;
-            batch.forEach(({ request, requestTime }) => {
-                let existingRequestEntry = page.requests.find(({ request: storedRequest }) => deepEquals(storedRequest, request));
-                if (existingRequestEntry === undefined) {
-                    existingRequestEntry = { request, requestMetadata: { requestTimes: [] } };
-                    page.requests.push(existingRequestEntry);
+const APEX_ADAPTER_NAME = 'getApex';
+const NORMALIZED_APEX_ADAPTER_NAME = `Apex.${APEX_ADAPTER_NAME}`;
+const REFRESH_APEX_KEY = 'refreshApex';
+const REFRESH_UIAPI_KEY = 'refreshUiApi';
+const SUPPORTED_KEY = 'refreshSupported';
+const UNSUPPORTED_KEY = 'refreshUnsupported';
+const REFRESH_EVENTSOURCE = 'lds-refresh-summary';
+const REFRESH_EVENTTYPE = 'system';
+const REFRESH_PAYLOAD_TARGET = 'adapters';
+const REFRESH_PAYLOAD_SCOPE = 'lds';
+const INCOMING_WEAKETAG_0_KEY = 'incoming-weaketag-0';
+const EXISTING_WEAKETAG_0_KEY = 'existing-weaketag-0';
+const RECORD_API_NAME_CHANGE_COUNT_METRIC_NAME = 'record-api-name-change-count';
+const NAMESPACE = 'lds';
+const NETWORK_TRANSACTION_NAME = 'lds-network';
+const CACHE_STATS_OUT_OF_TTL_MISS_POSTFIX = 'out-of-ttl-miss';
+// Aggregate Cache Stats and Metrics for all getApex invocations
+const getApexCacheStats = registerLdsCacheStats(NORMALIZED_APEX_ADAPTER_NAME);
+const getApexTtlCacheStats = registerLdsCacheStats(NORMALIZED_APEX_ADAPTER_NAME + ':' + CACHE_STATS_OUT_OF_TTL_MISS_POSTFIX);
+// Observability (READS)
+const getApexRequestCountMetric = counter(GET_APEX_REQUEST_COUNT);
+const totalAdapterRequestSuccessMetric = counter(TOTAL_ADAPTER_REQUEST_SUCCESS_COUNT);
+const totalAdapterErrorMetric = counter(TOTAL_ADAPTER_ERROR_COUNT);
+class Instrumentation {
+    constructor() {
+        this.adapterUnfulfilledErrorCounters = {};
+        this.recordApiNameChangeCounters = {};
+        this.refreshAdapterEvents = {};
+        this.refreshApiCallEventStats = {
+            [REFRESH_APEX_KEY]: 0,
+            [REFRESH_UIAPI_KEY]: 0,
+            [SUPPORTED_KEY]: 0,
+            [UNSUPPORTED_KEY]: 0,
+        };
+        this.lastRefreshApiCall = null;
+        this.weakEtagZeroEvents = {};
+        this.adapterCacheMisses = new LRUCache(250);
+        if (typeof window !== 'undefined' && window.addEventListener) {
+            window.addEventListener('beforeunload', () => {
+                if (keys(this.weakEtagZeroEvents).length > 0) {
+                    perfStart(NETWORK_TRANSACTION_NAME);
+                    perfEnd(NETWORK_TRANSACTION_NAME, this.weakEtagZeroEvents);
                 }
-                existingRequestEntry.requestMetadata.requestTimes.push(requestTime);
             });
-            await this.storage.set(id, page);
         }
-        this.clearRequestBuffer();
-    }
-    async saveRequest(key, request) {
-        const identifier = stableJSONStringify$1(key);
-        const batchForKey = this.requestBuffer.get(identifier) || [];
-        batchForKey.push({
-            request,
-            requestTime: Date.now(),
-        });
-        this.requestBuffer.set(identifier, batchForKey);
+        registerPeriodicLogger(NAMESPACE, this.logRefreshStats.bind(this));
     }
-    getPage(key) {
-        const identifier = stableJSONStringify$1(key);
-        return this.storage.get(identifier);
-    }
-    getPageRequests(key) {
-        const page = this.getPage(key);
-        if (page === undefined) {
-            return [];
-        }
-        return page.requests.map((requestEntry) => requestEntry.request);
-    }
-}
-
-class RequestStrategy {
-    transformForSave(request) {
-        return request;
-    }
-    reduce(requests) {
-        return requests;
-    }
-}
-
-class LuvioAdapterRequestStrategy extends RequestStrategy {
-    transformForSave(request) {
-        return request;
-    }
-    filterRequests(unfilteredRequests) {
-        return unfilteredRequests.filter((request) => request.adapterName === this.adapterName);
-    }
-    reduce(unfilteredRequests) {
-        const requests = this.filterRequests(unfilteredRequests);
-        const visitedRequests = new Set();
-        const reducedRequests = [];
-        for (let i = 0, n = requests.length; i < n; i++) {
-            const currentRequest = requests[i];
-            if (!visitedRequests.has(currentRequest)) {
-                const combinedRequest = { ...currentRequest };
-                for (let j = i + 1; j < n; j++) {
-                    const hasNotBeenVisited = !visitedRequests.has(requests[j]);
-                    const canCombineConfigs = this.canCombine(combinedRequest.config, requests[j].config);
-                    if (hasNotBeenVisited && canCombineConfigs) {
-                        combinedRequest.config = this.combineRequests(combinedRequest.config, requests[j].config);
-                        visitedRequests.add(requests[j]);
-                    }
+    /**
+     * Instruments an existing adapter to log argus metrics and cache stats.
+     * @param adapter The adapter function.
+     * @param metadata The adapter metadata.
+     * @param wireConfigKeyFn Optional function to transform wire configs to a unique key.
+     * @returns The wrapped adapter.
+     */
+    instrumentAdapter(adapter, metadata) {
+        // We are consolidating all apex adapter instrumentation calls under a single key
+        const { apiFamily, name, ttl } = metadata;
+        const adapterName = normalizeAdapterName(name, apiFamily);
+        const isGetApexAdapter = isApexAdapter(name);
+        const stats = isGetApexAdapter ? getApexCacheStats : registerLdsCacheStats(adapterName);
+        const ttlMissStats = isGetApexAdapter
+            ? getApexTtlCacheStats
+            : registerLdsCacheStats(adapterName + ':' + CACHE_STATS_OUT_OF_TTL_MISS_POSTFIX);
+        /**
+         * W-8076905
+         * Dynamically generated metric. Simple counter for all requests made by this adapter.
+         */
+        const wireAdapterRequestMetric = isGetApexAdapter
+            ? getApexRequestCountMetric
+            : counter(createMetricsKey(OBSERVABILITY_NAMESPACE, ADAPTER_INVOCATION_COUNT_METRIC_NAME, adapterName));
+        const instrumentedAdapter = (config, requestContext) => {
+            // increment overall and adapter request metrics
+            wireAdapterRequestMetric.increment(1);
+            totalAdapterRequestSuccessMetric.increment(1);
+            // execute adapter logic
+            const result = adapter(config, requestContext);
+            // In the case where the adapter returns a non-Pending Snapshot it is constructed out of the store
+            // (cache hit) whereas a Promise<Snapshot> or Pending Snapshot indicates a network request (cache miss).
+            //
+            // Note: we can't do a plain instanceof check for a promise here since the Promise may
+            // originate from another javascript realm (for example: in jest test). Instead we use a
+            // duck-typing approach by checking if the result has a then property.
+            //
+            // For adapters without persistent store:
+            //  - total cache hit ratio:
+            //      [in-memory cache hit count] / ([in-memory cache hit count] + [in-memory cache miss count])
+            // For adapters with persistent store:
+            //  - in-memory cache hit ratio:
+            //      [in-memory cache hit count] / ([in-memory cache hit count] + [in-memory cache miss count])
+            //  - total cache hit ratio:
+            //      ([in-memory cache hit count] + [store cache hit count]) / ([in-memory cache hit count] + [in-memory cache miss count])
+            // if result === null then config is insufficient/invalid so do not log
+            if (isPromise(result)) {
+                stats.logMisses();
+                if (ttl !== undefined) {
+                    this.logAdapterCacheMissOutOfTtlDuration(adapterName, config, ttlMissStats, Date.now(), ttl);
                 }
-                reducedRequests.push(combinedRequest);
-                visitedRequests.add(currentRequest);
             }
-        }
-        return reducedRequests;
+            else if (result !== null) {
+                stats.logHits();
+            }
+            return result;
+        };
+        // Set the name property on the function for debugging purposes.
+        Object.defineProperty(instrumentedAdapter, 'name', {
+            value: name + '__instrumented',
+        });
+        return instrumentAdapter(instrumentedAdapter, metadata);
     }
-    canCombine(_reqA, _reqB) {
-        // By default, all requests are not comibinable
-        return false;
+    /**
+     * Logs when adapter requests come in. If we have subsequent cache misses on a given config, beyond its TTL then log the duration to metrics.
+     * Backed by an LRU Cache implementation to prevent too many record entries from being stored in-memory.
+     * @param name The wire adapter name.
+     * @param config The config passed into wire adapter.
+     * @param ttlMissStats CacheStatsLogger to log misses out of TTL.
+     * @param currentCacheMissTimestamp Timestamp for when the request was made.
+     * @param ttl TTL for the wire adapter.
+     */
+    logAdapterCacheMissOutOfTtlDuration(name, config, ttlMissStats, currentCacheMissTimestamp, ttl) {
+        const configKey = `${name}:${stableJSONStringify$1(config)}`;
+        const existingCacheMissTimestamp = this.adapterCacheMisses.get(configKey);
+        this.adapterCacheMisses.set(configKey, currentCacheMissTimestamp);
+        if (existingCacheMissTimestamp !== undefined) {
+            const duration = currentCacheMissTimestamp - existingCacheMissTimestamp;
+            if (duration > ttl) {
+                ttlMissStats.logMisses();
+            }
+        }
     }
-    combineRequests(reqA, _reqB) {
-        // By default, this should never be called since requests aren't combinable
-        if (process.env.NODE_ENV !== 'production') {
-            throw new Error('Not implemented');
+    /**
+     * Injected to LDS for Luvio specific instrumentation.
+     *
+     * @param context The transaction context.
+     */
+    instrumentLuvio(context) {
+        instrumentLuvio(context);
+        if (this.isRefreshAdapterEvent(context)) {
+            this.aggregateRefreshAdapterEvents(context);
         }
-        return reqA;
+        else if (this.isAdapterUnfulfilledError(context)) {
+            this.incrementAdapterRequestErrorCount(context);
+        }
+        else ;
     }
-}
-
-function normalizeRecordIds$1(recordIds) {
-    if (!Array.isArray(recordIds)) {
-        return [recordIds];
+    /**
+     * Returns whether or not this is a RefreshAdapterEvent.
+     * @param context The transaction context.
+     * @returns Whether or not this is a RefreshAdapterEvent.
+     */
+    isRefreshAdapterEvent(context) {
+        return context[REFRESH_ADAPTER_EVENT] === true;
     }
-    return recordIds;
-}
-class GetRecordAvatarsRequestStrategy extends LuvioAdapterRequestStrategy {
-    constructor() {
-        super(...arguments);
-        this.adapterName = 'getRecordAvatars';
-        this.adapterFactory = getRecordAvatarsAdapterFactory;
+    /**
+     * Returns whether or not this is an AdapterUnfulfilledError.
+     * @param context The transaction context.
+     * @returns Whether or not this is an AdapterUnfulfilledError.
+     */
+    isAdapterUnfulfilledError(context) {
+        return context[ADAPTER_UNFULFILLED_ERROR] === true;
     }
-    buildConcreteRequest(similarRequest, context) {
-        return {
-            ...similarRequest,
-            config: {
-                ...similarRequest.config,
-                recordIds: [context.recordId],
-            },
-        };
+    /**
+     * Specific instrumentation for getRecordNotifyChange.
+     * temporary implementation to match existing aura call for now
+     *
+     * @param uniqueWeakEtags whether weakEtags match or not
+     * @param error if dispatchResourceRequest fails for any reason
+     */
+    notifyChangeNetwork(uniqueWeakEtags, error) {
+        perfStart(NETWORK_TRANSACTION_NAME);
+        if (error === true) {
+            perfEnd(NETWORK_TRANSACTION_NAME, { 'notify-change-network': 'error' });
+        }
+        else {
+            perfEnd(NETWORK_TRANSACTION_NAME, { 'notify-change-network': uniqueWeakEtags });
+        }
     }
-    buildGetRecordAvatarsSaveRequestData(similarContext, context, request) {
-        if (this.isGetRecordAvatarsRequestContextDependent(context, request)) {
-            return {
-                request: this.transformForSave({
-                    ...request,
-                    config: {
-                        ...request.config,
-                        recordIds: ['*'],
-                    },
-                }),
-                context: similarContext,
+    /**
+     * Parses and aggregates weakETagZero events to be sent in summarized log line.
+     * @param context The transaction context.
+     */
+    aggregateWeakETagEvents(incomingWeakEtagZero, existingWeakEtagZero, apiName) {
+        const key = 'weaketag-0-' + apiName;
+        if (this.weakEtagZeroEvents[key] === undefined) {
+            this.weakEtagZeroEvents[key] = {
+                [EXISTING_WEAKETAG_0_KEY]: 0,
+                [INCOMING_WEAKETAG_0_KEY]: 0,
             };
         }
-        return {
-            request: this.transformForSave(request),
-            context,
-        };
-    }
-    isGetRecordAvatarsRequestContextDependent(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 &&
-                    request.config.recordIds[0] === context.recordId)));
+        if (existingWeakEtagZero) {
+            this.weakEtagZeroEvents[key][EXISTING_WEAKETAG_0_KEY] += 1;
+        }
+        if (incomingWeakEtagZero) {
+            this.weakEtagZeroEvents[key][INCOMING_WEAKETAG_0_KEY] += 1;
+        }
     }
-    canCombine(reqA, reqB) {
-        return reqA.formFactor === reqB.formFactor;
+    /**
+     * Aggregates refresh adapter events to be sent in summarized log line.
+     *   - how many times refreshApex is called
+     *   - how many times refresh from lightning/uiRecordApi is called
+     *   - number of supported calls: refreshApex called on apex adapter
+     *   - number of unsupported calls: refreshApex on non-apex adapter
+     *          + any use of refresh from uiRecordApi module
+     *   - count of refresh calls per adapter
+     * @param context The refresh adapter event.
+     */
+    aggregateRefreshAdapterEvents(context) {
+        // We are consolidating all apex adapter instrumentation calls under a single key
+        // Adding additional logging that getApex adapters can invoke? Read normalizeAdapterName ts-doc.
+        const adapterName = normalizeAdapterName(context.adapterName);
+        if (this.lastRefreshApiCall === REFRESH_APEX_KEY) {
+            if (isApexAdapter(adapterName)) {
+                this.refreshApiCallEventStats[SUPPORTED_KEY] += 1;
+            }
+            else {
+                this.refreshApiCallEventStats[UNSUPPORTED_KEY] += 1;
+            }
+        }
+        else if (this.lastRefreshApiCall === REFRESH_UIAPI_KEY) {
+            this.refreshApiCallEventStats[UNSUPPORTED_KEY] += 1;
+        }
+        if (this.refreshAdapterEvents[adapterName] === undefined) {
+            this.refreshAdapterEvents[adapterName] = 0;
+        }
+        this.refreshAdapterEvents[adapterName] += 1;
+        this.lastRefreshApiCall = null;
     }
-    combineRequests(reqA, reqB) {
-        const combined = { ...reqA };
-        combined.recordIds = Array.from(new Set([...normalizeRecordIds$1(reqA.recordIds), ...normalizeRecordIds$1(reqB.recordIds)]));
-        return combined;
+    /**
+     * Increments call stat for incoming refresh api call, and sets the name
+     * to be used in {@link aggregateRefreshCalls}
+     * @param from The name of the refresh function called.
+     */
+    handleRefreshApiCall(apiName) {
+        this.refreshApiCallEventStats[apiName] += 1;
+        // set function call to be used with aggregateRefreshCalls
+        this.lastRefreshApiCall = apiName;
     }
-}
-
-class GetRecordRequestStrategy extends LuvioAdapterRequestStrategy {
-    constructor() {
-        super(...arguments);
-        this.adapterName = 'getRecord';
-        this.adapterFactory = getRecordAdapterFactory;
+    /**
+     * W-7302241
+     * Logs refresh call summary stats as a LightningInteraction.
+     */
+    logRefreshStats() {
+        if (keys(this.refreshAdapterEvents).length > 0) {
+            interaction(REFRESH_PAYLOAD_TARGET, REFRESH_PAYLOAD_SCOPE, this.refreshAdapterEvents, REFRESH_EVENTSOURCE, REFRESH_EVENTTYPE, this.refreshApiCallEventStats);
+            this.resetRefreshStats();
+        }
     }
-    buildConcreteRequest(similarRequest, context) {
-        return {
-            ...similarRequest,
-            config: {
-                ...similarRequest.config,
-                recordId: context.recordId,
-            },
+    /**
+     * Resets the stat trackers for refresh call events.
+     */
+    resetRefreshStats() {
+        this.refreshAdapterEvents = {};
+        this.refreshApiCallEventStats = {
+            [REFRESH_APEX_KEY]: 0,
+            [REFRESH_UIAPI_KEY]: 0,
+            [SUPPORTED_KEY]: 0,
+            [UNSUPPORTED_KEY]: 0,
         };
+        this.lastRefreshApiCall = null;
     }
-    transformForSave(request) {
-        if (request.config.fields === undefined && request.config.optionalFields === undefined) {
-            return request;
+    /**
+     * W-7801618
+     * Counter for occurrences where the incoming record to be merged has a different apiName.
+     * Dynamically generated metric, stored in an {@link RecordApiNameChangeCounters} object.
+     *
+     * @param context The transaction context.
+     *
+     * Note: Short-lived metric candidate, remove at the end of 230
+     */
+    incrementRecordApiNameChangeCount(_incomingApiName, existingApiName) {
+        let apiNameChangeCounter = this.recordApiNameChangeCounters[existingApiName];
+        if (apiNameChangeCounter === undefined) {
+            apiNameChangeCounter = counter(createMetricsKey(NAMESPACE, RECORD_API_NAME_CHANGE_COUNT_METRIC_NAME, existingApiName));
+            this.recordApiNameChangeCounters[existingApiName] = apiNameChangeCounter;
         }
-        let fields = coerceFieldIdArray(request.config.fields) || [];
-        let optionalFields = coerceFieldIdArray(request.config.optionalFields) || [];
-        return {
-            ...request,
-            config: {
-                ...request.config,
-                fields: undefined,
-                optionalFields: [...fields, ...optionalFields],
-            },
-        };
-    }
-    canCombine(reqA, reqB) {
-        // must be same record and
-        return (reqA.recordId === reqB.recordId &&
-            // both requests are fields requests
-            (reqA.optionalFields !== undefined || reqB.optionalFields !== undefined) &&
-            (reqB.fields !== undefined || reqB.optionalFields !== undefined));
+        apiNameChangeCounter.increment(1);
     }
-    combineRequests(reqA, reqB) {
-        const fields = new Set();
-        const optionalFields = new Set();
-        if (reqA.fields !== undefined) {
-            reqA.fields.forEach((field) => fields.add(field));
-        }
-        if (reqB.fields !== undefined) {
-            reqB.fields.forEach((field) => fields.add(field));
-        }
-        if (reqA.optionalFields !== undefined) {
-            reqA.optionalFields.forEach((field) => optionalFields.add(field));
-        }
-        if (reqB.optionalFields !== undefined) {
-            reqB.optionalFields.forEach((field) => optionalFields.add(field));
+    /**
+     * W-8620679
+     * Increment the counter for an UnfulfilledSnapshotError coming from luvio
+     *
+     * @param context The transaction context.
+     */
+    incrementAdapterRequestErrorCount(context) {
+        // We are consolidating all apex adapter instrumentation calls under a single key
+        const adapterName = normalizeAdapterName(context.adapterName);
+        let adapterRequestErrorCounter = this.adapterUnfulfilledErrorCounters[adapterName];
+        if (adapterRequestErrorCounter === undefined) {
+            adapterRequestErrorCounter = counter(createMetricsKey(OBSERVABILITY_NAMESPACE, ADAPTER_ERROR_COUNT_METRIC_NAME, adapterName));
+            this.adapterUnfulfilledErrorCounters[adapterName] = adapterRequestErrorCounter;
         }
-        return {
-            recordId: reqA.recordId,
-            fields: Array.from(fields),
-            optionalFields: Array.from(optionalFields),
-        };
+        adapterRequestErrorCounter.increment(1);
+        totalAdapterErrorMetric.increment(1);
     }
 }
-
-class GetRecordsRequestStrategy extends LuvioAdapterRequestStrategy {
-    constructor() {
-        super(...arguments);
-        this.adapterName = 'getRecords';
-        this.adapterFactory = getRecordsAdapterFactory;
-    }
-    buildConcreteRequest(similarRequest, context) {
-        return {
-            ...similarRequest,
-            config: {
-                ...similarRequest.config,
-                records: [{ ...similarRequest.config.records[0], recordIds: [context.recordId] }],
-            },
-        };
+function createMetricsKey(owner, name, unit) {
+    let metricName = name;
+    if (unit) {
+        metricName = metricName + '.' + unit;
     }
+    return {
+        get() {
+            return { owner: owner, name: metricName };
+        },
+    };
 }
-
-function normalizeRecordIds(recordIds) {
-    if (!ArrayIsArray(recordIds)) {
-        return [recordIds];
-    }
-    return recordIds;
+/**
+ * Returns whether adapter is an Apex one or not.
+ * @param adapterName The name of the adapter.
+ */
+function isApexAdapter(adapterName) {
+    return adapterName.indexOf(APEX_ADAPTER_NAME) > -1;
 }
-function normalizeApiNames(apiNames) {
-    if (apiNames === undefined || apiNames === null) {
-        return [];
+/**
+ * Normalizes getApex adapter names to `Apex.getApex`. Non-Apex adapters will be prefixed with
+ * API family, if supplied. Example: `UiApi.getRecord`.
+ *
+ * Note: If you are adding additional logging that can come from getApex adapter contexts that provide
+ * the full getApex adapter name (i.e. getApex_[namespace]_[class]_[function]_[continuation]),
+ * ensure to call this method to normalize all logging to 'getApex'. This
+ * is because Argus has a 50k key cardinality limit. More context: W-8379680.
+ *
+ * @param adapterName The name of the adapter.
+ * @param apiFamily The API family of the adapter.
+ */
+function normalizeAdapterName(adapterName, apiFamily) {
+    if (isApexAdapter(adapterName)) {
+        return NORMALIZED_APEX_ADAPTER_NAME;
     }
-    return ArrayIsArray(apiNames) ? apiNames : [apiNames];
+    return apiFamily ? `${apiFamily}.${adapterName}` : adapterName;
 }
-class GetRecordActionsRequestStrategy extends LuvioAdapterRequestStrategy {
-    constructor() {
-        super(...arguments);
-        this.adapterName = 'getRecordActions';
-        this.adapterFactory = getRecordActionsAdapterFactory;
-    }
-    buildConcreteRequest(similarRequest, context) {
-        return {
-            ...similarRequest,
-            config: {
-                ...similarRequest.config,
-                recordIds: [context.recordId],
-            },
-        };
-    }
-    buildGetRecordActionsSaveRequestData(similarContext, context, request) {
-        if (this.isGetRecordActionsRequestContextDependent(context, request)) {
-            return {
-                request: this.transformForSave({
-                    ...request,
-                    config: {
-                        ...request.config,
-                        recordIds: ['*'],
-                    },
-                }),
-                context: similarContext,
-            };
-        }
-        return {
-            request: this.transformForSave(request),
-            context,
-        };
-    }
-    canCombine(reqA, reqB) {
-        return (reqA.retrievalMode === reqB.retrievalMode &&
-            reqA.formFactor === reqB.formFactor &&
-            (reqA.actionTypes || []).toString() === (reqB.actionTypes || []).toString() &&
-            (reqA.sections || []).toString() === (reqB.sections || []).toString());
-    }
-    combineRequests(reqA, reqB) {
-        const combined = { ...reqA };
-        // let's merge the recordIds
-        combined.recordIds = Array.from(new Set([...normalizeRecordIds(reqA.recordIds), ...normalizeRecordIds(reqB.recordIds)]));
-        if (combined.retrievalMode === 'ALL') {
-            const combinedSet = new Set([
-                ...normalizeApiNames(combined.apiNames),
-                ...normalizeApiNames(reqB.apiNames),
-            ]);
-            combined.apiNames = Array.from(combinedSet);
-        }
-        return combined;
+const timerMetricTracker = create(null);
+/**
+ * Calls instrumentation/service telemetry timer
+ * @param name Name of the metric
+ * @param duration number to update backing percentile histogram, negative numbers ignored
+ */
+function updateTimerMetric(name, duration) {
+    let metric = timerMetricTracker[name];
+    if (metric === undefined) {
+        metric = timer(createMetricsKey(NAMESPACE, name));
+        timerMetricTracker[name] = metric;
     }
-    isGetRecordActionsRequestContextDependent(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 &&
-                    request.config.recordIds[0] === context.recordId)));
+    timerMetricAddDuration(metric, duration);
+}
+function timerMetricAddDuration(timer, duration) {
+    // Guard against negative values since it causes error to be thrown by MetricsService
+    if (duration >= 0) {
+        timer.addDuration(duration);
     }
 }
-
-class GetObjectInfoRequestStrategy extends LuvioAdapterRequestStrategy {
-    constructor() {
-        super(...arguments);
-        this.adapterName = 'getObjectInfo';
-        this.adapterFactory = getObjectInfoAdapterFactory;
+/**
+ * W-10315098
+ * Increments the counter associated with the request response. Counts are bucketed by status.
+ */
+const requestResponseMetricTracker = create(null);
+function incrementRequestResponseCount(cb) {
+    const status = cb().status;
+    let metric = requestResponseMetricTracker[status];
+    if (metric === undefined) {
+        metric = counter(createMetricsKey(OBSERVABILITY_NAMESPACE, NETWORK_ADAPTER_RESPONSE_METRIC_NAME, `${status.valueOf()}`));
+        requestResponseMetricTracker[status] = metric;
     }
-    buildConcreteRequest(similarRequest, context) {
-        return {
-            ...similarRequest,
-            config: {
-                ...similarRequest.config,
-                objectApiName: context.objectApiName,
+    metric.increment();
+}
+function logObjectInfoChanged() {
+    logObjectInfoChanged$1();
+}
+/**
+ * Create a new instrumentation cache stats and return it.
+ *
+ * @param name The cache logger name.
+ */
+function registerLdsCacheStats(name) {
+    return registerCacheStats(`${NAMESPACE}:${name}`);
+}
+/**
+ * Add or overwrite hooks that require aura implementations
+ */
+function setAuraInstrumentationHooks() {
+    instrument({
+        recordConflictsResolved: (serverRequestCount) => {
+            // Ignore 0 values which can originate from ADS bridge
+            if (serverRequestCount > 0) {
+                updatePercentileHistogramMetric('record-conflicts-resolved', serverRequestCount);
+            }
+        },
+        nullDisplayValueConflict: ({ fieldType, areValuesEqual }) => {
+            const metricName = `merge-null-dv-count.${fieldType}`;
+            if (fieldType === 'scalar') {
+                incrementCounterMetric(`${metricName}.${areValuesEqual}`);
+            }
+            else {
+                incrementCounterMetric(metricName);
+            }
+        },
+        getRecordNotifyChangeAllowed: incrementGetRecordNotifyChangeAllowCount,
+        getRecordNotifyChangeDropped: incrementGetRecordNotifyChangeDropCount,
+        notifyRecordUpdateAvailableAllowed: incrementNotifyRecordUpdateAvailableAllowCount,
+        notifyRecordUpdateAvailableDropped: incrementNotifyRecordUpdateAvailableDropCount,
+        recordApiNameChanged: instrumentation.incrementRecordApiNameChangeCount.bind(instrumentation),
+        weakEtagZero: instrumentation.aggregateWeakETagEvents.bind(instrumentation),
+        getRecordNotifyChangeNetworkResult: instrumentation.notifyChangeNetwork.bind(instrumentation),
+    });
+    withRegistration('@salesforce/lds-adapters-uiapi', (reg) => setLdsAdaptersUiapiInstrumentation(reg));
+    instrument$1({
+        logCrud: logCRUDLightningInteraction,
+        networkResponse: incrementRequestResponseCount,
+    });
+    instrument$2({
+        refreshCalled: instrumentation.handleRefreshApiCall.bind(instrumentation),
+        instrumentAdapter: instrumentation.instrumentAdapter.bind(instrumentation),
+    });
+    instrument$3({
+        timerMetricAddDuration: updateTimerMetric,
+    });
+    // Our getRecord through aggregate-ui CRUD logging has moved
+    // to lds-network-adapter. We still need to respect the
+    // orgs environment setting
+    if (forceRecordTransactionsDisabled === false) {
+        ldsNetworkAdapterInstrument({
+            getRecordAggregateResolve: (cb) => {
+                const { recordId, apiName } = cb();
+                logCRUDLightningInteraction('read', {
+                    recordId,
+                    recordType: apiName,
+                    state: 'SUCCESS',
+                });
             },
-        };
-    }
-    buildGetObjectInfoSaveRequestData(similarContext, context, request) {
-        if (this.isGetObjectInfoContextDependent(context, request)) {
-            return {
-                request: this.transformForSave(request),
-                context: similarContext,
-            };
-        }
-        return {
-            request: this.transformForSave(request),
-            context,
-        };
-    }
-    isGetObjectInfoContextDependent(context, request) {
-        return (request.config.objectApiName && context.objectApiName === request.config.objectApiName);
+            getRecordAggregateReject: (cb) => {
+                const recordId = cb();
+                logCRUDLightningInteraction('read', {
+                    recordId,
+                    state: 'ERROR',
+                });
+            },
+        });
     }
+    withRegistration('@salesforce/lds-network-adapter', (reg) => setLdsNetworkAdapterInstrumentation(reg));
 }
-
-class GetObjectInfosRequestStrategy extends LuvioAdapterRequestStrategy {
-    constructor() {
-        super(...arguments);
-        this.adapterName = 'getObjectInfos';
-        this.adapterFactory = getObjectInfosAdapterFactory;
-    }
-    buildConcreteRequest(similarRequest) {
-        return similarRequest;
-    }
+/**
+ * Initialize the instrumentation and instrument the LDS instance and the InMemoryStore.
+ *
+ * @param luvio The Luvio instance to instrument.
+ * @param store The InMemoryStore to instrument.
+ */
+function setupInstrumentation(luvio, store) {
+    setupInstrumentation$1(luvio, store);
+    setAuraInstrumentationHooks();
+}
+/**
+ * Note: locator.scope is set to 'force_record' in order for the instrumentation gate to work, which will
+ * disable all crud operations if it is on.
+ * @param eventSource - Source of the logging event.
+ * @param attributes - Free form object of attributes to log.
+ */
+function logCRUDLightningInteraction(eventSource, attributes) {
+    interaction(eventSource, 'force_record', null, eventSource, 'crud', attributes);
 }
+const instrumentation = new Instrumentation();
 
-class LexRequestRunner {
-    constructor(luvio) {
-        this.luvio = luvio;
-        this.requestStrategies = {
-            getRecord: new GetRecordRequestStrategy(),
-            getRecords: new GetRecordsRequestStrategy(),
-            getRecordActions: new GetRecordActionsRequestStrategy(),
-            getRecordAvatars: new GetRecordAvatarsRequestStrategy(),
-            getObjectInfo: new GetObjectInfoRequestStrategy(),
-            getObjectInfos: new GetObjectInfosRequestStrategy(),
-        };
-    }
-    reduceRequests(requests) {
-        return Object.values(this.requestStrategies)
-            .map((strategy) => strategy.reduce(requests))
-            .flat();
+class ApplicationPredictivePrefetcher {
+    constructor(context, repository, requestRunner) {
+        this.repository = repository;
+        this.requestRunner = requestRunner;
+        this.isRecording = false;
+        this.queuedPredictionRequests = [];
+        this._context = context;
+        this.page = this.getPage();
     }
-    runRequest(request) {
-        if (request.adapterName in this.requestStrategies) {
-            const adapterFactory = this.requestStrategies[request.adapterName].adapterFactory;
-            return Promise.resolve(adapterFactory(this.luvio)(request.config)).then();
-        }
-        return Promise.resolve(undefined);
+    set context(value) {
+        this._context = value;
+        this.page = this.getPage();
     }
-}
-
-class InMemoryPrefetchStorage {
-    constructor() {
-        this.data = {};
+    get context() {
+        return this._context;
     }
-    set(key, value) {
-        this.data[key] = value;
-        return Promise.resolve();
+    async stopRecording() {
+        this.isRecording = false;
+        await this.repository.flushRequestsToStorage();
     }
-    get(key) {
-        return this.data[key];
+    startRecording() {
+        this.isRecording = true;
+        this.repository.clearRequestBuffer();
     }
-}
-
-const { keys: ObjectKeys } = Object;
-const DEFAULT_STORAGE_OPTIONS = {
-    name: 'ldsPredictiveLoading',
-    persistent: true,
-    secure: true,
-    maxSize: 7 * 1024 * 1024,
-    expiration: 12 * 60 * 60,
-    clearOnInit: false,
-    debugLogging: false,
-    version: 2,
-};
-function buildAuraPrefetchStorage(options = {}) {
-    const auraStorage = createStorage({
-        ...DEFAULT_STORAGE_OPTIONS,
-        ...options,
-    });
-    const inMemoryStorage = new InMemoryPrefetchStorage();
-    if (auraStorage === null) {
-        return inMemoryStorage;
+    saveRequest(request) {
+        if (!this.isRecording) {
+            return Promise.resolve();
+        }
+        return executeAsyncActivity(METRIC_KEYS.PREDICTIVE_DATA_LOADING_SAVE_REQUEST, (_act) => {
+            const { request: requestToSave, context } = this.page.buildSaveRequestData(request);
+            // No need to differentiate from predictions requests because these
+            // are made from the adapters factory, which are not prediction aware.
+            return this.repository.saveRequest(context, requestToSave);
+        }, PDL_EXECUTE_ASYNC_OPTIONS);
     }
-    return new AuraPrefetchStorage(auraStorage, inMemoryStorage);
-}
-class AuraPrefetchStorage {
-    constructor(auraStorage, inMemoryStorage) {
-        this.auraStorage = auraStorage;
-        this.inMemoryStorage = inMemoryStorage;
-        /**
-         * Because of aura is an event loop hog and we therefore need to minimize asynchronicity in LEX,
-         * we need need to preload predictions and treat read operations sync. Not making it sync, will cause
-         * some request to be sent the network when they could be dedupe against those from the predictions.
-         *
-         * Drawbacks of this approach:
-         * 1. Loading all of aura storage into memory and then updating it based on changes to that in memory
-         *    representation means that updates to predictions in aura storage across different tabs will result
-         *    in overwrites, not graceful merges of predictions.
-         * 2. If whoever is consuming this tries to get and run predictions before this is done loading,
-         *    then they will (potentially incorrectly) think that we don't have any predictions.
-         */
-        auraStorage.getAll().then((results) => {
-            ObjectKeys(results).forEach((key) => this.inMemoryStorage.set(key, results[key]));
-        });
+    async predict() {
+        const exactPageRequests = (await this.repository.getPageRequests(this.context)) || [];
+        const similarPageRequests = await this.getSimilarPageRequests();
+        const alwaysRequests = this.page.getAlwaysRunRequests();
+        const predictedRequests = [
+            ...alwaysRequests,
+            ...this.requestRunner.reduceRequests([
+                ...exactPageRequests,
+                ...similarPageRequests,
+                ...this.page.getAlwaysRunRequests(),
+            ]),
+        ];
+        this.queuedPredictionRequests.push(...predictedRequests);
+        return Promise.all(predictedRequests.map((request) => this.requestRunner.runRequest(request))).then();
     }
-    set(key, value) {
-        const inMemoryResult = this.inMemoryStorage.set(key, value);
-        this.auraStorage.set(key, value).catch((error) => {
-            if (process.env.NODE_ENV !== 'production') {
-                // eslint-disable-next-line no-console
-                console.error('Error save LDS prediction: ', error);
-            }
-        });
-        return inMemoryResult;
+    hasPredictions() {
+        const exactPageRequests = this.repository.getPageRequests(this.context) || [];
+        const similarPageRequests = this.page.similarContext !== undefined
+            ? this.repository.getPageRequests(this.page.similarContext)
+            : [];
+        return exactPageRequests.length > 0 || similarPageRequests.length > 0;
     }
-    get(key) {
-        // we never read from the AuraStorage, except in construction.
-        return this.inMemoryStorage.get(key);
+    getSimilarPageRequests() {
+        let resolvedSimilarPageRequests = [];
+        if (this.page.similarContext !== undefined) {
+            const similarPageRequests = this.repository.getPageRequests(this.page.similarContext);
+            if (similarPageRequests !== undefined) {
+                resolvedSimilarPageRequests = similarPageRequests.map((request) => this.page.resolveSimilarRequest(request));
+            }
+        }
+        return resolvedSimilarPageRequests;
     }
 }
 
-/**
- * Observability / Critical Availability Program (230+)
- *
- * This file is intended to be used as a consolidated place for all definitions, functions,
- * and helpers related to "M1"[1].
- *
- * Below are the R.E.A.D.S. metrics for the Lightning Data Service, defined here[2].
- *
- * [1] Search "[M1] Lightning Data Service Design Spike" in Quip
- * [2] Search "Lightning Data Service R.E.A.D.S. Metrics" in Quip
- */
-const OBSERVABILITY_NAMESPACE = 'LIGHTNING.lds.service';
-const ADAPTER_INVOCATION_COUNT_METRIC_NAME = 'request';
-const ADAPTER_ERROR_COUNT_METRIC_NAME = 'error';
-const NETWORK_ADAPTER_RESPONSE_METRIC_NAME = 'network-response';
-/**
- * W-8379680
- * Counter for number of getApex requests.
- */
-const GET_APEX_REQUEST_COUNT = {
-    get() {
-        return {
-            owner: OBSERVABILITY_NAMESPACE,
-            name: ADAPTER_INVOCATION_COUNT_METRIC_NAME + '.' + NORMALIZED_APEX_ADAPTER_NAME,
-        };
-    },
-};
-/**
- * W-8828410
- * Counter for the number of UnfulfilledSnapshotErrors the luvio engine has.
- */
-const TOTAL_ADAPTER_ERROR_COUNT = {
-    get() {
-        return { owner: OBSERVABILITY_NAMESPACE, name: ADAPTER_ERROR_COUNT_METRIC_NAME };
-    },
-};
-/**
- * W-8828410
- * Counter for the number of invocations made into LDS by a wire adapter.
- */
-const TOTAL_ADAPTER_REQUEST_SUCCESS_COUNT = {
-    get() {
-        return { owner: OBSERVABILITY_NAMESPACE, name: ADAPTER_INVOCATION_COUNT_METRIC_NAME };
-    },
-};
-
-const { create, keys } = Object;
-const { isArray } = Array;
-const { stringify } = JSON;
+class LexPredictivePrefetcher extends ApplicationPredictivePrefetcher {
+    constructor(context, repository, requestRunner, 
+    // These strategies need to be in sync with the "predictiveDataLoadCapable" list
+    // from scripts/lds-uiapi-plugin.js
+    requestStrategies) {
+        super(context, repository, requestRunner);
+        this.requestStrategies = requestStrategies;
+        this.page = this.getPage();
+    }
+    getPage() {
+        if (RecordHomePage.handlesContext(this.context)) {
+            return new RecordHomePage(this.context, this.requestStrategies);
+        }
+        return new LexDefaultPage(this.context);
+    }
+}
 
+// Copy-pasted from adapter-utils. This util should be extracted from generated code and imported in prefetch repository.
+const { keys: ObjectKeys$1 } = Object;
+const { stringify: JSONStringify } = JSON;
+const { isArray: ArrayIsArray } = Array;
 /**
  * A deterministic JSON stringify implementation. Heavily adapted from https://github.com/epoberezkin/fast-json-stable-stringify.
  * This is needed because insertion order for JSON.stringify(object) affects output:
@@ -839,7 +842,6 @@ const { stringify } = JSON;
  *      "{"a":1,"b":2}"
  * JSON.stringify({b: 2, a: 1})
  *      "{"b":2,"a":1}"
- * Modified from the apex implementation to sort arrays non-destructively.
  * @param data Data to be JSON-stringified.
  * @returns JSON.stringified value with consistent ordering of keys.
  */
@@ -849,512 +851,517 @@ function stableJSONStringify(node) {
         // eslint-disable-next-line no-param-reassign
         node = node.toJSON();
     }
-    if (node === undefined) {
-        return;
+    if (node === undefined) {
+        return;
+    }
+    if (typeof node === 'number') {
+        return isFinite(node) ? '' + node : 'null';
+    }
+    if (typeof node !== 'object') {
+        return JSONStringify(node);
+    }
+    let i;
+    let out;
+    if (ArrayIsArray(node)) {
+        out = '[';
+        for (i = 0; i < node.length; i++) {
+            if (i) {
+                out += ',';
+            }
+            out += stableJSONStringify(node[i]) || 'null';
+        }
+        return out + ']';
+    }
+    if (node === null) {
+        return 'null';
+    }
+    const keys = ObjectKeys$1(node).sort();
+    out = '';
+    for (i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const value = stableJSONStringify(node[key]);
+        if (!value) {
+            continue;
+        }
+        if (out) {
+            out += ',';
+        }
+        out += JSONStringify(key) + ':' + value;
+    }
+    return '{' + out + '}';
+}
+function isObject(obj) {
+    return obj !== null && typeof obj === 'object';
+}
+function deepEquals(objA, objB) {
+    if (objA === objB)
+        return true;
+    if (objA instanceof Date && objB instanceof Date)
+        return objA.getTime() === objB.getTime();
+    // If one of them is not an object, they are not deeply equal
+    if (!isObject(objA) || !isObject(objB))
+        return false;
+    // Filter out keys set as undefined, we can compare undefined as equals.
+    const keysA = ObjectKeys$1(objA).filter((key) => objA[key] !== undefined);
+    const keysB = ObjectKeys$1(objB).filter((key) => objB[key] !== undefined);
+    // If the objects do not have the same set of keys, they are not deeply equal
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const key of keysA) {
+        const valA = objA[key];
+        const valB = objB[key];
+        const areObjects = isObject(valA) && isObject(valB);
+        // If both values are objects, recursively compare them
+        if (areObjects && !deepEquals(valA, valB))
+            return false;
+        // If only one value is an object or if the values are not strictly equal, they are not deeply equal
+        if (!areObjects && valA !== valB)
+            return false;
+    }
+    return true;
+}
+
+class PrefetchRepository {
+    constructor(storage) {
+        this.storage = storage;
+        this.requestBuffer = new Map();
+    }
+    clearRequestBuffer() {
+        this.requestBuffer.clear();
+    }
+    async flushRequestsToStorage() {
+        for (const [id, batch] of this.requestBuffer) {
+            const rawPage = await this.storage.get(id);
+            const page = rawPage === undefined ? { id, requests: [] } : rawPage;
+            batch.forEach(({ request, requestTime }) => {
+                let existingRequestEntry = page.requests.find(({ request: storedRequest }) => deepEquals(storedRequest, request));
+                if (existingRequestEntry === undefined) {
+                    existingRequestEntry = { request, requestMetadata: { requestTimes: [] } };
+                    page.requests.push(existingRequestEntry);
+                }
+                existingRequestEntry.requestMetadata.requestTimes.push(requestTime);
+            });
+            await this.storage.set(id, page);
+        }
+        this.clearRequestBuffer();
+    }
+    async saveRequest(key, request) {
+        const identifier = stableJSONStringify(key);
+        const batchForKey = this.requestBuffer.get(identifier) || [];
+        batchForKey.push({
+            request,
+            requestTime: Date.now(),
+        });
+        this.requestBuffer.set(identifier, batchForKey);
+    }
+    getPage(key) {
+        const identifier = stableJSONStringify(key);
+        return this.storage.get(identifier);
+    }
+    getPageRequests(key) {
+        const page = this.getPage(key);
+        if (page === undefined) {
+            return [];
+        }
+        return page.requests.map((requestEntry) => requestEntry.request);
+    }
+}
+
+class RequestStrategy {
+    transformForSave(request) {
+        return request;
+    }
+    reduce(requests) {
+        return requests;
+    }
+}
+
+class LuvioAdapterRequestStrategy extends RequestStrategy {
+    transformForSave(request) {
+        return request;
+    }
+    filterRequests(unfilteredRequests) {
+        return unfilteredRequests.filter((request) => request.adapterName === this.adapterName);
+    }
+    reduce(unfilteredRequests) {
+        const requests = this.filterRequests(unfilteredRequests);
+        const visitedRequests = new Set();
+        const reducedRequests = [];
+        for (let i = 0, n = requests.length; i < n; i++) {
+            const currentRequest = requests[i];
+            if (!visitedRequests.has(currentRequest)) {
+                const combinedRequest = { ...currentRequest };
+                for (let j = i + 1; j < n; j++) {
+                    const hasNotBeenVisited = !visitedRequests.has(requests[j]);
+                    const canCombineConfigs = this.canCombine(combinedRequest.config, requests[j].config);
+                    if (hasNotBeenVisited && canCombineConfigs) {
+                        combinedRequest.config = this.combineRequests(combinedRequest.config, requests[j].config);
+                        visitedRequests.add(requests[j]);
+                    }
+                }
+                reducedRequests.push(combinedRequest);
+                visitedRequests.add(currentRequest);
+            }
+        }
+        return reducedRequests;
+    }
+    canCombine(_reqA, _reqB) {
+        // By default, all requests are not comibinable
+        return false;
     }
-    if (typeof node === 'number') {
-        return isFinite(node) ? '' + node : 'null';
+    combineRequests(reqA, _reqB) {
+        // By default, this should never be called since requests aren't combinable
+        if (process.env.NODE_ENV !== 'production') {
+            throw new Error('Not implemented');
+        }
+        return reqA;
     }
-    if (typeof node !== 'object') {
-        return stringify(node);
+}
+
+function normalizeRecordIds$1(recordIds) {
+    if (!Array.isArray(recordIds)) {
+        return [recordIds];
     }
-    let i;
-    let out;
-    if (isArray(node)) {
-        // copy any array before sorting so we don't mutate the object.
-        // eslint-disable-next-line no-param-reassign
-        node = node.slice(0).sort();
-        out = '[';
-        for (i = 0; i < node.length; i++) {
-            if (i) {
-                out += ',';
-            }
-            out += stableJSONStringify(node[i]) || 'null';
-        }
-        return out + ']';
+    return recordIds;
+}
+class GetRecordAvatarsRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getRecordAvatars';
+        this.adapterFactory = getRecordAvatarsAdapterFactory;
     }
-    if (node === null) {
-        return 'null';
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                recordIds: [context.recordId],
+            },
+        };
     }
-    const keys$1 = keys(node).sort();
-    out = '';
-    for (i = 0; i < keys$1.length; i++) {
-        const key = keys$1[i];
-        const value = stableJSONStringify(node[key]);
-        if (!value) {
-            continue;
-        }
-        if (out) {
-            out += ',';
+    buildGetRecordAvatarsSaveRequestData(similarContext, context, request) {
+        if (this.isGetRecordAvatarsRequestContextDependent(context, request)) {
+            return {
+                request: this.transformForSave({
+                    ...request,
+                    config: {
+                        ...request.config,
+                        recordIds: ['*'],
+                    },
+                }),
+                context: similarContext,
+            };
         }
-        out += stringify(key) + ':' + value;
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
+    }
+    isGetRecordAvatarsRequestContextDependent(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 &&
+                    request.config.recordIds[0] === context.recordId)));
+    }
+    canCombine(reqA, reqB) {
+        return reqA.formFactor === reqB.formFactor;
+    }
+    combineRequests(reqA, reqB) {
+        const combined = { ...reqA };
+        combined.recordIds = Array.from(new Set([...normalizeRecordIds$1(reqA.recordIds), ...normalizeRecordIds$1(reqB.recordIds)]));
+        return combined;
     }
-    return '{' + out + '}';
-}
-function isPromise(value) {
-    // check for Thenable due to test frameworks using custom Promise impls
-    return value !== null && value.then !== undefined;
 }
 
-const APEX_ADAPTER_NAME = 'getApex';
-const NORMALIZED_APEX_ADAPTER_NAME = `Apex.${APEX_ADAPTER_NAME}`;
-const REFRESH_APEX_KEY = 'refreshApex';
-const REFRESH_UIAPI_KEY = 'refreshUiApi';
-const SUPPORTED_KEY = 'refreshSupported';
-const UNSUPPORTED_KEY = 'refreshUnsupported';
-const REFRESH_EVENTSOURCE = 'lds-refresh-summary';
-const REFRESH_EVENTTYPE = 'system';
-const REFRESH_PAYLOAD_TARGET = 'adapters';
-const REFRESH_PAYLOAD_SCOPE = 'lds';
-const INCOMING_WEAKETAG_0_KEY = 'incoming-weaketag-0';
-const EXISTING_WEAKETAG_0_KEY = 'existing-weaketag-0';
-const RECORD_API_NAME_CHANGE_COUNT_METRIC_NAME = 'record-api-name-change-count';
-const NAMESPACE = 'lds';
-const NETWORK_TRANSACTION_NAME = 'lds-network';
-const CACHE_STATS_OUT_OF_TTL_MISS_POSTFIX = 'out-of-ttl-miss';
-// Aggregate Cache Stats and Metrics for all getApex invocations
-const getApexCacheStats = registerLdsCacheStats(NORMALIZED_APEX_ADAPTER_NAME);
-const getApexTtlCacheStats = registerLdsCacheStats(NORMALIZED_APEX_ADAPTER_NAME + ':' + CACHE_STATS_OUT_OF_TTL_MISS_POSTFIX);
-// Observability (READS)
-const getApexRequestCountMetric = counter(GET_APEX_REQUEST_COUNT);
-const totalAdapterRequestSuccessMetric = counter(TOTAL_ADAPTER_REQUEST_SUCCESS_COUNT);
-const totalAdapterErrorMetric = counter(TOTAL_ADAPTER_ERROR_COUNT);
-class Instrumentation {
+const COERCE_FIELD_ID_ARRAY_OPTIONS = { onlyQualifiedFieldNames: true };
+class GetRecordRequestStrategy extends LuvioAdapterRequestStrategy {
     constructor() {
-        this.adapterUnfulfilledErrorCounters = {};
-        this.recordApiNameChangeCounters = {};
-        this.refreshAdapterEvents = {};
-        this.refreshApiCallEventStats = {
-            [REFRESH_APEX_KEY]: 0,
-            [REFRESH_UIAPI_KEY]: 0,
-            [SUPPORTED_KEY]: 0,
-            [UNSUPPORTED_KEY]: 0,
+        super(...arguments);
+        this.adapterName = 'getRecord';
+        this.adapterFactory = getRecordAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                recordId: context.recordId,
+            },
         };
-        this.lastRefreshApiCall = null;
-        this.weakEtagZeroEvents = {};
-        this.adapterCacheMisses = new LRUCache(250);
-        if (typeof window !== 'undefined' && window.addEventListener) {
-            window.addEventListener('beforeunload', () => {
-                if (keys(this.weakEtagZeroEvents).length > 0) {
-                    perfStart(NETWORK_TRANSACTION_NAME);
-                    perfEnd(NETWORK_TRANSACTION_NAME, this.weakEtagZeroEvents);
-                }
-            });
-        }
-        registerPeriodicLogger(NAMESPACE, this.logRefreshStats.bind(this));
     }
-    /**
-     * Instruments an existing adapter to log argus metrics and cache stats.
-     * @param adapter The adapter function.
-     * @param metadata The adapter metadata.
-     * @param wireConfigKeyFn Optional function to transform wire configs to a unique key.
-     * @returns The wrapped adapter.
-     */
-    instrumentAdapter(adapter, metadata) {
-        // We are consolidating all apex adapter instrumentation calls under a single key
-        const { apiFamily, name, ttl } = metadata;
-        const adapterName = normalizeAdapterName(name, apiFamily);
-        const isGetApexAdapter = isApexAdapter(name);
-        const stats = isGetApexAdapter ? getApexCacheStats : registerLdsCacheStats(adapterName);
-        const ttlMissStats = isGetApexAdapter
-            ? getApexTtlCacheStats
-            : registerLdsCacheStats(adapterName + ':' + CACHE_STATS_OUT_OF_TTL_MISS_POSTFIX);
-        /**
-         * W-8076905
-         * Dynamically generated metric. Simple counter for all requests made by this adapter.
-         */
-        const wireAdapterRequestMetric = isGetApexAdapter
-            ? getApexRequestCountMetric
-            : counter(createMetricsKey(OBSERVABILITY_NAMESPACE, ADAPTER_INVOCATION_COUNT_METRIC_NAME, adapterName));
-        const instrumentedAdapter = (config, requestContext) => {
-            // increment overall and adapter request metrics
-            wireAdapterRequestMetric.increment(1);
-            totalAdapterRequestSuccessMetric.increment(1);
-            // execute adapter logic
-            const result = adapter(config, requestContext);
-            // In the case where the adapter returns a non-Pending Snapshot it is constructed out of the store
-            // (cache hit) whereas a Promise<Snapshot> or Pending Snapshot indicates a network request (cache miss).
-            //
-            // Note: we can't do a plain instanceof check for a promise here since the Promise may
-            // originate from another javascript realm (for example: in jest test). Instead we use a
-            // duck-typing approach by checking if the result has a then property.
-            //
-            // For adapters without persistent store:
-            //  - total cache hit ratio:
-            //      [in-memory cache hit count] / ([in-memory cache hit count] + [in-memory cache miss count])
-            // For adapters with persistent store:
-            //  - in-memory cache hit ratio:
-            //      [in-memory cache hit count] / ([in-memory cache hit count] + [in-memory cache miss count])
-            //  - total cache hit ratio:
-            //      ([in-memory cache hit count] + [store cache hit count]) / ([in-memory cache hit count] + [in-memory cache miss count])
-            // if result === null then config is insufficient/invalid so do not log
-            if (isPromise(result)) {
-                stats.logMisses();
-                if (ttl !== undefined) {
-                    this.logAdapterCacheMissOutOfTtlDuration(adapterName, config, ttlMissStats, Date.now(), ttl);
-                }
-            }
-            else if (result !== null) {
-                stats.logHits();
-            }
-            return result;
+    transformForSave(request) {
+        if (request.config.fields === undefined && request.config.optionalFields === undefined) {
+            return request;
+        }
+        let fields = coerceFieldIdArray(request.config.fields, COERCE_FIELD_ID_ARRAY_OPTIONS) || [];
+        let optionalFields = coerceFieldIdArray(request.config.optionalFields, COERCE_FIELD_ID_ARRAY_OPTIONS) || [];
+        return {
+            ...request,
+            config: {
+                ...request.config,
+                fields: undefined,
+                optionalFields: [...fields, ...optionalFields],
+            },
         };
-        // Set the name property on the function for debugging purposes.
-        Object.defineProperty(instrumentedAdapter, 'name', {
-            value: name + '__instrumented',
-        });
-        return instrumentAdapter(instrumentedAdapter, metadata);
     }
-    /**
-     * Logs when adapter requests come in. If we have subsequent cache misses on a given config, beyond its TTL then log the duration to metrics.
-     * Backed by an LRU Cache implementation to prevent too many record entries from being stored in-memory.
-     * @param name The wire adapter name.
-     * @param config The config passed into wire adapter.
-     * @param ttlMissStats CacheStatsLogger to log misses out of TTL.
-     * @param currentCacheMissTimestamp Timestamp for when the request was made.
-     * @param ttl TTL for the wire adapter.
-     */
-    logAdapterCacheMissOutOfTtlDuration(name, config, ttlMissStats, currentCacheMissTimestamp, ttl) {
-        const configKey = `${name}:${stableJSONStringify(config)}`;
-        const existingCacheMissTimestamp = this.adapterCacheMisses.get(configKey);
-        this.adapterCacheMisses.set(configKey, currentCacheMissTimestamp);
-        if (existingCacheMissTimestamp !== undefined) {
-            const duration = currentCacheMissTimestamp - existingCacheMissTimestamp;
-            if (duration > ttl) {
-                ttlMissStats.logMisses();
-            }
+    canCombine(reqA, reqB) {
+        // must be same record and
+        return (reqA.recordId === reqB.recordId &&
+            // both requests are fields requests
+            (reqA.optionalFields !== undefined || reqB.optionalFields !== undefined) &&
+            (reqB.fields !== undefined || reqB.optionalFields !== undefined));
+    }
+    combineRequests(reqA, reqB) {
+        const fields = new Set();
+        const optionalFields = new Set();
+        if (reqA.fields !== undefined) {
+            reqA.fields.forEach((field) => fields.add(field));
+        }
+        if (reqB.fields !== undefined) {
+            reqB.fields.forEach((field) => fields.add(field));
         }
-    }
-    /**
-     * Injected to LDS for Luvio specific instrumentation.
-     *
-     * @param context The transaction context.
-     */
-    instrumentLuvio(context) {
-        instrumentLuvio(context);
-        if (this.isRefreshAdapterEvent(context)) {
-            this.aggregateRefreshAdapterEvents(context);
+        if (reqA.optionalFields !== undefined) {
+            reqA.optionalFields.forEach((field) => optionalFields.add(field));
         }
-        else if (this.isAdapterUnfulfilledError(context)) {
-            this.incrementAdapterRequestErrorCount(context);
+        if (reqB.optionalFields !== undefined) {
+            reqB.optionalFields.forEach((field) => optionalFields.add(field));
         }
-        else ;
+        return {
+            recordId: reqA.recordId,
+            fields: Array.from(fields),
+            optionalFields: Array.from(optionalFields),
+        };
     }
-    /**
-     * Returns whether or not this is a RefreshAdapterEvent.
-     * @param context The transaction context.
-     * @returns Whether or not this is a RefreshAdapterEvent.
-     */
-    isRefreshAdapterEvent(context) {
-        return context[REFRESH_ADAPTER_EVENT] === true;
+}
+
+class GetRecordsRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getRecords';
+        this.adapterFactory = getRecordsAdapterFactory;
     }
-    /**
-     * Returns whether or not this is an AdapterUnfulfilledError.
-     * @param context The transaction context.
-     * @returns Whether or not this is an AdapterUnfulfilledError.
-     */
-    isAdapterUnfulfilledError(context) {
-        return context[ADAPTER_UNFULFILLED_ERROR] === true;
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                records: [{ ...similarRequest.config.records[0], recordIds: [context.recordId] }],
+            },
+        };
     }
-    /**
-     * Specific instrumentation for getRecordNotifyChange.
-     * temporary implementation to match existing aura call for now
-     *
-     * @param uniqueWeakEtags whether weakEtags match or not
-     * @param error if dispatchResourceRequest fails for any reason
-     */
-    notifyChangeNetwork(uniqueWeakEtags, error) {
-        perfStart(NETWORK_TRANSACTION_NAME);
-        if (error === true) {
-            perfEnd(NETWORK_TRANSACTION_NAME, { 'notify-change-network': 'error' });
-        }
-        else {
-            perfEnd(NETWORK_TRANSACTION_NAME, { 'notify-change-network': uniqueWeakEtags });
-        }
+}
+
+function normalizeRecordIds(recordIds) {
+    if (!ArrayIsArray(recordIds)) {
+        return [recordIds];
     }
-    /**
-     * Parses and aggregates weakETagZero events to be sent in summarized log line.
-     * @param context The transaction context.
-     */
-    aggregateWeakETagEvents(incomingWeakEtagZero, existingWeakEtagZero, apiName) {
-        const key = 'weaketag-0-' + apiName;
-        if (this.weakEtagZeroEvents[key] === undefined) {
-            this.weakEtagZeroEvents[key] = {
-                [EXISTING_WEAKETAG_0_KEY]: 0,
-                [INCOMING_WEAKETAG_0_KEY]: 0,
+    return recordIds;
+}
+function normalizeApiNames(apiNames) {
+    if (apiNames === undefined || apiNames === null) {
+        return [];
+    }
+    return ArrayIsArray(apiNames) ? apiNames : [apiNames];
+}
+class GetRecordActionsRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getRecordActions';
+        this.adapterFactory = getRecordActionsAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                recordIds: [context.recordId],
+            },
+        };
+    }
+    buildGetRecordActionsSaveRequestData(similarContext, context, request) {
+        if (this.isGetRecordActionsRequestContextDependent(context, request)) {
+            return {
+                request: this.transformForSave({
+                    ...request,
+                    config: {
+                        ...request.config,
+                        recordIds: ['*'],
+                    },
+                }),
+                context: similarContext,
             };
         }
-        if (existingWeakEtagZero) {
-            this.weakEtagZeroEvents[key][EXISTING_WEAKETAG_0_KEY] += 1;
-        }
-        if (incomingWeakEtagZero) {
-            this.weakEtagZeroEvents[key][INCOMING_WEAKETAG_0_KEY] += 1;
-        }
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
     }
-    /**
-     * Aggregates refresh adapter events to be sent in summarized log line.
-     *   - how many times refreshApex is called
-     *   - how many times refresh from lightning/uiRecordApi is called
-     *   - number of supported calls: refreshApex called on apex adapter
-     *   - number of unsupported calls: refreshApex on non-apex adapter
-     *          + any use of refresh from uiRecordApi module
-     *   - count of refresh calls per adapter
-     * @param context The refresh adapter event.
-     */
-    aggregateRefreshAdapterEvents(context) {
-        // We are consolidating all apex adapter instrumentation calls under a single key
-        // Adding additional logging that getApex adapters can invoke? Read normalizeAdapterName ts-doc.
-        const adapterName = normalizeAdapterName(context.adapterName);
-        if (this.lastRefreshApiCall === REFRESH_APEX_KEY) {
-            if (isApexAdapter(adapterName)) {
-                this.refreshApiCallEventStats[SUPPORTED_KEY] += 1;
-            }
-            else {
-                this.refreshApiCallEventStats[UNSUPPORTED_KEY] += 1;
-            }
-        }
-        else if (this.lastRefreshApiCall === REFRESH_UIAPI_KEY) {
-            this.refreshApiCallEventStats[UNSUPPORTED_KEY] += 1;
-        }
-        if (this.refreshAdapterEvents[adapterName] === undefined) {
-            this.refreshAdapterEvents[adapterName] = 0;
+    canCombine(reqA, reqB) {
+        return (reqA.retrievalMode === reqB.retrievalMode &&
+            reqA.formFactor === reqB.formFactor &&
+            (reqA.actionTypes || []).toString() === (reqB.actionTypes || []).toString() &&
+            (reqA.sections || []).toString() === (reqB.sections || []).toString());
+    }
+    combineRequests(reqA, reqB) {
+        const combined = { ...reqA };
+        // let's merge the recordIds
+        combined.recordIds = Array.from(new Set([...normalizeRecordIds(reqA.recordIds), ...normalizeRecordIds(reqB.recordIds)]));
+        if (combined.retrievalMode === 'ALL') {
+            const combinedSet = new Set([
+                ...normalizeApiNames(combined.apiNames),
+                ...normalizeApiNames(reqB.apiNames),
+            ]);
+            combined.apiNames = Array.from(combinedSet);
         }
-        this.refreshAdapterEvents[adapterName] += 1;
-        this.lastRefreshApiCall = null;
+        return combined;
     }
-    /**
-     * Increments call stat for incoming refresh api call, and sets the name
-     * to be used in {@link aggregateRefreshCalls}
-     * @param from The name of the refresh function called.
-     */
-    handleRefreshApiCall(apiName) {
-        this.refreshApiCallEventStats[apiName] += 1;
-        // set function call to be used with aggregateRefreshCalls
-        this.lastRefreshApiCall = apiName;
+    isGetRecordActionsRequestContextDependent(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 &&
+                    request.config.recordIds[0] === context.recordId)));
     }
-    /**
-     * W-7302241
-     * Logs refresh call summary stats as a LightningInteraction.
-     */
-    logRefreshStats() {
-        if (keys(this.refreshAdapterEvents).length > 0) {
-            interaction(REFRESH_PAYLOAD_TARGET, REFRESH_PAYLOAD_SCOPE, this.refreshAdapterEvents, REFRESH_EVENTSOURCE, REFRESH_EVENTTYPE, this.refreshApiCallEventStats);
-            this.resetRefreshStats();
+}
+
+class GetObjectInfoRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getObjectInfo';
+        this.adapterFactory = getObjectInfoAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest, context) {
+        return {
+            ...similarRequest,
+            config: {
+                ...similarRequest.config,
+                objectApiName: context.objectApiName,
+            },
+        };
+    }
+    buildGetObjectInfoSaveRequestData(similarContext, context, request) {
+        if (this.isGetObjectInfoContextDependent(context, request)) {
+            return {
+                request: this.transformForSave(request),
+                context: similarContext,
+            };
         }
+        return {
+            request: this.transformForSave(request),
+            context,
+        };
     }
-    /**
-     * Resets the stat trackers for refresh call events.
-     */
-    resetRefreshStats() {
-        this.refreshAdapterEvents = {};
-        this.refreshApiCallEventStats = {
-            [REFRESH_APEX_KEY]: 0,
-            [REFRESH_UIAPI_KEY]: 0,
-            [SUPPORTED_KEY]: 0,
-            [UNSUPPORTED_KEY]: 0,
+    isGetObjectInfoContextDependent(context, request) {
+        return (request.config.objectApiName && context.objectApiName === request.config.objectApiName);
+    }
+}
+
+class GetObjectInfosRequestStrategy extends LuvioAdapterRequestStrategy {
+    constructor() {
+        super(...arguments);
+        this.adapterName = 'getObjectInfos';
+        this.adapterFactory = getObjectInfosAdapterFactory;
+    }
+    buildConcreteRequest(similarRequest) {
+        return similarRequest;
+    }
+}
+
+class LexRequestRunner {
+    constructor(luvio) {
+        this.luvio = luvio;
+        this.requestStrategies = {
+            getRecord: new GetRecordRequestStrategy(),
+            getRecords: new GetRecordsRequestStrategy(),
+            getRecordActions: new GetRecordActionsRequestStrategy(),
+            getRecordAvatars: new GetRecordAvatarsRequestStrategy(),
+            getObjectInfo: new GetObjectInfoRequestStrategy(),
+            getObjectInfos: new GetObjectInfosRequestStrategy(),
         };
-        this.lastRefreshApiCall = null;
     }
-    /**
-     * W-7801618
-     * Counter for occurrences where the incoming record to be merged has a different apiName.
-     * Dynamically generated metric, stored in an {@link RecordApiNameChangeCounters} object.
-     *
-     * @param context The transaction context.
-     *
-     * Note: Short-lived metric candidate, remove at the end of 230
-     */
-    incrementRecordApiNameChangeCount(_incomingApiName, existingApiName) {
-        let apiNameChangeCounter = this.recordApiNameChangeCounters[existingApiName];
-        if (apiNameChangeCounter === undefined) {
-            apiNameChangeCounter = counter(createMetricsKey(NAMESPACE, RECORD_API_NAME_CHANGE_COUNT_METRIC_NAME, existingApiName));
-            this.recordApiNameChangeCounters[existingApiName] = apiNameChangeCounter;
-        }
-        apiNameChangeCounter.increment(1);
+    reduceRequests(requests) {
+        return Object.values(this.requestStrategies)
+            .map((strategy) => strategy.reduce(requests))
+            .flat();
     }
-    /**
-     * W-8620679
-     * Increment the counter for an UnfulfilledSnapshotError coming from luvio
-     *
-     * @param context The transaction context.
-     */
-    incrementAdapterRequestErrorCount(context) {
-        // We are consolidating all apex adapter instrumentation calls under a single key
-        const adapterName = normalizeAdapterName(context.adapterName);
-        let adapterRequestErrorCounter = this.adapterUnfulfilledErrorCounters[adapterName];
-        if (adapterRequestErrorCounter === undefined) {
-            adapterRequestErrorCounter = counter(createMetricsKey(OBSERVABILITY_NAMESPACE, ADAPTER_ERROR_COUNT_METRIC_NAME, adapterName));
-            this.adapterUnfulfilledErrorCounters[adapterName] = adapterRequestErrorCounter;
+    runRequest(request) {
+        if (request.adapterName in this.requestStrategies) {
+            const adapterFactory = this.requestStrategies[request.adapterName].adapterFactory;
+            return Promise.resolve(adapterFactory(this.luvio)(request.config)).then();
         }
-        adapterRequestErrorCounter.increment(1);
-        totalAdapterErrorMetric.increment(1);
+        return Promise.resolve(undefined);
     }
 }
-function createMetricsKey(owner, name, unit) {
-    let metricName = name;
-    if (unit) {
-        metricName = metricName + '.' + unit;
+
+class InMemoryPrefetchStorage {
+    constructor() {
+        this.data = {};
     }
-    return {
-        get() {
-            return { owner: owner, name: metricName };
-        },
-    };
-}
-/**
- * Returns whether adapter is an Apex one or not.
- * @param adapterName The name of the adapter.
- */
-function isApexAdapter(adapterName) {
-    return adapterName.indexOf(APEX_ADAPTER_NAME) > -1;
-}
-/**
- * Normalizes getApex adapter names to `Apex.getApex`. Non-Apex adapters will be prefixed with
- * API family, if supplied. Example: `UiApi.getRecord`.
- *
- * Note: If you are adding additional logging that can come from getApex adapter contexts that provide
- * the full getApex adapter name (i.e. getApex_[namespace]_[class]_[function]_[continuation]),
- * ensure to call this method to normalize all logging to 'getApex'. This
- * is because Argus has a 50k key cardinality limit. More context: W-8379680.
- *
- * @param adapterName The name of the adapter.
- * @param apiFamily The API family of the adapter.
- */
-function normalizeAdapterName(adapterName, apiFamily) {
-    if (isApexAdapter(adapterName)) {
-        return NORMALIZED_APEX_ADAPTER_NAME;
+    set(key, value) {
+        this.data[key] = value;
+        return Promise.resolve();
     }
-    return apiFamily ? `${apiFamily}.${adapterName}` : adapterName;
-}
-const timerMetricTracker = create(null);
-/**
- * Calls instrumentation/service telemetry timer
- * @param name Name of the metric
- * @param duration number to update backing percentile histogram, negative numbers ignored
- */
-function updateTimerMetric(name, duration) {
-    let metric = timerMetricTracker[name];
-    if (metric === undefined) {
-        metric = timer(createMetricsKey(NAMESPACE, name));
-        timerMetricTracker[name] = metric;
+    get(key) {
+        return this.data[key];
     }
-    timerMetricAddDuration(metric, duration);
 }
-function timerMetricAddDuration(timer, duration) {
-    // Guard against negative values since it causes error to be thrown by MetricsService
-    if (duration >= 0) {
-        timer.addDuration(duration);
+
+const { keys: ObjectKeys } = Object;
+const DEFAULT_STORAGE_OPTIONS = {
+    name: 'ldsPredictiveLoading',
+    persistent: true,
+    secure: true,
+    maxSize: 7 * 1024 * 1024,
+    expiration: 12 * 60 * 60,
+    clearOnInit: false,
+    debugLogging: false,
+    version: 2,
+};
+function buildAuraPrefetchStorage(options = {}) {
+    const auraStorage = createStorage({
+        ...DEFAULT_STORAGE_OPTIONS,
+        ...options,
+    });
+    const inMemoryStorage = new InMemoryPrefetchStorage();
+    if (auraStorage === null) {
+        return inMemoryStorage;
     }
+    return new AuraPrefetchStorage(auraStorage, inMemoryStorage);
 }
-/**
- * W-10315098
- * Increments the counter associated with the request response. Counts are bucketed by status.
- */
-const requestResponseMetricTracker = create(null);
-function incrementRequestResponseCount(cb) {
-    const status = cb().status;
-    let metric = requestResponseMetricTracker[status];
-    if (metric === undefined) {
-        metric = counter(createMetricsKey(OBSERVABILITY_NAMESPACE, NETWORK_ADAPTER_RESPONSE_METRIC_NAME, `${status.valueOf()}`));
-        requestResponseMetricTracker[status] = metric;
+class AuraPrefetchStorage {
+    constructor(auraStorage, inMemoryStorage) {
+        this.auraStorage = auraStorage;
+        this.inMemoryStorage = inMemoryStorage;
+        /**
+         * Because of aura is an event loop hog and we therefore need to minimize asynchronicity in LEX,
+         * we need need to preload predictions and treat read operations sync. Not making it sync, will cause
+         * some request to be sent the network when they could be dedupe against those from the predictions.
+         *
+         * Drawbacks of this approach:
+         * 1. Loading all of aura storage into memory and then updating it based on changes to that in memory
+         *    representation means that updates to predictions in aura storage across different tabs will result
+         *    in overwrites, not graceful merges of predictions.
+         * 2. If whoever is consuming this tries to get and run predictions before this is done loading,
+         *    then they will (potentially incorrectly) think that we don't have any predictions.
+         */
+        auraStorage.getAll().then((results) => {
+            ObjectKeys(results).forEach((key) => this.inMemoryStorage.set(key, results[key]));
+        });
     }
-    metric.increment();
-}
-function logObjectInfoChanged() {
-    logObjectInfoChanged$1();
-}
-/**
- * Create a new instrumentation cache stats and return it.
- *
- * @param name The cache logger name.
- */
-function registerLdsCacheStats(name) {
-    return registerCacheStats(`${NAMESPACE}:${name}`);
-}
-/**
- * Add or overwrite hooks that require aura implementations
- */
-function setAuraInstrumentationHooks() {
-    instrument({
-        recordConflictsResolved: (serverRequestCount) => {
-            // Ignore 0 values which can originate from ADS bridge
-            if (serverRequestCount > 0) {
-                updatePercentileHistogramMetric('record-conflicts-resolved', serverRequestCount);
-            }
-        },
-        nullDisplayValueConflict: ({ fieldType, areValuesEqual }) => {
-            const metricName = `merge-null-dv-count.${fieldType}`;
-            if (fieldType === 'scalar') {
-                incrementCounterMetric(`${metricName}.${areValuesEqual}`);
-            }
-            else {
-                incrementCounterMetric(metricName);
+    set(key, value) {
+        const inMemoryResult = this.inMemoryStorage.set(key, value);
+        this.auraStorage.set(key, value).catch((error) => {
+            if (process.env.NODE_ENV !== 'production') {
+                // eslint-disable-next-line no-console
+                console.error('Error save LDS prediction: ', error);
             }
-        },
-        getRecordNotifyChangeAllowed: incrementGetRecordNotifyChangeAllowCount,
-        getRecordNotifyChangeDropped: incrementGetRecordNotifyChangeDropCount,
-        notifyRecordUpdateAvailableAllowed: incrementNotifyRecordUpdateAvailableAllowCount,
-        notifyRecordUpdateAvailableDropped: incrementNotifyRecordUpdateAvailableDropCount,
-        recordApiNameChanged: instrumentation.incrementRecordApiNameChangeCount.bind(instrumentation),
-        weakEtagZero: instrumentation.aggregateWeakETagEvents.bind(instrumentation),
-        getRecordNotifyChangeNetworkResult: instrumentation.notifyChangeNetwork.bind(instrumentation),
-    });
-    withRegistration('@salesforce/lds-adapters-uiapi', (reg) => setLdsAdaptersUiapiInstrumentation(reg));
-    instrument$1({
-        logCrud: logCRUDLightningInteraction,
-        networkResponse: incrementRequestResponseCount,
-    });
-    instrument$2({
-        refreshCalled: instrumentation.handleRefreshApiCall.bind(instrumentation),
-        instrumentAdapter: instrumentation.instrumentAdapter.bind(instrumentation),
-    });
-    instrument$3({
-        timerMetricAddDuration: updateTimerMetric,
-    });
-    // Our getRecord through aggregate-ui CRUD logging has moved
-    // to lds-network-adapter. We still need to respect the
-    // orgs environment setting
-    if (forceRecordTransactionsDisabled === false) {
-        ldsNetworkAdapterInstrument({
-            getRecordAggregateResolve: (cb) => {
-                const { recordId, apiName } = cb();
-                logCRUDLightningInteraction('read', {
-                    recordId,
-                    recordType: apiName,
-                    state: 'SUCCESS',
-                });
-            },
-            getRecordAggregateReject: (cb) => {
-                const recordId = cb();
-                logCRUDLightningInteraction('read', {
-                    recordId,
-                    state: 'ERROR',
-                });
-            },
         });
+        return inMemoryResult;
+    }
+    get(key) {
+        // we never read from the AuraStorage, except in construction.
+        return this.inMemoryStorage.get(key);
     }
-    withRegistration('@salesforce/lds-network-adapter', (reg) => setLdsNetworkAdapterInstrumentation(reg));
-}
-/**
- * Initialize the instrumentation and instrument the LDS instance and the InMemoryStore.
- *
- * @param luvio The Luvio instance to instrument.
- * @param store The InMemoryStore to instrument.
- */
-function setupInstrumentation(luvio, store) {
-    setupInstrumentation$1(luvio, store);
-    setAuraInstrumentationHooks();
-}
-/**
- * Note: locator.scope is set to 'force_record' in order for the instrumentation gate to work, which will
- * disable all crud operations if it is on.
- * @param eventSource - Source of the logging event.
- * @param attributes - Free form object of attributes to log.
- */
-function logCRUDLightningInteraction(eventSource, attributes) {
-    interaction(eventSource, 'force_record', null, eventSource, 'crud', attributes);
 }
-const instrumentation = new Instrumentation();
 
 class NoComposedAdapterTypeError extends TypeError {
     constructor(message, resourceRequest) {
@@ -1593,7 +1600,7 @@ function buildPredictorForContext(context) {
             });
         },
         runPredictions() {
-            return __lexPrefetcher.predict();
+            return executeAsyncActivity(METRIC_KEYS.PREDICTIVE_DATA_LOADING_PREDICT, (_act) => __lexPrefetcher.predict(), PDL_EXECUTE_ASYNC_OPTIONS);
         },
     };
 }
@@ -1623,4 +1630,4 @@ function ldsEngineCreator() {
 }
 
 export { buildPredictorForContext, ldsEngineCreator as default, initializeLDS, predictiveLoadPage };
-// version: 1.266.0-dev20-117d849b4
+// version: 1.266.0-dev22-06d4657e7