@zeniai/client-epic-state 4.19.97 → 4.19.99-beta0ND

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

@@ -1,11 +1,17 @@
 import { Amount } from '../../../commonStateTypes/amount';
-import { FetchStateAndError, UpdateType } from '../../../commonStateTypes/common';
+import { FetchStateAndError, ID, UpdateType } from '../../../commonStateTypes/common';
+import { SortOrder } from '../../../commonStateTypes/selectorTypes/sortOrderTypes';
 import { MonthYearPeriod, TimePeriod } from '../../../commonStateTypes/timePeriod';
+import type { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
 import { TransactionPayload } from '../../../entity/transaction/payloadTypes/transactionPayload';
 import { SupportedTransactionPayload } from '../../../entity/transaction/transactionState';
 import { ZeniAPIStatus } from '../../../responsePayload';
-import { MissingReceiptsViewState, MissingReceiptsViewUIState } from '../types/missingReceiptsViewState';
+import { type BatchDetails, type BatchListItem, type BatchStatus, type BulkUploadResultsTab, type BulkUploadSortKey, type BulkUploadState, type CompletedSubTab, type ManualSearchResult, type MissingReceiptsViewState, type MissingReceiptsViewUIState } from '../types/missingReceiptsViewState';
+export declare const getCompletedTransactionsCacheKey: (periodId: MonthYearPeriodId, sortKey: BulkUploadSortKey, sortOrder: SortOrder, subTab: CompletedSubTab) => string;
+export declare const initialBulkUploadState: BulkUploadState;
 export declare const initialState: MissingReceiptsViewState;
+/** Epic trigger only; batch-details fetch is handled in epics. */
+export declare const fetchBulkUploadBatchDetails: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/fetchBulkUploadBatchDetails">;
 export declare const fetchMissingReceipts: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[period: TimePeriod, minimumTransactionAmount: Amount, cacheOverride?: any, refreshViewInBackground?: any], {
     period: TimePeriod;
     minimumTransactionAmount: Amount;
@@ -26,6 +32,73 @@ export declare const fetchMissingReceipts: import("@reduxjs/toolkit").ActionCrea
 }, "expenseAutomationMissingReceiptsView/updateMissingReceiptUploadState", never, never>, updateMissingReceiptsUIState: import("@reduxjs/toolkit").ActionCreatorWithPayload<Partial<MissingReceiptsViewUIState>, "expenseAutomationMissingReceiptsView/updateMissingReceiptsUIState">, markMissingReceiptAsDone: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[transactionPayload: SupportedTransactionPayload, selectedPeriod: MonthYearPeriod], {
     transactionPayload: SupportedTransactionPayload;
     selectedPeriod: MonthYearPeriod;
-}, "expenseAutomationMissingReceiptsView/markMissingReceiptAsDone", never, never>, clearExpenseAutomationMissingReceiptsView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/clearExpenseAutomationMissingReceiptsView">;
+}, "expenseAutomationMissingReceiptsView/markMissingReceiptAsDone", never, never>, clearExpenseAutomationMissingReceiptsView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/clearExpenseAutomationMissingReceiptsView">, bulkUploadReceipts: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[files: File[]], {
+    files: File[];
+}, "expenseAutomationMissingReceiptsView/bulkUploadReceipts", never, never>, updateBulkUploadProgress: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "expenseAutomationMissingReceiptsView/updateBulkUploadProgress">, bulkUploadReceiptsSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    batchId: ID;
+}, "expenseAutomationMissingReceiptsView/bulkUploadReceiptsSuccess">, bulkUploadReceiptsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+}, "expenseAutomationMissingReceiptsView/bulkUploadReceiptsFailure">, bulkUploadAutomatchingTimedOut: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[batchId: string], {
+    batchId: string;
+}, "expenseAutomationMissingReceiptsView/bulkUploadAutomatchingTimedOut", never, never>, pusherBatchStatusUpdate: import("@reduxjs/toolkit").ActionCreatorWithPayload<BatchStatus, "expenseAutomationMissingReceiptsView/pusherBatchStatusUpdate">, requestMissingReceiptsTabNavigation: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    tab: BulkUploadResultsTab;
+}, "expenseAutomationMissingReceiptsView/requestMissingReceiptsTabNavigation">, clearMissingReceiptsTabNavigation: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/clearMissingReceiptsTabNavigation">, fetchBulkUploadBatchDetailsSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<BatchDetails, "expenseAutomationMissingReceiptsView/fetchBulkUploadBatchDetailsSuccess">, fetchBulkUploadBatchDetailsFailure: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    error: ZeniAPIStatus;
+}], {
+    error: ZeniAPIStatus;
+}, "expenseAutomationMissingReceiptsView/fetchBulkUploadBatchDetailsFailure", never, never>, storeBatchDetails: import("@reduxjs/toolkit").ActionCreatorWithPayload<BatchDetails, "expenseAutomationMissingReceiptsView/storeBatchDetails">, batchDetailFetchFailed: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    batchId: ID;
+}, "expenseAutomationMissingReceiptsView/batchDetailFetchFailed">, setInitialBatchDetailsLoading: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/setInitialBatchDetailsLoading">, fetchMoreBatchDetails: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/fetchMoreBatchDetails">, fetchMoreBatchDetailsComplete: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/fetchMoreBatchDetailsComplete">, fetchMoreBatchDetailsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+}, "expenseAutomationMissingReceiptsView/fetchMoreBatchDetailsFailure">, fetchBulkUploadBatches: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[input?: {
+    cacheOverride?: boolean;
+    invalidateBatchDetailsCache?: boolean;
+} | undefined], {
+    cacheOverride: boolean;
+    invalidateBatchDetailsCache: boolean;
+}, "expenseAutomationMissingReceiptsView/fetchBulkUploadBatches", never, never>, fetchBulkUploadBatchesSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    batchList: BatchListItem[];
+    selectedPeriod: MonthYearPeriod;
+}, "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], {
+    batchId: string;
+    attachmentId: string;
+    transactionId: string;
+    transactionType: string;
+    fileName: string;
+}, "expenseAutomationMissingReceiptsView/confirmBulkUploadMatch", never, never>, confirmBulkUploadMatchSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    attachmentId: ID;
+    batchId: ID;
+    transactionId: ID;
+}, "expenseAutomationMissingReceiptsView/confirmBulkUploadMatchSuccess">, confirmBulkUploadMatchFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+}, "expenseAutomationMissingReceiptsView/confirmBulkUploadMatchFailure">, setBulkUploadResultsTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<"completed" | "unmatched", "expenseAutomationMissingReceiptsView/setBulkUploadResultsTab">, setBulkUploadCompletedSubTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<"all" | "manual" | "ai_accountant", "expenseAutomationMissingReceiptsView/setBulkUploadCompletedSubTab">, setBulkUploadSortConfig: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    sortKey: BulkUploadSortKey;
+    sortOrder: SortOrder;
+}, "expenseAutomationMissingReceiptsView/setBulkUploadSortConfig">, clearBulkUpload: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/clearBulkUpload">, searchTransactionsForManualMatch: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[query: string, pageToken?: string | null | undefined], {
+    query: string;
+    pageToken: string | undefined;
+}, "expenseAutomationMissingReceiptsView/searchTransactionsForManualMatch", never, never>, searchTransactionsForManualMatchSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    append: boolean;
+    nextPageToken: string | null;
+    results: ManualSearchResult[];
+    totalCount: number;
+}, "expenseAutomationMissingReceiptsView/searchTransactionsForManualMatchSuccess">, searchTransactionsForManualMatchFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+}, "expenseAutomationMissingReceiptsView/searchTransactionsForManualMatchFailure">, clearManualSearchResults: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/clearManualSearchResults">, acknowledgeBulkUploadConfirmMatchComplete: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"expenseAutomationMissingReceiptsView/acknowledgeBulkUploadConfirmMatchComplete">, fetchCompletedTransactions: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[pageToken?: string | undefined, cacheOverride?: boolean | undefined], {
+    pageToken: string | undefined;
+    cacheOverride: boolean | undefined;
+}, "expenseAutomationMissingReceiptsView/fetchCompletedTransactions", never, never>, fetchCompletedTransactionsSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    isInitialLoad: boolean;
+    nextPageToken: string | null;
+    selectedPeriod: MonthYearPeriod;
+    totalCount: number;
+    transactionIds: ID[];
+}, "expenseAutomationMissingReceiptsView/fetchCompletedTransactionsSuccess">, fetchCompletedTransactionsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+    selectedPeriod: MonthYearPeriod;
+}, "expenseAutomationMissingReceiptsView/fetchCompletedTransactionsFailure">;
 declare const _default: import("redux").Reducer<MissingReceiptsViewState>;
 export default _default;

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

