@zeniai/client-epic-state 5.1.0-betaSS3 → 5.1.1-beta0ND

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUploadedKybDocumentFailure = exports.parseUploadedKycDocumentFailure = exports.parseUploadedKybDocument = exports.parseUploadedKycDocument = void 0;
+/**
+ * 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.
+ */
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.parseUploadedKycDocument = (0, toolkit_1.createAction)('commonSetup/parseUploadedKycDocument');
+exports.parseUploadedKybDocument = (0, toolkit_1.createAction)('commonSetup/parseUploadedKybDocument');
+exports.parseUploadedKycDocumentFailure = (0, toolkit_1.createAction)('commonSetup/parseUploadedKycDocumentFailure');
+exports.parseUploadedKybDocumentFailure = (0, toolkit_1.createAction)('commonSetup/parseUploadedKybDocumentFailure');

package/lib/view/spendManagement/commonSetup/kycKybParseMapper.d.ts

@@ -0,0 +1,29 @@
+import { AddressUpdatableInfo } from '../../addressView/addressViewState';
+import { CompanyDetailsLocalData, CompanyOfficerLocalData } from './setupViewState';
+import { ExtendCertificateOfIncorporationParsed, ExtendDrivingLicenseParsed, ExtendPassportParsed, ExtendSsnCardParsed, ExtendTaxEinParsed } from './types/kycKybAutofill';
+export interface AutofillResult<TLocalData> {
+    autoFilledFieldNames: (keyof TLocalData & string)[];
+    values: Partial<TLocalData>;
+}
+/**
+ * Officer mappers may additionally produce an address (driving license only).
+ * The officer's address lives in the `addressView` slice — not in
+ * `CompanyOfficerLocalData` — so it is returned separately and the consuming
+ * epic dispatches `newAddressInLocalStore` for it. The synthetic field name
+ * `'officerAddress'` is appended to `autoFilledFieldNames` so the form section
+ * shows the ✦ badge next to the address field.
+ */
+export interface OfficerAutofillResult extends AutofillResult<CompanyOfficerLocalData> {
+    address?: AddressUpdatableInfo;
+}
+export declare const OFFICER_ADDRESS_AUTOFILL_FIELD = "officerAddress";
+/** Passport → Company Officer. */
+export declare const mapPassportToOfficer: (parsed: ExtendPassportParsed) => AutofillResult<CompanyOfficerLocalData>;
+/** Driving License → Company Officer (name, DOB, and home address). */
+export declare const mapDrivingLicenseToOfficer: (parsed: ExtendDrivingLicenseParsed) => OfficerAutofillResult;
+/** SSN Card → Company Officer (name only — SSN value not yet returned by parser). */
+export declare const mapSsnCardToOfficer: (parsed: ExtendSsnCardParsed) => AutofillResult<CompanyOfficerLocalData>;
+/** Certificate of Incorporation → Company Details. */
+export declare const mapCoiToCompanyDetails: (parsed: ExtendCertificateOfIncorporationParsed) => AutofillResult<CompanyDetailsLocalData>;
+/** Tax EIN letter → Company Details. */
+export declare const mapTaxEinToCompanyDetails: (parsed: ExtendTaxEinParsed) => AutofillResult<CompanyDetailsLocalData>;

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

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapTaxEinToCompanyDetails = exports.mapCoiToCompanyDetails = exports.mapSsnCardToOfficer = exports.mapDrivingLicenseToOfficer = exports.mapPassportToOfficer = exports.OFFICER_ADDRESS_AUTOFILL_FIELD = void 0;
+/**
+ * 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.
+ */
+const zeniDayJS_1 = require("../../../zeniDayJS");
+const zeniUrl_1 = require("../../../zeniUrl");
+const kycKybAutofill_1 = require("./types/kycKybAutofill");
+exports.OFFICER_ADDRESS_AUTOFILL_FIELD = 'officerAddress';
+// US driving licenses carry a US state in `address_state` but no country field;
+// default the composed address to the US.
+const DRIVING_LICENSE_DEFAULT_COUNTRY = 'United States';
+const DRIVING_LICENSE_DEFAULT_COUNTRY_CODE = 'US';
+const emptyResult = () => ({
+    values: {},
+    autoFilledFieldNames: [],
+});
+const isConfident = (field) => {
+    if (field == null) {
+        return false;
+    }
+    if (field.value == null) {
+        return false;
+    }
+    return field.confidence >= kycKybAutofill_1.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 = (0, zeniDayJS_1.date)(rawDate);
+    if (parsedDate.isValid()) {
+        return parsedDate;
+    }
+    return undefined;
+};
+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. */
+const mapPassportToOfficer = (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);
+        }
+    }
+    // The raw nationality string (e.g. "USA", "UNITED STATES OF AMERICA") is
+    // passed through unresolved; the consuming form section normalizes it to an
+    // ISO-2 code via the `countries-list` dataset before `setValue`. The form
+    // value (not this localData seed) is what gets submitted.
+    if (isConfident(parsed.nationality)) {
+        assignAutofilledValue(result, 'nationalityCountryCode', parsed.nationality.value);
+    }
+    return result;
+};
+exports.mapPassportToOfficer = mapPassportToOfficer;
+/** Driving License → Company Officer (name, DOB, and home address). */
+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);
+        }
+    }
+    // The officer address lives in the addressView slice rather than
+    // CompanyOfficerLocalData, so it's returned separately for the epic to
+    // dispatch via newAddressInLocalStore.
+    const street = isConfident(parsed.address_street)
+        ? parsed.address_street.value.trim()
+        : undefined;
+    const city = isConfident(parsed.address_city)
+        ? parsed.address_city.value.trim()
+        : undefined;
+    const state = isConfident(parsed.address_state)
+        ? parsed.address_state.value.trim()
+        : undefined;
+    const postalCode = isConfident(parsed.address_zip)
+        ? parsed.address_zip.value.trim()
+        : undefined;
+    if (street != null || city != null || state != null || postalCode != null) {
+        result.address = {
+            street: street != null ? [street] : [],
+            city: city ?? '',
+            state: state ?? '',
+            postalCode: postalCode ?? '',
+            country: DRIVING_LICENSE_DEFAULT_COUNTRY,
+            countryCode: DRIVING_LICENSE_DEFAULT_COUNTRY_CODE,
+        };
+        result.autoFilledFieldNames.push(exports.OFFICER_ADDRESS_AUTOFILL_FIELD);
+    }
+    return result;
+};
+exports.mapDrivingLicenseToOfficer = mapDrivingLicenseToOfficer;
+/** SSN Card → Company Officer (name only — SSN value not yet returned by parser). */
+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;
+};
+exports.mapSsnCardToOfficer = mapSsnCardToOfficer;
+/** Certificate of Incorporation → Company Details. */
+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', (0, zeniUrl_1.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;
+};
+exports.mapCoiToCompanyDetails = mapCoiToCompanyDetails;
+/** Tax EIN letter → Company Details. */
+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;
+};
+exports.mapTaxEinToCompanyDetails = mapTaxEinToCompanyDetails;

