@salesforce/lds-runtime-mobile 1.426.1 → 1.427.0

package/dist/main.js

@@ -30,6 +30,7 @@ import graphqlPartialEmitParity from '@salesforce/gate/lmr.graphqlPartialEmitPar
 import { pdpEventSchema } from 'o11y_schema/sf_pdp';
 import { instrument as instrument$1 } from '@salesforce/lds-bindings';
 import ldsAdapterO11yLoggingGate from '@salesforce/gate/lmr.ldsAdapterO11yLogging';
+import { entityFetchedMetadataSchema } from 'o11y_schema/sf_lightningsdk';
 import LOCALE from '@salesforce/i18n/locale';
 import CURRENCY from '@salesforce/i18n/currency';
 import TIMEZONE from '@salesforce/i18n/timeZone';
@@ -52374,6 +52375,7 @@ function instrumentAdapter(adapter, metadata) {
                 });
             }
         },
+        cacheMissObserver: logCacheMissObservability,
     });
 }
 function setupMobileInstrumentation(luvio, store) {
@@ -52392,6 +52394,101 @@ function registerReportObserver(reportObserver) {
         }
     };
 }
+/**
+ * Extracts object name from the first field in fields or optionalFields array
+ * @param record Object with fields and/or optionalFields arrays
+ * @returns Object name (e.g., "Account" from "Account.Name") or undefined
+ */
+function extractObjectNameFromFields(record) {
+    const firstField = record.fields?.[0] || record.optionalFields?.[0];
+    if (firstField) {
+        const objectName = firstField.split('.')[0];
+        return objectName || undefined;
+    }
+    return undefined;
+}
+/**
+ * Extracts apiName from adapter config based on adapter type
+ * @param adapterName The name of the adapter
+ * @param config The adapter configuration
+ * @param completedNetworkRequests Network requests for fallback extraction from response
+ * @returns API name string or 'unknown'
+ */
+function extractApiNameFromConfig(adapterName, config, completedNetworkRequests) {
+    let apiName = 'unknown';
+    // Parse config once to avoid repeated JSONParse calls
+    const parsedConfig = typeof config === 'string' ? parse$5(config) : config;
+    // Extract apiName based on adapter type
+    switch (adapterName) {
+        case 'getRecord':
+            // getRecord config has fields/optionalFields like "Account.Name"
+            // Extract apiName from first field in config
+            const objectName = extractObjectNameFromFields(parsedConfig);
+            if (objectName) {
+                apiName = objectName;
+            }
+            else {
+                // Fallback to response body when config uses layoutTypes instead of fields
+                for (const request of completedNetworkRequests) {
+                    const response = request.response;
+                    if (response?.body?.apiName) {
+                        apiName = response.body.apiName;
+                        break;
+                    }
+                }
+            }
+            break;
+        case 'getRecords':
+            // getRecords config has records array with fields/optionalFields like "Account.Name"
+            // Extract apiNames from first field of each record to determine record type
+            if (parsedConfig?.records && isArray$3(parsedConfig.records)) {
+                const apiNames = new Set();
+                for (const record of parsedConfig.records) {
+                    const recordObjectName = extractObjectNameFromFields(record);
+                    if (recordObjectName) {
+                        apiNames.add(recordObjectName);
+                    }
+                }
+                if (apiNames.size > 0) {
+                    apiName = Array.from(apiNames).sort().join(',');
+                }
+            }
+            break;
+        case 'getObjectInfo':
+        case 'getPicklistValues':
+        case 'getPicklistValuesByRecordType':
+        case 'getLayout':
+            // All of these adapters have a single objectApiName field
+            if (parsedConfig?.objectApiName) {
+                apiName = parsedConfig.objectApiName;
+            }
+            break;
+        case 'getObjectInfos':
+            // getObjectInfos has objectApiNames array (plural)
+            if (parsedConfig?.objectApiNames && isArray$3(parsedConfig.objectApiNames)) {
+                apiName = parsedConfig.objectApiNames.sort().join(',');
+            }
+            break;
+    }
+    return apiName;
+}
+function logCacheMissObservability(report) {
+    const { snapshotState, adapterName, config } = report;
+    // Check for offline conditions (short-circuits on first match)
+    const isOffline = report.completedNetworkRequests.some((request) => {
+        const response = request.response;
+        return response?.errorType === 'networkAdapterError' || response?.status === 504;
+    });
+    // Extract apiName from config based on adapter type
+    const apiName = extractApiNameFromConfig(adapterName, config, report.completedNetworkRequests);
+    const wasSuccessful = snapshotState === 'Fulfilled' || snapshotState === 'Stale';
+    ldsInstrumentation.log(entityFetchedMetadataSchema, {
+        apiName: apiName,
+        adapterName: adapterName,
+        isOffline: isOffline,
+        wasSuccessful: wasSuccessful,
+    });
+}
 
 const { keys: keys$1, create: create$1, assign, entries: entries$1, values } = Object;
 const { stringify: stringify$3, parse: parse$3 } = JSON;