@@ -1,10 +1,43 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clearExpenseAutomationMissingReceiptsView = exports.markMissingReceiptAsDone = exports.updateMissingReceiptsUIState = exports.updateMissingReceiptUploadState = exports.uploadMissingReceiptSuccess = exports.fetchMissingReceiptsFailure = exports.fetchMissingReceiptsSuccess = exports.fetchMissingReceipts = exports.initialState = void 0;
+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.bulkUploadReceiptsFailure = exports.bulkUploadReceiptsSuccess = exports.updateBulkUploadProgress = exports.bulkUploadReceipts = exports.clearExpenseAutomationMissingReceiptsView = exports.markMissingReceiptAsDone = exports.updateMissingReceiptsUIState = exports.updateMissingReceiptUploadState = exports.uploadMissingReceiptSuccess = exports.fetchMissingReceiptsFailure = exports.fetchMissingReceiptsSuccess = exports.fetchMissingReceipts = exports.fetchBulkUploadBatchDetails = exports.initialState = exports.initialBulkUploadState = exports.getCompletedTransactionsCacheKey = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const timePeriod_1 = require("../../../commonStateTypes/timePeriod");
+const missingReceiptsViewState_1 = require("../types/missingReceiptsViewState");
+const getCompletedTransactionsCacheKey = (periodId, sortKey, sortOrder, subTab) => `completed-${subTab}-${sortKey}-${sortOrder === 'ascending' ? 'asc' : 'desc'}-${periodId}`;
+exports.getCompletedTransactionsCacheKey = getCompletedTransactionsCacheKey;
+exports.initialBulkUploadState = {
+    batchDetailsById: {},
+    batchDetailsPaginationState: { fetchState: 'Not-Started', error: undefined },
+    batchListByPeriod: {},
+    batchListFetchState: { fetchState: 'Not-Started', error: undefined },
+    batchStatusById: {},
+    completedSubTab: 'all',
+    completedTransactionsByPeriod: {},
+    confirmMatchStatus: { fetchState: 'Not-Started', error: undefined },
+    currentBatchId: undefined,
+    currentResultsTab: 'unmatched',
+    failedBatchDetailIds: [],
+    manualSearchUiResetKey: 0,
+    manualSearch: {
+        fetchState: { fetchState: 'Not-Started', error: undefined },
+        isLoadingMore: false,
+        nextPageToken: null,
+        pageSize: 25,
+        results: [],
+        searchQuery: '',
+        totalCount: 0,
+    },
+    phase: 'idle',
+    sortKey: 'date',
+    sortOrder: 'descending',
+    uploadProgress: 0,
+    uploadStatus: { fetchState: 'Not-Started', error: undefined },
+};
 exports.initialState = {
+    bulkUpload: exports.initialBulkUploadState,
+    pendingMissingReceiptsTabNavigation: null,
     uploadReceiptStatusById: {},
     refreshStatus: {
         fetchState: 'Not-Started',
@@ -23,6 +56,8 @@ exports.initialState = {
         return this.fetchState == 'Completed';
     },
 };
+/** Epic trigger only; batch-details fetch is handled in epics. */
+exports.fetchBulkUploadBatchDetails = (0, toolkit_1.createAction)('expenseAutomationMissingReceiptsView/fetchBulkUploadBatchDetails');
 const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
     name: 'expenseAutomationMissingReceiptsView',
     initialState: exports.initialState,
@@ -124,7 +159,404 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
         clearExpenseAutomationMissingReceiptsView(draft) {
             Object.assign(draft, exports.initialState);
         },
+        // -- Bulk Upload Actions --
+        bulkUploadReceipts: {
+            reducer(draft) {
+                draft.bulkUpload.phase = 'uploading';
+                draft.bulkUpload.uploadProgress = 0;
+                draft.bulkUpload.uploadStatus = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+            prepare(files) {
+                return { payload: { files } };
+            },
+        },
+        updateBulkUploadProgress(draft, action) {
+            draft.bulkUpload.uploadProgress = action.payload;
+        },
+        bulkUploadReceiptsSuccess(draft, action) {
+            draft.bulkUpload.currentBatchId = action.payload.batchId;
+            draft.bulkUpload.uploadProgress = 100;
+            draft.bulkUpload.uploadStatus = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+            draft.bulkUpload.phase = 'matching';
+        },
+        bulkUploadReceiptsFailure(draft, action) {
+            draft.bulkUpload.uploadStatus = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+            draft.bulkUpload.phase = 'idle';
+        },
+        bulkUploadAutomatchingTimedOut: {
+            reducer(draft, action) {
+                if (draft.bulkUpload.phase !== 'matching' ||
+                    draft.bulkUpload.currentBatchId !== action.payload.batchId) {
+                    return;
+                }
+                draft.bulkUpload.phase = 'completed';
+            },
+            prepare(batchId) {
+                return { payload: { batchId } };
+            },
+        },
+        pusherBatchStatusUpdate(draft, action) {
+            const batchStatus = action.payload;
+            draft.bulkUpload.batchStatusById[batchStatus.batchId] = batchStatus;
+            /**
+             * Auto-matching banner (`phase === 'matching'`) must clear when the server reports this
+             * upload batch is done — otherwise the Missing tab keeps MatchingProgressBanner until
+             * batch-details APIs run; EmailUploadBanner should show again for the next upload.
+             */
+            if (batchStatus.status === 'completed' &&
+                draft.bulkUpload.phase === 'matching' &&
+                draft.bulkUpload.currentBatchId === batchStatus.batchId) {
+                draft.bulkUpload.phase = 'completed';
+            }
+        },
+        requestMissingReceiptsTabNavigation(draft, action) {
+            draft.pendingMissingReceiptsTabNavigation = action.payload.tab;
+        },
+        clearMissingReceiptsTabNavigation(draft) {
+            draft.pendingMissingReceiptsTabNavigation = null;
+        },
+        fetchBulkUploadBatchDetailsSuccess(draft, action) {
+            const details = action.payload;
+            draft.bulkUpload.batchDetailsById[details.batchId] = details;
+            draft.bulkUpload.phase = 'completed';
+        },
+        fetchBulkUploadBatchDetailsFailure: {
+            reducer(draft) {
+                draft.bulkUpload.phase = 'completed';
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        storeBatchDetails(draft, action) {
+            const details = action.payload;
+            draft.bulkUpload.batchDetailsById[details.batchId] = details;
+            /**
+             * Multi-batch fetch paths use `storeBatchDetails` (not `fetchBulkUploadBatchDetailsSuccess`).
+             * Without this, `phase` stays `matching` after upload forever and the Unmatched tab keeps
+             * showing the skeleton (`bulkUploadPhase === 'matching'` in web-components).
+             */
+            if (draft.bulkUpload.phase === 'matching' &&
+                draft.bulkUpload.currentBatchId === details.batchId) {
+                draft.bulkUpload.phase = 'completed';
+            }
+        },
+        batchDetailFetchFailed(draft, action) {
+            const { batchId } = action.payload;
+            if (!draft.bulkUpload.failedBatchDetailIds.includes(batchId)) {
+                draft.bulkUpload.failedBatchDetailIds.push(batchId);
+            }
+            if (draft.bulkUpload.phase === 'matching' &&
+                draft.bulkUpload.currentBatchId === batchId) {
+                draft.bulkUpload.phase = 'completed';
+            }
+        },
+        setInitialBatchDetailsLoading(draft) {
+            draft.bulkUpload.batchDetailsPaginationState = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        fetchMoreBatchDetails(draft) {
+            draft.bulkUpload.batchDetailsPaginationState = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        fetchMoreBatchDetailsComplete(draft) {
+            draft.bulkUpload.batchDetailsPaginationState = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+            const currentId = draft.bulkUpload.currentBatchId;
+            const currentDetails = currentId != null
+                ? draft.bulkUpload.batchDetailsById[currentId]
+                : undefined;
+            if (draft.bulkUpload.phase === 'matching' &&
+                currentId != null &&
+                currentDetails?.status === 'completed') {
+                draft.bulkUpload.phase = 'completed';
+            }
+        },
+        fetchMoreBatchDetailsFailure(draft, action) {
+            draft.bulkUpload.batchDetailsPaginationState = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        fetchBulkUploadBatches: {
+            reducer(draft, action) {
+                if (action.payload.invalidateBatchDetailsCache === true) {
+                    draft.bulkUpload.batchDetailsById = {};
+                    draft.bulkUpload.failedBatchDetailIds = [];
+                }
+                draft.bulkUpload.batchListFetchState = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+            prepare(input) {
+                const fetchOptions = input ?? {};
+                return {
+                    payload: {
+                        cacheOverride: fetchOptions.cacheOverride === true,
+                        invalidateBatchDetailsCache: fetchOptions.invalidateBatchDetailsCache === true,
+                    },
+                };
+            },
+        },
+        fetchBulkUploadBatchesSuccess(draft, action) {
+            const periodId = (0, timePeriod_1.toMonthYearPeriodId)(action.payload.selectedPeriod);
+            draft.bulkUpload.batchListByPeriod[periodId] = action.payload.batchList;
+            draft.bulkUpload.batchListFetchState = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+            /**
+             * When the multi-batch-details epic has nothing to fetch (e.g. list rows not `completed`
+             * yet, or details already present), `phase` can stay `matching` even though we already
+             * have completed details for `currentBatchId` (from polling / Pusher). Sync so the UI can
+             * dismiss the Unmatched skeleton.
+             */
+            const currentId = draft.bulkUpload.currentBatchId;
+            if (draft.bulkUpload.phase === 'matching' && currentId != null) {
+                const existing = draft.bulkUpload.batchDetailsById[currentId];
+                if (existing?.status === 'completed') {
+                    draft.bulkUpload.phase = 'completed';
+                }
+            }
+        },
+        fetchBulkUploadBatchesFailure(draft, action) {
+            draft.bulkUpload.batchListFetchState = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        confirmBulkUploadMatch: {
+            reducer(draft) {
+                draft.bulkUpload.confirmMatchStatus = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+            prepare(batchId, attachmentId, transactionId, transactionType, fileName) {
+                return {
+                    payload: {
+                        batchId,
+                        attachmentId,
+                        transactionId,
+                        transactionType,
+                        fileName,
+                    },
+                };
+            },
+        },
+        confirmBulkUploadMatchSuccess(draft, action) {
+            const { batchId, attachmentId, transactionId } = action.payload;
+            draft.bulkUpload.confirmMatchStatus = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+            const details = draft.bulkUpload.batchDetailsById[batchId];
+            if (details != null) {
+                const file = details.files.find((batchFile) => batchFile.attachmentId === attachmentId);
+                if (file != null) {
+                    const originalStatus = file.status;
+                    file.status = 'exact_match';
+                    file.matchedTransactionId = transactionId;
+                    file.candidates = undefined;
+                    details.summary.matched += 1;
+                    if (originalStatus === 'no_match') {
+                        details.summary.noMatch = Math.max(0, details.summary.noMatch - 1);
+                    }
+                    else if (originalStatus === 'possible_matches') {
+                        details.summary.possibleMatches = Math.max(0, details.summary.possibleMatches - 1);
+                    }
+                }
+            }
+            draft.bulkUpload.manualSearch = exports.initialBulkUploadState.manualSearch;
+            draft.bulkUpload.manualSearchUiResetKey += 1;
+        },
+        confirmBulkUploadMatchFailure(draft, action) {
+            draft.bulkUpload.confirmMatchStatus = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        setBulkUploadResultsTab(draft, action) {
+            draft.bulkUpload.currentResultsTab = action.payload;
+        },
+        setBulkUploadCompletedSubTab(draft, action) {
+            draft.bulkUpload.completedSubTab = action.payload;
+        },
+        setBulkUploadSortConfig(draft, action) {
+            draft.bulkUpload.sortKey = action.payload.sortKey;
+            draft.bulkUpload.sortOrder = action.payload.sortOrder;
+        },
+        clearBulkUpload(draft) {
+            Object.assign(draft.bulkUpload, exports.initialBulkUploadState);
+            draft.pendingMissingReceiptsTabNavigation = null;
+        },
+        searchTransactionsForManualMatch: {
+            reducer(draft, action) {
+                const { query, pageToken } = action.payload;
+                const isLoadMore = pageToken != null;
+                const trimmed = query.trim();
+                /**
+                 * Cleared or too-short query: no API (see epic). Reset fully (no In-Progress).
+                 * Only bump `manualSearchUiResetKey` when clearing a real search — not when the UI
+                 * dispatches `""` on every keystroke while length is below MIN (web-components always sends
+                 * `onSearch("")` in that case), or ReceiptCard remounts and the input loses focus.
+                 */
+                if (!isLoadMore &&
+                    trimmed.length < missingReceiptsViewState_1.MIN_MANUAL_TRANSACTION_SEARCH_LENGTH) {
+                    const hadActiveSearch = draft.bulkUpload.manualSearch.searchQuery.trim().length >=
+                        missingReceiptsViewState_1.MIN_MANUAL_TRANSACTION_SEARCH_LENGTH ||
+                        draft.bulkUpload.manualSearch.results.length > 0;
+                    draft.bulkUpload.manualSearch = exports.initialBulkUploadState.manualSearch;
+                    if (hadActiveSearch) {
+                        draft.bulkUpload.manualSearchUiResetKey += 1;
+                    }
+                    return;
+                }
+                draft.bulkUpload.manualSearch.searchQuery = query;
+                if (isLoadMore) {
+                    draft.bulkUpload.manualSearch.isLoadingMore = true;
+                }
+                else {
+                    draft.bulkUpload.manualSearch.isLoadingMore = false;
+                    draft.bulkUpload.manualSearch.results = [];
+                    draft.bulkUpload.manualSearch.nextPageToken = null;
+                    draft.bulkUpload.manualSearch.totalCount = 0;
+                    draft.bulkUpload.manualSearch.fetchState = {
+                        fetchState: 'In-Progress',
+                        error: undefined,
+                    };
+                }
+            },
+            prepare(query, pageToken) {
+                return { payload: { query, pageToken: pageToken ?? undefined } };
+            },
+        },
+        searchTransactionsForManualMatchSuccess(draft, action) {
+            const { append, nextPageToken, results, totalCount } = action.payload;
+            if (append) {
+                const merged = [...draft.bulkUpload.manualSearch.results, ...results];
+                const byId = new Map(merged.map((result) => [result.transactionId, result]));
+                draft.bulkUpload.manualSearch.results = Array.from(byId.values());
+            }
+            else {
+                draft.bulkUpload.manualSearch.results = results;
+            }
+            draft.bulkUpload.manualSearch.nextPageToken = nextPageToken;
+            draft.bulkUpload.manualSearch.totalCount = totalCount;
+            draft.bulkUpload.manualSearch.isLoadingMore = false;
+            draft.bulkUpload.manualSearch.fetchState = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        searchTransactionsForManualMatchFailure(draft, action) {
+            draft.bulkUpload.manualSearch.isLoadingMore = false;
+            draft.bulkUpload.manualSearch.fetchState = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        clearManualSearchResults(draft) {
+            draft.bulkUpload.manualSearch = exports.initialBulkUploadState.manualSearch;
+            draft.bulkUpload.manualSearchUiResetKey += 1;
+        },
+        acknowledgeBulkUploadConfirmMatchComplete(draft) {
+            draft.bulkUpload.confirmMatchStatus = {
+                fetchState: 'Not-Started',
+                error: undefined,
+            };
+        },
+        // -- Completed Transactions Actions --
+        fetchCompletedTransactions: {
+            reducer(draft, action) {
+                const { pageToken } = action.payload;
+                if (pageToken != null) {
+                    const periods = draft.bulkUpload.completedTransactionsByPeriod;
+                    for (const entry of Object.values(periods)) {
+                        if (entry.nextPageToken === pageToken) {
+                            entry.fetchState = {
+                                fetchState: 'In-Progress',
+                                error: undefined,
+                            };
+                            break;
+                        }
+                    }
+                }
+            },
+            prepare(pageToken, cacheOverride) {
+                return { payload: { pageToken, cacheOverride } };
+            },
+        },
+        fetchCompletedTransactionsSuccess(draft, action) {
+            const { transactionIds, nextPageToken, totalCount, selectedPeriod, isInitialLoad, } = action.payload;
+            const periodId = (0, timePeriod_1.toMonthYearPeriodId)(selectedPeriod);
+            const cacheKey = (0, exports.getCompletedTransactionsCacheKey)(periodId, draft.bulkUpload.sortKey, draft.bulkUpload.sortOrder, draft.bulkUpload.completedSubTab);
+            if (isInitialLoad) {
+                draft.bulkUpload.completedTransactionsByPeriod[cacheKey] = {
+                    transactionIds,
+                    nextPageToken,
+                    totalCount,
+                    fetchState: { fetchState: 'Completed', error: undefined },
+                };
+            }
+            else {
+                const existing = draft.bulkUpload.completedTransactionsByPeriod[cacheKey];
+                if (existing != null) {
+                    existing.transactionIds.push(...transactionIds);
+                    existing.nextPageToken = nextPageToken;
+                    existing.totalCount = totalCount;
+                    existing.fetchState = { fetchState: 'Completed', error: undefined };
+                }
+                else {
+                    draft.bulkUpload.completedTransactionsByPeriod[cacheKey] = {
+                        transactionIds,
+                        nextPageToken,
+                        totalCount,
+                        fetchState: { fetchState: 'Completed', error: undefined },
+                    };
+                }
+            }
+        },
+        fetchCompletedTransactionsFailure(draft, action) {
+            const periodId = (0, timePeriod_1.toMonthYearPeriodId)(action.payload.selectedPeriod);
+            const cacheKey = (0, exports.getCompletedTransactionsCacheKey)(periodId, draft.bulkUpload.sortKey, draft.bulkUpload.sortOrder, draft.bulkUpload.completedSubTab);
+            const existing = draft.bulkUpload.completedTransactionsByPeriod[cacheKey];
+            if (existing != null) {
+                existing.fetchState = {
+                    fetchState: 'Error',
+                    error: action.payload.error,
+                };
+            }
+            else {
+                draft.bulkUpload.completedTransactionsByPeriod[cacheKey] = {
+                    fetchState: { fetchState: 'Error', error: action.payload.error },
+                    nextPageToken: null,
+                    totalCount: 0,
+                    transactionIds: [],
+                };
+            }
+        },
     },
 });
-_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;
+_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.bulkUploadReceiptsSuccess = _a.bulkUploadReceiptsSuccess, exports.bulkUploadReceiptsFailure = _a.bulkUploadReceiptsFailure, 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, 
+// Completed Transactions
+exports.fetchCompletedTransactions = _a.fetchCompletedTransactions, exports.fetchCompletedTransactionsSuccess = _a.fetchCompletedTransactionsSuccess, exports.fetchCompletedTransactionsFailure = _a.fetchCompletedTransactionsFailure;
 exports.default = expenseAutomationMissingReceiptsView.reducer;

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

@@ -1,4 +1,4 @@
-import { FetchState, ID } from '../../../commonStateTypes/common';
+import { FetchState, FetchStateAndError, ID, UpdateType } from '../../../commonStateTypes/common';
 import { COTTransactionTrackingByTransactionId, RecommendationWithCOT } from '../../../commonStateTypes/recommendationBase';
 import { MonthYearPeriod, TimePeriod } from '../../../commonStateTypes/timePeriod';
 import { PageToken } from '../../../commonStateTypes/viewAndReport/viewAndReport';
@@ -7,7 +7,7 @@ import { ClassBase } from '../../../entity/class/classState';
 import { CustomerBase } from '../../../entity/customer/customerState';
 import { Entity } from '../../../entity/genericEntity/entity';
 import { RecommendationWithCOTByLineId, TransactionID } from '../../../entity/transaction/stateTypes/transaction';
-import { SupportedTransaction, SupportedTransactionWithCOT } from '../../../entity/transaction/transactionState';
+import { SupportedTransaction, SupportedTransactionPayload, SupportedTransactionWithCOT } from '../../../entity/transaction/transactionState';
 import { VendorBase } from '../../../entity/vendor/vendorState';
 import { ZeniAPIStatus } from '../../../responsePayload';
 import { UncategorizedAccounts } from '../../accountList/accountListSelector';
@@ -158,6 +158,14 @@ export declare const fetchTransactionCategorization: import("@reduxjs/toolkit").
 }, "expenseAutomationTransactionsView/syncTransactionCategorizationFromDetailSave", never, never>, backgroundRefetchReviewTab: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[period: TimePeriod, isUncategorizedExpenseCategoryEnabled?: boolean | undefined], {
     period: TimePeriod;
     isUncategorizedExpenseCategoryEnabled: boolean | undefined;
-}, "expenseAutomationTransactionsView/backgroundRefetchReviewTab", never, never>;
+}, "expenseAutomationTransactionsView/backgroundRefetchReviewTab", never, never>, updateTransactionCategorizationUploadReceiptState: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[selectedTab: "review" | "autoCategorized", transactionId: string, fetchStatus: FetchStateAndError], {
+    selectedTab: "review" | "autoCategorized";
+    transactionId: string;
+    fetchStatus: FetchStateAndError;
+}, "expenseAutomationTransactionsView/updateTransactionCategorizationUploadReceiptState", never, never>, uploadTransactionCategorizationReceiptSuccess: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[selectedTab: "review" | "autoCategorized", transactionPayload: SupportedTransactionPayload, updateType?: UpdateType | undefined], {
+    selectedTab: "review" | "autoCategorized";
+    transactionPayload: SupportedTransactionPayload;
+    updateType: UpdateType;
+}, "expenseAutomationTransactionsView/uploadTransactionCategorizationReceiptSuccess", never, never>;
 declare const _default: import("redux").Reducer<TransactionsViewState>;
 export default _default;