@salesforce/lds-worker-api 1.428.0-dev20 → 1.428.0-dev22

package/dist/sfdc/es/ldsWorkerApi.js

@@ -1371,4 +1371,4 @@ if (process.env.NODE_ENV !== 'production') {
 }
 
 export { createPrimingSession, draftManager, draftQueue, evictCacheRecordsByIds, evictExpiredCacheEntries, executeAdapter, executeMutatingAdapter, getImperativeAdapterNames, importLuvioAdapterModule, importOneStoreAdapterModule, invokeAdapter, invokeAdapterWithDraftToMerge, invokeAdapterWithDraftToReplace, invokeAdapterWithMetadata, nimbusDraftQueue, setMetadataTTL, setUiApiRecordTTL, stopEviction, subscribeToAdapter };
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317

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

@@ -4274,7 +4274,7 @@ function withDefaultLuvio(callback) {
     }
     callbacks.push(callback);
 }
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317
 
 // TODO [TD-0081508]: once that TD is fulfilled we can probably change this file
 function instrumentAdapter$1(createFunction, _metadata) {
@@ -5318,7 +5318,7 @@ function createGraphQLWireAdapterConstructor(luvio, adapter, metadata, astResolv
     const { apiFamily, name } = metadata;
     return createGraphQLWireAdapterConstructor$1(adapter, `${apiFamily}.${name}`, luvio, astResolver);
 }
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317
 
 function isSupportedEntity(_objectApiName) {
     return true;
@@ -32610,7 +32610,7 @@ withDefaultLuvio((luvio) => {
     throttle(60, 60000, setupNotifyAllListRecordUpdateAvailable(luvio));
     throttle(60, 60000, setupNotifyAllListInfoSummaryUpdateAvailable(luvio));
 });
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev22-bfcb919e66
 
 var draftQueueMaxRetryAttemptsGate = {
     isOpen: function (e) {
@@ -79751,6 +79751,10 @@ const DRAFT_QUEUE_ACTION_UPDATED = 'draft-queue-action-updated';
 const DRAFT_QUEUE_ACTION_FAILED = 'draft-queue-action-failed';
 const DRAFT_QUEUE_ACTION_UPLOAD_ERROR = 'draft-queue-action-upload-error';
 const DRAFT_QUEUE_TOTAL_MERGE_ACTIONS_CALLS = 'draft-queue-total-mergeActions-calls';
+// Emitted every time a draft's Idempotency-Key is rotated (replaced with a fresh uuid).
+// Used to triage the WOLI duplicate-record investigation in Splunk — correlate by draftId
+// with the other draft-queue events. @W-23428669
+const DRAFT_QUEUE_IDEMPOTENCY_KEY_ROTATED = 'draft-queue-idempotency-key-rotated';
 /** Content Document */
 const CREATE_CONTENT_DOCUMENT_AND_VERSION_TOTAL_SYNTHESIZE_CALLS = 'content-document-version-total-synthesize-calls';
 const CREATE_CONTENT_DOCUMENT_AND_VERSION_DRAFT_SYNTHESIZE_ERROR = 'create-content-document-version-draft-synthesize-error';
@@ -79866,6 +79870,34 @@ function reportDraftActionUploadError(error, handlerId, attempt) {
     });
     ldsMobileInstrumentation$2.error(normalized, DRAFT_QUEUE_ACTION_UPLOAD_ERROR);
 }
+/**
+ * Emits a single greppable Splunk log line (and an o11y counter) every time a draft's
+ * Idempotency-Key is rotated — i.e. replaced with a fresh uuid rather than reused on
+ * retry. This is the instrumentation for the WOLI duplicate-record investigation
+ * (@W-23428669): a rotation mid-flight is the mechanism by which an already-committed
+ * write can be re-sent under a new key and duplicated on the server, so recording every
+ * rotation lets us reconstruct, on a future reproduction, exactly where and how often a
+ * key changed for a given draft.
+ *
+ * The message is prefixed with a stable literal ("Idempotency key rotated") so it can be
+ * pulled out of Splunk with a substring match, and carries:
+ *   - draftId: the local (client-synthesized) draft-action target id, so this event can be
+ *     correlated with the other draft-queue events for the same draft. This is NOT a server
+ *     record id or any field value — it is the same local id already surfaced by the queue's
+ *     other lifecycle logs, so it introduces no new PII.
+ *   - reason: which rotation call site fired, to disambiguate the distinct rotation paths.
+ *
+ * @param draftId the local draft-action target id whose key was rotated
+ * @param reason  the rotation call site (see IdempotencyKeyRotationReason)
+ */
+function reportIdempotencyKeyRotated(draftId, reason) {
+    if (nimbusLogger) {
+        nimbusLogger.logInfo(`Idempotency key rotated: draftId=${draftId}, reason=${reason}`);
+    }
+    ldsMobileInstrumentation$2.incrementCounter(DRAFT_QUEUE_IDEMPOTENCY_KEY_ROTATED, 1, undefined, {
+        reason,
+    });
+}
 function reportDraftQueueState(state, draftCount) {
     if (nimbusLogger) {
         nimbusLogger.logInfo(`Draft state changed: ${state}, depth: ${draftCount}`);
@@ -80102,6 +80134,7 @@ class AbstractResourceRequestActionHandler {
                     // error (shouldRetry stays false). Retained as the default until the fix is
                     // enabled; this is the path that duplicated already-committed writes.
                     updatedAction.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                    reportIdempotencyKeyRotated(updatedAction.targetId, 'generic-400-killswitch');
                     actionDataChanged = true;
                 }
                 else if (!this.isServerGeneratedError(response.body)) {
@@ -80133,6 +80166,7 @@ class AbstractResourceRequestActionHandler {
                 if (this.hasIdempotencySupport() &&
                     updatedAction.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] !== undefined) {
                     updatedAction.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                    reportIdempotencyKeyRotated(updatedAction.targetId, 'backdating-collision');
                 }
                 shouldRetry = true;
                 actionDataChanged = true;
@@ -80426,6 +80460,7 @@ class AbstractResourceRequestActionHandler {
         // Updates Idempotency key if target has one
         if (targetData.headers && targetData.headers[HTTP_HEADER_IDEMPOTENCY_KEY]) {
             merged.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+            reportIdempotencyKeyRotated(merged.targetId, 'merge-actions');
         }
         // overlay metadata
         merged.metadata = { ...targetMetadata, ...sourceMetadata };
@@ -80455,6 +80490,7 @@ class AbstractResourceRequestActionHandler {
                 action.data.headers = action.data.headers || {};
                 if (updateIdempotencyKey) {
                     action.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                    reportIdempotencyKeyRotated(action.targetId, 'idempotency-error');
                 }
                 else {
                     delete action.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY];
@@ -94329,6 +94365,7 @@ class AuraNetworkCommand extends NetworkCommand$1 {
       storable: false
     };
     this.networkPreference = "aura";
+    this.additionalNullResponses = [];
   }
   get fetchParams() {
     throw new Error(
@@ -94365,14 +94402,37 @@ class AuraNetworkCommand extends NetworkCommand$1 {
       }
     });
   }
+  isSemanticNullResponse(response) {
+    return this.additionalNullResponses.includes(response.status);
+  }
+  isProtocolNoBodyStatus(status) {
+    return status === 204 || status === 205;
+  }
+  isUndeclaredNoBodyResponse(response) {
+    return this.isProtocolNoBodyStatus(response.status) && !this.isSemanticNullResponse(response);
+  }
   convertFetchResponseToData(response) {
     return response.then(
       (response2) => {
         if (response2.ok) {
-          return response2.json().then(
-            (json) => ok$1(json),
-            (reason) => err$1(toError(reason))
-          ).finally(() => {
+          let resultPromise;
+          if (this.isSemanticNullResponse(response2)) {
+            resultPromise = Promise.resolve(ok$1(null));
+          } else if (this.isUndeclaredNoBodyResponse(response2)) {
+            resultPromise = Promise.resolve(
+              err$1(
+                toError(
+                  `Unexpected ${response2.status} response: no-content status was not declared in the API specification. Declare this response in your OAS without a content property.`
+                )
+              )
+            );
+          } else {
+            resultPromise = response2.json().then(
+              (json) => ok$1(json),
+              (reason) => err$1(toError(reason))
+            );
+          }
+          return resultPromise.finally(() => {
             try {
               this.afterRequestHooks({ statusCode: response2.status });
             } catch {
@@ -96512,7 +96572,7 @@ function buildServiceDescriptor$b(luvio) {
         },
     };
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev22-bfcb919e66
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -96538,7 +96598,7 @@ function buildServiceDescriptor$a(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev22-bfcb919e66
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -99272,7 +99332,7 @@ register$1({
     id: '@salesforce/lds-network-adapter',
     instrument: instrument$2,
 });
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317
 
 const { create: create$2, keys: keys$2 } = Object;
 const { stringify, parse } = JSON;
@@ -107342,7 +107402,7 @@ function registerCallback(cb) {
         cb(graphql_v1_import, graphql_imperative$1, graphql_imperative_legacy_v1_import, graphql_state_manager, useOneStoreGraphQL);
     }
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev22-bfcb919e66
 
 function createFragmentMap(documentNode) {
     const fragments = {};
@@ -136615,7 +136675,7 @@ register$1({
     configuration: { ...configurationForGraphQLAdapters$1 },
     instrument: instrument$1,
 });
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev22-bfcb919e66
 
 // On core the unstable adapters are re-exported with different names,
 // we want to match them here.
@@ -136767,7 +136827,7 @@ withDefaultLuvio((luvio) => {
     unstable_graphQL_imperative = createImperativeAdapter(luvio, createInstrumentedAdapter(ldsAdapter, adapterMetadata), adapterMetadata);
     graphQLImperative = ldsAdapter;
 });
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev22-bfcb919e66
 
 var gqlApi = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -137566,7 +137626,7 @@ const callbacks$1 = [];
 function register(r) {
     callbacks$1.forEach((callback) => callback(r));
 }
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -138882,4 +138942,4 @@ const { luvio } = getRuntime();
 setDefaultLuvio({ luvio });
 
 export { createPrimingSession, draftManager, draftQueue, evictCacheRecordsByIds, evictExpiredCacheEntries, executeAdapter, executeMutatingAdapter, getImperativeAdapterNames, importLuvioAdapterModule, importOneStoreAdapterModule, invokeAdapter, invokeAdapterWithDraftToMerge, invokeAdapterWithDraftToReplace, invokeAdapterWithMetadata, nimbusDraftQueue, registerReportObserver, setMetadataTTL, setUiApiRecordTTL, stopEviction, subscribeToAdapter };
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317

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

@@ -4280,7 +4280,7 @@
         }
         callbacks.push(callback);
     }
-    // version: 1.428.0-dev20-1b319a0432
+    // version: 1.428.0-dev22-319313a317
 
     // TODO [TD-0081508]: once that TD is fulfilled we can probably change this file
     function instrumentAdapter$1(createFunction, _metadata) {
@@ -5324,7 +5324,7 @@
         const { apiFamily, name } = metadata;
         return createGraphQLWireAdapterConstructor$1(adapter, `${apiFamily}.${name}`, luvio, astResolver);
     }
-    // version: 1.428.0-dev20-1b319a0432
+    // version: 1.428.0-dev22-319313a317
 
     function isSupportedEntity(_objectApiName) {
         return true;
@@ -32616,7 +32616,7 @@
         throttle(60, 60000, setupNotifyAllListRecordUpdateAvailable(luvio));
         throttle(60, 60000, setupNotifyAllListInfoSummaryUpdateAvailable(luvio));
     });
-    // version: 1.428.0-dev20-d72ac06681
+    // version: 1.428.0-dev22-bfcb919e66
 
     var draftQueueMaxRetryAttemptsGate = {
         isOpen: function (e) {
@@ -79757,6 +79757,10 @@
     const DRAFT_QUEUE_ACTION_FAILED = 'draft-queue-action-failed';
     const DRAFT_QUEUE_ACTION_UPLOAD_ERROR = 'draft-queue-action-upload-error';
     const DRAFT_QUEUE_TOTAL_MERGE_ACTIONS_CALLS = 'draft-queue-total-mergeActions-calls';
+    // Emitted every time a draft's Idempotency-Key is rotated (replaced with a fresh uuid).
+    // Used to triage the WOLI duplicate-record investigation in Splunk — correlate by draftId
+    // with the other draft-queue events. @W-23428669
+    const DRAFT_QUEUE_IDEMPOTENCY_KEY_ROTATED = 'draft-queue-idempotency-key-rotated';
     /** Content Document */
     const CREATE_CONTENT_DOCUMENT_AND_VERSION_TOTAL_SYNTHESIZE_CALLS = 'content-document-version-total-synthesize-calls';
     const CREATE_CONTENT_DOCUMENT_AND_VERSION_DRAFT_SYNTHESIZE_ERROR = 'create-content-document-version-draft-synthesize-error';
@@ -79872,6 +79876,34 @@
         });
         ldsMobileInstrumentation$2.error(normalized, DRAFT_QUEUE_ACTION_UPLOAD_ERROR);
     }
+    /**
+     * Emits a single greppable Splunk log line (and an o11y counter) every time a draft's
+     * Idempotency-Key is rotated — i.e. replaced with a fresh uuid rather than reused on
+     * retry. This is the instrumentation for the WOLI duplicate-record investigation
+     * (@W-23428669): a rotation mid-flight is the mechanism by which an already-committed
+     * write can be re-sent under a new key and duplicated on the server, so recording every
+     * rotation lets us reconstruct, on a future reproduction, exactly where and how often a
+     * key changed for a given draft.
+     *
+     * The message is prefixed with a stable literal ("Idempotency key rotated") so it can be
+     * pulled out of Splunk with a substring match, and carries:
+     *   - draftId: the local (client-synthesized) draft-action target id, so this event can be
+     *     correlated with the other draft-queue events for the same draft. This is NOT a server
+     *     record id or any field value — it is the same local id already surfaced by the queue's
+     *     other lifecycle logs, so it introduces no new PII.
+     *   - reason: which rotation call site fired, to disambiguate the distinct rotation paths.
+     *
+     * @param draftId the local draft-action target id whose key was rotated
+     * @param reason  the rotation call site (see IdempotencyKeyRotationReason)
+     */
+    function reportIdempotencyKeyRotated(draftId, reason) {
+        if (nimbusLogger) {
+            nimbusLogger.logInfo(`Idempotency key rotated: draftId=${draftId}, reason=${reason}`);
+        }
+        ldsMobileInstrumentation$2.incrementCounter(DRAFT_QUEUE_IDEMPOTENCY_KEY_ROTATED, 1, undefined, {
+            reason,
+        });
+    }
     function reportDraftQueueState(state, draftCount) {
         if (nimbusLogger) {
             nimbusLogger.logInfo(`Draft state changed: ${state}, depth: ${draftCount}`);
@@ -80108,6 +80140,7 @@
                         // error (shouldRetry stays false). Retained as the default until the fix is
                         // enabled; this is the path that duplicated already-committed writes.
                         updatedAction.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                        reportIdempotencyKeyRotated(updatedAction.targetId, 'generic-400-killswitch');
                         actionDataChanged = true;
                     }
                     else if (!this.isServerGeneratedError(response.body)) {
@@ -80139,6 +80172,7 @@
                     if (this.hasIdempotencySupport() &&
                         updatedAction.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] !== undefined) {
                         updatedAction.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                        reportIdempotencyKeyRotated(updatedAction.targetId, 'backdating-collision');
                     }
                     shouldRetry = true;
                     actionDataChanged = true;
@@ -80432,6 +80466,7 @@
             // Updates Idempotency key if target has one
             if (targetData.headers && targetData.headers[HTTP_HEADER_IDEMPOTENCY_KEY]) {
                 merged.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                reportIdempotencyKeyRotated(merged.targetId, 'merge-actions');
             }
             // overlay metadata
             merged.metadata = { ...targetMetadata, ...sourceMetadata };
@@ -80461,6 +80496,7 @@
                     action.data.headers = action.data.headers || {};
                     if (updateIdempotencyKey) {
                         action.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY] = uuidv4();
+                        reportIdempotencyKeyRotated(action.targetId, 'idempotency-error');
                     }
                     else {
                         delete action.data.headers[HTTP_HEADER_IDEMPOTENCY_KEY];
@@ -94335,6 +94371,7 @@
           storable: false
         };
         this.networkPreference = "aura";
+        this.additionalNullResponses = [];
       }
       get fetchParams() {
         throw new Error(
@@ -94371,14 +94408,37 @@
           }
         });
       }
+      isSemanticNullResponse(response) {
+        return this.additionalNullResponses.includes(response.status);
+      }
+      isProtocolNoBodyStatus(status) {
+        return status === 204 || status === 205;
+      }
+      isUndeclaredNoBodyResponse(response) {
+        return this.isProtocolNoBodyStatus(response.status) && !this.isSemanticNullResponse(response);
+      }
       convertFetchResponseToData(response) {
         return response.then(
           (response2) => {
             if (response2.ok) {
-              return response2.json().then(
-                (json) => ok$1(json),
-                (reason) => err$1(toError(reason))
-              ).finally(() => {
+              let resultPromise;
+              if (this.isSemanticNullResponse(response2)) {
+                resultPromise = Promise.resolve(ok$1(null));
+              } else if (this.isUndeclaredNoBodyResponse(response2)) {
+                resultPromise = Promise.resolve(
+                  err$1(
+                    toError(
+                      `Unexpected ${response2.status} response: no-content status was not declared in the API specification. Declare this response in your OAS without a content property.`
+                    )
+                  )
+                );
+              } else {
+                resultPromise = response2.json().then(
+                  (json) => ok$1(json),
+                  (reason) => err$1(toError(reason))
+                );
+              }
+              return resultPromise.finally(() => {
                 try {
                   this.afterRequestHooks({ statusCode: response2.status });
                 } catch {
@@ -96518,7 +96578,7 @@
             },
         };
     }
-    // version: 1.428.0-dev20-d72ac06681
+    // version: 1.428.0-dev22-bfcb919e66
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -96544,7 +96604,7 @@
             },
         };
     }
-    // version: 1.428.0-dev20-d72ac06681
+    // version: 1.428.0-dev22-bfcb919e66
 
     /*!
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -99278,7 +99338,7 @@
         id: '@salesforce/lds-network-adapter',
         instrument: instrument$2,
     });
-    // version: 1.428.0-dev20-1b319a0432
+    // version: 1.428.0-dev22-319313a317
 
     const { create: create$2, keys: keys$2 } = Object;
     const { stringify, parse } = JSON;
@@ -107348,7 +107408,7 @@
             cb(graphql_v1_import, graphql_imperative$1, graphql_imperative_legacy_v1_import, graphql_state_manager, useOneStoreGraphQL);
         }
     }
-    // version: 1.428.0-dev20-d72ac06681
+    // version: 1.428.0-dev22-bfcb919e66
 
     function createFragmentMap(documentNode) {
         const fragments = {};
@@ -136621,7 +136681,7 @@
         configuration: { ...configurationForGraphQLAdapters$1 },
         instrument: instrument$1,
     });
-    // version: 1.428.0-dev20-d72ac06681
+    // version: 1.428.0-dev22-bfcb919e66
 
     // On core the unstable adapters are re-exported with different names,
     // we want to match them here.
@@ -136773,7 +136833,7 @@
         unstable_graphQL_imperative = createImperativeAdapter(luvio, createInstrumentedAdapter(ldsAdapter, adapterMetadata), adapterMetadata);
         graphQLImperative = ldsAdapter;
     });
-    // version: 1.428.0-dev20-d72ac06681
+    // version: 1.428.0-dev22-bfcb919e66
 
     var gqlApi = /*#__PURE__*/Object.freeze({
         __proto__: null,
@@ -137572,7 +137632,7 @@
     function register(r) {
         callbacks$1.forEach((callback) => callback(r));
     }
-    // version: 1.428.0-dev20-1b319a0432
+    // version: 1.428.0-dev22-319313a317
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -138909,4 +138969,4 @@
     exports.subscribeToAdapter = subscribeToAdapter;
 
 }));
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev22-319313a317

package/package.json

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