@salesforce/lds-runtime-aura 1.426.1 → 1.427.0

package/dist/ldsEngineCreator.js

@@ -813,14 +813,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.
    *
@@ -845,7 +846,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
@@ -2705,7 +2712,7 @@ function buildServiceDescriptor$d(luvio) {
         },
     };
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -3058,7 +3065,7 @@ function buildServiceDescriptor$9(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -5694,7 +5701,7 @@ function getEnvironmentSetting(name) {
     }
     return undefined;
 }
-// version: 1.426.1-9fe18ee3ae
+// version: 1.427.0-d53a098e46
 
 const environmentHasAura = typeof window !== 'undefined' && typeof window.$A !== 'undefined';
 const defaultConfig = {
@@ -9628,6 +9635,9 @@ function buildUpdate(update, existing) {
       );
       return updatedCacheControl !== void 0 ? { type: "metadata", metadata: updatedCacheControl } : { type: "no-op" };
     }
+    case "evict": {
+      return { type: "delete" };
+    }
     default:
       throw new Error(`Invalid update operation: ${update.type}`);
   }
@@ -9700,6 +9710,13 @@ class InMemoryCacheInclusionPolicy extends CacheInclusionPolicyService {
           });
           yield key;
           break;
+        case "delete":
+          this.write({
+            l1: cache,
+            writeToL1: (l1) => resolvedPromiseLike(ok(l1.delete(key)))
+          });
+          yield key;
+          break;
       }
     }
   }
