@zeniai/client-epic-state 5.0.71-betaVR1 → 5.0.71-betaVR3

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,17 +362,20 @@ 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 = [];
-                    /**
-                     * Also reset pagination so the post-success epic re-runs the details chain from a
-                     * clean slate. Otherwise a previously `Completed` pagination state survives the cache
-                     * wipe and the Unmatched skeleton can stay up while no new details actually load.
-                     */
                     draft.bulkUpload.batchDetailsPaginationState = {
                         fetchState: 'Not-Started',
                         error: undefined,
@@ -351,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;
@@ -593,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.71-betaVR1",
+  "version": "5.0.71-betaVR3",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",