@zeniai/client-epic-state 4.19.84-betaVR1 → 4.19.84-betaVR11

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

@@ -15,9 +15,13 @@ const bulkUploadReceiptsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0,
         .postFormData(`${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}/1.0/receipts/bulk-upload`, formData)
         .pipe((0, operators_1.mergeMap)((response) => {
         if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
-            return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.bulkUploadReceiptsSuccess)({
-                batchId: response.data.batch_id,
-            }));
+            const batchId = String(response.data.batch_id ?? '').trim();
+            if (batchId === '') {
+                return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.bulkUploadReceiptsFailure)({
+                    error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Bulk upload succeeded but batch_id was missing or empty.'),
+                }));
+            }
+            return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.bulkUploadReceiptsSuccess)({ batchId }));
         }
         return (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.bulkUploadReceiptsFailure)({ error: response.status }));
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.bulkUploadReceiptsFailure)({

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

@@ -35,7 +35,7 @@ const fetchBulkUploadBatchDetailsEpic = (actions$, state$, zeniAPI) => actions$.
             actions.push((0, transactionReducer_1.updateTransactions)(transactionPayloads, (value) => value.transaction_id));
         }
         actions.push((0, missingReceiptsViewReducer_1.fetchBulkUploadBatchDetailsSuccess)((0, missingReceiptsPayload_1.toBatchDetails)(response.data, zeniAPI.apiEndPoints.fileMicroServiceBaseUrl)));
-        actions.push((0, missingReceiptsViewReducer_1.fetchBulkUploadBatches)(true));
+        actions.push((0, missingReceiptsViewReducer_1.fetchBulkUploadBatches)({ cacheOverride: true }));
         return (0, rxjs_1.from)(actions);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, missingReceiptsViewReducer_1.fetchBulkUploadBatchDetailsFailure)({
         error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch batch details errored out: ' + JSON.stringify(error)),

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

@@ -9,7 +9,7 @@ const responsePayload_1 = require("../../../../responsePayload");
 const missingReceiptsPayload_1 = require("../../payload/missingReceiptsPayload");
 const missingReceiptsViewReducer_1 = require("../../reducers/missingReceiptsViewReducer");
 const fetchMultipleBatchDetailsEpic_1 = require("./fetchMultipleBatchDetailsEpic");
-const MORE_BATCH_PAGE_SIZE = 1;
+const MORE_BATCH_PAGE_SIZE = 5;
 const fetchMoreBatchDetailsEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.fetchMoreBatchDetails.match), 
 /** One page at a time — avoids duplicate loads if IO + scroll fallback both fire. */
 (0, operators_1.exhaustMap)(() => {

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

@@ -8,7 +8,7 @@ const transactionReducer_1 = require("../../../../entity/transaction/transaction
 const responsePayload_1 = require("../../../../responsePayload");
 const missingReceiptsPayload_1 = require("../../payload/missingReceiptsPayload");
 const missingReceiptsViewReducer_1 = require("../../reducers/missingReceiptsViewReducer");
-const INITIAL_BATCH_PAGE_SIZE = 1;
+const INITIAL_BATCH_PAGE_SIZE = 5;
 function fetchBatchDetailsByIds(batchIds, zeniAPI) {
     if (batchIds.length === 0) {
         return rxjs_1.EMPTY;

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

@@ -18,10 +18,20 @@ const transactionsViewState_1 = require("../../types/transactionsViewState");
 exports.MANUAL_TRANSACTION_SEARCH_AUTO_CATEGORIZED = false;
 const searchTransactionsForManualMatchEpic = (actions$, state$, zeniAPI) => {
     const searchActions$ = actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.searchTransactionsForManualMatch.match));
-    const pagination$ = searchActions$.pipe((0, operators_1.filter)((a) => a.payload.pageToken != null));
-    const newSearch$ = searchActions$.pipe((0, operators_1.filter)((a) => a.payload.pageToken == null), (0, operators_1.debounceTime)(300));
-    return (0, rxjs_1.merge)(pagination$, newSearch$).pipe((0, operators_1.switchMap)((action) => {
+    const pagination$ = searchActions$.pipe((0, operators_1.filter)((action) => action.payload.pageToken != null));
+    /**
+     * No API for empty or 1-char queries; immediate merge so switchMap cancels any in-flight HTTP.
+     */
+    const newSearchTooShortOrClear$ = searchActions$.pipe((0, operators_1.filter)((action) => action.payload.pageToken == null &&
+        action.payload.query.trim().length < 2));
+    const newSearchDebounced$ = searchActions$.pipe((0, operators_1.filter)((action) => action.payload.pageToken == null &&
+        action.payload.query.trim().length >= 2), (0, operators_1.debounceTime)(300));
+    return (0, rxjs_1.merge)(pagination$, newSearchTooShortOrClear$, newSearchDebounced$).pipe((0, operators_1.switchMap)((action) => {
         const { query, pageToken } = action.payload;
+        if (pageToken == null &&
+            query.trim().length < 2) {
+            return rxjs_1.EMPTY;
+        }
         const state = state$.value;
         const { expenseAutomationViewState: { selectedPeriodByTenantId }, expenseAutomationMissingReceiptsViewState: { bulkUpload: { manualSearch, sortKey, sortOrder }, }, } = state;
         const currentTenant = (0, tenantSelector_1.getCurrentTenant)(state);

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

@@ -1,13 +1,19 @@
 import { ActionsObservable, StateObservable } from 'redux-observable';
 import { Observable } from 'rxjs';
+import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { updateTransactions } from '../../../../entity/transaction/transactionReducer';
 import { RootState } from '../../../../reducer';
 import { ZeniAPI } from '../../../../zeniAPI';
 import { bulkUploadReceiptsSuccess, clearBulkUpload, fetchBulkUploadBatchDetailsSuccess, fetchBulkUploadBatches, pusherBatchStatusUpdate, requestMissingReceiptsTabNavigation } from '../../reducers/missingReceiptsViewReducer';
-export type ActionType = ReturnType<typeof bulkUploadReceiptsSuccess> | ReturnType<typeof pusherBatchStatusUpdate> | ReturnType<typeof fetchBulkUploadBatchDetailsSuccess> | ReturnType<typeof fetchBulkUploadBatches> | ReturnType<typeof requestMissingReceiptsTabNavigation> | ReturnType<typeof updateTransactions> | ReturnType<typeof clearBulkUpload>;
+export type ActionType = ReturnType<typeof bulkUploadReceiptsSuccess> | ReturnType<typeof pusherBatchStatusUpdate> | ReturnType<typeof fetchBulkUploadBatchDetailsSuccess> | ReturnType<typeof fetchBulkUploadBatches> | ReturnType<typeof requestMissingReceiptsTabNavigation> | ReturnType<typeof updateTransactions> | ReturnType<typeof clearBulkUpload> | ReturnType<typeof openSnackbar>;
 /**
  * On Pusher batch completion: refresh batch list (then fetchMultipleBatchDetailsEpic runs),
  * and request switching to the Unmatched tab. Debounced to reduce duplicate refreshes.
  */
 export declare const pusherBatchStatusCompletionEpic: (actions$: ActionsObservable<ActionType>) => Observable<ActionType>;
+/**
+ * Fallback polling when Pusher is slow or unavailable. Network errors on a poll tick show one
+ * error snackbar per upload session (first failure only) so the user is not spammed every
+ * interval; Pusher or a later successful poll still completes the flow.
+ */
 export declare const pollBulkUploadBatchStatusEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pollBulkUploadBatchStatusEpic = exports.pusherBatchStatusCompletionEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const snackbarReducer_1 = require("../../../../entity/snackbar/snackbarReducer");
 const transactionReducer_1 = require("../../../../entity/transaction/transactionReducer");
 const responsePayload_1 = require("../../../../responsePayload");
 const missingReceiptsPayload_1 = require("../../payload/missingReceiptsPayload");
@@ -22,9 +23,15 @@ const pusherBatchStatusCompletionEpic = (actions$) => actions$.pipe((0, operator
     (0, missingReceiptsViewReducer_1.requestMissingReceiptsTabNavigation)({ tab: 'unmatched' }),
 ])));
 exports.pusherBatchStatusCompletionEpic = pusherBatchStatusCompletionEpic;
+/**
+ * Fallback polling when Pusher is slow or unavailable. Network errors on a poll tick show one
+ * error snackbar per upload session (first failure only) so the user is not spammed every
+ * interval; Pusher or a later successful poll still completes the flow.
+ */
 const pollBulkUploadBatchStatusEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.bulkUploadReceiptsSuccess.match), (0, operators_1.mergeMap)((action) => {
     const { batchId } = action.payload;
-    return (0, rxjs_1.timer)(FALLBACK_FIRST_DELAY_MS, FALLBACK_POLL_INTERVAL_MS).pipe((0, operators_1.takeUntil)((0, rxjs_1.merge)(actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.clearBulkUpload.match)), actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.pusherBatchStatusUpdate.match), (0, operators_1.filter)((a) => a.payload.batchId === batchId)), actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.fetchBulkUploadBatchDetailsSuccess.match), (0, operators_1.filter)((a) => a.payload.batchId === batchId)))), (0, operators_1.switchMap)(() => zeniAPI
+    let pollErrorNotified = false;
+    return (0, rxjs_1.timer)(FALLBACK_FIRST_DELAY_MS, FALLBACK_POLL_INTERVAL_MS).pipe((0, operators_1.takeUntil)((0, rxjs_1.merge)(actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.clearBulkUpload.match)), actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.pusherBatchStatusUpdate.match), (0, operators_1.filter)((action) => action.payload.batchId === batchId)), actions$.pipe((0, operators_1.filter)(missingReceiptsViewReducer_1.fetchBulkUploadBatchDetailsSuccess.match), (0, operators_1.filter)((action) => action.payload.batchId === batchId)))), (0, operators_1.switchMap)(() => zeniAPI
         .getJSON(`${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}/1.0/batches/${batchId}`)
         .pipe((0, operators_1.mergeMap)((response) => {
         /** Same batch-details URL; polls until `status` is completed (Pusher may win first). */
@@ -36,12 +43,22 @@ const pollBulkUploadBatchStatusEpic = (actions$, _state$, zeniAPI) => actions$.p
                     actions.push((0, transactionReducer_1.updateTransactions)(transactionPayloads, (value) => value.transaction_id));
                 }
                 actions.push((0, missingReceiptsViewReducer_1.fetchBulkUploadBatchDetailsSuccess)((0, missingReceiptsPayload_1.toBatchDetails)(response.data, zeniAPI.apiEndPoints.fileMicroServiceBaseUrl)));
-                actions.push((0, missingReceiptsViewReducer_1.fetchBulkUploadBatches)(true));
+                actions.push((0, missingReceiptsViewReducer_1.fetchBulkUploadBatches)({ cacheOverride: true }));
                 actions.push((0, missingReceiptsViewReducer_1.requestMissingReceiptsTabNavigation)({ tab: 'unmatched' }));
                 return (0, rxjs_1.from)(actions);
             }
         }
         return rxjs_1.EMPTY;
-    }), (0, operators_1.catchError)(() => (0, rxjs_1.of)()))));
+    }), (0, operators_1.catchError)(() => {
+        if (!pollErrorNotified) {
+            pollErrorNotified = true;
+            return (0, rxjs_1.of)((0, snackbarReducer_1.openSnackbar)({
+                messageSection: 'receipts_upload',
+                messageText: 'failed',
+                type: 'error',
+            }));
+        }
+        return rxjs_1.EMPTY;
+    }))));
 }));
 exports.pollBulkUploadBatchStatusEpic = pollBulkUploadBatchStatusEpic;