@@ -9971,6 +9988,10 @@ class AuraDurableCacheInclusionPolicy extends DurableCacheInclusionPolicy {
      * Find and modify entries matching a query
      * @param query - Cache query to match entries
      * @param cacheUpdate - Update to apply to matching entries
+     *
+     * Note: This method does not publish cache events. Callers should publish
+     * appropriate cache events (e.g., 'cacheEviction') after eviction operations
+     * to notify subscribers.
      */
     async *findAndModify(query, cacheUpdate) {
         if (!this.storage) {
@@ -9981,28 +10002,51 @@ class AuraDurableCacheInclusionPolicy extends DurableCacheInclusionPolicy {
             // Cannot pass specific keys since we don't know which entries match the query
             const allStoredData = (await this.storage.getAll());
             const modifiedEntries = [];
-            // Find and modify matching entries
+            const deletedEntries = [];
+            // Find and process matching entries
             for (const [storageKey, storedEntry] of Object.entries(allStoredData)) {
                 const entry = storedEntry;
                 const key = storageKey;
                 if (entry && this.matchesQuery(key, entry, query)) {
                     // Apply the update to the entry
                     const updatedEntry = this.applyUpdate(entry, cacheUpdate);
-                    if (updatedEntry) {
-                        modifiedEntries.push({ storageKey, entry: updatedEntry, modifiedKey: key });
+                    if (updatedEntry.status === 'modified') {
+                        modifiedEntries.push({
+                            storageKey,
+                            entry: updatedEntry.entry,
+                            modifiedKey: key,
+                        });
+                    }
+                    else if (updatedEntry.status === 'deleted') {
+                        deletedEntries.push({ storageKey, deletedKey: key });
                     }
+                    // 'no-op' case: do nothing
                 }
             }
+            let promises = [];
             // Save all modified entries back to storage
             if (modifiedEntries.length > 0 && this.storage) {
-                const promises = modifiedEntries.map(({ storageKey, entry }) => this.storage.set(storageKey, entry).catch((error) => {
+                promises = modifiedEntries.map(({ storageKey, entry }) => this.storage.set(storageKey, entry).catch((error) => {
                     console.warn(`Failed to update cache entry: ${storageKey}`, error);
                 }));
-                await Promise.all(promises);
-                // Yield all modified keys
-                for (const { modifiedKey } of modifiedEntries) {
-                    yield modifiedKey;
-                }
+            }
+            // Handle deleted entries
+            if (deletedEntries.length > 0 && this.storage) {
+                const keysToDelete = deletedEntries.map(({ storageKey }) => storageKey);
+                promises.push(this.storage.removeAll(keysToDelete)
+                    .catch((error) => {
+                    console.warn(`Failed to remove cache entries: ${keysToDelete.join(', ')}`, error);
+                })
+                    .then(() => { }));
+            }
+            await Promise.all(promises);
+            // Yield all modified keys
+            for (const { modifiedKey } of modifiedEntries) {
+                yield modifiedKey;
+            }
+            // Yield all deleted keys
+            for (const { deletedKey } of deletedEntries) {
+                yield deletedKey;
             }
         }
         catch (error) {
@@ -10017,7 +10061,7 @@ class AuraDurableCacheInclusionPolicy extends DurableCacheInclusionPolicy {
      * @returns true if the entry matches the query
      */
     matchesQuery(key, entry, query) {
-        if (!query)
+        if (!query || Object.keys(query).length === 0)
             return true;
         // Handle logical operators
         if (this.isAndQuery(query)) {
@@ -10075,32 +10119,37 @@ class AuraDurableCacheInclusionPolicy extends DurableCacheInclusionPolicy {
      * Apply an update to a cache entry
      * @param entry - Original cache entry
      * @param update - Update to apply
-     * @returns Updated entry or null if no update needed
+     * @returns Object indicating the result: modified entry, deleted marker, or no-op
      */
     applyUpdate(entry, update) {
         try {
             const updateResult = this.buildUpdate(update, entry);
             switch (updateResult.type) {
                 case 'entry':
-                    return updateResult.entry;
+                    return { status: 'modified', entry: updateResult.entry };
                 case 'metadata':
                     // Create a new entry with updated metadata
                     return {
-                        ...entry,
-                        metadata: {
-                            ...entry.metadata,
-                            cacheControl: updateResult.metadata,
+                        status: 'modified',
+                        entry: {
+                            ...entry,
+                            metadata: {
+                                ...entry.metadata,
+                                cacheControl: updateResult.metadata,
+                            },
                         },
                     };
+                case 'delete':
+                    return { status: 'deleted' };
                 case 'no-op':
-                    return null; // No changes needed
+                    return { status: 'no-op' };
                 default:
-                    return null;
+                    return { status: 'no-op' };
             }
         }
         catch (error) {
             console.warn('Failed to apply update to cache entry:', error);
-            return null;
+            return { status: 'no-op' };
         }
     }
     /**
@@ -10116,6 +10165,9 @@ class AuraDurableCacheInclusionPolicy extends DurableCacheInclusionPolicy {
                 return updatedCacheControl !== undefined
                     ? { type: 'metadata', metadata: updatedCacheControl }
                     : { type: 'no-op' };
+            case 'evict':
+                // Eviction removes the entry entirely from storage
+                return { type: 'delete' };
             default:
                 throw new Error(`Invalid update operation: ${update.type}`);
         }
@@ -10480,4 +10532,4 @@ function ldsEngineCreator() {
 }
 
 export { LexRequestStrategy, PdlPrefetcherEventType, PdlRequestPriority, buildPredictorForContext, configService, ldsEngineCreator as default, initializeLDS, initializeOneStore, notifyUpdateAvailableFactory, registerRequestStrategy, saveRequestAsPrediction, subscribeToPrefetcherEvents, unregisterRequestStrategy, whenPredictionsReady };
-// version: 1.426.1-37e68ccef8
+// version: 1.427.0-281d684cba

package/dist/types/service-variants/durable-cache-inclusion-policy.d.ts

@@ -34,6 +34,10 @@ export declare class AuraDurableCacheInclusionPolicy extends DurableCacheInclusi
      * Find and modify entries matching a query
      * @param query - Cache query to match entries
      * @param cacheUpdate - Update to apply to matching entries
+     *
+     * Note: This method does not publish cache events. Callers should publish
+     * appropriate cache events (e.g., 'cacheEviction') after eviction operations
+     * to notify subscribers.
      */
     findAndModify(query: CacheQuery, cacheUpdate: CacheUpdate): AsyncGenerator<Key, void, unknown>;
     /**
@@ -53,7 +57,7 @@ export declare class AuraDurableCacheInclusionPolicy extends DurableCacheInclusi
      * Apply an update to a cache entry
      * @param entry - Original cache entry
      * @param update - Update to apply
-     * @returns Updated entry or null if no update needed
+     * @returns Object indicating the result: modified entry, deleted marker, or no-op
      */
     private applyUpdate;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-runtime-aura",
-    "version": "1.426.1",
+    "version": "1.427.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "LDS engine for Aura runtime",
     "main": "dist/ldsEngineCreator.js",
@@ -34,51 +34,51 @@
         "release:corejar": "yarn build && ../core-build/scripts/core.js --name=lds-runtime-aura"
     },
     "devDependencies": {
-        "@conduit-client/service-provisioner": "3.17.3",
-        "@conduit-client/tools-core": "3.17.3",
-        "@salesforce/lds-adapters-apex": "^1.426.1",
-        "@salesforce/lds-adapters-uiapi": "^1.426.1",
-        "@salesforce/lds-ads-bridge": "^1.426.1",
-        "@salesforce/lds-aura-storage": "^1.426.1",
-        "@salesforce/lds-bindings": "^1.426.1",
-        "@salesforce/lds-instrumentation": "^1.426.1",
-        "@salesforce/lds-network-aura": "^1.426.1",
-        "@salesforce/lds-network-fetch": "^1.426.1",
+        "@conduit-client/service-provisioner": "3.18.0",
+        "@conduit-client/tools-core": "3.18.0",
+        "@salesforce/lds-adapters-apex": "^1.427.0",
+        "@salesforce/lds-adapters-uiapi": "^1.427.0",
+        "@salesforce/lds-ads-bridge": "^1.427.0",
+        "@salesforce/lds-aura-storage": "^1.427.0",
+        "@salesforce/lds-bindings": "^1.427.0",
+        "@salesforce/lds-instrumentation": "^1.427.0",
+        "@salesforce/lds-network-aura": "^1.427.0",
+        "@salesforce/lds-network-fetch": "^1.427.0",
         "jwt-encode": "1.0.1"
     },
     "dependencies": {
-        "@conduit-client/command-aura-graphql-normalized-cache-control": "3.17.3",
-        "@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-graphql-normalized-cache-control": "3.17.3",
-        "@conduit-client/command-http-normalized-cache-control": "3.17.3",
-        "@conduit-client/command-ndjson": "3.17.3",
-        "@conduit-client/command-network": "3.17.3",
-        "@conduit-client/command-sse": "3.17.3",
-        "@conduit-client/command-streaming": "3.17.3",
-        "@conduit-client/service-aura-network": "3.17.3",
-        "@conduit-client/service-bindings-imperative": "3.17.3",
-        "@conduit-client/service-bindings-lwc": "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-config": "3.17.3",
-        "@conduit-client/service-feature-flags": "3.17.3",
-        "@conduit-client/service-fetch-network": "3.17.3",
-        "@conduit-client/service-instrument-command": "3.17.3",
-        "@conduit-client/service-pubsub": "3.17.3",
-        "@conduit-client/service-store": "3.17.3",
-        "@conduit-client/utils": "3.17.3",
+        "@conduit-client/command-aura-graphql-normalized-cache-control": "3.18.0",
+        "@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-graphql-normalized-cache-control": "3.18.0",
+        "@conduit-client/command-http-normalized-cache-control": "3.18.0",
+        "@conduit-client/command-ndjson": "3.18.0",
+        "@conduit-client/command-network": "3.18.0",
+        "@conduit-client/command-sse": "3.18.0",
+        "@conduit-client/command-streaming": "3.18.0",
+        "@conduit-client/service-aura-network": "3.18.0",
+        "@conduit-client/service-bindings-imperative": "3.18.0",
+        "@conduit-client/service-bindings-lwc": "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-config": "3.18.0",
+        "@conduit-client/service-feature-flags": "3.18.0",
+        "@conduit-client/service-fetch-network": "3.18.0",
+        "@conduit-client/service-instrument-command": "3.18.0",
+        "@conduit-client/service-pubsub": "3.18.0",
+        "@conduit-client/service-store": "3.18.0",
+        "@conduit-client/utils": "3.18.0",
         "@luvio/network-adapter-composable": "0.160.3",
         "@luvio/network-adapter-fetch": "0.160.3",
         "@lwc/state": "^0.29.0",
-        "@salesforce/lds-adapters-onestore-graphql": "^1.426.1",
+        "@salesforce/lds-adapters-onestore-graphql": "^1.427.0",
         "@salesforce/lds-adapters-uiapi-lex": "^1.415.0",
-        "@salesforce/lds-durable-storage": "^1.426.1",
-        "@salesforce/lds-luvio-service": "^1.426.1",
-        "@salesforce/lds-luvio-uiapi-records-service": "^1.426.1"
+        "@salesforce/lds-durable-storage": "^1.427.0",
+        "@salesforce/lds-luvio-service": "^1.427.0",
+        "@salesforce/lds-luvio-uiapi-records-service": "^1.427.0"
     },
     "luvioBundlesize": [
         {