@zeniai/client-epic-state 5.0.75 → 5.0.77-betaAD01

package/lib/view/aiCfoView/epics/updateChatSessionPinEpic.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateChatSessionPinEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const aiCfoReducer_1 = require("../../../entity/aiCfo/aiCfoReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const aiCfoViewReducer_1 = require("../aiCfoViewReducer");
+/**
+ * TEMP (remove after chat platform pin API is deployed everywhere):
+ * When PUT pin/unpin fails, still merge requested pin state so the drawer/navbar UX works
+ * against older backends. Revert this file when the platform supports pin or when dropping
+ * compatibility — search for `TEMP_PIN_OPTIMISTIC`.
+ */
+function buildOptimisticPinPayload_TEMP_PIN_OPTIMISTIC(state, chatSessionId, isPinned) {
+    const session = state.aiCfoState.aiCfoByChatSessionId[chatSessionId]?.chatSession;
+    if (session == null) {
+        return null;
+    }
+    return {
+        chat_session_id: chatSessionId,
+        user_id: session.userId,
+        created_at: session.createdAt.toISOString(),
+        chat_session_summary: session.chatSessionSummary ?? null,
+        is_pinned: isPinned,
+        pinned_at: isPinned ? new Date().toISOString() : null,
+    };
+}
+const updateChatSessionPinEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(aiCfoViewReducer_1.updateChatSessionPin.match), (0, operators_1.switchMap)((action) => {
+    const { chatSessionId, isPinned } = action.payload;
+    return zeniAPI
+        .putAndGetJSON(`${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/sessions/${chatSessionId}`, { is_pinned: isPinned })
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, aiCfoReducer_1.mergeChatSessionFromPutResponse)(response.data));
+        }
+        // TEMP_PIN_OPTIMISTIC — see comment above
+        const synthetic = buildOptimisticPinPayload_TEMP_PIN_OPTIMISTIC(state$.value, chatSessionId, isPinned);
+        return synthetic != null
+            ? (0, rxjs_1.of)((0, aiCfoReducer_1.mergeChatSessionFromPutResponse)(synthetic))
+            : rxjs_1.EMPTY;
+    }), (0, operators_1.catchError)(() => {
+        // TEMP_PIN_OPTIMISTIC — see comment above
+        const synthetic = buildOptimisticPinPayload_TEMP_PIN_OPTIMISTIC(state$.value, chatSessionId, isPinned);
+        return synthetic != null
+            ? (0, rxjs_1.of)((0, aiCfoReducer_1.mergeChatSessionFromPutResponse)(synthetic))
+            : rxjs_1.EMPTY;
+    }));
+}));
+exports.updateChatSessionPinEpic = updateChatSessionPinEpic;

package/lib/view/expenseAutomationView/epics/missingReceipts/fetchMultipleBatchDetailsEpic.js

@@ -35,10 +35,19 @@ function fetchBatchDetailsByIds(batchIds, zeniAPI) {
 }
 const fetchMultipleBatchDetailsEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.fetchBulkUploadBatchesSuccess.match), (0, operators_1.mergeMap)((action) => {
     const batchList = action.payload.batchList;
-    const { batchDetailsById } = state$.value.expenseAutomationMissingReceiptsViewState.bulkUpload;
+    const bulkUpload = state$.value.expenseAutomationMissingReceiptsViewState.bulkUpload;
+    const { batchDetailsById, batchDetailsRevalidating } = bulkUpload;
     /** Only completed list rows may trigger batch-details API; preserve platform order. */
-    const completedBatchesMissingDetails = (0, missingReceiptsPayload_1.filterBatchListItemsForBatchDetailsFetch)(batchList).filter((batch) => batchDetailsById[batch.batchId] == null);
-    const completedBatchIds = completedBatchesMissingDetails.map((batch) => batch.batchId);
+    const completedRows = (0, missingReceiptsPayload_1.filterBatchListItemsForBatchDetailsFetch)(batchList);
+    /**
+     * Stale-while-revalidate: when a manual refresh has set `batchDetailsRevalidating`, refresh
+     * every completed list row (replacing entries via `storeBatchDetails` as they arrive). On a
+     * normal first fetch we still only request rows whose details are missing.
+     */
+    const candidateRows = batchDetailsRevalidating === true
+        ? completedRows
+        : completedRows.filter((batch) => batchDetailsById[batch.batchId] == null);
+    const completedBatchIds = candidateRows.map((batch) => batch.batchId);
     const batchIdsToFetch = completedBatchIds.slice(0, INITIAL_BATCH_PAGE_SIZE);
     if (batchIdsToFetch.length === 0) {
         /**
@@ -46,7 +55,6 @@ const fetchMultipleBatchDetailsEpic = (actions$, state$, zeniAPI) => actions$.pi
          * `currentBatchId` may not appear in the filtered list but still needs `GET /batches/:id`.
          * Fall back to the single-batch-details epic so `phase` and details can resolve.
          */
-        const bulkUpload = state$.value.expenseAutomationMissingReceiptsViewState.bulkUpload;
         const currentId = bulkUpload.currentBatchId;
         if (currentId != null &&
             bulkUpload.phase === 'matching' &&
@@ -54,7 +62,15 @@ const fetchMultipleBatchDetailsEpic = (actions$, state$, zeniAPI) => actions$.pi
             (0, missingReceiptsPayload_1.shouldFetchBatchDetailsForBatchId)(bulkUpload.batchStatusById, bulkUpload.batchListByPeriod, currentId)) {
             return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.fetchBulkUploadBatchDetails)());
         }
-        return rxjs_1.EMPTY;
+        /**
+         * Close the pagination loop so the Unmatched-tab loading heuristic can settle.
+         * `fetchMoreBatchDetailsComplete` also clears `batchDetailsRevalidating` and flips
+         * `initialBatchDetailsLoaded` to true. Without this, `batchDetailsPaginationState` stays
+         * at `Not-Started` forever after a list refresh that finds zero completed rows (or all
+         * already cached) — the direct-open-Unmatched-without-upload path used to render an
+         * infinite skeleton.
+         */
+        return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.fetchMoreBatchDetailsComplete)());
     }
     return (0, rxjs_1.concat)((0, rxjs_1.of)((0, missingReceiptsViewReducer_1.setInitialBatchDetailsLoading)()), fetchBatchDetailsByIds(batchIdsToFetch, zeniAPI), (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.fetchMoreBatchDetailsComplete)()));
 }));

