@salesforce/lds-runtime-mobile 1.428.0-dev14 → 1.428.0-dev15

package/dist/types/drafts/AbstractResourceRequestActionHandler.d.ts

@@ -25,6 +25,28 @@ export declare abstract class AbstractResourceRequestActionHandler<ResponseType>
     enqueue(data: ResourceRequest): Promise<PendingDraftAction<ResourceRequest>>;
     buildPendingAction(request: ResourceRequest, queue: DraftAction<unknown, unknown>[]): Promise<PendingDraftAction<ResourceRequest>>;
     handleAction(action: DraftAction<ResourceRequest, ResponseType>, actionCompleted: (action: CompletedDraftAction<ResourceRequest, ResponseType>) => Promise<void>, actionErrored: (action: DraftAction<ResourceRequest, ResponseType>, retry: boolean, retryDelayInMs?: number, actionDataChanged?: boolean) => Promise<void>): Promise<ProcessActionResult>;
+    /**
+     * Reads the persisted upload retry-attempt count from the action's durable metadata
+     * bag. The count lives in metadata (rather than in-memory) so it survives app
+     * restarts and queue re-creation — the failure modes that let the unbounded retry
+     * loop run for days.
+     */
+    private getUploadRetryCount;
+    /**
+     * Enforces the upload retry-attempt cap around the queue's `actionErrored` callback.
+     * Both retry paths — a retryable HTTP error and a thrown exception — funnel through
+     * here.
+     *
+     * The entire cap behavior is gated behind `lmr.draft-queue-max-retry-attempts`. When
+     * the gate is CLOSED this is a transparent passthrough: it issues the same
+     * `actionErrored(action, true, ...)` retry the queue made before this change, and
+     * writes no extra metadata. When the gate is OPEN it persists an incremented attempt
+     * count to the action's durable metadata and, once the action has failed
+     * {@link MAX_RETRY_ATTEMPTS} times, transitions it to Error (carrying a
+     * FetchResponse-shaped error that names the failure that exhausted the retries)
+     * instead of scheduling yet another retry.
+     */
+    private retryOrCap;
     handleActionEnqueued(action: PendingDraftAction<ResourceRequest>): Promise<void>;
     handleActionRemoved(action: DraftAction<ResourceRequest, ResponseType>): Promise<void>;
     handleActionReplaced(target: DraftAction<ResourceRequest, ResponseType>, source: DraftAction<ResourceRequest, ResponseType>): Promise<void>;

package/dist/types/drafts/utils/error.d.ts

@@ -1,4 +1,33 @@
+import type { FetchResponse } from '@luvio/engine';
 /**
  * This function takes an unknown error and normalizes it to an Error object
  */
 export declare function normalizeError(error: unknown): Error;
+/**
+ * Maximum number of times an action's upload will be retried before the action is
+ * transitioned to Error and surfaced to the consumer. Caps the otherwise-unbounded
+ * retry loop that can wedge the single-worker draft queue when an upload fails
+ * deterministically on every dispatch. Only enforced when the
+ * `lmr.draft-queue-max-retry-attempts` gate is open.
+ */
+export declare const MAX_RETRY_ATTEMPTS = 5;
+export declare const MAX_RETRY_ERROR_CODE = "MAX_RETRY_ATTEMPTS_EXCEEDED";
+/**
+ * The two things that can cause an upload attempt to fail and be retried:
+ *  - a non-ok `FetchResponse` returned by the network adapter (the HTTP error path), or
+ *  - an `Error` thrown out of the dispatch and caught by `handleAction` (the catch path;
+ *    the raw caught value is normalized to an `Error` before it reaches here).
+ * Either way the cause is concretely typed — it is never an opaque `unknown`.
+ */
+export type UploadFailure = FetchResponse<unknown> | Error;
+/**
+ * Builds the FetchResponse-shaped error attached to an action that has exhausted its
+ * upload retries. Shaped like a real network error response (status/statusText/ok/
+ * headers/body) so downstream consumers (DraftManager, queue instrumentation) that
+ * read `action.error.status`/`.body`/etc. behave consistently with a server error.
+ *
+ * The failure that caused the final attempt — a non-ok response (HTTP path) or a thrown
+ * error (catch path) — is folded into the body so the surfaced error says WHAT failed,
+ * not merely that the attempt cap was reached.
+ */
+export declare function buildMaxRetryError(lastFailure: UploadFailure): FetchResponse<unknown>;

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