package/lib/view/spendManagement/commonSetup/setupViewReducer.d.ts

@@ -2,7 +2,7 @@ import { ID } from '../../../commonStateTypes/common';
 import { ZeniAPIStatus } from '../../../responsePayload';
 import { ZeniDate } from '../../../zeniDayJS';
 import { CompanyOfficerType } from '../../companyView/types/companyPassport/companyUsersLocalData';
-import { CompanyDetailsLocalData, SetupViewLocalData, SetupViewState } from './setupViewState';
+import { CompanyDetailsLocalData, CompanyOfficerLocalData, SetupViewLocalData, SetupViewState } from './setupViewState';
 export declare const initialState: SetupViewState;
 export declare const enableSetup: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[companyId: string, setupViewType: "bill_pay" | "reimbursement" | "zeni_accounts" | "zeni_treasury" | "charge_cards" | "other_connection" | "billing" | "debit_cards" | "charge_cards__debit_cards"], {
     companyId: string;
@@ -29,6 +29,32 @@ export declare const enableSetup: import("@reduxjs/toolkit").ActionCreatorWithPr
 }, "setupView/sendOtpSuccess">, sendOtpFailureSpendManagementSetUp: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "setupView/sendOtpFailure">, verifyOtpSpendManagementSetUp: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"setupView/verifyOtp">, verifyOtpSuccessSpendManagementSetUp: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"setupView/verifyOtpSuccess">, verifyOtpFailureSpendManagementSetUp: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "setupView/verifyOtpFailure">, saveIndustryAndIncDateInLocalStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     incDate: ZeniDate;
     industry: string;