package/lib/view/expenseAutomationView/epics/missingReceipts/refreshBatchDetailsForBatchIdEpic.d.ts

@@ -0,0 +1,18 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateTransactions } from '../../../../entity/transaction/transactionReducer';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { batchDetailFetchFailed, markBatchDetailRefreshAttempted, refreshBatchDetailsForBatchId, storeBatchDetails } from '../../reducers/missingReceiptsViewReducer';
+export type ActionType = ReturnType<typeof refreshBatchDetailsForBatchId> | ReturnType<typeof markBatchDetailRefreshAttempted> | ReturnType<typeof updateTransactions> | ReturnType<typeof storeBatchDetails> | ReturnType<typeof batchDetailFetchFailed>;
+/**
+ * Single-batch stale-while-revalidate refresh. Triggered by `pusherBatchStatusCompletionEpic`
+ * (and any other path that wants to update one batch without wiping the cache). The response is
+ * stored via `storeBatchDetails`, which replaces the entry by `batchId` so the row updates in
+ * place — no skeleton, no list reflow.
+ *
+ * Throttle: `lastBatchDetailRefreshAtById[batchId]` is checked against `TARGETED_REFRESH_DEDUPE_MS`
+ * before issuing the call. The marker is emitted first so concurrent dispatches (e.g. Pusher
+ * resend during an in-flight request) see the dedupe timestamp and collapse to a single call.
+ */
+export declare const refreshBatchDetailsForBatchIdEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/expenseAutomationView/epics/missingReceipts/refreshBatchDetailsForBatchIdEpic.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshBatchDetailsForBatchIdEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const transactionReducer_1 = require("../../../../entity/transaction/transactionReducer");
+const responsePayload_1 = require("../../../../responsePayload");
+const missingReceiptsPayload_1 = require("../../payload/missingReceiptsPayload");
+const missingReceiptsViewReducer_1 = require("../../reducers/missingReceiptsViewReducer");
+/**
+ * Pusher resends the same `completed` event in some cases (reconnect, server retry). Skip a
+ * targeted refresh if we issued one for the same batch within this window — the cached details
+ * are already fresh, so another `GET /1.0/batches/:id` is wasteful and visually flickers nothing.
+ */
+const TARGETED_REFRESH_DEDUPE_MS = 5000;
+/**
+ * Single-batch stale-while-revalidate refresh. Triggered by `pusherBatchStatusCompletionEpic`
+ * (and any other path that wants to update one batch without wiping the cache). The response is
+ * stored via `storeBatchDetails`, which replaces the entry by `batchId` so the row updates in
+ * place — no skeleton, no list reflow.
+ *
+ * Throttle: `lastBatchDetailRefreshAtById[batchId]` is checked against `TARGETED_REFRESH_DEDUPE_MS`
+ * before issuing the call. The marker is emitted first so concurrent dispatches (e.g. Pusher
+ * resend during an in-flight request) see the dedupe timestamp and collapse to a single call.
+ */
+const refreshBatchDetailsForBatchIdEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.refreshBatchDetailsForBatchId.match), (0, operators_1.mergeMap)((action) => {
+    const { batchId } = action.payload;
+    const now = Date.now();
+    const lastAttempt = state$.value.expenseAutomationMissingReceiptsViewState.bulkUpload
+        .lastBatchDetailRefreshAtById[batchId];
+    if (lastAttempt != null &&
+        now - lastAttempt < TARGETED_REFRESH_DEDUPE_MS) {
+        return rxjs_1.EMPTY;
+    }
+    const apiCall = zeniAPI
+        .getJSON(`${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}/1.0/batches/${batchId}`)
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if (!(0, responsePayload_1.isSuccessResponse)(response) ||
+            response.data == null ||
+            !(0, missingReceiptsPayload_1.isBatchDetailsApiStatusCompleted)(response.data.status)) {
+            return rxjs_1.EMPTY;
+        }
+        const actions = [];
+        const transactionPayloads = (0, missingReceiptsPayload_1.extractTransactionPayloadsFromBatchFiles)(response.data.files);
+        if (transactionPayloads.length > 0) {
+            actions.push((0, transactionReducer_1.updateTransactions)(transactionPayloads, (value) => value.transaction_id));
+        }
+        actions.push((0, missingReceiptsViewReducer_1.storeBatchDetails)((0, missingReceiptsPayload_1.toBatchDetails)(response.data, zeniAPI.apiEndPoints.fileMicroServiceBaseUrl)));
+        return (0, rxjs_1.from)(actions);
+    }), (0, operators_1.catchError)((error) => {
+        console.error(`Failed to refresh batch details for ${batchId}:`, (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Refresh batch details errored out: ' + JSON.stringify(error)));
+        return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.batchDetailFetchFailed)({ batchId }));
+    }));
+    return (0, rxjs_1.concat)((0, rxjs_1.of)((0, missingReceiptsViewReducer_1.markBatchDetailRefreshAttempted)({ batchId, timestamp: now })), apiCall);
+}));
+exports.refreshBatchDetailsForBatchIdEpic = refreshBatchDetailsForBatchIdEpic;

package/lib/view/expenseAutomationView/epics/missingReceipts/syncTabsAfterAutomatchEpic.d.ts

