@zeniai/client-epic-state 5.0.80 → 5.0.81-beta0ND

package/lib/esm/view/spendManagement/commonSetup/kycKybParseMapper.js

@@ -0,0 +1,205 @@
+/**
+ * Pure mappers from ExtendAI parser payloads to our form-side local-data shapes.
+ *
+ * Each mapper filters out fields below KYC_KYB_AUTOFILL_MIN_CONFIDENCE and returns
+ * both the merged values and the list of field names that were autofilled so the
+ * UI can show the ✦ AI badge next to each.
+ */
+import { date } from '../../../zeniDayJS';
+import { toZeniUrl } from '../../../zeniUrl';
+import { KYC_KYB_AUTOFILL_MIN_CONFIDENCE, } from './types/kycKybAutofill';
+const emptyResult = () => ({
+    values: {},
+    autoFilledFieldNames: [],
+});
+const isConfident = (field) => {
+    if (field == null) {
+        return false;
+    }
+    if (field.value == null) {
+        return false;
+    }
+    return field.confidence >= KYC_KYB_AUTOFILL_MIN_CONFIDENCE;
+};
+const assignAutofilledValue = (result, key, value) => {
+    if (value == null) {
+        return;
+    }
+    if (typeof value === 'string' && value.trim() === '') {
+        return;
+    }
+    result.values[key] = value;
+    result.autoFilledFieldNames.push(key);
+};
+const tryParseDate = (rawDate) => {
+    const parsedDate = date(rawDate);
+    if (parsedDate.isValid()) {
+        return parsedDate;
+    }
+    return undefined;
+};
+const normalizeNationality = (rawNationality, countries) => {
+    const needle = rawNationality.trim().toLowerCase();
+    if (needle === '') {
+        return undefined;
+    }
+    // Exact ISO-2 / ISO-3 match.
+    const isoMatch = countries.find((country) => country.countryCode.toLowerCase() === needle);
+    if (isoMatch != null) {
+        return isoMatch.countryCode;
+    }
+    // Common nationality adjectives map to country names (e.g. "American" → "United States").
+    const adjectiveToCountry = {
+        american: 'united states',
+        british: 'united kingdom',
+        indian: 'india',
+        canadian: 'canada',
+        australian: 'australia',
+        german: 'germany',
+        french: 'france',
+        chinese: 'china',
+        japanese: 'japan',
+        mexican: 'mexico',
+        brazilian: 'brazil',
+    };
+    const resolvedName = adjectiveToCountry[needle] ?? needle;
+    const nameMatch = countries.find((country) => country.countryName.toLowerCase() === resolvedName);
+    return nameMatch?.countryCode;
+};
+const splitFullName = (fullName) => {
+    const parts = fullName.trim().split(/\s+/);
+    if (parts.length === 1) {
+        return { firstName: parts[0], lastName: '' };
+    }
+    const lastName = parts[parts.length - 1];
+    const firstName = parts.slice(0, -1).join(' ');
+    return { firstName, lastName };
+};
+/** Passport → Company Officer. */
+export const mapPassportToOfficer = (parsed, allNationalityCountries) => {
+    const result = emptyResult();
+    if (isConfident(parsed.first_name)) {
+        assignAutofilledValue(result, 'firstName', parsed.first_name.value);
+    }
+    if (isConfident(parsed.last_name)) {
+        assignAutofilledValue(result, 'lastName', parsed.last_name.value);
+    }
+    if (isConfident(parsed.date_of_birth)) {
+        const parsedDate = tryParseDate(parsed.date_of_birth.value);
+        if (parsedDate != null) {
+            assignAutofilledValue(result, 'birthday', parsedDate);
+        }
+    }
+    if (isConfident(parsed.nationality)) {
+        const isoCode = normalizeNationality(parsed.nationality.value, allNationalityCountries);
+        if (isoCode != null) {
+            assignAutofilledValue(result, 'nationalityCountryCode', isoCode);
+        }
+    }
+    return result;
+};
+/** Driving License → Company Officer. */
+export const mapDrivingLicenseToOfficer = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.first_name)) {
+        assignAutofilledValue(result, 'firstName', parsed.first_name.value);
+    }
+    if (isConfident(parsed.last_name)) {
+        assignAutofilledValue(result, 'lastName', parsed.last_name.value);
+    }
+    if (isConfident(parsed.date_of_birth)) {
+        const parsedDate = tryParseDate(parsed.date_of_birth.value);
+        if (parsedDate != null) {
+            assignAutofilledValue(result, 'birthday', parsedDate);
+        }
+    }
+    // address_* fields are mapped at a higher layer (addressView reducer) — kept here as values
+    // only, the consuming epic dispatches the address payload separately.
+    return result;
+};
+/** SSN Card → Company Officer (name only — SSN value not yet returned by parser). */
+export const mapSsnCardToOfficer = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.full_name)) {
+        const { firstName, lastName } = splitFullName(parsed.full_name.value);
+        if (firstName !== '') {
+            assignAutofilledValue(result, 'firstName', firstName);
+        }
+        if (lastName !== '') {
+            assignAutofilledValue(result, 'lastName', lastName);
+        }
+    }
+    return result;
+};
+/** Certificate of Incorporation → Company Details. */
+export const mapCoiToCompanyDetails = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.company_legal_name)) {
+        assignAutofilledValue(result, 'companyLegalName', parsed.company_legal_name.value);
+    }
+    if (isConfident(parsed.ein)) {
+        assignAutofilledValue(result, 'taxIdOrEIN', parsed.ein.value);
+    }
+    if (isConfident(parsed.phone_number)) {
+        assignAutofilledValue(result, 'phone', parsed.phone_number.value);
+    }
+    if (isConfident(parsed.product_description)) {
+        assignAutofilledValue(result, 'companyDescription', parsed.product_description.value);
+    }
+    if (isConfident(parsed.website)) {
+        try {
+            assignAutofilledValue(result, 'website', toZeniUrl(parsed.website.value));
+        }
+        catch {
+            // ignore — malformed URL string from OCR
+        }
+    }
+    if (isConfident(parsed.industry)) {
+        assignAutofilledValue(result, 'companyIndustryType', parsed.industry.value);
+    }
+    if (isConfident(parsed.sub_industry)) {
+        assignAutofilledValue(result, 'companySubIndustry', parsed.sub_industry.value);
+    }
+    if (isConfident(parsed.type_of_incorporation)) {
+        assignAutofilledValue(result, 'typeOfIncorporation', parsed.type_of_incorporation.value);
+    }
+    if (isConfident(parsed.date_of_incorporation)) {
+        const parsedDate = tryParseDate(parsed.date_of_incorporation.value);
+        if (parsedDate != null) {
+            assignAutofilledValue(result, 'incDate', parsedDate);
+        }
+    }
+    if (isConfident(parsed.state_of_incorporation)) {
+        assignAutofilledValue(result, 'stateOfIncorporation', parsed.state_of_incorporation.value);
+    }
+    if (isConfident(parsed.countries_of_operations)) {
+        assignAutofilledValue(result, 'countriesOfOperations', parsed.countries_of_operations.value);
+    }
+    if (isConfident(parsed.source_of_funds)) {
+        assignAutofilledValue(result, 'sourceOfFunds', parsed.source_of_funds.value);
+    }
+    if (isConfident(parsed.transaction_volume_expectations)) {
+        assignAutofilledValue(result, 'transactionVolume', parsed.transaction_volume_expectations.value);
+    }
+    if (isConfident(parsed.purpose_of_account)) {
+        assignAutofilledValue(result, 'purposeOfAccount', parsed.purpose_of_account.value);
+    }
+    if (isConfident(parsed.regulated_status)) {
+        assignAutofilledValue(result, 'regulatedStatus', parsed.regulated_status.value);
+    }
+    if (isConfident(parsed.us_nexus)) {
+        assignAutofilledValue(result, 'usNexus', parsed.us_nexus.value);
+    }
+    return result;
+};
+/** Tax EIN letter → Company Details. */
+export const mapTaxEinToCompanyDetails = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.legal_business_name)) {
+        assignAutofilledValue(result, 'companyLegalName', parsed.legal_business_name.value);
+    }
+    if (isConfident(parsed.ein)) {
+        assignAutofilledValue(result, 'taxIdOrEIN', parsed.ein.value);
+    }
+    return result;
+};