@@ -10,6 +10,20 @@ export declare function reportGraphqlAdapterError(errorCode: string): void;
 export declare function reportGraphqlQueryInstrumentation(data: QueryInstrumentation): void;
 export declare function incrementGraphQLRefreshUndfined(): void;
 export declare function reportDraftActionEvent(state: 'added' | 'uploading' | 'completed' | 'deleted' | 'updated' | 'failed', draftCount: number, message?: string): void;
+/**
+ * Reports an exception thrown while uploading a draft action. The thrown error is
+ * otherwise swallowed by the upload handler's retry path, leaving the failure
+ * invisible in telemetry; this surfaces it to o11y (log + counter) so a deterministic
+ * upload failure can be diagnosed instead of silently retried forever.
+ *
+ * PII: the device log line carries only the handler id, retry attempt, and the error
+ * NAME (e.g. "TypeError") — never the free-text error message, which can embed record
+ * ids (URL path segments) or server field-validation strings. The full normalized error
+ * (message + stack) is handed only to `ldsMobileInstrumentation.error`, the structured
+ * o11y error pipeline responsible for scrubbing/handling that detail. Also does NOT log
+ * the action's targetId/tag or any request body/field values.
+ */
+export declare function reportDraftActionUploadError(error: unknown, handlerId: string, attempt: number): 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-dev14",
+    "version": "1.428.0-dev15",
     "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-dev14",
-        "@salesforce/lds-bindings": "^1.428.0-dev14",
-        "@salesforce/lds-instrumentation": "^1.428.0-dev14",
-        "@salesforce/lds-luvio-service": "^1.428.0-dev14",
-        "@salesforce/lds-luvio-uiapi-records-service": "^1.428.0-dev14",
+        "@salesforce/lds-adapters-uiapi": "^1.428.0-dev15",
+        "@salesforce/lds-bindings": "^1.428.0-dev15",
+        "@salesforce/lds-instrumentation": "^1.428.0-dev15",
+        "@salesforce/lds-luvio-service": "^1.428.0-dev15",
+        "@salesforce/lds-luvio-uiapi-records-service": "^1.428.0-dev15",
         "@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-dev14",
-        "@salesforce/lds-drafts": "^1.428.0-dev14",
-        "@salesforce/lds-durable-records": "^1.428.0-dev14",
-        "@salesforce/lds-network-adapter": "^1.428.0-dev14",
-        "@salesforce/lds-network-nimbus": "^1.428.0-dev14",
-        "@salesforce/lds-store-binary": "^1.428.0-dev14",
-        "@salesforce/lds-store-nimbus": "^1.428.0-dev14",
-        "@salesforce/lds-store-sql": "^1.428.0-dev14",
-        "@salesforce/lds-utils-adapters": "^1.428.0-dev14",
-        "@salesforce/nimbus-plugin-lds": "^1.428.0-dev14",
+        "@salesforce/lds-adapters-graphql": "^1.428.0-dev15",
+        "@salesforce/lds-drafts": "^1.428.0-dev15",
+        "@salesforce/lds-durable-records": "^1.428.0-dev15",
+        "@salesforce/lds-network-adapter": "^1.428.0-dev15",
+        "@salesforce/lds-network-nimbus": "^1.428.0-dev15",
+        "@salesforce/lds-store-binary": "^1.428.0-dev15",
+        "@salesforce/lds-store-nimbus": "^1.428.0-dev15",
+        "@salesforce/lds-store-sql": "^1.428.0-dev15",
+        "@salesforce/lds-utils-adapters": "^1.428.0-dev15",
+        "@salesforce/nimbus-plugin-lds": "^1.428.0-dev15",
         "babel-plugin-dynamic-import-node": "^2.3.3",
         "wait-for-expect": "^3.0.2"
     },
@@ -77,7 +77,7 @@
         {
             "path": "./dist/main.js",
             "maxSize": {
-                "none": "2.38 MB",
+                "none": "2.40 MB",
                 "min": "1000 kB",
                 "compressed": "250 kB"
             }
@@ -85,7 +85,7 @@
         {
             "path": "./sfdc/main.js",
             "maxSize": {
-                "none": "2.37 MB",
+                "none": "2.40 MB",
                 "min": "1000 kB",
                 "compressed": "250 kB"
             }