@@ -0,0 +1,28 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../reducer';
+import { bulkUploadReceiptsSuccess, clearBulkUpload, fetchBulkUploadBatchDetailsSuccess, fetchCompletedTransactions, fetchMissingReceipts, restoreBulkUploadMatchingState, storeBatchDetails } from '../../reducers/missingReceiptsViewReducer';
+export type ActionType = ReturnType<typeof bulkUploadReceiptsSuccess> | ReturnType<typeof restoreBulkUploadMatchingState> | ReturnType<typeof fetchBulkUploadBatchDetailsSuccess> | ReturnType<typeof storeBatchDetails> | ReturnType<typeof clearBulkUpload> | ReturnType<typeof fetchMissingReceipts> | ReturnType<typeof fetchCompletedTransactions>;
+/**
+ * After automatch completes for the active bulk-upload batch, refresh the two
+ * caches that are not invalidated by the existing batch-details refresh path:
+ *   - Missing Receipts list (`transactionIdsBySelectedPeriod`)
+ *   - Completed transactions cache (`bulkUpload.completedTransactionsByPeriod`)
+ *
+ * The Unmatched tab is already kept fresh via `pusherBatchStatusCompletionEpic`
+ * dispatching `fetchBulkUploadBatches({invalidateBatchDetailsCache: true})`,
+ * which feeds `fetchMultipleBatchDetailsEpic` and re-stores batch details.
+ *
+ * Lifecycle mirrors `bulkUploadMatchResultToastEpic`: trigger on
+ * `bulkUploadReceiptsSuccess` (fresh upload) or `restoreBulkUploadMatchingState`
+ * (restored session), then wait for the first batch-details action for that
+ * batchId — landing as either `fetchBulkUploadBatchDetailsSuccess` or
+ * `storeBatchDetails`. `clearBulkUpload` cancels the in-flight wait.
+ *
+ * Refetches use `cacheOverride: true` to bypass per-tab cache guards, and
+ * `fetchMissingReceipts` uses `refreshViewInBackground: true` to keep the
+ * existing rows visible while fresh data is in flight (the authoritative
+ * server filter `is_attachment_missing_only=true` removes matched rows once
+ * the response lands).
+ */
+export declare const syncTabsAfterAutomatchEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

package/lib/view/expenseAutomationView/epics/missingReceipts/syncTabsAfterAutomatchEpic.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncTabsAfterAutomatchEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const timePeriod_1 = require("../../../../commonStateTypes/timePeriod");
+const tenantSelector_1 = require("../../../../entity/tenant/tenantSelector");
+const missingReceiptsViewReducer_1 = require("../../reducers/missingReceiptsViewReducer");
+/**
+ * After automatch completes for the active bulk-upload batch, refresh the two
+ * caches that are not invalidated by the existing batch-details refresh path:
+ *   - Missing Receipts list (`transactionIdsBySelectedPeriod`)
+ *   - Completed transactions cache (`bulkUpload.completedTransactionsByPeriod`)
+ *
+ * The Unmatched tab is already kept fresh via `pusherBatchStatusCompletionEpic`
+ * dispatching `fetchBulkUploadBatches({invalidateBatchDetailsCache: true})`,
+ * which feeds `fetchMultipleBatchDetailsEpic` and re-stores batch details.
+ *
+ * Lifecycle mirrors `bulkUploadMatchResultToastEpic`: trigger on
+ * `bulkUploadReceiptsSuccess` (fresh upload) or `restoreBulkUploadMatchingState`
+ * (restored session), then wait for the first batch-details action for that
+ * batchId — landing as either `fetchBulkUploadBatchDetailsSuccess` or
+ * `storeBatchDetails`. `clearBulkUpload` cancels the in-flight wait.
+ *
+ * Refetches use `cacheOverride: true` to bypass per-tab cache guards, and
+ * `fetchMissingReceipts` uses `refreshViewInBackground: true` to keep the
+ * existing rows visible while fresh data is in flight (the authoritative
+ * server filter `is_attachment_missing_only=true` removes matched rows once
+ * the response lands).
+ */
+const syncTabsAfterAutomatchEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)((action) => missingReceiptsViewReducer_1.bulkUploadReceiptsSuccess.match(action) ||
+    missingReceiptsViewReducer_1.restoreBulkUploadMatchingState.match(action)), (0, operators_1.switchMap)((uploadAction) => {
+    const { batchId } = uploadAction.payload;
+    return (0, rxjs_1.merge)(actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.fetchBulkUploadBatchDetailsSuccess.match)), actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.storeBatchDetails.match))).pipe((0, operators_1.filter)((a) => a.payload.batchId === batchId), (0, operators_1.take)(1), (0, operators_1.switchMap)((action) => {
+        const { summary } = action.payload;
+        if (summary.matched <= 0) {
+            return rxjs_1.EMPTY;
+        }
+        const state = state$.value;
+        const currentTenant = (0, tenantSelector_1.getCurrentTenant)(state);
+        if (currentTenant == null) {
+            return rxjs_1.EMPTY;
+        }
+        const selectedPeriod = state.expenseAutomationViewState.selectedPeriodByTenantId[currentTenant.tenantId];
+        if (selectedPeriod == null) {
+            return (0, rxjs_1.from)([(0, missingReceiptsViewReducer_1.fetchCompletedTransactions)(undefined, true)]);
+        }
+        const period = (0, timePeriod_1.convertToPeriod)(selectedPeriod);
+        const timePeriodStart = (0, timePeriod_1.toAbsoluteDay)(period.start);
+        const timePeriodEnd = (0, timePeriod_1.toAbsoluteDay)(period.end);
+        if (timePeriodStart == null || timePeriodEnd == null) {
+            return (0, rxjs_1.from)([(0, missingReceiptsViewReducer_1.fetchCompletedTransactions)(undefined, true)]);
+        }
+        return (0, rxjs_1.from)([
+            (0, missingReceiptsViewReducer_1.fetchMissingReceipts)({ start: timePeriodStart, end: timePeriodEnd }, { amount: 75.0, currencyCode: 'USD', currencySymbol: '$' }, true, true),
+            (0, missingReceiptsViewReducer_1.fetchCompletedTransactions)(undefined, true),
+        ]);
+    }), (0, operators_1.takeUntil)(actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.clearBulkUpload.match))));
+}));
+exports.syncTabsAfterAutomatchEpic = syncTabsAfterAutomatchEpic;

package/lib/view/expenseAutomationView/epics/missingReceipts/watchBulkUploadBatchStatusEpic.d.ts

@@ -4,13 +4,19 @@ import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { updateTransactions } from '../../../../entity/transaction/transactionReducer';
 import { RootState } from '../../../../reducer';
 import { ZeniAPI } from '../../../../zeniAPI';
