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

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

@@ -19,9 +19,19 @@ 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) => {
+    /**
+     * 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)((a) => a.payload.pageToken == null &&
+        a.payload.query.trim().length < 2));
+    const newSearchDebounced$ = searchActions$.pipe((0, operators_1.filter)((a) => a.payload.pageToken == null &&
+        a.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,8 +23,14 @@ 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;
+    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)((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
         .getJSON(`${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}/1.0/batches/${batchId}`)
         .pipe((0, operators_1.mergeMap)((response) => {
@@ -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, BatchFile, BatchFileStatus, BatchListItem, BatchStatus, BatchSummary, 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;
@@ -14,6 +15,32 @@ exports.supportedTransactionPayloadToManualSearchResult = supportedTransactionPa
 const urlPayload_1 = require("../../../commonPayloadTypes/urlPayload");
 const transactionPayload_1 = require("../../../entity/transaction/payloadTypes/transactionPayload");
 // -- 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 s = raw.trim().toLowerCase().replace(/-/g, '_');
+    switch (s) {
+        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,
@@ -29,7 +56,7 @@ function toBatchFile(payload, filesEndPoint) {
         filename: payload.filename,
         matchSource: payload.match_source,
         matchedTransactionId: payload.matched_transaction?.transaction_id,
-        status: payload.status,
+        status: parseBatchFileStatus(payload.status),
     };
 }
 function extractTransactionPayloadsFromBatchFiles(files) {

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], {

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,14 +291,6 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 };
             },
             prepare(input) {
-                if (input === true || input === false) {
-                    return {
-                        payload: {
-                            cacheOverride: input === true,
-                            invalidateBatchDetailsCache: false,
-                        },
-                    };
-                }
                 const o = input ?? {};
                 return {
                     payload: {
@@ -358,14 +351,14 @@ const expenseAutomationMissingReceiptsView = (0, toolkit_1.createSlice)({
                 const file = details.files.find((f) => f.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.
      */
@@ -106,8 +107,8 @@ function getExpenseAutomationMissingReceiptsView(state) {
         }
     };
     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((f) => f.status === 'exact_match') ?? [], getSortValue, bulkUploadSortDirection);
+    const unmatchedFiles = (0, orderBy_1.default)(resolvedFiles?.filter((f) => (0, missingReceiptsViewState_1.isUnmatchedTabFileStatus)(f.status)) ?? [], getSortValue, bulkUploadSortDirection);
     const progress = currentBatchStatus != null
         ? {
             ...currentBatchStatus.progress,
@@ -132,7 +133,7 @@ function getExpenseAutomationMissingReceiptsView(state) {
             return [];
         }
         return details.files
-            .filter((f) => f.status === 'un_matched' || f.status === 'no_match')
+            .filter((f) => (0, missingReceiptsViewState_1.isUnmatchedTabFileStatus)(f.status))
             .map((f) => resolveBatchFile(f, b.batchId, transactionState));
     });
     const completedTransactionsCacheKey = monthYearPeriodId != null
@@ -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((f) => (0, missingReceiptsViewState_1.isUnmatchedTabFileStatus)(f.status));
 }
 /** List row summary before batch details load — aligns with unmatched / possible-match work. */
 function batchListItemHasUnmatchedWork(batch) {

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

@@ -13,8 +13,15 @@ export interface MissingReceiptsViewUIState {
     sortKey: MissingReceiptsSortKey;
     sortOrder: SortOrder;
 }
+/**
+ * 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 type BatchStatusValue = 'pending' | 'processing' | 'completed';
-export type BatchFileStatus = 'matched' | 'un_matched' | 'no_match' | 'failed';
+export type BatchFileStatus = 'exact_match' | 'possible_matches' | 'no_match' | 'failed';
+/** True for files that belong in the Unmatched tab (possible matches or no match). */
+export declare function isUnmatchedTabFileStatus(status: BatchFileStatus): boolean;
 export type BulkUploadPhase = 'idle' | 'uploading' | 'matching' | 'completed';
 export type BulkUploadResultsTab = 'completed' | 'unmatched';
 export type MissingReceiptsTab = 'missing' | BulkUploadResultsTab;

package/lib/view/expenseAutomationView/types/missingReceiptsViewState.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toMissingReceiptsSortKey = void 0;
+exports.MIN_MANUAL_TRANSACTION_SEARCH_LENGTH = exports.toMissingReceiptsSortKey = void 0;
+exports.isUnmatchedTabFileStatus = isUnmatchedTabFileStatus;
 const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
 const MISSING_RECEIPTS_SORT_KEYS = [
     'vendor',
@@ -11,3 +12,13 @@ const MISSING_RECEIPTS_SORT_KEYS = [
 ];
 const toMissingReceiptsSortKey = (v) => (0, stringToUnion_1.stringToUnion)(v, MISSING_RECEIPTS_SORT_KEYS);
 exports.toMissingReceiptsSortKey = toMissingReceiptsSortKey;
+// -- Bulk Receipt Upload Types --
+/**
+ * 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).
+ */
+exports.MIN_MANUAL_TRANSACTION_SEARCH_LENGTH = 2;
+/** True for files that belong in the Unmatched tab (possible matches or no match). */
+function isUnmatchedTabFileStatus(status) {
+    return status === 'possible_matches' || status === 'no_match';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "4.19.84-betaVR1",
+  "version": "4.19.84-betaVR10",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",
@@ -111,7 +111,7 @@
     "find-dead-code": "ts-prune | grep -v '(used in module)'",
     "find-unused-exports": "ts-unused-exports ./tsconfig.json",
     "circular-dependency": "npx madge --circular --extensions ts ./src",
-    "build": "concurrently --kill-others-on-fail --handle-input \"echo 'Running ESLint...' && eslint . --ext .js,.jsx,.ts,.tsx\" \"echo 'TypeScript build in progress...' && time tsc && echo 'ESM build...' && tsc -p tsconfig.esm.json\"",
+    "build": "concurrently --kill-others-on-fail --handle-input \"echo 'Running ESLint...' && eslint . --ext .js,.jsx,.ts,.tsx\" \"echo 'TypeScript build in progress...' && time tsc && echo 'ESM build...' && tsc -p tsconfig.esm.json\" \"echo 'Running tests and typecheck...' && pnpm test\" && rimraf \"lib/**/__mocks__\" \"lib/**/__testHelpers__\"",
     "only-build": "eslint . --ext .js,.jsx,.ts,.tsx && time tsc && tsc -p tsconfig.esm.json && rimraf \"lib/**/__mocks__\" \"lib/**/__testHelpers__\"",
     "only-build-dev": "eslint . --ext .js,.jsx,.ts,.tsx && time tsc -p tsconfig.dev.json && tsc -p tsconfig.esm.dev.json && rimraf \"lib/**/__mocks__\" \"lib/**/__testHelpers__\"",
     "format": "prettier --write --ignore-unknown \"src/**/*\" && pnpm lint",