package/lib/view/expenseAutomationView/payload/missingReceiptsPayload.d.ts

@@ -3,7 +3,7 @@ import { TransactionPayload } from '../../../entity/transaction/payloadTypes/tra
 import { SupportedTransactionPayload } from '../../../entity/transaction/transactionState';
 import { ZeniAPIResponse } from '../../../responsePayload';
 import type { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
-import type { BatchDetails, BatchFile, BatchListItem, BatchStatus, BatchSummary, ManualSearchResult } from '../types/missingReceiptsViewState';
+import { type BatchDetails, type BatchFile, type BatchFileStatus, type BatchListItem, type BatchStatus, type BatchSummary, type ManualSearchResult } from '../types/missingReceiptsViewState';
 export interface MissingReceiptsQueryPayload {
     end_date: string;
     is_attachment_missing_only: boolean;
@@ -54,6 +54,11 @@ export interface MatchedTransactionPayload {
 export interface MatchCandidatePayload extends MatchedTransactionPayload {
     match_score: number;
 }
+/**
+ * Wire payload for a batch file row. `status` may use legacy aliases (`matched`, `un_matched`,
+ * `possible_match`, `possible_matches`, etc.) until the backend is fully migrated; canonical
+ * values are applied in {@link parseBatchFileStatus} via {@link toBatchFile}.
+ */
 export interface BatchFilePayload {
     attachment_id: string;
     file_id: string;
@@ -78,6 +83,12 @@ export interface BatchDetailsResponsePayload {
     };
 }
 export type BatchDetailsResponse = ZeniAPIResponse<BatchDetailsResponsePayload>;
+/**
+ * Maps batch-details API `files[].status` strings to canonical {@link BatchFileStatus}.
+ * Legacy aliases are supported during rollout; unknown strings map to `failed` so Redux never
+ * holds untyped status values.
+ */
+export declare function parseBatchFileStatus(raw: string): BatchFileStatus;
 export declare function toBatchFile(payload: BatchFilePayload, filesEndPoint?: string): BatchFile;
 export declare function extractTransactionPayloadsFromBatchFiles(files: BatchFilePayload[]): SupportedTransactionPayload[];
 export declare function toBatchSummary(payload: BatchDetailsResponsePayload['summary']): BatchSummary;

package/lib/view/expenseAutomationView/payload/missingReceiptsPayload.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBatchFileStatus = parseBatchFileStatus;
 exports.toBatchFile = toBatchFile;
 exports.extractTransactionPayloadsFromBatchFiles = extractTransactionPayloadsFromBatchFiles;
 exports.toBatchSummary = toBatchSummary;
@@ -13,13 +14,40 @@ exports.toBatchListItem = toBatchListItem;
 exports.supportedTransactionPayloadToManualSearchResult = supportedTransactionPayloadToManualSearchResult;
 const urlPayload_1 = require("../../../commonPayloadTypes/urlPayload");
 const transactionPayload_1 = require("../../../entity/transaction/payloadTypes/transactionPayload");
+const missingReceiptsViewState_1 = require("../types/missingReceiptsViewState");
 // -- Converter functions --
+/**
+ * Maps batch-details API `files[].status` strings to canonical {@link BatchFileStatus}.
+ * Legacy aliases are supported during rollout; unknown strings map to `failed` so Redux never
+ * holds untyped status values.
+ */
+function parseBatchFileStatus(raw) {
+    const normalizedStatus = raw.trim().toLowerCase().replace(/-/g, '_');
+    switch (normalizedStatus) {
+        case 'exact_match':
+        case 'matched':
+            return 'exact_match';
+        case 'possible_matches':
+        case 'possible_match':
+        case 'possiblematch':
+        case 'un_matched':
+        case 'unmatched':
+            return 'possible_matches';
+        case 'no_match':
+        case 'nomatch':
+            return 'no_match';
+        case 'failed':
+            return 'failed';
+        default:
+            return 'failed';
+    }
+}
 function toBatchFile(payload, filesEndPoint) {
     return {
         attachmentId: payload.attachment_id,
-        candidates: payload.candidates?.map((c) => ({
-            transactionId: c.transaction_id,
-            matchScore: c.match_score,
+        candidates: payload.candidates?.map((candidate) => ({
+            transactionId: candidate.transaction_id,
+            matchScore: candidate.match_score,
         })),
         fileDownloadUrl: payload.file_id != null && filesEndPoint != null
             ? `${filesEndPoint}/1.0/files/${payload.file_id}?query=${encodeURIComponent(JSON.stringify({ download_file: true }))}`
@@ -27,9 +55,11 @@ function toBatchFile(payload, filesEndPoint) {
         fileId: payload.file_id,
         filePreviewUrl: payload.file_preview_url,
         filename: payload.filename,
-        matchSource: payload.match_source,
+        matchSource: payload.match_source != null
+            ? (0, missingReceiptsViewState_1.toMatchSource)(payload.match_source)
+            : undefined,
         matchedTransactionId: payload.matched_transaction?.transaction_id,
-        status: payload.status,
+        status: parseBatchFileStatus(payload.status),
     };
 }
 function extractTransactionPayloadsFromBatchFiles(files) {
@@ -79,8 +109,8 @@ function toBatchDetails(payload, filesEndPoint) {
     return {
         batchId: payload.batch_id,
         createdAt: payload.created_at,
-        files: payload.files.map((f) => toBatchFile(f, filesEndPoint)),
-        status: payload.status,
+        files: payload.files.map((file) => toBatchFile(file, filesEndPoint)),
+        status: (0, missingReceiptsViewState_1.toBatchStatusValue)(payload.status),
         summary: toBatchSummary(payload.summary),
     };
 }
@@ -94,7 +124,7 @@ function isBatchListStatusCompleted(status) {
  * statuses for UI; only `completed` rows should trigger batch-details requests.
  */
 function filterBatchListItemsForBatchDetailsFetch(batches) {
-    return batches.filter((b) => isBatchListStatusCompleted(b.status));
+    return batches.filter((batch) => isBatchListStatusCompleted(batch.status));
 }
 /**
  * Batch details API response `status` field — only completed payloads should be stored from
@@ -105,7 +135,7 @@ function isBatchDetailsApiStatusCompleted(status) {
 }
 function findBatchListItemForBatchId(batchListByPeriod, batchId) {
     for (const list of Object.values(batchListByPeriod)) {
-        const found = list.find((b) => b.batchId === batchId);
+        const found = list.find((batch) => batch.batchId === batchId);
         if (found != null) {
             return found;
         }

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

@@ -5,7 +5,7 @@ import { MonthYearPeriod, TimePeriod } from '../../../commonStateTypes/timePerio
 import { TransactionPayload } from '../../../entity/transaction/payloadTypes/transactionPayload';
 import { SupportedTransactionPayload } from '../../../entity/transaction/transactionState';
 import { ZeniAPIStatus } from '../../../responsePayload';
-import type { BatchDetails, BatchListItem, BatchStatus, BulkUploadResultsTab, BulkUploadSortKey, BulkUploadState, CompletedSubTab, ManualSearchResult, 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';
 import type { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
 export declare const getCompletedTransactionsCacheKey: (periodId: MonthYearPeriodId, sortKey: BulkUploadSortKey, sortOrder: SortOrder, subTab: CompletedSubTab) => string;
 export declare const initialBulkUploadState: BulkUploadState;
@@ -44,7 +44,7 @@ export declare const fetchMissingReceipts: import("@reduxjs/toolkit").ActionCrea
     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?: boolean | {
+}, "expenseAutomationMissingReceiptsView/fetchMoreBatchDetailsFailure">, fetchBulkUploadBatches: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[input?: {
     cacheOverride?: boolean;
     invalidateBatchDetailsCache?: boolean;
 } | undefined], {
@@ -68,7 +68,7 @@ export declare const fetchMissingReceipts: import("@reduxjs/toolkit").ActionCrea
     transactionId: ID;
 }, "expenseAutomationMissingReceiptsView/confirmBulkUploadMatchSuccess">, confirmBulkUploadMatchFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     error: ZeniAPIStatus;
-}, "expenseAutomationMissingReceiptsView/confirmBulkUploadMatchFailure">, setBulkUploadResultsTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<BulkUploadResultsTab, "expenseAutomationMissingReceiptsView/setBulkUploadResultsTab">, setBulkUploadCompletedSubTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<CompletedSubTab, "expenseAutomationMissingReceiptsView/setBulkUploadCompletedSubTab">, setBulkUploadSortConfig: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+}, "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], {

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

@@ -4,6 +4,7 @@ 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.fetchBulkUploadBatchDetails = exports.clearMissingReceiptsTabNavigation = exports.requestMissingReceiptsTabNavigation = exports.pusherBatchStatusUpdate = 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.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 = {
@@ -290,19 +291,11 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 };
             },
             prepare(input) {
-                if (input === true || input === false) {
-                    return {
-                        payload: {
-                            cacheOverride: input === true,
-                            invalidateBatchDetailsCache: false,
-                        },
-                    };
-                }
-                const o = input ?? {};
+                const fetchOptions = input ?? {};
                 return {
                     payload: {
-                        cacheOverride: o.cacheOverride === true,
-                        invalidateBatchDetailsCache: o.invalidateBatchDetailsCache === true,
+                        cacheOverride: fetchOptions.cacheOverride === true,
+                        invalidateBatchDetailsCache: fetchOptions.invalidateBatchDetailsCache === true,
                     },
                 };
             },
@@ -355,17 +348,17 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
             };
             const details = draft.bulkUpload.batchDetailsById[batchId];
             if (details != null) {
-                const file = details.files.find((f) => f.attachmentId === attachmentId);
+                const file = details.files.find((batchFile) => batchFile.attachmentId === attachmentId);
                 if (file != null) {
                     const originalStatus = file.status;
-                    file.status = 'matched';
+                    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 {
+                    else if (originalStatus === 'possible_matches') {
                         details.summary.possibleMatches = Math.max(0, details.summary.possibleMatches - 1);
                     }
                 }
@@ -397,6 +390,24 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
             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;

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

@@ -11,6 +11,7 @@ const transactionSelector_1 = require("../../../entity/transaction/transactionSe
 const expenseAutomationViewSelectorTypes_1 = require("../selectorTypes/expenseAutomationViewSelectorTypes");
 const missingReceiptsPayload_1 = require("../payload/missingReceiptsPayload");
 const missingReceiptsViewReducer_1 = require("../reducers/missingReceiptsViewReducer");
+const missingReceiptsViewState_1 = require("../types/missingReceiptsViewState");
 function getExpenseAutomationMissingReceiptsView(state) {
     const { expenseAutomationMissingReceiptsViewState, expenseAutomationViewState, transactionState, monthEndCloseChecksState, } = state;
     const currentTenant = (0, tenantSelector_1.getCurrentTenant)(state);
@@ -64,7 +65,7 @@ function getExpenseAutomationMissingReceiptsView(state) {
         : [];
     /**
      * Primary "Unmatched" batch = first completed batch in platform list order, preferring the
-     * first batch that still has un_matched/no_match work when any completed batch has such work.
+     * first batch that still has possible_matches/no_match work when any completed batch has such work.
      * Batches without details yet: wait if the list row still reports unmatched work; otherwise skip
      * so we do not block the whole tab while other rows are not fetched yet.
      */
@@ -73,41 +74,41 @@ function getExpenseAutomationMissingReceiptsView(state) {
     const unmatchedSectionBatchId = bulkUpload.phase === 'matching' || bulkUpload.phase === 'uploading'
         ? bulkUpload.currentBatchId ?? primaryBatchIdFromDetailsOrder
         : primaryBatchIdFromDetailsOrder;
-    const completedBatchesInApiOrder = batchList.filter((b) => (0, missingReceiptsPayload_1.isBatchListStatusCompleted)(b.status));
+    const completedBatchesInApiOrder = batchList.filter((batchListItem) => (0, missingReceiptsPayload_1.isBatchListStatusCompleted)(batchListItem.status));
     const currentBatchDetails = unmatchedSectionBatchId != null
         ? bulkUpload.batchDetailsById[unmatchedSectionBatchId]
         : undefined;
     const resolvedFiles = currentBatchDetails?.files.map((file) => resolveBatchFile(file, currentBatchDetails.batchId, transactionState));
     const failedIds = new Set(bulkUpload.failedBatchDetailIds);
-    const hasMoreBatchDetails = completedBatchesInApiOrder.some((b) => bulkUpload.batchDetailsById[b.batchId] == null &&
-        !failedIds.has(b.batchId));
+    const hasMoreBatchDetails = completedBatchesInApiOrder.some((batchListItem) => bulkUpload.batchDetailsById[batchListItem.batchId] == null &&
+        !failedIds.has(batchListItem.batchId));
     const getSortValue = (file) => {
-        const t = file.matchedTransaction;
-        if (t == null) {
+        const matchedTransaction = file.matchedTransaction;
+        if (matchedTransaction == null) {
             return null;
         }
         switch (bulkUpload.sortKey) {
             case 'vendor':
-                return (t.vendorName ?? t.description)?.toLowerCase() ?? null;
+                return (matchedTransaction.vendorName ?? matchedTransaction.description)?.toLowerCase() ?? null;
             case 'category': {
-                const line = t.lines?.[0];
+                const line = matchedTransaction.lines?.[0];
                 return line?.account?.accountName?.toLowerCase() ?? null;
             }
             case 'class': {
-                const line = t.lines?.[0];
+                const line = matchedTransaction.lines?.[0];
                 return line?.class?.className?.toLowerCase() ?? null;
             }
             case 'date':
-                return t.date.valueOf();
+                return matchedTransaction.date.valueOf();
             case 'amount':
-                return t.amount.amount;
+                return matchedTransaction.amount.amount;
             default:
                 return null;
         }
     };
     const bulkUploadSortDirection = bulkUpload.sortOrder === 'ascending' ? 'asc' : 'desc';
-    const matchedFiles = (0, orderBy_1.default)(resolvedFiles?.filter((f) => f.status === 'matched') ?? [], getSortValue, bulkUploadSortDirection);
-    const unmatchedFiles = (0, orderBy_1.default)(resolvedFiles?.filter((f) => f.status === 'un_matched' || f.status === 'no_match') ?? [], getSortValue, bulkUploadSortDirection);
+    const matchedFiles = (0, orderBy_1.default)(resolvedFiles?.filter((resolvedFile) => resolvedFile.status === 'exact_match') ?? [], getSortValue, bulkUploadSortDirection);
+    const unmatchedFiles = (0, orderBy_1.default)(resolvedFiles?.filter((resolvedFile) => (0, missingReceiptsViewState_1.isUnmatchedTabFileStatus)(resolvedFile.status)) ?? [], getSortValue, bulkUploadSortDirection);
     const progress = currentBatchStatus != null
         ? {
             ...currentBatchStatus.progress,
@@ -124,16 +125,16 @@ function getExpenseAutomationMissingReceiptsView(state) {
      * that has details loaded (otherwise past is empty and receipts vanish from the UI).
      */
     const pastBatches = unmatchedSectionBatchId != null
-        ? batchList.filter((b) => b.batchId !== unmatchedSectionBatchId)
+        ? batchList.filter((batchListItem) => batchListItem.batchId !== unmatchedSectionBatchId)
         : batchList;
-    const pastUnmatchedFiles = pastBatches.flatMap((b) => {
-        const details = bulkUpload.batchDetailsById[b.batchId];
+    const pastUnmatchedFiles = pastBatches.flatMap((pastBatch) => {
+        const details = bulkUpload.batchDetailsById[pastBatch.batchId];
         if (details == null) {
             return [];
         }
         return details.files
-            .filter((f) => f.status === 'un_matched' || f.status === 'no_match')
-            .map((f) => resolveBatchFile(f, b.batchId, transactionState));
+            .filter((batchFile) => (0, missingReceiptsViewState_1.isUnmatchedTabFileStatus)(batchFile.status))
+            .map((batchFile) => resolveBatchFile(batchFile, pastBatch.batchId, transactionState));
     });
     const completedTransactionsCacheKey = monthYearPeriodId != null
         ? (0, missingReceiptsViewReducer_1.getCompletedTransactionsCacheKey)(monthYearPeriodId, bulkUpload.sortKey, bulkUpload.sortOrder, bulkUpload.completedSubTab)
@@ -152,11 +153,11 @@ function getExpenseAutomationMissingReceiptsView(state) {
             summary: currentBatchDetails.summary,
         }
         : undefined;
-    const manualSearchResults = bulkUpload.manualSearch.results.map((r) => {
-        const t = (0, transactionSelector_1.getSupportedTransactionById)(transactionState, r.transactionId);
+    const manualSearchResults = bulkUpload.manualSearch.results.map((result) => {
+        const transaction = (0, transactionSelector_1.getSupportedTransactionById)(transactionState, result.transactionId);
         return {
-            ...r,
-            vendorLogo: r.vendorLogo ?? t?.logo?.href,
+            ...result,
+            vendorLogo: result.vendorLogo ?? transaction?.logo?.href,
         };
     });
     return {
@@ -206,7 +207,7 @@ function getExpenseAutomationMissingReceiptsView(state) {
     };
 }
 function batchDetailsHasUnmatchedWork(details) {
-    return details.files.some((f) => f.status === 'un_matched' || f.status === 'no_match');
+    return details.files.some((file) => (0, missingReceiptsViewState_1.isUnmatchedTabFileStatus)(file.status));
 }
 /** List row summary before batch details load — aligns with unmatched / possible-match work. */
 function batchListItemHasUnmatchedWork(batch) {
@@ -223,17 +224,17 @@ function batchListItemHasUnmatchedWork(batch) {
  */
 function getPrimaryBatchIdFromBatchListOrder(batchListInPlatformOrder, batchDetailsById, failedBatchDetailIds) {
     const failedIds = new Set(failedBatchDetailIds);
-    const anyCompletedBatchHasUnmatchedWork = batchListInPlatformOrder.some((b) => {
-        if (failedIds.has(b.batchId)) {
+    const anyCompletedBatchHasUnmatchedWork = batchListInPlatformOrder.some((batch) => {
+        if (failedIds.has(batch.batchId)) {
             return false;
         }
-        const d = batchDetailsById[b.batchId];
-        if (d != null &&
-            d.status === 'completed' &&
-            batchDetailsHasUnmatchedWork(d)) {
+        const details = batchDetailsById[batch.batchId];
+        if (details != null &&
+            details.status === 'completed' &&
+            batchDetailsHasUnmatchedWork(details)) {
             return true;
         }
-        return d == null && batchListItemHasUnmatchedWork(b);
+        return details == null && batchListItemHasUnmatchedWork(batch);
     });
     for (const batch of batchListInPlatformOrder) {
         if (failedIds.has(batch.batchId)) {
@@ -270,7 +271,7 @@ function resolveBatchFile(file, batchId, transactionState) {
             ? { transaction, matchScore: ref.matchScore }
             : undefined;
     })
-        .filter((c) => c != null);
+        .filter((candidate) => candidate != null);
     return {
         attachmentId: file.attachmentId,
         batchId,

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

@@ -3,7 +3,6 @@ import { SortOrder } from '../../../commonStateTypes/selectorTypes/sortOrderType
 import { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
 export declare const toMissingReceiptsSortKey: (v: string) => "date" | "amount" | "vendor" | "category" | "class";
 export type MissingReceiptsSortKey = ReturnType<typeof toMissingReceiptsSortKey>;
-export type BulkUploadSortKey = 'amount' | 'category' | 'class' | 'date' | 'vendor';
 export interface MissingReceiptsViewUIState {
     scrollPosition: {
         scrollTop: number;
@@ -13,13 +12,31 @@ export interface MissingReceiptsViewUIState {
     sortKey: MissingReceiptsSortKey;
     sortOrder: SortOrder;
 }
-export type BatchStatusValue = 'pending' | 'processing' | 'completed';
-export type BatchFileStatus = 'matched' | 'un_matched' | 'no_match' | 'failed';
-export type BulkUploadPhase = 'idle' | 'uploading' | 'matching' | 'completed';
-export type BulkUploadResultsTab = 'completed' | 'unmatched';
-export type MissingReceiptsTab = 'missing' | BulkUploadResultsTab;
-export type CompletedSubTab = 'all' | 'ai_accountant' | 'manual';
-export type MatchSource = 'ai' | 'manual';
+/**
+ * Minimum trimmed query length before manual-match search calls the expense-automation API.
+ * Kept in sync with `ManualSearchInput` in web-components (fires search only when length ≥ this).
+ */
+export declare const MIN_MANUAL_TRANSACTION_SEARCH_LENGTH = 2;
+export declare const toBatchStatusValue: (v: string) => "pending" | "processing" | "completed";
+export type BatchStatusValue = ReturnType<typeof toBatchStatusValue>;
+/** Canonical batch file statuses (API ingress may use aliases; see `parseBatchFileStatus`). */
+export declare const BATCH_FILE_STATUSES: readonly ["exact_match", "possible_matches", "no_match", "failed"];
+export declare const toBatchFileStatus: (v: string) => "failed" | "exact_match" | "possible_matches" | "no_match";
+export type BatchFileStatus = ReturnType<typeof toBatchFileStatus>;
+/** True for files that belong in the Unmatched tab (possible matches or no match). */
+export declare function isUnmatchedTabFileStatus(status: BatchFileStatus): boolean;
+export declare const toBulkUploadPhase: (v: string) => "completed" | "idle" | "uploading" | "matching";
+export type BulkUploadPhase = ReturnType<typeof toBulkUploadPhase>;
+export declare const toBulkUploadResultsTab: (v: string) => "completed" | "unmatched";
+export type BulkUploadResultsTab = ReturnType<typeof toBulkUploadResultsTab>;
+export declare const toMissingReceiptsTab: (v: string) => "completed" | "unmatched" | "missing";
+export type MissingReceiptsTab = ReturnType<typeof toMissingReceiptsTab>;
+export declare const toCompletedSubTab: (v: string) => "all" | "manual" | "ai_accountant";
+export type CompletedSubTab = ReturnType<typeof toCompletedSubTab>;
+export declare const toMatchSource: (v: string) => "manual" | "ai";
+export type MatchSource = ReturnType<typeof toMatchSource>;
+export declare const toBulkUploadSortKey: (v: string) => "date" | "amount" | "vendor" | "category" | "class";
+export type BulkUploadSortKey = ReturnType<typeof toBulkUploadSortKey>;
 export interface CandidateRef {
     matchScore: number;
     transactionId: ID;
@@ -99,7 +116,8 @@ export interface ManualSearchState {
     searchQuery: string;
     totalCount: number;
 }
-export type CompletedTransactionsMatchType = 'all' | 'ai_accountant' | 'manual';
+/** Same union as {@link CompletedSubTab} — used for completed-transactions API `match_type`. */
+export type CompletedTransactionsMatchType = CompletedSubTab;
 export interface CompletedTransactionsState {
     fetchState: FetchStateAndError;
     nextPageToken: string | null;