-import { bulkUploadAutomatchingTimedOut, bulkUploadReceiptsSuccess, clearBulkUpload, fetchBulkUploadBatchDetails, fetchBulkUploadBatchDetailsSuccess, fetchBulkUploadBatches, pusherBatchStatusUpdate, restoreBulkUploadMatchingState } from '../../reducers/missingReceiptsViewReducer';
-export type ActionType = ReturnType<typeof bulkUploadReceiptsSuccess> | ReturnType<typeof restoreBulkUploadMatchingState> | ReturnType<typeof pusherBatchStatusUpdate> | ReturnType<typeof fetchBulkUploadBatchDetails> | ReturnType<typeof fetchBulkUploadBatchDetailsSuccess> | ReturnType<typeof fetchBulkUploadBatches> | ReturnType<typeof updateTransactions> | ReturnType<typeof clearBulkUpload> | ReturnType<typeof openSnackbar> | ReturnType<typeof bulkUploadAutomatchingTimedOut>;
+import { bulkUploadAutomatchingTimedOut, bulkUploadReceiptsSuccess, clearBulkUpload, fetchBulkUploadBatchDetails, fetchBulkUploadBatchDetailsSuccess, fetchBulkUploadBatches, pusherBatchStatusUpdate, refreshBatchDetailsForBatchId, restoreBulkUploadMatchingState } from '../../reducers/missingReceiptsViewReducer';
+export type ActionType = ReturnType<typeof bulkUploadReceiptsSuccess> | ReturnType<typeof restoreBulkUploadMatchingState> | ReturnType<typeof pusherBatchStatusUpdate> | ReturnType<typeof fetchBulkUploadBatchDetails> | ReturnType<typeof fetchBulkUploadBatchDetailsSuccess> | ReturnType<typeof fetchBulkUploadBatches> | ReturnType<typeof refreshBatchDetailsForBatchId> | ReturnType<typeof updateTransactions> | ReturnType<typeof clearBulkUpload> | ReturnType<typeof openSnackbar> | ReturnType<typeof bulkUploadAutomatchingTimedOut>;
 /**
- * On Pusher batch completion: refresh batch list (then fetchMultipleBatchDetailsEpic runs).
- * Debounced to reduce duplicate refreshes. The post-match tab decision
- * (Unmatched vs Completed) is made client-side in `ExpenseAutomationPage` once fresh
+ * On Pusher batch completion: refresh the batch list (so summary counts update) and dispatch a
+ * targeted single-batch details refresh for the batch that just completed. Stale-while-revalidate:
+ * we no longer pass `invalidateBatchDetailsCache: true` — existing `batchDetailsById` entries stay
+ * on screen and the just-completed row replaces in place via `storeBatchDetails`. The post-match
+ * tab decision (Unmatched vs Completed) is made client-side in `ExpenseAutomationPage` once fresh
  * batch details land -- do not dispatch `requestMissingReceiptsTabNavigation` here.
+ *
+ * Pusher resend storms (same batch completing twice within the dedupe window) are throttled in
+ * `refreshBatchDetailsForBatchIdEpic` via `lastBatchDetailRefreshAtById`, so this epic stays
+ * stateless and just forwards the event.
  */
 export declare const pusherBatchStatusCompletionEpic: (actions$: ActionsObservable<ActionType>) => Observable<ActionType>;
 /**

package/lib/view/expenseAutomationView/epics/missingReceipts/watchBulkUploadBatchStatusEpic.js

@@ -15,16 +15,20 @@ const FALLBACK_FIRST_DELAY_MS = 30000;
 const RESTORE_FIRST_DELAY_MS = 5000;
 const FALLBACK_POLL_INTERVAL_MS = 10000;
 /**
- * On Pusher batch completion: refresh batch list (then fetchMultipleBatchDetailsEpic runs).
- * Debounced to reduce duplicate refreshes. The post-match tab decision
- * (Unmatched vs Completed) is made client-side in `ExpenseAutomationPage` once fresh
+ * On Pusher batch completion: refresh the batch list (so summary counts update) and dispatch a
+ * targeted single-batch details refresh for the batch that just completed. Stale-while-revalidate:
+ * we no longer pass `invalidateBatchDetailsCache: true` — existing `batchDetailsById` entries stay
+ * on screen and the just-completed row replaces in place via `storeBatchDetails`. The post-match
+ * tab decision (Unmatched vs Completed) is made client-side in `ExpenseAutomationPage` once fresh
  * batch details land -- do not dispatch `requestMissingReceiptsTabNavigation` here.
+ *
+ * Pusher resend storms (same batch completing twice within the dedupe window) are throttled in
+ * `refreshBatchDetailsForBatchIdEpic` via `lastBatchDetailRefreshAtById`, so this epic stays
+ * stateless and just forwards the event.
  */
-const pusherBatchStatusCompletionEpic = (actions$) => actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.pusherBatchStatusUpdate.match), (0, operators_1.filter)((action) => action.payload.status === 'completed'), (0, operators_1.debounceTime)(300), (0, operators_1.mergeMap)(() => (0, rxjs_1.from)([
-    (0, missingReceiptsViewReducer_1.fetchBulkUploadBatches)({
-        cacheOverride: true,
-        invalidateBatchDetailsCache: true,
-    }),
+const pusherBatchStatusCompletionEpic = (actions$) => actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.pusherBatchStatusUpdate.match), (0, operators_1.filter)((action) => action.payload.status === 'completed'), (0, operators_1.debounceTime)(300), (0, operators_1.mergeMap)((action) => (0, rxjs_1.from)([
+    (0, missingReceiptsViewReducer_1.fetchBulkUploadBatches)({ cacheOverride: true }),
+    (0, missingReceiptsViewReducer_1.refreshBatchDetailsForBatchId)({ batchId: action.payload.batchId }),
 ])));
 exports.pusherBatchStatusCompletionEpic = pusherBatchStatusCompletionEpic;
 /**

package/lib/view/expenseAutomationView/reducers/missingReceiptsViewReducer.d.ts

@@ -19,6 +19,15 @@ export declare const fetchBulkUploadBatchDetails: import("@reduxjs/toolkit").Act
  * after a hard refresh. The epic owns the list + details API calls end-to-end.
  */
 export declare const restoreBulkUploadAutomatchingOnMount: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/restoreBulkUploadAutomatchingOnMount">;
+/**
+ * Epic trigger only. Targeted stale-while-revalidate refresh for a single batch's details — used
+ * by `pusherBatchStatusCompletionEpic` so a Pusher 'completed' event re-fetches only that one
+ * batch instead of wiping the entire `batchDetailsById` cache. The epic dedupes via
+ * `lastBatchDetailRefreshAtById` so resend storms don't trigger waves of API calls.
+ */
+export declare const refreshBatchDetailsForBatchId: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    batchId: ID;
+}, string>;
 export declare const fetchMissingReceipts: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[period: TimePeriod, minimumTransactionAmount: Amount, cacheOverride?: any, refreshViewInBackground?: any], {
     period: TimePeriod;
     minimumTransactionAmount: Amount;
@@ -73,7 +82,10 @@ export declare const fetchMissingReceipts: import("@reduxjs/toolkit").ActionCrea
 }, "expenseAutomationMissingReceiptsView/fetchBulkUploadBatchesSuccess">, fetchBulkUploadBatchesFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     error: ZeniAPIStatus;
     selectedPeriod: MonthYearPeriod;
