@salesforce/lds-runtime-mobile 1.428.0-dev20 → 1.428.0-dev21

package/dist/main.js

@@ -42261,6 +42261,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';
@@ -42376,6 +42380,34 @@ function reportDraftActionUploadError(error, handlerId, attempt) {
     });
     ldsMobileInstrumentation.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.incrementCounter(DRAFT_QUEUE_IDEMPOTENCY_KEY_ROTATED, 1, undefined, {
+        reason,
+    });
+}
 function reportDraftQueueState(state, draftCount) {
     if (nimbusLogger) {
         nimbusLogger.logInfo(`Draft state changed: ${state}, depth: ${draftCount}`);
@@ -42612,6 +42644,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)) {
@@ -42643,6 +42676,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;
@@ -42936,6 +42970,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 };
@@ -42965,6 +43000,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];
@@ -59188,7 +59224,7 @@ function buildServiceDescriptor$b(luvio) {
         },
     };
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev21-133a7da4f5
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -59214,7 +59250,7 @@ function buildServiceDescriptor$a(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev21-133a7da4f5
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -61951,4 +61987,4 @@ register({
 });
 
 export { O11Y_NAMESPACE_LDS_MOBILE, getRuntime, ingest$1o as ingestDenormalizedRecordRepresentation, initializeOneStore, registerReportObserver, reportGraphqlQueryParseError };
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev21-c9faba50c9

package/dist/types/instrumentation/metrics.d.ts

@@ -24,6 +24,28 @@ export declare function reportDraftActionEvent(state: 'added' | 'uploading' | 'c
  * the action's targetId/tag or any request body/field values.
  */
 export declare function reportDraftActionUploadError(error: unknown, handlerId: string, attempt: number): void;
+export type IdempotencyKeyRotationReason = 'idempotency-error' | 'backdating-collision' | 'merge-actions' | 'generic-400-killswitch';
+/**
+ * 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)
+ */
+export declare function reportIdempotencyKeyRotated(draftId: string, reason: IdempotencyKeyRotationReason): void;
 export declare function reportDraftQueueState(state: 'started' | 'error' | 'waiting' | 'stopped', draftCount: number): void;
 export declare function reportDraftAwareContentDocumentVersionSynthesizeError(err: unknown): void;
 export declare function reportDraftAwareContentVersionSynthesizeCalls(mimeType: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-runtime-mobile",
-    "version": "1.428.0-dev20",
+    "version": "1.428.0-dev21",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "LDS runtime for mobile/hybrid environments.",
     "main": "dist/main.js",
@@ -35,11 +35,11 @@
         "@conduit-client/service-bindings-imperative": "3.19.0-dev3",
         "@conduit-client/service-bindings-lwc": "3.19.0-dev3",
         "@conduit-client/service-provisioner": "3.19.0-dev3",
-        "@salesforce/lds-adapters-uiapi": "^1.428.0-dev20",
-        "@salesforce/lds-bindings": "^1.428.0-dev20",
-        "@salesforce/lds-instrumentation": "^1.428.0-dev20",
-        "@salesforce/lds-luvio-service": "^1.428.0-dev20",
-        "@salesforce/lds-luvio-uiapi-records-service": "^1.428.0-dev20",
+        "@salesforce/lds-adapters-uiapi": "^1.428.0-dev21",
+        "@salesforce/lds-bindings": "^1.428.0-dev21",
+        "@salesforce/lds-instrumentation": "^1.428.0-dev21",
+        "@salesforce/lds-luvio-service": "^1.428.0-dev21",
+        "@salesforce/lds-luvio-uiapi-records-service": "^1.428.0-dev21",
         "@salesforce/user": "0.0.21",
         "o11y": "250.7.0",
         "o11y_schema": "256.126.0"
@@ -60,16 +60,16 @@
         "@conduit-client/service-pubsub": "3.19.0-dev3",
         "@conduit-client/service-store": "3.19.0-dev3",
         "@conduit-client/utils": "3.19.0-dev3",
-        "@salesforce/lds-adapters-graphql": "^1.428.0-dev20",
-        "@salesforce/lds-drafts": "^1.428.0-dev20",
-        "@salesforce/lds-durable-records": "^1.428.0-dev20",
-        "@salesforce/lds-network-adapter": "^1.428.0-dev20",
-        "@salesforce/lds-network-nimbus": "^1.428.0-dev20",
-        "@salesforce/lds-store-binary": "^1.428.0-dev20",
-        "@salesforce/lds-store-nimbus": "^1.428.0-dev20",
-        "@salesforce/lds-store-sql": "^1.428.0-dev20",
-        "@salesforce/lds-utils-adapters": "^1.428.0-dev20",
-        "@salesforce/nimbus-plugin-lds": "^1.428.0-dev20",
+        "@salesforce/lds-adapters-graphql": "^1.428.0-dev21",
+        "@salesforce/lds-drafts": "^1.428.0-dev21",
+        "@salesforce/lds-durable-records": "^1.428.0-dev21",
+        "@salesforce/lds-network-adapter": "^1.428.0-dev21",
+        "@salesforce/lds-network-nimbus": "^1.428.0-dev21",
+        "@salesforce/lds-store-binary": "^1.428.0-dev21",
+        "@salesforce/lds-store-nimbus": "^1.428.0-dev21",
+        "@salesforce/lds-store-sql": "^1.428.0-dev21",
+        "@salesforce/lds-utils-adapters": "^1.428.0-dev21",
+        "@salesforce/nimbus-plugin-lds": "^1.428.0-dev21",
         "babel-plugin-dynamic-import-node": "^2.3.3",
         "wait-for-expect": "^3.0.2"
     },

package/sfdc/main.js

@@ -42261,6 +42261,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';
@@ -42376,6 +42380,34 @@ function reportDraftActionUploadError(error, handlerId, attempt) {
     });
     ldsMobileInstrumentation.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.incrementCounter(DRAFT_QUEUE_IDEMPOTENCY_KEY_ROTATED, 1, undefined, {
+        reason,
+    });
+}
 function reportDraftQueueState(state, draftCount) {
     if (nimbusLogger) {
         nimbusLogger.logInfo(`Draft state changed: ${state}, depth: ${draftCount}`);
@@ -42612,6 +42644,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)) {
@@ -42643,6 +42676,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;
@@ -42936,6 +42970,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 };
@@ -42965,6 +43000,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];
@@ -59188,7 +59224,7 @@ function buildServiceDescriptor$b(luvio) {
         },
     };
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev21-133a7da4f5
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -59214,7 +59250,7 @@ function buildServiceDescriptor$a(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.428.0-dev20-d72ac06681
+// version: 1.428.0-dev21-133a7da4f5
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -61951,4 +61987,4 @@ register({
 });
 
 export { O11Y_NAMESPACE_LDS_MOBILE, getRuntime, ingest$1o as ingestDenormalizedRecordRepresentation, initializeOneStore, registerReportObserver, reportGraphqlQueryParseError };
-// version: 1.428.0-dev20-1b319a0432
+// version: 1.428.0-dev21-c9faba50c9

package/sfdc/types/instrumentation/metrics.d.ts

@@ -24,6 +24,28 @@ export declare function reportDraftActionEvent(state: 'added' | 'uploading' | 'c
  * the action's targetId/tag or any request body/field values.
  */
 export declare function reportDraftActionUploadError(error: unknown, handlerId: string, attempt: number): void;
+export type IdempotencyKeyRotationReason = 'idempotency-error' | 'backdating-collision' | 'merge-actions' | 'generic-400-killswitch';
+/**
+ * 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)
+ */
+export declare function reportIdempotencyKeyRotated(draftId: string, reason: IdempotencyKeyRotationReason): void;
 export declare function reportDraftQueueState(state: 'started' | 'error' | 'waiting' | 'stopped', draftCount: number): void;
 export declare function reportDraftAwareContentDocumentVersionSynthesizeError(err: unknown): void;
 export declare function reportDraftAwareContentVersionSynthesizeCalls(mimeType: string): void;