@@ -57049,14 +57146,15 @@ class CacheControlCommand extends BaseCommand {
     return "query";
   }
   /**
-   * Subscribes to cache update and invalidation events for reactive updates
+   * Subscribes to cache update, invalidation, and eviction events for reactive updates
    *
    * This method sets up subscriptions to listen for changes that affect the data returned
    * by this Command.
    *
-   * By default, it subscribes to two types of events on the PubSub service:
+   * By default, it subscribes to three types of events on the PubSub service:
    * - 'cacheUpdate': Triggers a rebuild with the original instantiation time
-   * - 'cacheInvalidation': Triggers a full refresh without time constraints
+   * - 'cacheInvalidation': Triggers a full refresh without time constraints (data marked stale)
+   * - 'cacheEviction': Triggers a full refresh without time constraints (data removed from cache)
    *
    * This method can be extended by subclasses to add additional subscriptions.
    *
@@ -57081,7 +57179,13 @@ class CacheControlCommand extends BaseCommand {
       callback: () => this.rerun().then(() => void 0),
       keys: this.keysUsed
     });
-    this.unsubscribers.push(rebuildUnsubscribe, refreshUnsubscribe);
+    const evictionUnsubscribe = pubSub.subscribe({
+      type: "cacheEviction",
+      predicate: (event) => setOverlaps(event.data, this.keysUsed),
+      callback: () => this.rerun().then(() => void 0),
+      keys: this.keysUsed
+    });
+    this.unsubscribers.push(rebuildUnsubscribe, refreshUnsubscribe, evictionUnsubscribe);
   }
   /**
    * Unsubscribes from all stored subscriptions
@@ -58779,7 +58883,7 @@ function buildServiceDescriptor$b(luvio) {
         },
     };
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -58805,7 +58909,7 @@ function buildServiceDescriptor$a(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -61465,4 +61569,4 @@ register({
 });
 
 export { O11Y_NAMESPACE_LDS_MOBILE, getRuntime, ingest$1o as ingestDenormalizedRecordRepresentation, initializeOneStore, registerReportObserver, reportGraphqlQueryParseError };
-// version: 1.426.1-37e68ccef8
+// version: 1.427.0-281d684cba

package/dist/types/__mocks__/o11y_schema/sf_lightningsdk.d.ts

@@ -0,0 +1 @@
+export declare const entityFetchedMetadataSchema: {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-runtime-mobile",
-    "version": "1.426.1",
+    "version": "1.427.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "LDS runtime for mobile/hybrid environments.",
     "main": "dist/main.js",
@@ -32,44 +32,44 @@
         "release:corejar": "yarn build && ../core-build/scripts/core.js --name=lds-runtime-mobile"
     },
     "dependencies": {
-        "@conduit-client/service-bindings-imperative": "3.17.3",
-        "@conduit-client/service-bindings-lwc": "3.17.3",
-        "@conduit-client/service-provisioner": "3.17.3",
-        "@salesforce/lds-adapters-uiapi": "^1.426.1",
-        "@salesforce/lds-bindings": "^1.426.1",
-        "@salesforce/lds-instrumentation": "^1.426.1",
-        "@salesforce/lds-luvio-service": "^1.426.1",
-        "@salesforce/lds-luvio-uiapi-records-service": "^1.426.1",
+        "@conduit-client/service-bindings-imperative": "3.18.0",
+        "@conduit-client/service-bindings-lwc": "3.18.0",
+        "@conduit-client/service-provisioner": "3.18.0",
+        "@salesforce/lds-adapters-uiapi": "^1.427.0",
+        "@salesforce/lds-bindings": "^1.427.0",
+        "@salesforce/lds-instrumentation": "^1.427.0",
+        "@salesforce/lds-luvio-service": "^1.427.0",
+        "@salesforce/lds-luvio-uiapi-records-service": "^1.427.0",
         "@salesforce/user": "0.0.21",
         "o11y": "250.7.0",
         "o11y_schema": "256.126.0"
     },
     "devDependencies": {
-        "@conduit-client/command-aura-network": "3.17.3",
-        "@conduit-client/command-aura-normalized-cache-control": "3.17.3",
-        "@conduit-client/command-aura-resource-cache-control": "3.17.3",
-        "@conduit-client/command-fetch-network": "3.17.3",
-        "@conduit-client/command-http-normalized-cache-control": "3.17.3",
-        "@conduit-client/command-network": "3.17.3",
-        "@conduit-client/service-cache": "3.17.3",
-        "@conduit-client/service-cache-control": "3.17.3",
-        "@conduit-client/service-cache-inclusion-policy": "3.17.3",
-        "@conduit-client/service-fetch-network": "3.17.3",
-        "@conduit-client/service-instrument-command": "3.17.3",
-        "@conduit-client/service-instrumentation": "3.17.3",
-        "@conduit-client/service-pubsub": "3.17.3",
-        "@conduit-client/service-store": "3.17.3",
-        "@conduit-client/utils": "3.17.3",
-        "@salesforce/lds-adapters-graphql": "^1.426.1",
-        "@salesforce/lds-drafts": "^1.426.1",
-        "@salesforce/lds-durable-records": "^1.426.1",
-        "@salesforce/lds-network-adapter": "^1.426.1",
-        "@salesforce/lds-network-nimbus": "^1.426.1",
-        "@salesforce/lds-store-binary": "^1.426.1",
-        "@salesforce/lds-store-nimbus": "^1.426.1",
-        "@salesforce/lds-store-sql": "^1.426.1",
-        "@salesforce/lds-utils-adapters": "^1.426.1",
-        "@salesforce/nimbus-plugin-lds": "^1.426.1",
+        "@conduit-client/command-aura-network": "3.18.0",
+        "@conduit-client/command-aura-normalized-cache-control": "3.18.0",
+        "@conduit-client/command-aura-resource-cache-control": "3.18.0",
+        "@conduit-client/command-fetch-network": "3.18.0",
+        "@conduit-client/command-http-normalized-cache-control": "3.18.0",
+        "@conduit-client/command-network": "3.18.0",
+        "@conduit-client/service-cache": "3.18.0",
+        "@conduit-client/service-cache-control": "3.18.0",
+        "@conduit-client/service-cache-inclusion-policy": "3.18.0",
+        "@conduit-client/service-fetch-network": "3.18.0",
+        "@conduit-client/service-instrument-command": "3.18.0",
+        "@conduit-client/service-instrumentation": "3.18.0",
+        "@conduit-client/service-pubsub": "3.18.0",
+        "@conduit-client/service-store": "3.18.0",
+        "@conduit-client/utils": "3.18.0",
+        "@salesforce/lds-adapters-graphql": "^1.427.0",
+        "@salesforce/lds-drafts": "^1.427.0",
+        "@salesforce/lds-durable-records": "^1.427.0",
+        "@salesforce/lds-network-adapter": "^1.427.0",
+        "@salesforce/lds-network-nimbus": "^1.427.0",
+        "@salesforce/lds-store-binary": "^1.427.0",
+        "@salesforce/lds-store-nimbus": "^1.427.0",
+        "@salesforce/lds-store-sql": "^1.427.0",
+        "@salesforce/lds-utils-adapters": "^1.427.0",
+        "@salesforce/nimbus-plugin-lds": "^1.427.0",
         "babel-plugin-dynamic-import-node": "^2.3.3",
         "wait-for-expect": "^3.0.2"
     },

package/sfdc/main.js

@@ -30,6 +30,7 @@ import graphqlPartialEmitParity from '@salesforce/gate/lmr.graphqlPartialEmitPar
 import { pdpEventSchema } from 'o11y_schema/sf_pdp';
 import { instrument as instrument$1 } from 'force/ldsBindings';
 import ldsAdapterO11yLoggingGate from '@salesforce/gate/lmr.ldsAdapterO11yLogging';
+import { entityFetchedMetadataSchema } from 'o11y_schema/sf_lightningsdk';
 import LOCALE from '@salesforce/i18n/locale';
 import CURRENCY from '@salesforce/i18n/currency';
 import TIMEZONE from '@salesforce/i18n/timeZone';
@@ -52374,6 +52375,7 @@ function instrumentAdapter(adapter, metadata) {
                 });
             }
         },
+        cacheMissObserver: logCacheMissObservability,
     });
 }
 function setupMobileInstrumentation(luvio, store) {
@@ -52392,6 +52394,101 @@ function registerReportObserver(reportObserver) {
         }
     };
 }
+/**
+ * Extracts object name from the first field in fields or optionalFields array
+ * @param record Object with fields and/or optionalFields arrays
+ * @returns Object name (e.g., "Account" from "Account.Name") or undefined
+ */
+function extractObjectNameFromFields(record) {
+    const firstField = record.fields?.[0] || record.optionalFields?.[0];
+    if (firstField) {
+        const objectName = firstField.split('.')[0];
+        return objectName || undefined;
+    }
+    return undefined;
+}
+/**
+ * Extracts apiName from adapter config based on adapter type
+ * @param adapterName The name of the adapter
+ * @param config The adapter configuration
+ * @param completedNetworkRequests Network requests for fallback extraction from response
+ * @returns API name string or 'unknown'
+ */
+function extractApiNameFromConfig(adapterName, config, completedNetworkRequests) {
+    let apiName = 'unknown';
+    // Parse config once to avoid repeated JSONParse calls
+    const parsedConfig = typeof config === 'string' ? parse$5(config) : config;
+    // Extract apiName based on adapter type
+    switch (adapterName) {
+        case 'getRecord':
+            // getRecord config has fields/optionalFields like "Account.Name"
+            // Extract apiName from first field in config
+            const objectName = extractObjectNameFromFields(parsedConfig);
+            if (objectName) {
+                apiName = objectName;
+            }
+            else {
+                // Fallback to response body when config uses layoutTypes instead of fields
+                for (const request of completedNetworkRequests) {
+                    const response = request.response;
+                    if (response?.body?.apiName) {
+                        apiName = response.body.apiName;
+                        break;
+                    }
+                }
+            }
+            break;
+        case 'getRecords':
+            // getRecords config has records array with fields/optionalFields like "Account.Name"
+            // Extract apiNames from first field of each record to determine record type
+            if (parsedConfig?.records && isArray$3(parsedConfig.records)) {
+                const apiNames = new Set();
+                for (const record of parsedConfig.records) {
+                    const recordObjectName = extractObjectNameFromFields(record);
+                    if (recordObjectName) {
+                        apiNames.add(recordObjectName);
+                    }
+                }
+                if (apiNames.size > 0) {
+                    apiName = Array.from(apiNames).sort().join(',');
+                }
+            }
+            break;
+        case 'getObjectInfo':
+        case 'getPicklistValues':
+        case 'getPicklistValuesByRecordType':
+        case 'getLayout':
+            // All of these adapters have a single objectApiName field
+            if (parsedConfig?.objectApiName) {
+                apiName = parsedConfig.objectApiName;
+            }
+            break;
+        case 'getObjectInfos':
+            // getObjectInfos has objectApiNames array (plural)
+            if (parsedConfig?.objectApiNames && isArray$3(parsedConfig.objectApiNames)) {
+                apiName = parsedConfig.objectApiNames.sort().join(',');
+            }
+            break;
+    }
+    return apiName;
+}
+function logCacheMissObservability(report) {
+    const { snapshotState, adapterName, config } = report;
+    // Check for offline conditions (short-circuits on first match)
+    const isOffline = report.completedNetworkRequests.some((request) => {
+        const response = request.response;
+        return response?.errorType === 'networkAdapterError' || response?.status === 504;
+    });
+    // Extract apiName from config based on adapter type
+    const apiName = extractApiNameFromConfig(adapterName, config, report.completedNetworkRequests);
+    const wasSuccessful = snapshotState === 'Fulfilled' || snapshotState === 'Stale';
+    ldsInstrumentation.log(entityFetchedMetadataSchema, {
+        apiName: apiName,
+        adapterName: adapterName,
+        isOffline: isOffline,
+        wasSuccessful: wasSuccessful,
+    });
+}
 
 const { keys: keys$1, create: create$1, assign, entries: entries$1, values } = Object;
 const { stringify: stringify$3, parse: parse$3 } = JSON;
