@salesforce/lds-worker-api 1.229.0-dev7 → 1.229.0-dev9

package/dist/sfdc/es/ldsWorkerApi.js

@@ -795,4 +795,4 @@ if (process.env.NODE_ENV !== 'production') {
 }
 
 export { createPrimingSession, draftManager, draftQueue, executeAdapter, executeMutatingAdapter, getImperativeAdapterNames, invokeAdapter, invokeAdapterWithDraftToReplace, invokeAdapterWithMetadata, nimbusDraftQueue, setMetadataTTL, setUiApiRecordTTL, subscribeToAdapter };
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901

package/dist/standalone/es/lds-worker-api.js

@@ -25,12 +25,15 @@ const { hasOwnProperty: hasOwnProperty$3 } = Object.prototype;
 const { isArray: isArray$9 } = Array;
 const { push: push$5, indexOf, slice: slice$2 } = Array.prototype;
 const { parse: parse$a, stringify: stringify$a } = JSON;
+const WeakSetCtor = WeakSet;
 
+const deeplyFrozen = new WeakSetCtor();
 function deepFreeze(value) {
-    // No need to freeze primitives
-    if (typeof value !== 'object' || value === null) {
+    // No need to freeze primitives or already frozen stuff
+    if (typeof value !== 'object' || value === null || deeplyFrozen.has(value)) {
         return;
     }
+    deeplyFrozen.add(value);
     if (isArray$9(value)) {
         for (let i = 0, len = value.length; i < len; i += 1) {
             deepFreeze(value[i]);
@@ -1727,6 +1730,10 @@ class InMemoryStore {
         }
     }
     markVisited(canonicalKey) {
+        if (typeof canonicalKey === 'string') {
+            this.fallbackStringKeyInMemoryStore.markVisited(canonicalKey);
+            return;
+        }
         const { visitedIdsSet, reverseRedirectKeysMap } = this;
         let redirectKey = canonicalKey;
         // mark all redirects leading up to the canonical key as visited so
@@ -2038,7 +2045,7 @@ class GraphLink {
         if (isStoreRecordError$1(linked)) {
             return new GraphNodeError(this.store, linked);
         }
-        return new GraphNode(this.store, linked);
+        return new GraphNode(this.store, linked, __ref);
     }
     linkData() {
         return this.data.data;
@@ -2048,10 +2055,11 @@ class GraphLink {
     }
 }
 class GraphNode {
-    constructor(store, data) {
+    constructor(store, data, storeKey) {
         this.type = GraphNodeType$1.Node;
         this.store = store;
         this.data = data;
+        this.storeKey = storeKey;
     }
     object(propertyName) {
         const value = this.data[propertyName];
@@ -2061,7 +2069,8 @@ class GraphNode {
         if (typeof value !== 'object' || value === null) {
             throw new Error(`Cannot walk to path ${String(propertyName)}. "${String(propertyName)}" is a scalar: "${value}"`);
         }
-        return new GraphNode(this.store, value);
+        // We're walking to an object property on the current store record, pass the storeKey down.
+        return new GraphNode(this.store, value, this.storeKey);
     }
     link(propertyName) {
         const value = this.data[propertyName];
@@ -2091,6 +2100,8 @@ class GraphNode {
     }
     write(propertyName, value) {
         this.data[propertyName] = value;
+        const canonicalKey = this.store.getCanonicalRecordId(this.storeKey);
+        this.store.markVisited(canonicalKey);
     }
     isUndefined(propertyName) {
         return this.data[propertyName] === undefined;
@@ -3253,9 +3264,9 @@ class Environment {
         if (value === undefined) {
             return null;
         }
-        return this.wrapNormalizedGraphNode(value, store);
+        return this.wrapNormalizedGraphNode(value, key, store);
     }
-    wrapNormalizedGraphNode(normalized, storeOverride) {
+    wrapNormalizedGraphNode(normalized, key, storeOverride) {
         if (normalized === null) {
             return null;
         }
@@ -3263,7 +3274,7 @@ class Environment {
         if (isStoreRecordError$1(normalized)) {
             return new GraphNodeError(store, normalized);
         }
-        return new GraphNode(store, normalized);
+        return new GraphNode(store, normalized, key);
     }
     withContext(adapter, options) {
         const { contextId, onContextLoaded } = options;
@@ -3558,8 +3569,8 @@ class Luvio {
     getNode(key) {
         return this.environment.getNode(key);
     }
-    wrapNormalizedGraphNode(normalized) {
-        return this.environment.wrapNormalizedGraphNode(normalized);
+    wrapNormalizedGraphNode(normalized, key) {
+        return this.environment.wrapNormalizedGraphNode(normalized, key);
     }
     instrument(paramsBuilder) {
         const { instrument } = this.options;
@@ -3869,7 +3880,7 @@ function createResourceParamsImpl(config, configMetadata) {
     }
     return resourceParams;
 }
-// engine version: 0.146.0-dev4-c265089a
+// engine version: 0.146.0-dev5-a2ec6e3f
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -3996,7 +4007,7 @@ function withDefaultLuvio(callback) {
     }
     callbacks.push(callback);
 }
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901
 
 // TODO [TD-0081508]: once that TD is fulfilled we can probably change this file
 function instrumentAdapter$1(createFunction, _metadata) {
@@ -15457,7 +15468,7 @@ function gql(literals, ...subs) {
     }
     return superResult;
 }
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901
 
 function unwrap(data) {
     // The lwc-luvio bindings import a function from lwc called "unwrap".
@@ -16381,7 +16392,7 @@ function createGraphQLWireAdapterConstructor(luvio, adapter, metadata, astResolv
     const { apiFamily, name } = metadata;
     return createGraphQLWireAdapterConstructor$1(adapter, `${apiFamily}.${name}`, luvio, astResolver);
 }
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -16480,7 +16491,7 @@ var TypeCheckShapes;
     TypeCheckShapes[TypeCheckShapes["Integer"] = 3] = "Integer";
     TypeCheckShapes[TypeCheckShapes["Unsupported"] = 4] = "Unsupported";
 })(TypeCheckShapes || (TypeCheckShapes = {}));
-// engine version: 0.146.0-dev4-c265089a
+// engine version: 0.146.0-dev5-a2ec6e3f
 
 const { keys: ObjectKeys$3, create: ObjectCreate$3 } = Object;
 
@@ -19823,7 +19834,7 @@ function extractTrackedFieldsToTrie(recordId, node, root, config, visitedRecordI
                 extractTrackedFieldsToTrie(spanningLink.data.__ref, spanning, next, config, spanningVisitedRecordIds, depth + 1);
                 // For a spanning record that is detected to be a circular reference, we add the field along with Id and Name.
                 // It's possible for spanning record lookup fields to sometimes be circular, and sometimes not - depending on the value of the lookup field.
-                // For more information on scenarios that caused this fix: https://salesforce.quip.com/OvzNAh3eNIWY
+                // For more information on scenarios that caused this fix: search "LDS Recursive Spanning Fields Problem" in Quip
                 if (keys$a(next.children).length === 0) {
                     addScalarFieldId(next);
                     addScalarFieldName(next);
@@ -20008,22 +20019,12 @@ function _markMissingPath(record, path) {
     const fieldValueRepresentation = record.object('fields');
     const fieldName = path.shift();
     if (fieldValueRepresentation.isUndefined(fieldName) === true) {
-        // TODO [W-6900046]: remove cast, make RecordRepresentationNormalized['fields'] accept
-        // an undefined/non-present __ref if isMissing is present
-        fieldValueRepresentation.write(fieldName, {
-            __ref: undefined,
-            isMissing: true,
-        });
+        writeMissingFieldToStore(fieldValueRepresentation, fieldName);
         return;
     }
     const link = fieldValueRepresentation.link(fieldName);
     if (link.isPending()) {
-        // TODO [W-6900046]: remove cast, make RecordRepresentationNormalized['fields'] accept
-        // an undefined/non-present __ref if isMissing is present
-        fieldValueRepresentation.write(fieldName, {
-            __ref: undefined,
-            isMissing: true,
-        });
+        writeMissingFieldToStore(fieldValueRepresentation, fieldName);
     }
     else if (path.length > 0 && link.isMissing() === false) {
         const fieldValue = link.follow();
@@ -20039,6 +20040,19 @@ function _markMissingPath(record, path) {
         }
     }
 }
+/**
+ * Graph Node Directly modifies store entries, which is generally a non-starter.
+ * Until we can refactor this mess, you need to use this function to safely mark the RecordRepresentation
+ * as a seenId in the store when you perform this mutation.
+ */
+function writeMissingFieldToStore(field, fieldName) {
+    // TODO [W-6900046]: remove cast, make RecordRepresentationNormalized['fields'] accept
+    // an undefined/non-present __ref if isMissing is present
+    field.write(fieldName, {
+        __ref: undefined,
+        isMissing: true,
+    });
+}
 /**
  * Tells you if an objectApiName is supported by UI API or not.
  * Note: Luvio does not currently support all the entities, the list is limited to UI API supported entities
@@ -20170,8 +20184,11 @@ function mergeAndRefreshLowerVersionRecord(luvio, incoming, existing, incomingTr
     return existing;
 }
 function mergeRecordConflict(luvio, incoming, existing, recordConflictMap) {
-    const incomingNode = luvio.wrapNormalizedGraphNode(incoming);
-    const existingNode = luvio.wrapNormalizedGraphNode(existing);
+    const recordKey = keyBuilder$1U(luvio, {
+        recordId: incoming.id,
+    });
+    const incomingNode = luvio.wrapNormalizedGraphNode(incoming, recordKey);
+    const existingNode = luvio.wrapNormalizedGraphNode(existing, recordKey);
     const incomingTrackedFieldsTrieRoot = {
         name: incoming.apiName,
         children: {},
@@ -20180,9 +20197,6 @@ function mergeRecordConflict(luvio, incoming, existing, recordConflictMap) {
         name: existing.apiName,
         children: {},
     };
-    const recordKey = keyBuilder$1U(luvio, {
-        recordId: incoming.id,
-    });
     const trackedFieldsConfig = {
         maxDepth: configurationForRestAdapters$1.getTrackedFieldDepthOnCacheMergeConflict(),
         onlyFetchLeafNodeIdAndName: configurationForRestAdapters$1.getTrackedFieldLeafNodeIdAndNameOnly(),
@@ -25303,7 +25317,7 @@ const notifyChangeFactory = (luvio) => {
             const responsePromises = [];
             for (let i = 0, len = entries.length; i < len; i++) {
                 const { key, record } = entries[i];
-                const node = luvio.wrapNormalizedGraphNode(record);
+                const node = luvio.wrapNormalizedGraphNode(record, key);
                 const optionalFields = getTrackedFields(key, node, {
                     maxDepth: configurationForRestAdapters$1.getTrackedFieldDepthOnNotifyChange(),
                     onlyFetchLeafNodeIdAndName: configurationForRestAdapters$1.getTrackedFieldLeafNodeIdAndNameOnly(),
@@ -41201,7 +41215,16 @@ withDefaultLuvio((luvio) => {
     throttle(60, 60000, createLDSAdapter(luvio, 'notifyListInfoUpdateAvailable', notifyUpdateAvailableFactory$1));
     throttle(60, 60000, createLDSAdapter(luvio, 'notifyQuickActionDefaultsUpdateAvailable', notifyUpdateAvailableFactory));
 });
-// version: 1.229.0-dev7-22b616ee5
+// version: 1.229.0-dev9-939b09095
+
+var ldsIdempotencyWriteDisabled = {
+    isOpen: function (e) {
+        return e.fallback;
+    },
+    hasError: function () {
+        return !0;
+    },
+};
 
 var caseSensitiveUserId = '005B0000000GR4OIAW';
 
@@ -42419,12 +42442,12 @@ function makeDurable(environment, { durableStore, instrumentation }) {
         }
         return environment.getNode(key, ingestStagingStore);
     };
-    const wrapNormalizedGraphNode = function (normalized) {
+    const wrapNormalizedGraphNode = function (normalized, key) {
         validateNotDisposed();
         if (ingestStagingStore === null) {
             ingestStagingStore = buildIngestStagingStore(environment);
         }
-        return environment.wrapNormalizedGraphNode(normalized, ingestStagingStore);
+        return environment.wrapNormalizedGraphNode(normalized, key, ingestStagingStore);
     };
     const rebuildSnapshot = function (snapshot, onRebuild) {
         validateNotDisposed();
@@ -47216,7 +47239,12 @@ class AbstractResourceRequestActionHandler {
         // the luvio store redirect table, during which a new draft might be enqueued
         // which would not see a necessary mapping.
         this.ephemeralRedirects = {};
+        // determined by Server setup.
         this.isIdempotencySupported = true;
+        // idempotency write flag set by lds
+        this.isLdsIdempotencyWriteDisabled = ldsIdempotencyWriteDisabled.isOpen({
+            fallback: false,
+        });
     }
     enqueue(data) {
         return this.draftQueue.enqueue(this.handlerId, data);
@@ -47576,7 +47604,7 @@ class AbstractResourceRequestActionHandler {
         return [action.targetId];
     }
     hasIdempotencySupport() {
-        return this.isIdempotencySupported;
+        return this.isIdempotencySupported && !this.isLdsIdempotencyWriteDisabled;
     }
     async ingestResponses(responses, action) {
         const luvio = this.getLuvio();
@@ -53031,34 +53059,42 @@ function applyReferenceLinksToDraft(record, draftMetadata) {
         }
         const { dataType, relationshipName, referenceToInfos } = fieldInfo;
         const draftFieldValue = record.fields[draftField].value;
-        if (dataType === 'Reference' && relationshipName !== null && draftFieldValue !== null) {
-            if (typeof draftFieldValue !== 'string') {
-                throw Error('reference field value is not a string');
+        if (dataType === 'Reference' && relationshipName !== null) {
+            if (draftFieldValue === null) {
+                recordFields[relationshipName] = {
+                    displayValue: null,
+                    value: null,
+                };
             }
-            const key = getRecordKeyForId(luvio, draftFieldValue);
-            const referencedRecord = referencedRecords.get(key);
-            recordFields[relationshipName] = {
-                displayValue: null,
-                value: createLink$2(key),
-            };
-            // for custom objects, we select the 'Name' field
-            // otherwise we check the object info for name fields.
-            //if there are multiple we select 'Name' if it exists, otherwise the first one
-            if (referencedRecord !== undefined && referenceToInfos.length > 0) {
-                let nameField;
-                const referenceToInfo = referenceToInfos[0];
-                const nameFields = referenceToInfo.nameFields;
-                if (nameFields.length !== 0) {
-                    nameField = nameFields.find((x) => x === 'Name');
-                    if (nameField === undefined) {
-                        nameField = nameFields[0];
-                    }
+            else {
+                if (typeof draftFieldValue !== 'string') {
+                    throw Error('reference field value is not a string');
                 }
-                if (nameField !== undefined) {
-                    const nameFieldRef = referencedRecord.fields[nameField];
-                    if (nameFieldRef) {
-                        recordFields[relationshipName].displayValue =
-                            (_a = nameFieldRef.displayValue) !== null && _a !== void 0 ? _a : nameFieldRef.value;
+                const key = getRecordKeyForId(luvio, draftFieldValue);
+                const referencedRecord = referencedRecords.get(key);
+                recordFields[relationshipName] = {
+                    displayValue: null,
+                    value: createLink$2(key),
+                };
+                // for custom objects, we select the 'Name' field
+                // otherwise we check the object info for name fields.
+                //if there are multiple we select 'Name' if it exists, otherwise the first one
+                if (referencedRecord !== undefined && referenceToInfos.length > 0) {
+                    let nameField;
+                    const referenceToInfo = referenceToInfos[0];
+                    const nameFields = referenceToInfo.nameFields;
+                    if (nameFields.length !== 0) {
+                        nameField = nameFields.find((x) => x === 'Name');
+                        if (nameField === undefined) {
+                            nameField = nameFields[0];
+                        }
+                    }
+                    if (nameField !== undefined) {
+                        const nameFieldRef = referencedRecord.fields[nameField];
+                        if (nameFieldRef) {
+                            recordFields[relationshipName].displayValue =
+                                (_a = nameFieldRef.displayValue) !== null && _a !== void 0 ? _a : nameFieldRef.value;
+                        }
                     }
                 }
             }
@@ -53351,17 +53387,8 @@ class UiApiActionHandler extends AbstractResourceRequestActionHandler {
         };
         for (const fieldName of keys$3(recordWithSpanningRefLinks.fields)) {
             const fieldKey = buildRecordFieldStoreKey(key, fieldName);
-            if (this.collectedFields[fieldKey] !== undefined) {
-                const fieldData = recordWithSpanningRefLinks.fields[fieldName];
-                normalizedRecord.fields[fieldName] = { __ref: fieldKey };
-                publishData(fieldKey, fieldData);
-            }
-            else if (recordWithSpanningRefLinks.fields[fieldName] &&
-                recordWithSpanningRefLinks.fields[fieldName].value &&
-                recordWithSpanningRefLinks.fields[fieldName].value.__ref !== undefined) {
-                normalizedRecord.fields[fieldName] = { __ref: fieldKey };
-                publishData(fieldKey, recordWithSpanningRefLinks.fields[fieldName]);
-            }
+            normalizedRecord.fields[fieldName] = { __ref: fieldKey };
+            publishData(fieldKey, recordWithSpanningRefLinks.fields[fieldName]);
         }
         // publish the normalized record
         publishData(key, normalizedRecord);
@@ -58049,7 +58076,7 @@ register({
     id: '@salesforce/lds-network-adapter',
     instrument: instrument$1,
 });
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901
 
 const { create: create$2, keys: keys$2 } = Object;
 const { stringify: stringify$1, parse: parse$1 } = JSON;
@@ -76481,7 +76508,7 @@ register({
     configuration: { ...configurationForGraphQLAdapters },
     instrument,
 });
-// version: 1.229.0-dev7-22b616ee5
+// version: 1.229.0-dev9-939b09095
 
 // On core the unstable adapters are re-exported with different names,
 
@@ -78728,7 +78755,7 @@ withDefaultLuvio((luvio) => {
     unstable_graphQL_imperative = createImperativeAdapter(luvio, createInstrumentedAdapter(ldsAdapter, adapterMetadata), adapterMetadata);
     graphQLImperative = ldsAdapter;
 });
-// version: 1.229.0-dev7-22b616ee5
+// version: 1.229.0-dev9-939b09095
 
 var gqlApi = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -79442,4 +79469,4 @@ const { luvio } = getRuntime();
 setDefaultLuvio({ luvio });
 
 export { createPrimingSession, draftManager, draftQueue, executeAdapter, executeMutatingAdapter, getImperativeAdapterNames, invokeAdapter, invokeAdapterWithDraftToReplace, invokeAdapterWithMetadata, nimbusDraftQueue, registerReportObserver, setMetadataTTL, setUiApiRecordTTL, subscribeToAdapter };
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901

package/dist/standalone/umd/lds-worker-api.js

@@ -31,12 +31,15 @@
     const { isArray: isArray$9 } = Array;
     const { push: push$5, indexOf, slice: slice$2 } = Array.prototype;
     const { parse: parse$a, stringify: stringify$a } = JSON;
+    const WeakSetCtor = WeakSet;
 
+    const deeplyFrozen = new WeakSetCtor();
     function deepFreeze(value) {
-        // No need to freeze primitives
-        if (typeof value !== 'object' || value === null) {
+        // No need to freeze primitives or already frozen stuff
+        if (typeof value !== 'object' || value === null || deeplyFrozen.has(value)) {
             return;
         }
+        deeplyFrozen.add(value);
         if (isArray$9(value)) {
             for (let i = 0, len = value.length; i < len; i += 1) {
                 deepFreeze(value[i]);
@@ -1733,6 +1736,10 @@
             }
         }
         markVisited(canonicalKey) {
+            if (typeof canonicalKey === 'string') {
+                this.fallbackStringKeyInMemoryStore.markVisited(canonicalKey);
+                return;
+            }
             const { visitedIdsSet, reverseRedirectKeysMap } = this;
             let redirectKey = canonicalKey;
             // mark all redirects leading up to the canonical key as visited so
@@ -2044,7 +2051,7 @@
             if (isStoreRecordError$1(linked)) {
                 return new GraphNodeError(this.store, linked);
             }
-            return new GraphNode(this.store, linked);
+            return new GraphNode(this.store, linked, __ref);
         }
         linkData() {
             return this.data.data;
@@ -2054,10 +2061,11 @@
         }
     }
     class GraphNode {
-        constructor(store, data) {
+        constructor(store, data, storeKey) {
             this.type = GraphNodeType$1.Node;
             this.store = store;
             this.data = data;
+            this.storeKey = storeKey;
         }
         object(propertyName) {
             const value = this.data[propertyName];
@@ -2067,7 +2075,8 @@
             if (typeof value !== 'object' || value === null) {
                 throw new Error(`Cannot walk to path ${String(propertyName)}. "${String(propertyName)}" is a scalar: "${value}"`);
             }
-            return new GraphNode(this.store, value);
+            // We're walking to an object property on the current store record, pass the storeKey down.
+            return new GraphNode(this.store, value, this.storeKey);
         }
         link(propertyName) {
             const value = this.data[propertyName];
@@ -2097,6 +2106,8 @@
         }
         write(propertyName, value) {
             this.data[propertyName] = value;
+            const canonicalKey = this.store.getCanonicalRecordId(this.storeKey);
+            this.store.markVisited(canonicalKey);
         }
         isUndefined(propertyName) {
             return this.data[propertyName] === undefined;
@@ -3259,9 +3270,9 @@
             if (value === undefined) {
                 return null;
             }
-            return this.wrapNormalizedGraphNode(value, store);
+            return this.wrapNormalizedGraphNode(value, key, store);
         }
-        wrapNormalizedGraphNode(normalized, storeOverride) {
+        wrapNormalizedGraphNode(normalized, key, storeOverride) {
             if (normalized === null) {
                 return null;
             }
@@ -3269,7 +3280,7 @@
             if (isStoreRecordError$1(normalized)) {
                 return new GraphNodeError(store, normalized);
             }
-            return new GraphNode(store, normalized);
+            return new GraphNode(store, normalized, key);
         }
         withContext(adapter, options) {
             const { contextId, onContextLoaded } = options;
@@ -3564,8 +3575,8 @@
         getNode(key) {
             return this.environment.getNode(key);
         }
-        wrapNormalizedGraphNode(normalized) {
-            return this.environment.wrapNormalizedGraphNode(normalized);
+        wrapNormalizedGraphNode(normalized, key) {
+            return this.environment.wrapNormalizedGraphNode(normalized, key);
         }
         instrument(paramsBuilder) {
             const { instrument } = this.options;
@@ -3875,7 +3886,7 @@
         }
         return resourceParams;
     }
-    // engine version: 0.146.0-dev4-c265089a
+    // engine version: 0.146.0-dev5-a2ec6e3f
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -4002,7 +4013,7 @@
         }
         callbacks.push(callback);
     }
-    // version: 1.229.0-dev7-157e3a4db
+    // version: 1.229.0-dev9-dd96b5901
 
     // TODO [TD-0081508]: once that TD is fulfilled we can probably change this file
     function instrumentAdapter$1(createFunction, _metadata) {
@@ -15463,7 +15474,7 @@
         }
         return superResult;
     }
-    // version: 1.229.0-dev7-157e3a4db
+    // version: 1.229.0-dev9-dd96b5901
 
     function unwrap(data) {
         // The lwc-luvio bindings import a function from lwc called "unwrap".
@@ -16387,7 +16398,7 @@
         const { apiFamily, name } = metadata;
         return createGraphQLWireAdapterConstructor$1(adapter, `${apiFamily}.${name}`, luvio, astResolver);
     }
-    // version: 1.229.0-dev7-157e3a4db
+    // version: 1.229.0-dev9-dd96b5901
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -16486,7 +16497,7 @@
         TypeCheckShapes[TypeCheckShapes["Integer"] = 3] = "Integer";
         TypeCheckShapes[TypeCheckShapes["Unsupported"] = 4] = "Unsupported";
     })(TypeCheckShapes || (TypeCheckShapes = {}));
-    // engine version: 0.146.0-dev4-c265089a
+    // engine version: 0.146.0-dev5-a2ec6e3f
 
     const { keys: ObjectKeys$3, create: ObjectCreate$3 } = Object;
 
@@ -19829,7 +19840,7 @@
                     extractTrackedFieldsToTrie(spanningLink.data.__ref, spanning, next, config, spanningVisitedRecordIds, depth + 1);
                     // For a spanning record that is detected to be a circular reference, we add the field along with Id and Name.
                     // It's possible for spanning record lookup fields to sometimes be circular, and sometimes not - depending on the value of the lookup field.
-                    // For more information on scenarios that caused this fix: https://salesforce.quip.com/OvzNAh3eNIWY
+                    // For more information on scenarios that caused this fix: search "LDS Recursive Spanning Fields Problem" in Quip
                     if (keys$a(next.children).length === 0) {
                         addScalarFieldId(next);
                         addScalarFieldName(next);
@@ -20014,22 +20025,12 @@
         const fieldValueRepresentation = record.object('fields');
         const fieldName = path.shift();
         if (fieldValueRepresentation.isUndefined(fieldName) === true) {
-            // TODO [W-6900046]: remove cast, make RecordRepresentationNormalized['fields'] accept
-            // an undefined/non-present __ref if isMissing is present
-            fieldValueRepresentation.write(fieldName, {
-                __ref: undefined,
-                isMissing: true,
-            });
+            writeMissingFieldToStore(fieldValueRepresentation, fieldName);
             return;
         }
         const link = fieldValueRepresentation.link(fieldName);
         if (link.isPending()) {
-            // TODO [W-6900046]: remove cast, make RecordRepresentationNormalized['fields'] accept
-            // an undefined/non-present __ref if isMissing is present
-            fieldValueRepresentation.write(fieldName, {
-                __ref: undefined,
-                isMissing: true,
-            });
+            writeMissingFieldToStore(fieldValueRepresentation, fieldName);
         }
         else if (path.length > 0 && link.isMissing() === false) {
             const fieldValue = link.follow();
@@ -20045,6 +20046,19 @@
             }
         }
     }
+    /**
+     * Graph Node Directly modifies store entries, which is generally a non-starter.
+     * Until we can refactor this mess, you need to use this function to safely mark the RecordRepresentation
+     * as a seenId in the store when you perform this mutation.
+     */
+    function writeMissingFieldToStore(field, fieldName) {
+        // TODO [W-6900046]: remove cast, make RecordRepresentationNormalized['fields'] accept
+        // an undefined/non-present __ref if isMissing is present
+        field.write(fieldName, {
+            __ref: undefined,
+            isMissing: true,
+        });
+    }
     /**
      * Tells you if an objectApiName is supported by UI API or not.
      * Note: Luvio does not currently support all the entities, the list is limited to UI API supported entities
@@ -20176,8 +20190,11 @@
         return existing;
     }
     function mergeRecordConflict(luvio, incoming, existing, recordConflictMap) {
-        const incomingNode = luvio.wrapNormalizedGraphNode(incoming);
-        const existingNode = luvio.wrapNormalizedGraphNode(existing);
+        const recordKey = keyBuilder$1U(luvio, {
+            recordId: incoming.id,
+        });
+        const incomingNode = luvio.wrapNormalizedGraphNode(incoming, recordKey);
+        const existingNode = luvio.wrapNormalizedGraphNode(existing, recordKey);
         const incomingTrackedFieldsTrieRoot = {
             name: incoming.apiName,
             children: {},
@@ -20186,9 +20203,6 @@
             name: existing.apiName,
             children: {},
         };
-        const recordKey = keyBuilder$1U(luvio, {
-            recordId: incoming.id,
-        });
         const trackedFieldsConfig = {
             maxDepth: configurationForRestAdapters$1.getTrackedFieldDepthOnCacheMergeConflict(),
             onlyFetchLeafNodeIdAndName: configurationForRestAdapters$1.getTrackedFieldLeafNodeIdAndNameOnly(),
@@ -25309,7 +25323,7 @@
                 const responsePromises = [];
                 for (let i = 0, len = entries.length; i < len; i++) {
                     const { key, record } = entries[i];
-                    const node = luvio.wrapNormalizedGraphNode(record);
+                    const node = luvio.wrapNormalizedGraphNode(record, key);
                     const optionalFields = getTrackedFields(key, node, {
                         maxDepth: configurationForRestAdapters$1.getTrackedFieldDepthOnNotifyChange(),
                         onlyFetchLeafNodeIdAndName: configurationForRestAdapters$1.getTrackedFieldLeafNodeIdAndNameOnly(),
@@ -41207,7 +41221,16 @@
         throttle(60, 60000, createLDSAdapter(luvio, 'notifyListInfoUpdateAvailable', notifyUpdateAvailableFactory$1));
         throttle(60, 60000, createLDSAdapter(luvio, 'notifyQuickActionDefaultsUpdateAvailable', notifyUpdateAvailableFactory));
     });
-    // version: 1.229.0-dev7-22b616ee5
+    // version: 1.229.0-dev9-939b09095
+
+    var ldsIdempotencyWriteDisabled = {
+        isOpen: function (e) {
+            return e.fallback;
+        },
+        hasError: function () {
+            return !0;
+        },
+    };
 
     var caseSensitiveUserId = '005B0000000GR4OIAW';
 
@@ -42425,12 +42448,12 @@
             }
             return environment.getNode(key, ingestStagingStore);
         };
-        const wrapNormalizedGraphNode = function (normalized) {
+        const wrapNormalizedGraphNode = function (normalized, key) {
             validateNotDisposed();
             if (ingestStagingStore === null) {
                 ingestStagingStore = buildIngestStagingStore(environment);
             }
-            return environment.wrapNormalizedGraphNode(normalized, ingestStagingStore);
+            return environment.wrapNormalizedGraphNode(normalized, key, ingestStagingStore);
         };
         const rebuildSnapshot = function (snapshot, onRebuild) {
             validateNotDisposed();
@@ -47222,7 +47245,12 @@
             // the luvio store redirect table, during which a new draft might be enqueued
             // which would not see a necessary mapping.
             this.ephemeralRedirects = {};
+            // determined by Server setup.
             this.isIdempotencySupported = true;
+            // idempotency write flag set by lds
+            this.isLdsIdempotencyWriteDisabled = ldsIdempotencyWriteDisabled.isOpen({
+                fallback: false,
+            });
         }
         enqueue(data) {
             return this.draftQueue.enqueue(this.handlerId, data);
@@ -47582,7 +47610,7 @@
             return [action.targetId];
         }
         hasIdempotencySupport() {
-            return this.isIdempotencySupported;
+            return this.isIdempotencySupported && !this.isLdsIdempotencyWriteDisabled;
         }
         async ingestResponses(responses, action) {
             const luvio = this.getLuvio();
@@ -53037,34 +53065,42 @@
             }
             const { dataType, relationshipName, referenceToInfos } = fieldInfo;
             const draftFieldValue = record.fields[draftField].value;
-            if (dataType === 'Reference' && relationshipName !== null && draftFieldValue !== null) {
-                if (typeof draftFieldValue !== 'string') {
-                    throw Error('reference field value is not a string');
+            if (dataType === 'Reference' && relationshipName !== null) {
+                if (draftFieldValue === null) {
+                    recordFields[relationshipName] = {
+                        displayValue: null,
+                        value: null,
+                    };
                 }
-                const key = getRecordKeyForId(luvio, draftFieldValue);
-                const referencedRecord = referencedRecords.get(key);
-                recordFields[relationshipName] = {
-                    displayValue: null,
-                    value: createLink$2(key),
-                };
-                // for custom objects, we select the 'Name' field
-                // otherwise we check the object info for name fields.
-                //if there are multiple we select 'Name' if it exists, otherwise the first one
-                if (referencedRecord !== undefined && referenceToInfos.length > 0) {
-                    let nameField;
-                    const referenceToInfo = referenceToInfos[0];
-                    const nameFields = referenceToInfo.nameFields;
-                    if (nameFields.length !== 0) {
-                        nameField = nameFields.find((x) => x === 'Name');
-                        if (nameField === undefined) {
-                            nameField = nameFields[0];
-                        }
+                else {
+                    if (typeof draftFieldValue !== 'string') {
+                        throw Error('reference field value is not a string');
                     }
-                    if (nameField !== undefined) {
-                        const nameFieldRef = referencedRecord.fields[nameField];
-                        if (nameFieldRef) {
-                            recordFields[relationshipName].displayValue =
-                                (_a = nameFieldRef.displayValue) !== null && _a !== void 0 ? _a : nameFieldRef.value;
+                    const key = getRecordKeyForId(luvio, draftFieldValue);
+                    const referencedRecord = referencedRecords.get(key);
+                    recordFields[relationshipName] = {
+                        displayValue: null,
+                        value: createLink$2(key),
+                    };
+                    // for custom objects, we select the 'Name' field
+                    // otherwise we check the object info for name fields.
+                    //if there are multiple we select 'Name' if it exists, otherwise the first one
+                    if (referencedRecord !== undefined && referenceToInfos.length > 0) {
+                        let nameField;
+                        const referenceToInfo = referenceToInfos[0];
+                        const nameFields = referenceToInfo.nameFields;
+                        if (nameFields.length !== 0) {
+                            nameField = nameFields.find((x) => x === 'Name');
+                            if (nameField === undefined) {
+                                nameField = nameFields[0];
+                            }
+                        }
+                        if (nameField !== undefined) {
+                            const nameFieldRef = referencedRecord.fields[nameField];
+                            if (nameFieldRef) {
+                                recordFields[relationshipName].displayValue =
+                                    (_a = nameFieldRef.displayValue) !== null && _a !== void 0 ? _a : nameFieldRef.value;
+                            }
                         }
                     }
                 }
@@ -53357,17 +53393,8 @@
             };
             for (const fieldName of keys$3(recordWithSpanningRefLinks.fields)) {
                 const fieldKey = buildRecordFieldStoreKey(key, fieldName);
-                if (this.collectedFields[fieldKey] !== undefined) {
-                    const fieldData = recordWithSpanningRefLinks.fields[fieldName];
-                    normalizedRecord.fields[fieldName] = { __ref: fieldKey };
-                    publishData(fieldKey, fieldData);
-                }
-                else if (recordWithSpanningRefLinks.fields[fieldName] &&
-                    recordWithSpanningRefLinks.fields[fieldName].value &&
-                    recordWithSpanningRefLinks.fields[fieldName].value.__ref !== undefined) {
-                    normalizedRecord.fields[fieldName] = { __ref: fieldKey };
-                    publishData(fieldKey, recordWithSpanningRefLinks.fields[fieldName]);
-                }
+                normalizedRecord.fields[fieldName] = { __ref: fieldKey };
+                publishData(fieldKey, recordWithSpanningRefLinks.fields[fieldName]);
             }
             // publish the normalized record
             publishData(key, normalizedRecord);
@@ -58055,7 +58082,7 @@
         id: '@salesforce/lds-network-adapter',
         instrument: instrument$1,
     });
-    // version: 1.229.0-dev7-157e3a4db
+    // version: 1.229.0-dev9-dd96b5901
 
     const { create: create$2, keys: keys$2 } = Object;
     const { stringify: stringify$1, parse: parse$1 } = JSON;
@@ -76487,7 +76514,7 @@
         configuration: { ...configurationForGraphQLAdapters },
         instrument,
     });
-    // version: 1.229.0-dev7-22b616ee5
+    // version: 1.229.0-dev9-939b09095
 
     // On core the unstable adapters are re-exported with different names,
 
@@ -78734,7 +78761,7 @@
         unstable_graphQL_imperative = createImperativeAdapter(luvio, createInstrumentedAdapter(ldsAdapter, adapterMetadata), adapterMetadata);
         graphQLImperative = ldsAdapter;
     });
-    // version: 1.229.0-dev7-22b616ee5
+    // version: 1.229.0-dev9-939b09095
 
     var gqlApi = /*#__PURE__*/Object.freeze({
         __proto__: null,
@@ -79465,4 +79492,4 @@
     Object.defineProperty(exports, '__esModule', { value: true });
 
 }));
-// version: 1.229.0-dev7-157e3a4db
+// version: 1.229.0-dev9-dd96b5901

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-worker-api",
-    "version": "1.229.0-dev7",
+    "version": "1.229.0-dev9",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "",
     "main": "dist/standalone/es/lds-worker-api.js",
@@ -35,15 +35,15 @@
     },
     "devDependencies": {
         "@oat-sa/rollup-plugin-wildcard-external": "^1.0.0",
-        "@salesforce/lds-adapters-graphql": "1.229.0-dev7",
-        "@salesforce/lds-adapters-uiapi": "1.229.0-dev7",
-        "@salesforce/lds-default-luvio": "1.229.0-dev7",
-        "@salesforce/lds-drafts": "1.229.0-dev7",
-        "@salesforce/lds-graphql-parser": "1.229.0-dev7",
-        "@salesforce/lds-luvio-engine": "1.229.0-dev7",
-        "@salesforce/lds-priming": "1.229.0-dev7",
-        "@salesforce/lds-runtime-mobile": "1.229.0-dev7",
-        "@salesforce/nimbus-plugin-lds": "1.229.0-dev7",
+        "@salesforce/lds-adapters-graphql": "1.229.0-dev9",
+        "@salesforce/lds-adapters-uiapi": "1.229.0-dev9",
+        "@salesforce/lds-default-luvio": "1.229.0-dev9",
+        "@salesforce/lds-drafts": "1.229.0-dev9",
+        "@salesforce/lds-graphql-parser": "1.229.0-dev9",
+        "@salesforce/lds-luvio-engine": "1.229.0-dev9",
+        "@salesforce/lds-priming": "1.229.0-dev9",
+        "@salesforce/lds-runtime-mobile": "1.229.0-dev9",
+        "@salesforce/nimbus-plugin-lds": "1.229.0-dev9",
         "ajv": "^8.11.0",
         "glob": "^7.1.5",
         "nimbus-types": "^2.0.0-alpha1",