@zeniai/client-epic-state 5.1.3 → 5.1.4-beta0ND

package/lib/esm/view/onboardingView/customerView/onboardingCustomerViewReducer.js

@@ -1,5 +1,7 @@
 import { createSlice } from '@reduxjs/toolkit';
 import { date } from '../../../zeniDayJS';
+import { parseUploadedKybDocument, parseUploadedKybDocumentFailure, parseUploadedKycDocument, parseUploadedKycDocumentFailure, } from '../../spendManagement/commonSetup/kycKybAutofillActions';
+import { emptyAiAgentsActivationSubview, } from './onboardingCustomerViewState';
 const initialStatus = {
     fetchState: 'Not-Started',
     error: undefined,
@@ -9,61 +11,31 @@ export const initialState = {
     saveStatus: initialStatus,
     dashboardLoadedStatus: initialStatus,
     currentStep: 'link_payment_account',
+    parsingDocumentFileIds: [],
     companyDetails: {
+        autoFilledFields: [],
         localData: undefined,
     },
-    companyOfficerUpdateStatus: {
-        Officer_1: {
+    companyOfficerUpdateStatus: (() => {
+        const emptyOfficerSlot = {
+            autoFilledFields: [],
             localData: undefined,
             sendOtpStatus: initialStatus,
             otpverificationStatus: initialStatus,
-        },
-        Officer_2: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_3: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_4: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_5: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_6: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_7: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_8: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_9: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_10: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-    },
+        };
+        return {
+            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: {},
     paymentAccountDetails: {
         fetchStatus: initialStatus,
@@ -91,6 +63,7 @@ export const initialState = {
     },
     fetchState: 'Not-Started',
     error: undefined,
+    aiAgentsActivation: { ...emptyAiAgentsActivationSubview },
     uiState: {
         isQBOPopupOpen: false,
         isCardPaymentPopupOpen: false,
@@ -180,6 +153,126 @@ const onboardingCustomerView = createSlice({
                 };
             },
         },
+        acknowledgeOnboardingAiFinanceTeam: {
+            reducer(draft) {
+                draft.aiFinanceTeamAcknowledgementStatus = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+            prepare(companyId) {
+                return {
+                    payload: { companyId },
+                };
+            },
+        },
+        acknowledgeOnboardingAiFinanceTeamSuccess(draft) {
+            draft.aiFinanceTeamAcknowledgementStatus = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        acknowledgeOnboardingAiFinanceTeamFailure: {
+            reducer(draft, action) {
+                draft.aiFinanceTeamAcknowledgementStatus = {
+                    fetchState: 'Error',
+                    error: action.payload,
+                };
+            },
+            prepare(error) {
+                return {
+                    payload: error,
+                };
+            },
+        },
+        acknowledgeOnboardingAiActivationViewed: {
+            reducer(draft) {
+                draft.aiActivationViewedAcknowledgementStatus = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+            prepare(companyId) {
+                return {
+                    payload: { companyId },
+                };
+            },
+        },
+        acknowledgeOnboardingAiActivationViewedSuccess(draft) {
+            draft.aiActivationViewedAcknowledgementStatus = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        acknowledgeOnboardingAiActivationViewedFailure: {
+            reducer(draft, action) {
+                draft.aiActivationViewedAcknowledgementStatus = {
+                    fetchState: 'Error',
+                    error: action.payload,
+                };
+            },
+            prepare(error) {
+                return {
+                    payload: error,
+                };
+            },
+        },
+        fetchAiAgentsActivationStatus(draft) {
+            draft.aiAgentsActivation.fetchStatus = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        fetchAiAgentsActivationStatusSuccess: {
+            reducer(draft, action) {
+                draft.aiAgentsActivation.fetchStatus = {
+                    fetchState: 'Completed',
+                    error: undefined,
+                };
+                draft.aiAgentsActivation.phases = action.payload.phases;
+                draft.aiAgentsActivation.counts = action.payload.counts;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        fetchAiAgentsActivationStatusFailure: {
+            reducer(draft, action) {
+                draft.aiAgentsActivation.fetchStatus = {
+                    fetchState: 'Error',
+                    error: action.payload,
+                };
+            },
+            prepare(error) {
+                return { payload: error };
+            },
+        },
+        aiAgentsActivationCountsUpdated: {
+            reducer(draft, action) {
+                draft.aiAgentsActivation.counts = {
+                    ...draft.aiAgentsActivation.counts,
+                    ...action.payload,
+                };
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        aiAgentsActivationPhaseChanged: {
+            reducer(draft, action) {
+                const target = draft.aiAgentsActivation.phases;
+                const index = target.findIndex((phase) => phase.key === action.payload.key);
+                if (index === -1) {
+                    target.push(action.payload);
+                }
+                else {
+                    target[index] = { ...target[index], ...action.payload };
+                }
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
         updateOnboardingCustomerViewDashboardLoaded: {
             reducer(draft) {
                 draft.dashboardLoadedStatus = {
@@ -592,7 +685,82 @@ const onboardingCustomerView = createSlice({
         clearOnboardingCustomerView(draft) {
             Object.assign(draft, initialState);
         },
+        /** Merge AI-parsed officer fields into the officer's onboarding localData. */
+        applyKycDocumentAutofillForOnboarding: {
+            reducer(draft, action) {
+                const { officerType, values, autoFilledFieldNames, fileId } = action.payload;
+                const slot = draft.companyOfficerUpdateStatus[officerType];
+                slot.localData = Object.assign({}, slot.localData, values);
+                slot.autoFilledFields = Array.from(new Set([...(slot.autoFilledFields ?? []), ...autoFilledFieldNames]));
+                draft.parsingDocumentFileIds = (draft.parsingDocumentFileIds ?? []).filter((id) => id !== fileId);
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        /** Merge AI-parsed company fields into companyDetails onboarding localData. */
+        applyKybDocumentAutofillForOnboarding: {
+            reducer(draft, action) {
+                const { values, autoFilledFieldNames, fileId } = action.payload;
+                draft.companyDetails.localData = Object.assign({}, draft.companyDetails.localData, values);
+                const prev = draft.companyDetails.autoFilledFields ?? [];
+                draft.companyDetails.autoFilledFields = Array.from(new Set([...prev, ...autoFilledFieldNames]));
+                draft.parsingDocumentFileIds = (draft.parsingDocumentFileIds ?? []).filter((id) => id !== fileId);
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        /** Wipe AI-autofill badges during onboarding. */
+        clearKycKybAutofillForOnboarding: {
+            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 };
+            },
+        },
+    },
+    extraReducers: (builder) => {
+        const addParsingFileId = (draft, fileId) => {
+            draft.parsingDocumentFileIds = draft.parsingDocumentFileIds ?? [];
+            if (!draft.parsingDocumentFileIds.includes(fileId)) {
+                draft.parsingDocumentFileIds.push(fileId);
+            }
+        };
+        const removeParsingFileId = (draft, fileId) => {
+            draft.parsingDocumentFileIds = (draft.parsingDocumentFileIds ?? []).filter((id) => id !== fileId);
+        };
+        builder.addCase(parseUploadedKycDocument, (draft, action) => {
+            if (action.payload.target === 'onboarding') {
+                addParsingFileId(draft, action.payload.fileId);
+            }
+        });
+        builder.addCase(parseUploadedKybDocument, (draft, action) => {
+            if (action.payload.target === 'onboarding') {
+                addParsingFileId(draft, action.payload.fileId);
+            }
+        });
+        builder.addCase(parseUploadedKycDocumentFailure, (draft, action) => {
+            if (action.payload.target === 'onboarding') {
+                removeParsingFileId(draft, action.payload.fileId);
+            }
+        });
+        builder.addCase(parseUploadedKybDocumentFailure, (draft, action) => {
+            if (action.payload.target === 'onboarding') {
+                removeParsingFileId(draft, action.payload.fileId);
+            }
+        });
     },
 });
-export const { fetchOnboardingCustomerView, fetchOnboardingCustomerSetupView, fetchOnboardingCustomerSetupViewSuccess, fetchOnboardingCustomerSetupViewFailure, updateOnboardingCustomerViewCompleteStatus, updateOnboardingCustomerViewCompleteStatusSuccess, updateOnboardingCustomerViewCompleteStatusFailure, updateOnboardingCustomerViewDashboardLoaded, updateOnboardingCustomerViewDashboardLoadedSuccess, updateOnboardingCustomerViewDashboardLoadedFailure, updateOnboardingCustomerView, updateOnboardingCustomerViewSuccess, updateOnboardingCustomerViewFailure, updateOnboardingPaymentAccountStatus, updateOnboardingPaymentAccountStatusSuccess, updateOnboardingPaymentAccountStatusFailure, updateOnboardingPaymentAccountLoginStatus, updateOnboardingPaymentAccountLoginStatusSuccess, updateOnboardingPaymentAccountLoginStatusFailure, establishOnboardingPlaidConnection, establishOnboardingPlaidConnectionSuccess, establishOnboardingPlaidConnectionFailure, getOnboardingPlaidLinkToken, getOnboardingPlaidLinkTokenSuccess, getOnboardingPlaidLinkTokenFailure, updateCurrentStep, updateOnboardingCustomerViewAccountDetails, updateOnboardingCustomerViewLocalStoreData, saveOnboardingCustomerViewDataInLocalStore, saveOnboardingCompnayOfficerPhoneInLocalStore, updateOnboardingCustomerViewUIState, sendOnboardingOfficerOtp, sendOnboardingOfficerOtpSuccess, sendOnboardingOfficerOtpFailure, resendOnboardingOfficerOtp, verifyOnboardingOfficerOtp, verifyOnboardingOfficerOtpSuccess, verifyOnboardingOfficerOtpFailure, clearOnboardingCustomerViewDataInLocalStore, clearOnboardingCustomerView, } = onboardingCustomerView.actions;
+export const { fetchOnboardingCustomerView, fetchOnboardingCustomerSetupView, fetchOnboardingCustomerSetupViewSuccess, fetchOnboardingCustomerSetupViewFailure, updateOnboardingCustomerViewCompleteStatus, updateOnboardingCustomerViewCompleteStatusSuccess, updateOnboardingCustomerViewCompleteStatusFailure, acknowledgeOnboardingAiFinanceTeam, acknowledgeOnboardingAiFinanceTeamSuccess, acknowledgeOnboardingAiFinanceTeamFailure, acknowledgeOnboardingAiActivationViewed, acknowledgeOnboardingAiActivationViewedSuccess, acknowledgeOnboardingAiActivationViewedFailure, fetchAiAgentsActivationStatus, fetchAiAgentsActivationStatusSuccess, fetchAiAgentsActivationStatusFailure, aiAgentsActivationCountsUpdated, aiAgentsActivationPhaseChanged, updateOnboardingCustomerViewDashboardLoaded, updateOnboardingCustomerViewDashboardLoadedSuccess, updateOnboardingCustomerViewDashboardLoadedFailure, updateOnboardingCustomerView, updateOnboardingCustomerViewSuccess, updateOnboardingCustomerViewFailure, updateOnboardingPaymentAccountStatus, updateOnboardingPaymentAccountStatusSuccess, updateOnboardingPaymentAccountStatusFailure, updateOnboardingPaymentAccountLoginStatus, updateOnboardingPaymentAccountLoginStatusSuccess, updateOnboardingPaymentAccountLoginStatusFailure, establishOnboardingPlaidConnection, establishOnboardingPlaidConnectionSuccess, establishOnboardingPlaidConnectionFailure, getOnboardingPlaidLinkToken, getOnboardingPlaidLinkTokenSuccess, getOnboardingPlaidLinkTokenFailure, updateCurrentStep, updateOnboardingCustomerViewAccountDetails, updateOnboardingCustomerViewLocalStoreData, saveOnboardingCustomerViewDataInLocalStore, saveOnboardingCompnayOfficerPhoneInLocalStore, updateOnboardingCustomerViewUIState, sendOnboardingOfficerOtp, sendOnboardingOfficerOtpSuccess, sendOnboardingOfficerOtpFailure, resendOnboardingOfficerOtp, verifyOnboardingOfficerOtp, verifyOnboardingOfficerOtpSuccess, verifyOnboardingOfficerOtpFailure, clearOnboardingCustomerViewDataInLocalStore, clearOnboardingCustomerView, applyKycDocumentAutofillForOnboarding, applyKybDocumentAutofillForOnboarding, clearKycKybAutofillForOnboarding, } = onboardingCustomerView.actions;
 export default onboardingCustomerView.reducer;

package/lib/esm/view/onboardingView/customerView/onboardingCustomerViewSelector.js

@@ -8,10 +8,10 @@ import { getUserRoleByUserIds } from '../../../entity/userRole/userRoleSelector'
 import { getCompanyConfig } from '../../companyConfigView/companyConfigSelector';
 import { getCompanyView } from '../../companyView/selectorHelpers/getCompanyView';
 import { getCompanyAndIdentityDetails, } from '../../spendManagement/commonSetup/setupViewSelector';
-import { ALL_ONBOARDING_STEPS, ALL_ZENI_USER_ONBOARDING_STEPS, REQUIRED_ONBOARDING_STEPS, ZENI_USER_REQUIRED_ONBOARDING_STEPS, toOnboardingStepType, } from './onboardingCustomerViewState';
+import { ALL_ONBOARDING_STEPS, ALL_ZENI_USER_ONBOARDING_STEPS, REQUIRED_ONBOARDING_STEPS, ZENI_USER_REQUIRED_ONBOARDING_STEPS, emptyAiAgentsActivationSubview, toOnboardingStepType, } from './onboardingCustomerViewState';
 export function getOnboardingCustomerView(state, companyId) {
     const { fileState, paymentAccountState, onboardingCustomerViewState, userState, userRoleState, subscriptionPaymentAccountState, companyConfigState, cardPaymentViewState, countryListState, addressViewState, } = state;
-    const { companyDetails, companyOfficerUpdateStatus, primaryContactDetails, subscriptionPaymentAccountIds, paymentAccountDetails, plaidConnectionDetails, updateStatus, saveStatus, currentStep, uiState, fetchState, error, } = onboardingCustomerViewState;
+    const { companyDetails, companyOfficerUpdateStatus, primaryContactDetails, subscriptionPaymentAccountIds, paymentAccountDetails, plaidConnectionDetails, parsingDocumentFileIds, updateStatus, saveStatus, currentStep, uiState, fetchState, error, } = onboardingCustomerViewState;
     const { paymentAccountIds } = paymentAccountDetails;
     let subscriptionPaymentAccount;
     let paymentAccount;
@@ -54,6 +54,7 @@ export function getOnboardingCustomerView(state, companyId) {
         companyDetails,
         companyOfficerUpdateStatus,
         primaryContactDetails,
+        parsingDocumentFileIds,
     });
     const companyAddress = addressViewState.newAddressState?.company_address;
     if (companyAddress == null &&
@@ -119,6 +120,7 @@ export function getOnboardingCustomerView(state, companyId) {
     return {
         companyDetailsLocalData,
         companyOfficerLocalData,
+        parsingDocumentFileIds,
         subscriptionBillingAddress: subscriptionBillingAddress?.addressToCreate,
         companyView,
         allNationalityCountries,
@@ -323,3 +325,11 @@ export const getProductSettingsString = (productSettings) => {
         .map((key) => productKeyMap[key])
         .join(',');
 };
+const fromActivationView = (state) => 
+// Fall back to the empty subview so state hydrated from an older persisted
+// version (before aiAgentsActivation existed) doesn't crash on .phases/.counts.
+state.onboardingCustomerViewState.aiAgentsActivation ??
+    emptyAiAgentsActivationSubview;
+export const getAiAgentsActivationSubview = (state) => fromActivationView(state);
+export const getAiAgentsActivationPhases = (state) => fromActivationView(state).phases;
+export const getAiAgentsActivationCounts = (state) => fromActivationView(state).counts;

package/lib/esm/view/onboardingView/customerView/onboardingCustomerViewState.js

@@ -26,3 +26,15 @@ export const ALL_ONBOARDING_STEPS = [
     ...ALL_ZENI_USER_ONBOARDING_STEPS_WITHOUT_ACCOUNT,
 ];
 export const toOnboardingStepType = (v) => stringToUnion(v, ALL_ONBOARDING_STEPS);
+export const emptyAiAgentsActivationCounts = {
+    customerCount: 0,
+    glAccountCount: 0,
+    targetTransactionCount: 0,
+    transactionCount: 0,
+    vendorCount: 0,
+};
+export const emptyAiAgentsActivationSubview = {
+    counts: emptyAiAgentsActivationCounts,
+    fetchStatus: { fetchState: 'Not-Started', error: undefined },
+    phases: [],
+};

package/lib/esm/view/spendManagement/cashManagement/autoSweepFlow/autoSweepFlowPayload.js

@@ -20,8 +20,8 @@ export const toAutoSweepFlowStatePatch = (payload) => {
     return {
         bufferAmount: toAmount(payload.minimum_buffer_usd, currencyCode ?? 'USD', currencySymbol ?? '$'),
         frequency: toAutoSweepFrequency(payload.frequency) ?? 'weekly',
-        nextTransferDate: payload.next_transfer_date != null && payload.next_transfer_date !== ''
-            ? date(payload.next_transfer_date)
+        nextTransferDate: payload.next_run_date != null && payload.next_run_date !== ''
+            ? date(payload.next_run_date)
             : undefined,
         primaryFundingAccountId: payload.source_bank_account.deposit_account_id ?? undefined,
         settingsId: payload.cash_management_settings_id ?? undefined,

package/lib/esm/view/spendManagement/commonSetup/epic/setup/parseUploadedKybDocumentEpic.js

@@ -0,0 +1,58 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { isSuccessResponse } from '../../../../../responsePayload';
+import { applyKybDocumentAutofillForOnboarding } from '../../../../onboardingView/customerView/onboardingCustomerViewReducer';
+import { parseUploadedKybDocument, parseUploadedKybDocumentFailure, } from '../../kycKybAutofillActions';
+import { mapCoiToCompanyDetails, mapTaxEinToCompanyDetails, } from '../../kycKybParseMapper';
+import { applyKybDocumentAutofillForSetup } from '../../setupViewReducer';
+const PROCESS_DOCUMENT_SYNC_PATH = '/1.0/documents/process/sync';
+export const parseUploadedKybDocumentEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(parseUploadedKybDocument.match), mergeMap((action) => {
+    const { target, companyId, fileId, documentType } = action.payload;
+    const url = `${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}${PROCESS_DOCUMENT_SYNC_PATH}`;
+    const requestPayload = {
+        provided_document_type: documentType,
+        files: [{ file_id: fileId }],
+        processing_priority: 10,
+        metadata: { source: 'kyc_kyb_autofill' },
+    };
+    const failureAction = parseUploadedKybDocumentFailure({ target, fileId });
+    return zeniAPI
+        .postAndGetJSON(url, requestPayload)
+        .pipe(mergeMap((response) => {
+        if (!isSuccessResponse(response) || response.data == null) {
+            return of(failureAction);
+        }
+        // Sync API returns a batch envelope: `data.files[0].extracted_data`
+        // is the parser payload; `data` itself is the request-level wrapper.
+        const extracted = response.data.files?.[0]?.extracted_data;
+        if (extracted == null) {
+            return of(failureAction);
+        }
+        let result;
+        switch (documentType) {
+            case 'certificate_of_incorporation':
+                result = mapCoiToCompanyDetails(extracted);
+                break;
+            case 'tax_ein':
+                result = mapTaxEinToCompanyDetails(extracted);
+                break;
+        }
+        if (result.autoFilledFieldNames.length === 0) {
+            return of(failureAction);
+        }
+        const applyAction = target === 'setup'
+            ? applyKybDocumentAutofillForSetup({
+                companyId,
+                fileId,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            })
+            : applyKybDocumentAutofillForOnboarding({
+                companyId,
+                fileId,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            });
+        return of(applyAction);
+    }), catchError(() => of(failureAction)));
+}));

package/lib/esm/view/spendManagement/commonSetup/epic/setup/parseUploadedKycDocumentEpic.js

@@ -0,0 +1,77 @@
+import { from, of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { isSuccessResponse } from '../../../../../responsePayload';
+import { newAddressInLocalStore } from '../../../../addressView/addressViewReducer';
+import { applyKycDocumentAutofillForOnboarding } from '../../../../onboardingView/customerView/onboardingCustomerViewReducer';
+import { parseUploadedKycDocument, parseUploadedKycDocumentFailure, } from '../../kycKybAutofillActions';
+import { mapDrivingLicenseToOfficer, mapPassportToOfficer, mapSsnCardToOfficer, } from '../../kycKybParseMapper';
+import { applyKycDocumentAutofillForSetup } from '../../setupViewReducer';
+const PROCESS_DOCUMENT_SYNC_PATH = '/1.0/documents/process/sync';
+export const parseUploadedKycDocumentEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(parseUploadedKycDocument.match), mergeMap((action) => {
+    const { target, companyId, officerType, fileId, documentType } = action.payload;
+    const url = `${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}${PROCESS_DOCUMENT_SYNC_PATH}`;
+    const requestPayload = {
+        provided_document_type: documentType,
+        files: [{ file_id: fileId }],
+        processing_priority: 10,
+        metadata: { source: 'kyc_kyb_autofill' },
+    };
+    const failureAction = parseUploadedKycDocumentFailure({ target, fileId });
+    return zeniAPI
+        .postAndGetJSON(url, requestPayload)
+        .pipe(mergeMap((response) => {
+        if (!isSuccessResponse(response) || response.data == null) {
+            return of(failureAction);
+        }
+        // Sync API returns a batch envelope: `data.files[0].extracted_data`
+        // is the parser payload; `data` itself is the request-level wrapper
+        // ({request_id, status, files, metadata, ...}). Drill in before
+        // dispatching to the mapper.
+        const extracted = response.data.files?.[0]?.extracted_data;
+        if (extracted == null) {
+            return of(failureAction);
+        }
+        let result;
+        switch (documentType) {
+            case 'passport':
+                result = mapPassportToOfficer(extracted);
+                break;
+            case 'driving_license':
+                result = mapDrivingLicenseToOfficer(extracted);
+                break;
+            case 'social_security_card':
+                result = mapSsnCardToOfficer(extracted);
+                break;
+        }
+        if (result.autoFilledFieldNames.length === 0) {
+            return of(failureAction);
+        }
+        const applyAction = target === 'setup'
+            ? applyKycDocumentAutofillForSetup({
+                companyId,
+                officerType,
+                fileId,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            })
+            : applyKycDocumentAutofillForOnboarding({
+                companyId,
+                officerType,
+                fileId,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            });
+        const actions = [applyAction];
+        // Driving licenses also carry the home address, which lives in the
+        // addressView slice (keyed `officer_<n>_address`). Seed it so the
+        // section's address field + ✦ badge pick it up.
+        if (result.address != null) {
+            const addressType = `${officerType.toLowerCase()}_address`;
+            actions.push(newAddressInLocalStore({
+                addressType,
+                addressToCreate: result.address,
+            }));
+        }
+        return from(actions);
+    }), catchError(() => of(failureAction)));
+}));

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

@@ -0,0 +1,14 @@
+/**
+ * Trigger actions for the KYC / KYB autofill epics.
+ *
+ * These actions don't mutate state — the epic listens for them, calls
+ * document-communication-agent's sync endpoint, and dispatches the appropriate
+ * `applyKyc/KybDocumentAutofillFor{Setup,Onboarding}` against the matching
+ * slice. Co-located with the rest of the commonSetup module because the entire
+ * autofill flow is auxiliary to the setup view; there is no separate state.
+ */
+import { createAction } from '@reduxjs/toolkit';
+export const parseUploadedKycDocument = createAction('commonSetup/parseUploadedKycDocument');
+export const parseUploadedKybDocument = createAction('commonSetup/parseUploadedKybDocument');
+export const parseUploadedKycDocumentFailure = createAction('commonSetup/parseUploadedKycDocumentFailure');
+export const parseUploadedKybDocumentFailure = createAction('commonSetup/parseUploadedKybDocumentFailure');