package/lib/esm/view/spendManagement/commonSetup/setupViewReducer.js

@@ -3,60 +3,26 @@ const initialFetchStatus = {
     fetchState: 'Not-Started',
     error: undefined,
 };
+const emptyOfficerSlot = {
+    autoFilledFields: [],
+    localData: undefined,
+    sendOtpStatus: initialFetchStatus,
+    otpverificationStatus: initialFetchStatus,
+};
 export const initialState = {
     updateStatus: { fetchState: 'Not-Started', error: undefined },
-    companyDetails: {},
+    companyDetails: { autoFilledFields: [] },
     companyOfficerUpdateStatus: {
-        Officer_1: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_2: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_3: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_4: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_5: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_6: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_7: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_8: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_9: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
-        Officer_10: {
-            localData: undefined,
-            sendOtpStatus: initialFetchStatus,
-            otpverificationStatus: initialFetchStatus,
-        },
+        Officer_1: { ...emptyOfficerSlot },
+        Officer_2: { ...emptyOfficerSlot },
+        Officer_3: { ...emptyOfficerSlot },
+        Officer_4: { ...emptyOfficerSlot },
+        Officer_5: { ...emptyOfficerSlot },
+        Officer_6: { ...emptyOfficerSlot },
+        Officer_7: { ...emptyOfficerSlot },
+        Officer_8: { ...emptyOfficerSlot },
+        Officer_9: { ...emptyOfficerSlot },
+        Officer_10: { ...emptyOfficerSlot },
     },
     primaryContactDetails: {},
 };