-}, "expenseAutomationMissingReceiptsView/fetchBulkUploadBatchesFailure">, confirmBulkUploadMatch: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[batchId: string, attachmentId: string, transactionId: string, transactionType: string, fileName: string], {
+}, "expenseAutomationMissingReceiptsView/fetchBulkUploadBatchesFailure">, clearBulkUploadBatchDetailsForScopeChange: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/clearBulkUploadBatchDetailsForScopeChange">, markBatchDetailRefreshAttempted: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    batchId: ID;
+    timestamp: number;
+}, "expenseAutomationMissingReceiptsView/markBatchDetailRefreshAttempted">, confirmBulkUploadMatch: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[batchId: string, attachmentId: string, transactionId: string, transactionType: string, fileName: string], {
     batchId: string;
     attachmentId: string;
     transactionId: string;

package/lib/view/expenseAutomationView/reducers/missingReceiptsViewReducer.js

@@ -1,7 +1,8 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchCompletedTransactionsFailure = exports.fetchCompletedTransactionsSuccess = exports.fetchCompletedTransactions = exports.acknowledgeBulkUploadConfirmMatchComplete = exports.clearManualSearchResults = exports.searchTransactionsForManualMatchFailure = exports.searchTransactionsForManualMatchSuccess = exports.searchTransactionsForManualMatch = exports.clearBulkUpload = exports.setBulkUploadSortConfig = exports.setBulkUploadCompletedSubTab = exports.setBulkUploadResultsTab = exports.confirmBulkUploadMatchFailure = exports.confirmBulkUploadMatchSuccess = exports.confirmBulkUploadMatch = exports.fetchBulkUploadBatchesFailure = exports.fetchBulkUploadBatchesSuccess = exports.fetchBulkUploadBatches = exports.fetchMoreBatchDetailsFailure = exports.fetchMoreBatchDetailsComplete = exports.fetchMoreBatchDetails = exports.setInitialBatchDetailsLoading = exports.batchDetailFetchFailed = exports.storeBatchDetails = exports.fetchBulkUploadBatchDetailsFailure = exports.fetchBulkUploadBatchDetailsSuccess = exports.clearMissingReceiptsTabNavigation = exports.requestMissingReceiptsTabNavigation = exports.pusherBatchStatusUpdate = exports.bulkUploadAutomatchingTimedOut = exports.restoreBulkUploadMatchingState = exports.bulkUploadReceiptsFailure = exports.bulkUploadReceiptsSuccess = exports.setBulkUploadUploadedFileCount = exports.updateBulkUploadProgress = exports.bulkUploadReceipts = exports.clearExpenseAutomationMissingReceiptsView = exports.markMissingReceiptAsDone = exports.updateMissingReceiptsUIState = exports.updateMissingReceiptUploadState = exports.uploadMissingReceiptSuccess = exports.fetchMissingReceiptsFailure = exports.fetchMissingReceiptsSuccess = exports.fetchMissingReceipts = exports.restoreBulkUploadAutomatchingOnMount = exports.fetchBulkUploadBatchDetails = exports.initialState = exports.initialBulkUploadState = exports.getCompletedTransactionsCacheKey = void 0;
+exports.fetchCompletedTransactions = exports.acknowledgeBulkUploadConfirmMatchComplete = exports.clearManualSearchResults = exports.searchTransactionsForManualMatchFailure = exports.searchTransactionsForManualMatchSuccess = exports.searchTransactionsForManualMatch = exports.clearBulkUpload = exports.setBulkUploadSortConfig = exports.setBulkUploadCompletedSubTab = exports.setBulkUploadResultsTab = exports.confirmBulkUploadMatchFailure = exports.confirmBulkUploadMatchSuccess = exports.confirmBulkUploadMatch = exports.markBatchDetailRefreshAttempted = exports.clearBulkUploadBatchDetailsForScopeChange = exports.fetchBulkUploadBatchesFailure = exports.fetchBulkUploadBatchesSuccess = exports.fetchBulkUploadBatches = exports.fetchMoreBatchDetailsFailure = exports.fetchMoreBatchDetailsComplete = exports.fetchMoreBatchDetails = exports.setInitialBatchDetailsLoading = exports.batchDetailFetchFailed = exports.storeBatchDetails = exports.fetchBulkUploadBatchDetailsFailure = exports.fetchBulkUploadBatchDetailsSuccess = exports.clearMissingReceiptsTabNavigation = exports.requestMissingReceiptsTabNavigation = exports.pusherBatchStatusUpdate = exports.bulkUploadAutomatchingTimedOut = exports.restoreBulkUploadMatchingState = exports.bulkUploadReceiptsFailure = exports.bulkUploadReceiptsSuccess = exports.setBulkUploadUploadedFileCount = exports.updateBulkUploadProgress = exports.bulkUploadReceipts = exports.clearExpenseAutomationMissingReceiptsView = exports.markMissingReceiptAsDone = exports.updateMissingReceiptsUIState = exports.updateMissingReceiptUploadState = exports.uploadMissingReceiptSuccess = exports.fetchMissingReceiptsFailure = exports.fetchMissingReceiptsSuccess = exports.fetchMissingReceipts = exports.refreshBatchDetailsForBatchId = exports.restoreBulkUploadAutomatchingOnMount = exports.fetchBulkUploadBatchDetails = exports.initialState = exports.initialBulkUploadState = exports.getCompletedTransactionsCacheKey = void 0;
+exports.fetchCompletedTransactionsFailure = exports.fetchCompletedTransactionsSuccess = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const timePeriod_1 = require("../../../commonStateTypes/timePeriod");
 const completedSubTab_1 = require("../types/completedSubTab");
@@ -15,6 +16,7 @@ exports.getCompletedTransactionsCacheKey = getCompletedTransactionsCacheKey;
 exports.initialBulkUploadState = {
     batchDetailsById: {},
     batchDetailsPaginationState: { fetchState: 'Not-Started', error: undefined },
+    batchDetailsRevalidating: false,
     batchListByPeriod: {},
     batchListFetchState: { fetchState: 'Not-Started', error: undefined },
     batchStatusById: {},
@@ -24,6 +26,8 @@ exports.initialBulkUploadState = {
     currentBatchId: undefined,
     currentResultsTab: 'unmatched',
     failedBatchDetailIds: [],
+    initialBatchDetailsLoaded: false,
+    lastBatchDetailRefreshAtById: {},
     manualSearchUiResetKey: 0,
     manualSearch: {
         fetchState: { fetchState: 'Not-Started', error: undefined },
@@ -70,6 +74,13 @@ exports.fetchBulkUploadBatchDetails = (0, toolkit_1.createAction)('expenseAutoma
  * after a hard refresh. The epic owns the list + details API calls end-to-end.
  */
 exports.restoreBulkUploadAutomatchingOnMount = (0, toolkit_1.createAction)('expenseAutomationMissingReceiptsView/restoreBulkUploadAutomatchingOnMount');
+/**
+ * Epic trigger only. Targeted stale-while-revalidate refresh for a single batch's details — used
+ * by `pusherBatchStatusCompletionEpic` so a Pusher 'completed' event re-fetches only that one
+ * batch instead of wiping the entire `batchDetailsById` cache. The epic dedupes via
+ * `lastBatchDetailRefreshAtById` so resend storms don't trigger waves of API calls.
+ */
+exports.refreshBatchDetailsForBatchId = (0, toolkit_1.createAction)('expenseAutomationMissingReceiptsView/refreshBatchDetailsForBatchId');
 const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
     name: 'expenseAutomationMissingReceiptsView',
     initialState: exports.initialState,
@@ -256,6 +267,16 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
             const details = action.payload;
             draft.bulkUpload.batchDetailsById[details.batchId] = details;
             draft.bulkUpload.phase = 'completed';
+            draft.bulkUpload.initialBatchDetailsLoaded = true;
+            /**
+             * A successful detail load supersedes any previous failure for this batch — without this,
+             * `getPrimaryBatchIdFromBatchListOrder` (and pagination) would keep skipping the batch
+             * across the recovery, hiding now-valid Unmatched-tab work.
+             */
+            const failedIndex = draft.bulkUpload.failedBatchDetailIds.indexOf(details.batchId);
+            if (failedIndex >= 0) {
+                draft.bulkUpload.failedBatchDetailIds.splice(failedIndex, 1);
+            }
         },
         fetchBulkUploadBatchDetailsFailure: {
             reducer(draft) {
@@ -277,6 +298,19 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 draft.bulkUpload.currentBatchId === details.batchId) {
                 draft.bulkUpload.phase = 'completed';
             }
+            /** Stale-while-revalidate: any successful detail load means we have rendered data. */
+            draft.bulkUpload.initialBatchDetailsLoaded = true;
+            /**
+             * Stale-while-revalidate recovery: if this batch had previously failed, a successful
+             * targeted refresh (Pusher `completed` → `refreshBatchDetailsForBatchIdEpic`) or
+             * multi-batch revalidation (manual refresh) supersedes the failure. Selectors that gate
+             * on `failedBatchDetailIds` (primary-batch resolution, `hasMoreBatchDetails`) must see the
+             * batch as recovered so it can show fresh Unmatched work.
+             */
+            const failedIndex = draft.bulkUpload.failedBatchDetailIds.indexOf(details.batchId);
+            if (failedIndex >= 0) {
+                draft.bulkUpload.failedBatchDetailIds.splice(failedIndex, 1);
+            }
         },
         batchDetailFetchFailed(draft, action) {
             const { batchId } = action.payload;
@@ -305,6 +339,14 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 fetchState: 'Completed',
                 error: undefined,
             };
+            /**
+             * Stale-while-revalidate: a completed pagination round means the initial page (or a
+             * subsequent revalidation) has fully resolved. Once `initialBatchDetailsLoaded` flips to
+             * `true` it stays `true` for the session — only `clearBulkUpload` /
+             * `clearBulkUploadBatchDetailsForScopeChange` can reset it.
+             */
+            draft.bulkUpload.initialBatchDetailsLoaded = true;
+            draft.bulkUpload.batchDetailsRevalidating = false;
             const currentId = draft.bulkUpload.currentBatchId;
             const currentDetails = currentId != null
                 ? draft.bulkUpload.batchDetailsById[currentId]
@@ -320,12 +362,24 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 fetchState: 'Error',
                 error: action.payload.error,
             };
+            draft.bulkUpload.batchDetailsRevalidating = false;
         },
         fetchBulkUploadBatches: {
             reducer(draft, action) {
+                /**
+                 * Manual refresh button (and any other caller passing `invalidateBatchDetailsCache: true`):
+                 * wipe the details cache, failed-id list, and pagination state so the Unmatched tab drops
+                 * its existing rows and re-renders the initial-load skeleton while the next list +
+                 * details fetches resolve. The post-success epic (`fetchMultipleBatchDetailsEpic`) then
+                 * re-runs the details chain from a clean slate.
+                 */
                 if (action.payload.invalidateBatchDetailsCache === true) {
                     draft.bulkUpload.batchDetailsById = {};
                     draft.bulkUpload.failedBatchDetailIds = [];
+                    draft.bulkUpload.batchDetailsPaginationState = {
+                        fetchState: 'Not-Started',
+                        error: undefined,
+                    };
                 }
                 draft.bulkUpload.batchListFetchState = {
                     fetchState: 'In-Progress',
@@ -342,6 +396,31 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 };
             },
         },
+        /**
+         * Tenant/period scope change — the new scope's data is genuinely unknown so the existing
+         * details cache and `initialBatchDetailsLoaded` flag must be reset (the Unmatched skeleton
+         * is acceptable on scope change). Distinct from a stale-while-revalidate refresh.
+         */
+        clearBulkUploadBatchDetailsForScopeChange(draft) {
+            draft.bulkUpload.batchDetailsById = {};
+            draft.bulkUpload.failedBatchDetailIds = [];
+            draft.bulkUpload.batchDetailsPaginationState = {
+                fetchState: 'Not-Started',
+                error: undefined,
+            };
+            draft.bulkUpload.batchDetailsRevalidating = false;
+            draft.bulkUpload.initialBatchDetailsLoaded = false;
+            draft.bulkUpload.lastBatchDetailRefreshAtById = {};
+        },
+        /**
+         * Records the last time we issued a targeted refresh for `batchId`. Set by
+         * `refreshBatchDetailsForBatchIdEpic` before each API call so subsequent Pusher resends in the
+         * dedupe window are skipped.
+         */
+        markBatchDetailRefreshAttempted(draft, action) {
+            draft.bulkUpload.lastBatchDetailRefreshAtById[action.payload.batchId] =
+                action.payload.timestamp;
+        },
         fetchBulkUploadBatchesSuccess(draft, action) {
             const periodId = (0, timePeriod_1.toMonthYearPeriodId)(action.payload.selectedPeriod);
             draft.bulkUpload.batchListByPeriod[periodId] = action.payload.batchList;
@@ -584,7 +663,7 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
 });
 _a = expenseAutomationMissingReceiptsView.actions, exports.fetchMissingReceipts = _a.fetchMissingReceipts, exports.fetchMissingReceiptsSuccess = _a.fetchMissingReceiptsSuccess, exports.fetchMissingReceiptsFailure = _a.fetchMissingReceiptsFailure, exports.uploadMissingReceiptSuccess = _a.uploadMissingReceiptSuccess, exports.updateMissingReceiptUploadState = _a.updateMissingReceiptUploadState, exports.updateMissingReceiptsUIState = _a.updateMissingReceiptsUIState, exports.markMissingReceiptAsDone = _a.markMissingReceiptAsDone, exports.clearExpenseAutomationMissingReceiptsView = _a.clearExpenseAutomationMissingReceiptsView, 
 // Bulk Upload
-exports.bulkUploadReceipts = _a.bulkUploadReceipts, exports.updateBulkUploadProgress = _a.updateBulkUploadProgress, exports.setBulkUploadUploadedFileCount = _a.setBulkUploadUploadedFileCount, exports.bulkUploadReceiptsSuccess = _a.bulkUploadReceiptsSuccess, exports.bulkUploadReceiptsFailure = _a.bulkUploadReceiptsFailure, exports.restoreBulkUploadMatchingState = _a.restoreBulkUploadMatchingState, exports.bulkUploadAutomatchingTimedOut = _a.bulkUploadAutomatchingTimedOut, exports.pusherBatchStatusUpdate = _a.pusherBatchStatusUpdate, exports.requestMissingReceiptsTabNavigation = _a.requestMissingReceiptsTabNavigation, exports.clearMissingReceiptsTabNavigation = _a.clearMissingReceiptsTabNavigation, exports.fetchBulkUploadBatchDetailsSuccess = _a.fetchBulkUploadBatchDetailsSuccess, exports.fetchBulkUploadBatchDetailsFailure = _a.fetchBulkUploadBatchDetailsFailure, exports.storeBatchDetails = _a.storeBatchDetails, exports.batchDetailFetchFailed = _a.batchDetailFetchFailed, exports.setInitialBatchDetailsLoading = _a.setInitialBatchDetailsLoading, exports.fetchMoreBatchDetails = _a.fetchMoreBatchDetails, exports.fetchMoreBatchDetailsComplete = _a.fetchMoreBatchDetailsComplete, exports.fetchMoreBatchDetailsFailure = _a.fetchMoreBatchDetailsFailure, exports.fetchBulkUploadBatches = _a.fetchBulkUploadBatches, exports.fetchBulkUploadBatchesSuccess = _a.fetchBulkUploadBatchesSuccess, exports.fetchBulkUploadBatchesFailure = _a.fetchBulkUploadBatchesFailure, exports.confirmBulkUploadMatch = _a.confirmBulkUploadMatch, exports.confirmBulkUploadMatchSuccess = _a.confirmBulkUploadMatchSuccess, exports.confirmBulkUploadMatchFailure = _a.confirmBulkUploadMatchFailure, exports.setBulkUploadResultsTab = _a.setBulkUploadResultsTab, exports.setBulkUploadCompletedSubTab = _a.setBulkUploadCompletedSubTab, exports.setBulkUploadSortConfig = _a.setBulkUploadSortConfig, exports.clearBulkUpload = _a.clearBulkUpload, exports.searchTransactionsForManualMatch = _a.searchTransactionsForManualMatch, exports.searchTransactionsForManualMatchSuccess = _a.searchTransactionsForManualMatchSuccess, exports.searchTransactionsForManualMatchFailure = _a.searchTransactionsForManualMatchFailure, exports.clearManualSearchResults = _a.clearManualSearchResults, exports.acknowledgeBulkUploadConfirmMatchComplete = _a.acknowledgeBulkUploadConfirmMatchComplete, 
+exports.bulkUploadReceipts = _a.bulkUploadReceipts, exports.updateBulkUploadProgress = _a.updateBulkUploadProgress, exports.setBulkUploadUploadedFileCount = _a.setBulkUploadUploadedFileCount, exports.bulkUploadReceiptsSuccess = _a.bulkUploadReceiptsSuccess, exports.bulkUploadReceiptsFailure = _a.bulkUploadReceiptsFailure, exports.restoreBulkUploadMatchingState = _a.restoreBulkUploadMatchingState, exports.bulkUploadAutomatchingTimedOut = _a.bulkUploadAutomatchingTimedOut, exports.pusherBatchStatusUpdate = _a.pusherBatchStatusUpdate, exports.requestMissingReceiptsTabNavigation = _a.requestMissingReceiptsTabNavigation, exports.clearMissingReceiptsTabNavigation = _a.clearMissingReceiptsTabNavigation, exports.fetchBulkUploadBatchDetailsSuccess = _a.fetchBulkUploadBatchDetailsSuccess, exports.fetchBulkUploadBatchDetailsFailure = _a.fetchBulkUploadBatchDetailsFailure, exports.storeBatchDetails = _a.storeBatchDetails, exports.batchDetailFetchFailed = _a.batchDetailFetchFailed, exports.setInitialBatchDetailsLoading = _a.setInitialBatchDetailsLoading, exports.fetchMoreBatchDetails = _a.fetchMoreBatchDetails, exports.fetchMoreBatchDetailsComplete = _a.fetchMoreBatchDetailsComplete, exports.fetchMoreBatchDetailsFailure = _a.fetchMoreBatchDetailsFailure, exports.fetchBulkUploadBatches = _a.fetchBulkUploadBatches, exports.fetchBulkUploadBatchesSuccess = _a.fetchBulkUploadBatchesSuccess, exports.fetchBulkUploadBatchesFailure = _a.fetchBulkUploadBatchesFailure, exports.clearBulkUploadBatchDetailsForScopeChange = _a.clearBulkUploadBatchDetailsForScopeChange, exports.markBatchDetailRefreshAttempted = _a.markBatchDetailRefreshAttempted, exports.confirmBulkUploadMatch = _a.confirmBulkUploadMatch, exports.confirmBulkUploadMatchSuccess = _a.confirmBulkUploadMatchSuccess, exports.confirmBulkUploadMatchFailure = _a.confirmBulkUploadMatchFailure, exports.setBulkUploadResultsTab = _a.setBulkUploadResultsTab, exports.setBulkUploadCompletedSubTab = _a.setBulkUploadCompletedSubTab, exports.setBulkUploadSortConfig = _a.setBulkUploadSortConfig, exports.clearBulkUpload = _a.clearBulkUpload, exports.searchTransactionsForManualMatch = _a.searchTransactionsForManualMatch, exports.searchTransactionsForManualMatchSuccess = _a.searchTransactionsForManualMatchSuccess, exports.searchTransactionsForManualMatchFailure = _a.searchTransactionsForManualMatchFailure, exports.clearManualSearchResults = _a.clearManualSearchResults, exports.acknowledgeBulkUploadConfirmMatchComplete = _a.acknowledgeBulkUploadConfirmMatchComplete, 
 // Completed Transactions
 exports.fetchCompletedTransactions = _a.fetchCompletedTransactions, exports.fetchCompletedTransactionsSuccess = _a.fetchCompletedTransactionsSuccess, exports.fetchCompletedTransactionsFailure = _a.fetchCompletedTransactionsFailure;
 exports.default = expenseAutomationMissingReceiptsView.reducer;

package/lib/view/expenseAutomationView/selectorTypes/missingReceiptsSelectorTypes.d.ts

@@ -29,6 +29,12 @@ export interface ResolvedBatchFile {
 export interface BulkUploadSelectorData {
     batchDetails: ResolvedBatchDetails | undefined;
     batchDetailsPaginationState: FetchStateAndError;
+    /**
+     * True while a stale-while-revalidate refresh of `batchDetailsById` is in flight (e.g. manual
+     * refresh button). UI should keep rendering existing data and show only a lightweight refresh
+     * indicator — never the full skeleton.
+     */
+    batchDetailsRevalidating: boolean;
     batchList: BatchListItem[];
     batchListFetchState: FetchStateAndError;
     batchStatus: BatchStatus | undefined;
@@ -37,6 +43,12 @@ export interface BulkUploadSelectorData {
     confirmMatchStatus: FetchStateAndError;
     currentResultsTab: BulkUploadResultsTab;
     hasMoreBatchDetails: boolean;
+    /**
+     * `true` once the first batch-details page has loaded for the current scope (period/tenant).
+     * Stays `true` across refreshes — flips back to `false` only on `clearBulkUpload` or on an
+     * explicit scope change. Used by the Unmatched tab to gate the initial-load skeleton.
+     */
+    initialBatchDetailsLoaded: boolean;
     manualSearch: ManualSearchState;
     /** Bumps when manual search state is cleared — remount manual search inputs. */
     manualSearchUiResetKey: number;

package/lib/view/expenseAutomationView/selectors/missingReceiptsSelector.js

@@ -230,6 +230,8 @@ function getExpenseAutomationMissingReceiptsView(state) {
             manualSearchUiResetKey: bulkUpload.manualSearchUiResetKey,
             hasMoreBatchDetails,
             batchDetailsPaginationState: bulkUpload.batchDetailsPaginationState,
+            batchDetailsRevalidating: bulkUpload.batchDetailsRevalidating,
+            initialBatchDetailsLoaded: bulkUpload.initialBatchDetailsLoaded,
             manualSearch: {
                 ...bulkUpload.manualSearch,
                 results: manualSearchResults,

package/lib/view/expenseAutomationView/types/missingReceiptsViewState.d.ts

@@ -129,6 +129,13 @@ export interface CompletedTransactionsState {
 export interface BulkUploadState {
     batchDetailsById: Record<ID, BatchDetails>;
     batchDetailsPaginationState: FetchStateAndError;
+    /**
+     * True while a stale-while-revalidate refresh of `batchDetailsById` is in flight (manual refresh
+     * or scope-change replacement). Existing entries are kept on screen during this window; the UI
+     * can surface a lightweight refresh indicator. Cleared on `fetchMoreBatchDetailsComplete` /
+     * `fetchMoreBatchDetailsFailure`.
+     */
+    batchDetailsRevalidating: boolean;
     batchListByPeriod: Record<MonthYearPeriodId, BatchListItem[]>;
     batchListFetchState: FetchStateAndError;
     batchStatusById: Record<ID, BatchStatus>;
@@ -137,6 +144,18 @@ export interface BulkUploadState {
     confirmMatchStatus: FetchStateAndError;
     currentResultsTab: BulkUploadResultsTab;
     failedBatchDetailIds: ID[];
+    /**
+     * Set to `true` once the first batch-details page has resolved (success or empty completion).
+     * Drives stale-while-revalidate: the Unmatched skeleton is shown only while this is `false`.
+     * Reset only by `clearBulkUpload` or by an explicit scope-change (period/tenant) clear.
+     */
+    initialBatchDetailsLoaded: boolean;
+    /**
+     * Last time `GET /1.0/batches/:id` was issued for a given batch via the targeted refresh epic.
+     * Used to throttle Pusher resend storms — repeat completion events for the same batchId within
+     * the dedupe window are dropped.
+     */
+    lastBatchDetailRefreshAtById: Record<ID, number>;
     /**
      * Incremented when manual search Redux state is cleared so Unmatched `ManualSearchInput`
      * instances remount and drop local query text.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.0.75",
+  "version": "5.0.77-betaAD01",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",