@@ -57049,14 +57146,15 @@ class CacheControlCommand extends BaseCommand {
     return "query";
   }
   /**
-   * Subscribes to cache update and invalidation events for reactive updates
+   * Subscribes to cache update, invalidation, and eviction events for reactive updates
    *
    * This method sets up subscriptions to listen for changes that affect the data returned
    * by this Command.
    *
-   * By default, it subscribes to two types of events on the PubSub service:
+   * By default, it subscribes to three types of events on the PubSub service:
    * - 'cacheUpdate': Triggers a rebuild with the original instantiation time
-   * - 'cacheInvalidation': Triggers a full refresh without time constraints
+   * - 'cacheInvalidation': Triggers a full refresh without time constraints (data marked stale)
+   * - 'cacheEviction': Triggers a full refresh without time constraints (data removed from cache)
    *
    * This method can be extended by subclasses to add additional subscriptions.
    *
@@ -57081,7 +57179,13 @@ class CacheControlCommand extends BaseCommand {
       callback: () => this.rerun().then(() => void 0),
       keys: this.keysUsed
     });
-    this.unsubscribers.push(rebuildUnsubscribe, refreshUnsubscribe);
+    const evictionUnsubscribe = pubSub.subscribe({
+      type: "cacheEviction",
+      predicate: (event) => setOverlaps(event.data, this.keysUsed),
+      callback: () => this.rerun().then(() => void 0),
+      keys: this.keysUsed
+    });
+    this.unsubscribers.push(rebuildUnsubscribe, refreshUnsubscribe, evictionUnsubscribe);
   }
   /**
    * Unsubscribes from all stored subscriptions
@@ -58779,7 +58883,7 @@ function buildServiceDescriptor$b(luvio) {
         },
     };
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -58805,7 +58909,7 @@ function buildServiceDescriptor$a(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -61465,4 +61569,4 @@ register({
 });
 
 export { O11Y_NAMESPACE_LDS_MOBILE, getRuntime, ingest$1o as ingestDenormalizedRecordRepresentation, initializeOneStore, registerReportObserver, reportGraphqlQueryParseError };
-// version: 1.426.1-37e68ccef8
+// version: 1.427.0-281d684cba

package/sfdc/types/__mocks__/o11y_schema/sf_lightningsdk.d.ts

@@ -0,0 +1 @@
+export declare const entityFetchedMetadataSchema: {};