-}, "setupView/saveIndustryAndIncDateInLocalStore">, clearSetupViewDataInLocalStore: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"setupView/clearSetupViewDataInLocalStore">, clearSetupView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"setupView/clearSetupView">;
+}, "setupView/saveIndustryAndIncDateInLocalStore">, clearSetupViewDataInLocalStore: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"setupView/clearSetupViewDataInLocalStore">, clearSetupView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"setupView/clearSetupView">, applyKycDocumentAutofillForSetup: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    autoFilledFieldNames: string[];
+    companyId: ID;
+    fileId: ID;
+    officerType: CompanyOfficerType;
+    values: Partial<CompanyOfficerLocalData>;
+}], {
+    autoFilledFieldNames: string[];
+    companyId: ID;
+    fileId: ID;
+    officerType: CompanyOfficerType;
+    values: Partial<CompanyOfficerLocalData>;
+}, "setupView/applyKycDocumentAutofillForSetup", never, never>, applyKybDocumentAutofillForSetup: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    autoFilledFieldNames: string[];
+    companyId: ID;
+    fileId: ID;
+    values: Partial<CompanyDetailsLocalData>;
+}], {
+    autoFilledFieldNames: string[];
+    companyId: ID;
+    fileId: ID;
+    values: Partial<CompanyDetailsLocalData>;
+}, "setupView/applyKybDocumentAutofillForSetup", never, never>, clearKycKybAutofillForSetup: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload?: {
+    officerType?: CompanyOfficerType;
+} | undefined], {
+    officerType?: CompanyOfficerType;
+}, "setupView/clearKycKybAutofillForSetup", never, never>;
 declare const _default: import("redux").Reducer<SetupViewState>;
 export default _default;

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

@@ -1,66 +1,34 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clearSetupView = exports.clearSetupViewDataInLocalStore = exports.saveIndustryAndIncDateInLocalStore = exports.verifyOtpFailureSpendManagementSetUp = exports.verifyOtpSuccessSpendManagementSetUp = exports.verifyOtpSpendManagementSetUp = exports.sendOtpFailureSpendManagementSetUp = exports.sendOtpSuccessSpendManagementSetUp = exports.resendOtpSpendManagementSetUp = exports.sendOtpSpendManagementSetUp = exports.saveTreasuryAdditionalDocumentsInLocalStore = exports.saveCompnayOfficerAdditionalDocumentsInLocalStore = exports.saveCompnayOfficerPhoneInLocalStore = exports.saveSetupViewDataInLocalStore = exports.updateSetupViewLocalStoreData = exports.updateSelectedCompanyOfficer = exports.updateBusinessVerificationDetailsFailure = exports.updateBusinessVerificationDetailsSuccess = exports.updateBusinessVerificationDetails = exports.enableSetupFailure = exports.enableSetupSuccess = exports.enableSetup = exports.initialState = void 0;
+exports.clearKycKybAutofillForSetup = exports.applyKybDocumentAutofillForSetup = exports.applyKycDocumentAutofillForSetup = exports.clearSetupView = exports.clearSetupViewDataInLocalStore = exports.saveIndustryAndIncDateInLocalStore = exports.verifyOtpFailureSpendManagementSetUp = exports.verifyOtpSuccessSpendManagementSetUp = exports.verifyOtpSpendManagementSetUp = exports.sendOtpFailureSpendManagementSetUp = exports.sendOtpSuccessSpendManagementSetUp = exports.resendOtpSpendManagementSetUp = exports.sendOtpSpendManagementSetUp = exports.saveTreasuryAdditionalDocumentsInLocalStore = exports.saveCompnayOfficerAdditionalDocumentsInLocalStore = exports.saveCompnayOfficerPhoneInLocalStore = exports.saveSetupViewDataInLocalStore = exports.updateSetupViewLocalStoreData = exports.updateSelectedCompanyOfficer = exports.updateBusinessVerificationDetailsFailure = exports.updateBusinessVerificationDetailsSuccess = exports.updateBusinessVerificationDetails = exports.enableSetupFailure = exports.enableSetupSuccess = exports.enableSetup = exports.initialState = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
+const kycKybAutofillActions_1 = require("./kycKybAutofillActions");
 const initialFetchStatus = {
     fetchState: 'Not-Started',
     error: undefined,
 };