@@ -297,7 +263,60 @@ const setupView = createSlice({
         clearSetupView(draft) {
             Object.assign(draft, initialState);
         },
+        /**
+         * Merge AI-parsed officer fields into the selected officer's localData and
+         * track which field names were autofilled so the form can show the ✦ badge.
+         */
+        applyKycDocumentAutofillForSetup: {
+            reducer(draft, action) {
+                const { officerType, values, autoFilledFieldNames } = action.payload;
+                const slot = draft.companyOfficerUpdateStatus[officerType];
+                slot.localData = Object.assign({}, slot.localData, values);
+                slot.autoFilledFields = Array.from(new Set([...slot.autoFilledFields, ...autoFilledFieldNames]));
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        /**
+         * Merge AI-parsed company fields into companyDetails.localData and track
+         * which field names were autofilled.
+         */
+        applyKybDocumentAutofillForSetup: {
+            reducer(draft, action) {
+                const { values, autoFilledFieldNames } = action.payload;
+                draft.companyDetails.localData = Object.assign({}, draft.companyDetails.localData, values);
+                draft.companyDetails.autoFilledFields = Array.from(new Set([
+                    ...draft.companyDetails.autoFilledFields,
+                    ...autoFilledFieldNames,
+                ]));
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        /**
+         * Wipe AI-autofill badges. If `officerType` is provided, clears only that
+         * officer; otherwise clears company details too.
+         */
+        clearKycKybAutofillForSetup: {
+            reducer(draft, action) {
+                const { officerType } = action.payload;
+                if (officerType != null) {
+                    draft.companyOfficerUpdateStatus[officerType].autoFilledFields = [];
+                }
+                else {
+                    draft.companyDetails.autoFilledFields = [];
+                    Object.keys(draft.companyOfficerUpdateStatus).forEach((key) => {
+                        draft.companyOfficerUpdateStatus[key].autoFilledFields = [];
+                    });
+                }
+            },
+            prepare(payload = {}) {
+                return { payload };
+            },
+        },
     },
 });
-export const { enableSetup, enableSetupSuccess, enableSetupFailure, updateBusinessVerificationDetails, updateBusinessVerificationDetailsSuccess, updateBusinessVerificationDetailsFailure, updateSelectedCompanyOfficer, updateSetupViewLocalStoreData, saveSetupViewDataInLocalStore, saveCompnayOfficerPhoneInLocalStore, saveCompnayOfficerAdditionalDocumentsInLocalStore, saveTreasuryAdditionalDocumentsInLocalStore, sendOtp: sendOtpSpendManagementSetUp, resendOtp: resendOtpSpendManagementSetUp, sendOtpSuccess: sendOtpSuccessSpendManagementSetUp, sendOtpFailure: sendOtpFailureSpendManagementSetUp, verifyOtp: verifyOtpSpendManagementSetUp, verifyOtpSuccess: verifyOtpSuccessSpendManagementSetUp, verifyOtpFailure: verifyOtpFailureSpendManagementSetUp, saveIndustryAndIncDateInLocalStore, clearSetupViewDataInLocalStore, clearSetupView, } = setupView.actions;
+export const { enableSetup, enableSetupSuccess, enableSetupFailure, updateBusinessVerificationDetails, updateBusinessVerificationDetailsSuccess, updateBusinessVerificationDetailsFailure, updateSelectedCompanyOfficer, updateSetupViewLocalStoreData, saveSetupViewDataInLocalStore, saveCompnayOfficerPhoneInLocalStore, saveCompnayOfficerAdditionalDocumentsInLocalStore, saveTreasuryAdditionalDocumentsInLocalStore, sendOtp: sendOtpSpendManagementSetUp, resendOtp: resendOtpSpendManagementSetUp, sendOtpSuccess: sendOtpSuccessSpendManagementSetUp, sendOtpFailure: sendOtpFailureSpendManagementSetUp, verifyOtp: verifyOtpSpendManagementSetUp, verifyOtpSuccess: verifyOtpSuccessSpendManagementSetUp, verifyOtpFailure: verifyOtpFailureSpendManagementSetUp, saveIndustryAndIncDateInLocalStore, clearSetupViewDataInLocalStore, clearSetupView, applyKycDocumentAutofillForSetup, applyKybDocumentAutofillForSetup, clearKycKybAutofillForSetup, } = setupView.actions;
 export default setupView.reducer;

package/lib/esm/view/spendManagement/commonSetup/setupViewSelector.js

@@ -119,6 +119,7 @@ export const getCompanyAndIdentityDetails = (state, companyId, companyAndIdentit
         const companyAddress = addressViewState.newAddressState?.company_address;
         const registeredCompanyAddress = addressViewState.newAddressState?.company_registered_address;
         companyDetailsLocalData = {
+            autoFilledFields: companyDetails.autoFilledFields,
             companyId,
             companyDescription,
             companyLegalName,
@@ -191,6 +192,7 @@ export const getCompanyAndIdentityDetails = (state, companyId, companyAndIdentit
             const companyOfficerAddress = addressViewState.newAddressState?.[addressType];
             companyOfficerLocalData[officerType] = {
                 ...companyOfficer.localData,
+                autoFilledFields: companyOfficer.autoFilledFields,
                 userFiles: getFilesByFileIds(fileState, fileIds),
                 additionalFiles: getFilesByFileIds(fileState, additionalSubmittedDocumentsForVerificationFileIds),
                 deleteFileStatusById,

package/lib/esm/view/spendManagement/commonSetup/types/kycKybAutofill.js

@@ -0,0 +1,28 @@
+/**
+ * Shared types for the KYC / KYB document autofill flow that lives inside the
+ * commonSetup feature (Setup pages + Onboarding both consume it via the same
+ * selector view; there is no separate state slice).
+ *
+ * Backed by document-communication-agent `POST /1.0/documents/process/sync`,
+ * which proxies document-service ExtendAI parsers and returns one of the
+ * parser payloads below — each value shaped as `{value, confidence}` per field.
+ */
+/** Confidence floor below which we drop an autofill candidate. */
+export const KYC_KYB_AUTOFILL_MIN_CONFIDENCE = 0.5;
+/**
+ * Maps the form-side {@link KycSelectDocumentType} (camelCase) to the
+ * parser-side {@link KycProvidedDocumentType} (snake_case). Returns `null` for
+ * `stateId`, which has no parser today.
+ */
+export const toKycProvidedDocumentType = (selectType) => {
+    switch (selectType) {
+        case 'driverLicense':
+            return 'driving_license';
+        case 'passport':
+            return 'passport';
+        case 'ssnCard':
+            return 'social_security_card';
+        case 'stateId':
+            return null;
+    }
+};

package/lib/esm/view/spendManagement/spendManagementFilterHelpers.js

@@ -8,6 +8,8 @@ import { getActualPaymentDate } from './helpers';
 import { getApproversOrRejectors as getApproversOrRejectorsForReimbursement, } from './reimbursement/remiListView/remiListSelector';
 import { ALL_REMI_TABS, getRemiListKey, } from './reimbursement/remiListView/remiListState';
 //filters items against filter values representing a range. ex: date (from-to), amount(1k<-->5k)
+// Spend Management uses only equal/not_equal — TC amount operators
+// (inBetween, lessThan, greaterThan) live in the TC filter pipeline.
 const filterItemOnRangeCategoryType = (valueForItem, currentFilter) => {
     let doesItemFallInValueRange = false;
     const filterField = currentFilter.field;
@@ -41,7 +43,7 @@ const filterItemOnCategoriesWithSingleValue = (categoryValue, currentFilter, ran
         return filterItemOnRangeCategoryType(categoryValue, currentFilter);
     }
     // if filter category is not rangeType
-    if (currentFilter.matchingOperator === 'not-equal') {
+    if (currentFilter.matchingOperator === 'not_equal') {
         return currentFilter.values.indexOf(categoryValue.toString()) === -1;
     }
     return currentFilter.values.indexOf(categoryValue.toString()) > -1;
@@ -115,7 +117,7 @@ export const applyAdvancedFiltersOnList = (entity, allItems, filters, filteredIt
                     ? getCategoryValueForTaskList(key, item)
                     : getCategoryValueForPaymentHistory(key, item);
         if (categoryValue == null) {
-            if (currentFilter.matchingOperator === 'not-equal') {
+            if (currentFilter.matchingOperator === 'not_equal') {
                 return true;
             }
             return false;

package/lib/esm/view/subscriptionView/subscriptionViewSelector.js

@@ -208,7 +208,7 @@ const applyAdvancedFiltersOnCompaniesList = (allCompanies, filters, filteredComp
         const key = currentFilter.field;
         const categoryValue = getCategoryValueForCompany(key, company);
         if (categoryValue == null) {
-            if (currentFilter.matchingOperator === 'not-equal') {
+            if (currentFilter.matchingOperator === 'not_equal') {
                 return true;
             }
             return false;

package/lib/esm/view/taskManager/cannedResponsesView/epics/fetchCannedResponsesEpic.js

@@ -1,5 +1,5 @@
 import { of } from 'rxjs';
-import { catchError, filter, switchMap, mergeMap } from 'rxjs/operators';
+import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { mapCannedResponsePayloadToCannedResponse, } from '../cannedResponsesPayload';
 import { fetchCannedResponses, updateCannedResponses, updateCannedResponsesFetchStatus, } from '../cannedResponsesReducer';

package/lib/esm/view/taskManager/cannedResponsesView/epics/saveCannedResponseEpic.js

@@ -1,5 +1,5 @@
 import { of } from 'rxjs';
-import { catchError, filter, switchMap, mergeMap } from 'rxjs/operators';
+import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { fetchCannedResponses, saveCannedResponse, saveCannedResponseFailure, saveCannedResponseSuccess, } from '../cannedResponsesReducer';
 export const saveCannedResponseEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(saveCannedResponse.match), switchMap((action) => {

package/lib/esm/view/taskManager/taskDetailView/epics/unsnoozeTaskEpic.js

@@ -4,7 +4,7 @@ import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { updateTasks } from '../../../../entity/task/taskReducer';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { fetchTaskList, removeTaskFromList, } from '../../taskListView/taskListReducer';
-import { snoozeTaskSuccessOrFailure, unsnoozeTask, } from '../taskDetailReducer';
+import { snoozeTaskSuccessOrFailure, unsnoozeTask } from '../taskDetailReducer';
 export const unsnoozeTaskEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(unsnoozeTask.match), mergeMap((action) => handleUnsnoozeTask(action.payload.taskId, zeniAPI)));
 const handleUnsnoozeTask = (taskId, zeniAPI) => {
     const unsnoozeTaskApi$ = zeniAPI.deleteAndGetJSON(`${zeniAPI.apiEndPoints.taskMicroServiceBaseUrl}/1.0/task-manager/tasks/${taskId}/snooze`);

package/lib/esm/view/taskManager/taskListView/taskListReducer.js

@@ -66,7 +66,7 @@ export const initialState = {
         categories: [
             {
                 field: 'status',
-                matchingOperator: 'not-equal',
+                matchingOperator: 'not_equal',
                 values: ['resolved'],
                 valuesCombinationOperator: 'ANY',
             },

package/lib/esm/view/transactionDetail/transactionDetailReducer.js

@@ -238,12 +238,34 @@ const transactionDetail = createSlice({
         saveTransactionDetailLocalData(draft, action) {
             const key = getTransactionDetailKey(action.payload.transactionId);
             const detail = recordGet(draft.transactionDetailById, key, undefined);
-            if (detail != null) {
-                draft.transactionDetailById[key] = {
-                    ...detail,
-                    transactionDetailLocalData: action.payload.transactionLocalData,
-                };
+            if (detail == null) {
+                return;
             }
+            const incoming = action.payload.transactionLocalData;
+            const prevById = detail.transactionDetailLocalData.lineItemById;
+            // Per-line `categoryClassRecommendationsFetchState` is owned by the
+            // recommendation epic/reducers (markInProgress / markCompleted /
+            // markFailure / setEntityRecommendationForLineIdsForTransactionDetail).
+            // Callers that rebuild `transactionLocalData` from a UI snapshot will
+            // typically have an out-of-date copy of this field (e.g. payee-change
+            // captures the snapshot before the epic's start arm runs and would
+            // otherwise clobber In-Progress back to undefined). Treat the field as
+            // sticky: only let the caller override it when they explicitly set it.
+            const mergedLineItemById = {};
+            Object.entries(incoming.lineItemById ?? {}).forEach(([lineId, line]) => {
+                mergedLineItemById[lineId] = {
+                    ...line,
+                    categoryClassRecommendationsFetchState: line.categoryClassRecommendationsFetchState ??
+                        prevById?.[lineId]?.categoryClassRecommendationsFetchState,
+                };
+            });
+            draft.transactionDetailById[key] = {
+                ...detail,
+                transactionDetailLocalData: {
+                    ...incoming,
+                    lineItemById: mergedLineItemById,
+                },
+            };
         },
         saveTransactionDetail(draft, action) {
             const key = getTransactionDetailKey(action.payload.transactionId);
@@ -365,6 +387,21 @@ const transactionDetail = createSlice({
                 const detail = recordGet(draft.transactionDetailById, key, undefined);
                 if (detail != null) {
                     const newLocalData = setEntityRecommendationForLineIdInLocalData(transaction, detail.transactionDetailLocalData, action.payload.entity, lineIds, uncategorizedIncomeExpense, recommendationWithCOTByLineId);
+                    // Release the per-line fetch flag for every line this fetch
+                    // covered so the inline skeleton resolves and the page-level
+                    // Save button can re-enable.
+                    lineIds.forEach((lineId) => {
+                        const lineItem = newLocalData.lineItemById[lineId];
+                        if (lineItem != null) {
+                            newLocalData.lineItemById[lineId] = {
+                                ...lineItem,
+                                categoryClassRecommendationsFetchState: {
+                                    fetchState: 'Completed',
+                                    error: undefined,
+                                },
+                            };
+                        }
+                    });
                     draft.transactionDetailById[key] = {
                         ...detail,
                         transactionDetailLocalData: newLocalData,
@@ -385,6 +422,84 @@ const transactionDetail = createSlice({
                 };
             },
         },
+        // Start arm of the line-update recommendations fetch for the detail
+        // page. Flips covered lines to In-Progress; detail page has no
+        // checkbox, so no auto-uncheck side effect.
+        markCategoryClassRecommendationsInProgressForTransactionDetail: {
+            reducer(draft, action) {
+                const { transactionId, lineIds } = action.payload;
+                const key = getTransactionDetailKey(transactionId);
+                const detail = recordGet(draft.transactionDetailById, key, undefined);
+                if (detail != null) {
+                    lineIds.forEach((lineId) => {
+                        const lineItem = detail.transactionDetailLocalData.lineItemById[lineId];
+                        if (lineItem != null) {
+                            detail.transactionDetailLocalData.lineItemById[lineId] = {
+                                ...lineItem,
+                                categoryClassRecommendationsFetchState: {
+                                    fetchState: 'In-Progress',
+                                    error: undefined,
+                                },
+                            };
+                        }
+                    });
+                }
+            },
+            prepare(transactionId, lineIds) {
+                return { payload: { transactionId, lineIds } };
+            },
+        },
+        // Completed arm. Used when the HTTP call succeeded but the server
+        // returned no per-line recommendations — still need to release the
+        // In-Progress flag.
+        markCategoryClassRecommendationsCompletedForTransactionDetail: {
+            reducer(draft, action) {
+                const { transactionId, lineIds } = action.payload;
+                const key = getTransactionDetailKey(transactionId);
+                const detail = recordGet(draft.transactionDetailById, key, undefined);
+                if (detail != null) {
+                    lineIds.forEach((lineId) => {
+                        const lineItem = detail.transactionDetailLocalData.lineItemById[lineId];
+                        if (lineItem != null) {
+                            detail.transactionDetailLocalData.lineItemById[lineId] = {
+                                ...lineItem,
+                                categoryClassRecommendationsFetchState: {
+                                    fetchState: 'Completed',
+                                    error: undefined,
+                                },
+                            };
+                        }
+                    });
+                }
+            },
+            prepare(transactionId, lineIds) {
+                return { payload: { transactionId, lineIds } };
+            },
+        },
+        markCategoryClassRecommendationsFailureForTransactionDetail: {
+            reducer(draft, action) {
+                const { transactionId, lineIds, error } = action.payload;
+                const key = getTransactionDetailKey(transactionId);
+                const detail = recordGet(draft.transactionDetailById, key, undefined);
+                if (detail != null) {
+                    lineIds.forEach((lineId) => {
+                        const lineItem = detail.transactionDetailLocalData.lineItemById[lineId];
+                        if (lineItem != null) {
+                            detail.transactionDetailLocalData.lineItemById[lineId] = {
+                                ...lineItem,
+                                categoryClassRecommendationsFetchState: {
+                                    fetchState: 'Error',
+                                    error,
+                                },
+                            };
+                        }
+                    });
+                }
+            },
+            prepare(transactionId, lineIds, error) {
+                return { payload: { transactionId, lineIds, error } };
+            },
+        },
         removeEntityRecommendationForLineIdForTransactionDetail: {
             reducer(draft, action) {
                 const { transaction, lineId } = action.payload;
@@ -656,7 +771,7 @@ const transactionDetail = createSlice({
         },
     },
 });
-export const { downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentSuccess, downloadAccountingProviderAttachmentFailure, fetchTransactionDetail, updateTransactionDetailFetchState, removeTransactionDetail, clearTransactionDetail, uploadMissingAttachmentSuccess, updateTransactionDetail, updateTransactionDetailSaveStatus, clearTransactionDetailSaveStatus, markTransactionAsNotMiscategorized, deleteTransactionAttachment, deleteTransactionAttachmentFailure, deleteTransactionAttachmentSuccess, updateStatusForTransactionNotMiscategorizedUpdate, updateStatusConsolidatedSaveTransactionDetail, updateTransactionStateIfUpdateActionNotAllowed, saveTransactionDetail, initializeTransactionDetailLocalData, saveTransactionDetailLocalData, clearTransactionDetailLocalData, resetLineItemsCategoryClassInLocalData, setAllLineItemsToCategoryClassInLocalData, setAllLineItemsLocalDataIsUpdateAllChecked, setEntityRecommendationForLineIdsForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, updateSelectedVendor, updateSelectedCustomer, resetVendor, resetSelectedCustomer, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateVendorToAllLineItems, resetAllLineItemsToVendor, updateLatestSelectedEntity, updateVendorBulkRecommendationsFetchStatus, setIsVendorUpdateAllChecked, } = transactionDetail.actions;
+export const { downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentSuccess, downloadAccountingProviderAttachmentFailure, fetchTransactionDetail, updateTransactionDetailFetchState, removeTransactionDetail, clearTransactionDetail, uploadMissingAttachmentSuccess, updateTransactionDetail, updateTransactionDetailSaveStatus, clearTransactionDetailSaveStatus, markTransactionAsNotMiscategorized, deleteTransactionAttachment, deleteTransactionAttachmentFailure, deleteTransactionAttachmentSuccess, updateStatusForTransactionNotMiscategorizedUpdate, updateStatusConsolidatedSaveTransactionDetail, updateTransactionStateIfUpdateActionNotAllowed, saveTransactionDetail, initializeTransactionDetailLocalData, saveTransactionDetailLocalData, clearTransactionDetailLocalData, resetLineItemsCategoryClassInLocalData, setAllLineItemsToCategoryClassInLocalData, setAllLineItemsLocalDataIsUpdateAllChecked, setEntityRecommendationForLineIdsForTransactionDetail, markCategoryClassRecommendationsInProgressForTransactionDetail, markCategoryClassRecommendationsCompletedForTransactionDetail, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, updateSelectedVendor, updateSelectedCustomer, resetVendor, resetSelectedCustomer, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateVendorToAllLineItems, resetAllLineItemsToVendor, updateLatestSelectedEntity, updateVendorBulkRecommendationsFetchStatus, setIsVendorUpdateAllChecked, } = transactionDetail.actions;
 export default transactionDetail.reducer;
 function getUpdatedEntityLocalData(detail, updates, entity, resetRecommendations, type) {
     const key = type === 'customer' ? 'customerUpdates' : 'vendorUpdates';