+const emptyOfficerSlot = {
+    autoFilledFields: [],
+    localData: undefined,
+    sendOtpStatus: initialFetchStatus,
+    otpverificationStatus: initialFetchStatus,
+};
 exports.initialState = {
     updateStatus: { fetchState: 'Not-Started', error: undefined },
-    companyDetails: {},
+    parsingDocumentFileIds: [],
+    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: {},
 };
@@ -301,7 +269,93 @@ const setupView = (0, toolkit_1.createSlice)({
         clearSetupView(draft) {
             Object.assign(draft, exports.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, 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.localData and track
+         * which field names were autofilled.
+         */
+        applyKybDocumentAutofillForSetup: {
+            reducer(draft, action) {
+                const { values, autoFilledFieldNames, fileId } = action.payload;
+                draft.companyDetails.localData = Object.assign({}, draft.companyDetails.localData, values);
+                draft.companyDetails.autoFilledFields = Array.from(new Set([
+                    ...(draft.companyDetails.autoFilledFields ?? []),
+                    ...autoFilledFieldNames,
+                ]));
+                draft.parsingDocumentFileIds = (draft.parsingDocumentFileIds ?? []).filter((id) => id !== fileId);
+            },
+            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 };
+            },
+        },
+    },
+    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(kycKybAutofillActions_1.parseUploadedKycDocument, (draft, action) => {
+            if (action.payload.target === 'setup') {
+                addParsingFileId(draft, action.payload.fileId);
+            }
+        });
+        builder.addCase(kycKybAutofillActions_1.parseUploadedKybDocument, (draft, action) => {
+            if (action.payload.target === 'setup') {
+                addParsingFileId(draft, action.payload.fileId);
+            }
+        });
+        builder.addCase(kycKybAutofillActions_1.parseUploadedKycDocumentFailure, (draft, action) => {
+            if (action.payload.target === 'setup') {
+                removeParsingFileId(draft, action.payload.fileId);
+            }
+        });
+        builder.addCase(kycKybAutofillActions_1.parseUploadedKybDocumentFailure, (draft, action) => {
+            if (action.payload.target === 'setup') {
+                removeParsingFileId(draft, action.payload.fileId);
+            }
+        });
     },
 });
-_a = setupView.actions, exports.enableSetup = _a.enableSetup, exports.enableSetupSuccess = _a.enableSetupSuccess, exports.enableSetupFailure = _a.enableSetupFailure, exports.updateBusinessVerificationDetails = _a.updateBusinessVerificationDetails, exports.updateBusinessVerificationDetailsSuccess = _a.updateBusinessVerificationDetailsSuccess, exports.updateBusinessVerificationDetailsFailure = _a.updateBusinessVerificationDetailsFailure, exports.updateSelectedCompanyOfficer = _a.updateSelectedCompanyOfficer, exports.updateSetupViewLocalStoreData = _a.updateSetupViewLocalStoreData, exports.saveSetupViewDataInLocalStore = _a.saveSetupViewDataInLocalStore, exports.saveCompnayOfficerPhoneInLocalStore = _a.saveCompnayOfficerPhoneInLocalStore, exports.saveCompnayOfficerAdditionalDocumentsInLocalStore = _a.saveCompnayOfficerAdditionalDocumentsInLocalStore, exports.saveTreasuryAdditionalDocumentsInLocalStore = _a.saveTreasuryAdditionalDocumentsInLocalStore, exports.sendOtpSpendManagementSetUp = _a.sendOtp, exports.resendOtpSpendManagementSetUp = _a.resendOtp, exports.sendOtpSuccessSpendManagementSetUp = _a.sendOtpSuccess, exports.sendOtpFailureSpendManagementSetUp = _a.sendOtpFailure, exports.verifyOtpSpendManagementSetUp = _a.verifyOtp, exports.verifyOtpSuccessSpendManagementSetUp = _a.verifyOtpSuccess, exports.verifyOtpFailureSpendManagementSetUp = _a.verifyOtpFailure, exports.saveIndustryAndIncDateInLocalStore = _a.saveIndustryAndIncDateInLocalStore, exports.clearSetupViewDataInLocalStore = _a.clearSetupViewDataInLocalStore, exports.clearSetupView = _a.clearSetupView;
+_a = setupView.actions, exports.enableSetup = _a.enableSetup, exports.enableSetupSuccess = _a.enableSetupSuccess, exports.enableSetupFailure = _a.enableSetupFailure, exports.updateBusinessVerificationDetails = _a.updateBusinessVerificationDetails, exports.updateBusinessVerificationDetailsSuccess = _a.updateBusinessVerificationDetailsSuccess, exports.updateBusinessVerificationDetailsFailure = _a.updateBusinessVerificationDetailsFailure, exports.updateSelectedCompanyOfficer = _a.updateSelectedCompanyOfficer, exports.updateSetupViewLocalStoreData = _a.updateSetupViewLocalStoreData, exports.saveSetupViewDataInLocalStore = _a.saveSetupViewDataInLocalStore, exports.saveCompnayOfficerPhoneInLocalStore = _a.saveCompnayOfficerPhoneInLocalStore, exports.saveCompnayOfficerAdditionalDocumentsInLocalStore = _a.saveCompnayOfficerAdditionalDocumentsInLocalStore, exports.saveTreasuryAdditionalDocumentsInLocalStore = _a.saveTreasuryAdditionalDocumentsInLocalStore, exports.sendOtpSpendManagementSetUp = _a.sendOtp, exports.resendOtpSpendManagementSetUp = _a.resendOtp, exports.sendOtpSuccessSpendManagementSetUp = _a.sendOtpSuccess, exports.sendOtpFailureSpendManagementSetUp = _a.sendOtpFailure, exports.verifyOtpSpendManagementSetUp = _a.verifyOtp, exports.verifyOtpSuccessSpendManagementSetUp = _a.verifyOtpSuccess, exports.verifyOtpFailureSpendManagementSetUp = _a.verifyOtpFailure, exports.saveIndustryAndIncDateInLocalStore = _a.saveIndustryAndIncDateInLocalStore, exports.clearSetupViewDataInLocalStore = _a.clearSetupViewDataInLocalStore, exports.clearSetupView = _a.clearSetupView, exports.applyKycDocumentAutofillForSetup = _a.applyKycDocumentAutofillForSetup, exports.applyKybDocumentAutofillForSetup = _a.applyKybDocumentAutofillForSetup, exports.clearKycKybAutofillForSetup = _a.clearKycKybAutofillForSetup;
 exports.default = setupView.reducer;

package/lib/view/spendManagement/commonSetup/setupViewSelector.d.ts

@@ -16,7 +16,7 @@ import { CompanyOfficerType } from '../../companyView/types/companyPassport/comp
 import { CompanyView } from '../../companyView/types/companyView';
 import { AccountTypeSubConfigCodeKeyType } from '../billPay/billPayConfig/billPayConfigState';
 import { PlaidAccountKeyType, PlaidConnectionDetails } from '../plaidAccount/plaidAccountViewState';
-import { CompanyAndIdentityDetails, CompanyOfficerLocalData, PrimaryContactLocalData, SetupViewType } from './setupViewState';
+import { CompanyAndIdentityDetails, CompanyOfficerLocalData, PrimaryContactLocalData, SetupViewState, SetupViewType } from './setupViewState';
 export interface SetupView {
     accountFetchStatus: FetchStateAndError;
     accountUpdateStatus: FetchStateAndError;
@@ -54,6 +54,8 @@ export interface FundingAccount {
 }
 export interface CompanyOfficersDetails extends CompanyOfficerLocalData {
     additionalFiles: File[];
+    /** Field names in this officer's localData populated by AI doc autofill. */
+    autoFilledFields: string[];
     deleteFileStatusById: Record<ID, FetchStateAndError | undefined>;
     otpverificationStatus: FetchStateAndError;
     sendOtpStatus: FetchStateAndError;
@@ -62,6 +64,8 @@ export interface CompanyOfficersDetails extends CompanyOfficerLocalData {
     addressStatus?: NewAddressData;
 }
 export interface CompanyDetails {
+    /** Field names in companyDetails localData populated by AI doc autofill. */
+    autoFilledFields: string[];
     companyFiles: File[];
     companyId: ID;
     deleteFileStatusById: Record<ID, FetchStateAndError | undefined>;
@@ -96,6 +100,7 @@ export interface CompanyDetails {
 }
 interface CompanyAndOfficerLocalData {
     companyOfficerLocalData: Record<CompanyOfficerType, CompanyOfficersDetails | undefined>;
+    parsingDocumentFileIds: ID[];
     companyDetailsLocalData?: CompanyDetails;
 }
 export interface BusinessVerificationDetails extends CompanyAndOfficerLocalData {
@@ -105,7 +110,7 @@ export interface BusinessVerificationDetails extends CompanyAndOfficerLocalData
 }
 export declare function getCommonSetupViewDetails(state: RootState, companyId: ID, setupViewType: SetupViewType, plaidAccountKeyType: PlaidAccountKeyType): SetupView;
 export declare function getBusinessVerificationDetails(state: RootState, companyId: ID): BusinessVerificationDetails;
-export declare const getCompanyAndIdentityDetails: (state: RootState, companyId: ID, companyAndIdentityDetails: CompanyAndIdentityDetails) => CompanyAndOfficerLocalData;
+export declare const getCompanyAndIdentityDetails: (state: RootState, companyId: ID, companyAndIdentityDetails: CompanyAndIdentityDetails & Pick<SetupViewState, "parsingDocumentFileIds">) => CompanyAndOfficerLocalData;
 export declare const getAllFundingAccounts: (depositAccounts: DepositAccount[], paymentAccounts: PaymentAccount[], paymentAccountBalanceFetchStatus: Record<ID, FetchStateAndError>, includeOnlyVerifiedAccounts?: boolean) => FundingAccount[];
 export declare const mapDepositAccToFundingAccount: (depositAcc: DepositAccount) => FundingAccount;
 export declare const mapDepositAccountWithLimitToFundingAccount: (depositAcc: DepositAccountWithLimit) => FundingAccount;

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

@@ -92,15 +92,17 @@ function getBusinessVerificationDetails(state, companyId) {
     const { setupViewState, countryListState } = state;
     const { companyDetails, companyOfficerUpdateStatus, primaryContactDetails, updateStatus, } = setupViewState;
     const companyView = (0, getCompanyView_1.getCompanyView)(state, companyId, []);
-    const { companyDetailsLocalData, companyOfficerLocalData } = (0, exports.getCompanyAndIdentityDetails)(state, companyId, {
+    const { companyDetailsLocalData, companyOfficerLocalData, parsingDocumentFileIds, } = (0, exports.getCompanyAndIdentityDetails)(state, companyId, {
         companyDetails,
         companyOfficerUpdateStatus,
         primaryContactDetails,
+        parsingDocumentFileIds: setupViewState.parsingDocumentFileIds,
     });
     const allNationalityCountries = countryListState.byCountryListCode.nationalityCountryList.countries;
     return {
         companyDetailsLocalData,
         companyOfficerLocalData,
+        parsingDocumentFileIds,
         companyView,
         updateStatus,
         allNationalityCountries,
@@ -124,6 +126,7 @@ const getCompanyAndIdentityDetails = (state, companyId, companyAndIdentityDetail
         const companyAddress = addressViewState.newAddressState?.company_address;
         const registeredCompanyAddress = addressViewState.newAddressState?.company_registered_address;
         companyDetailsLocalData = {
+            autoFilledFields: companyDetails.autoFilledFields,
             companyId,
             companyDescription,
             companyLegalName,
@@ -196,6 +199,7 @@ const getCompanyAndIdentityDetails = (state, companyId, companyAndIdentityDetail
             const companyOfficerAddress = addressViewState.newAddressState?.[addressType];
             companyOfficerLocalData[officerType] = {
                 ...companyOfficer.localData,
+                autoFilledFields: companyOfficer.autoFilledFields,
                 userFiles: (0, fileSelector_1.getFilesByFileIds)(fileState, fileIds),
                 additionalFiles: (0, fileSelector_1.getFilesByFileIds)(fileState, additionalSubmittedDocumentsForVerificationFileIds),
                 deleteFileStatusById,
@@ -209,6 +213,7 @@ const getCompanyAndIdentityDetails = (state, companyId, companyAndIdentityDetail
     return {
         companyDetailsLocalData,
         companyOfficerLocalData,
+        parsingDocumentFileIds: companyAndIdentityDetails.parsingDocumentFileIds,
     };
 };
 exports.getCompanyAndIdentityDetails = getCompanyAndIdentityDetails;

package/lib/view/spendManagement/commonSetup/setupViewState.d.ts

@@ -81,9 +81,21 @@ export interface SetupViewLocalData {
  */
 export interface CompanyAndIdentityDetails {
     companyDetails: {
+        /**
+         * Field names from {@link CompanyDetailsLocalData} that were populated by AI
+         * autofill from an uploaded KYB document. Drives the ✦ sparkle in the form.
+         * Always present (empty when no autofill has run yet).
+         */
+        autoFilledFields: string[];
         localData?: CompanyDetailsLocalData;
     };
     companyOfficerUpdateStatus: Record<CompanyOfficerType, {
+        /**
+         * Field names from {@link CompanyOfficerLocalData} populated by AI autofill
+         * from an uploaded KYC identity document. Drives the ✦ sparkle in the form.
+         * Always present (empty when no autofill has run yet).
+         */
+        autoFilledFields: string[];
         otpverificationStatus: FetchStateAndError;
         sendOtpStatus: FetchStateAndError;
         localData?: CompanyOfficerLocalData;
@@ -93,6 +105,13 @@ export interface CompanyAndIdentityDetails {
     };
 }
 export interface SetupViewState extends CompanyAndIdentityDetails {
+    /**
+     * File IDs currently being parsed by the AI autofill epic. Populated when
+     * `parseUploadedKyc/KybDocument` dispatches and cleared when the
+     * corresponding apply / failure action fires. Drives the "AI is reading
+     * your document" overlay on the document upload field.
+     */
+    parsingDocumentFileIds: ID[];
     updateStatus: FetchStateAndError;
 }
 export {};