@zeniai/client-epic-state 5.0.84 → 5.0.85-beta0ND

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

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapTaxEinToCompanyDetails = exports.mapCoiToCompanyDetails = exports.mapSsnCardToOfficer = exports.mapDrivingLicenseToOfficer = exports.mapPassportToOfficer = void 0;
+const zeniDayJS_1 = require("../../../zeniDayJS");
+const zeniUrl_1 = require("../../../zeniUrl");
+const kycKybAutofill_1 = require("./types/kycKybAutofill");
+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 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. */
+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;
+};
+exports.mapPassportToOfficer = mapPassportToOfficer;
+/** Driving License → Company Officer. */
+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;
+};
+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,28 @@ 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;
+    officerType: CompanyOfficerType;
+    values: Partial<CompanyOfficerLocalData>;
+}], {
+    autoFilledFieldNames: string[];
+    companyId: ID;
+    officerType: CompanyOfficerType;
+    values: Partial<CompanyOfficerLocalData>;
+}, "setupView/applyKycDocumentAutofillForSetup", never, never>, applyKybDocumentAutofillForSetup: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    autoFilledFieldNames: string[];
+    companyId: ID;
+    values: Partial<CompanyDetailsLocalData>;
+}], {
+    autoFilledFieldNames: string[];
+    companyId: 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,32 @@
 "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 initialFetchStatus = {
     fetchState: 'Not-Started',
     error: undefined,
 };
+const emptyOfficerSlot = {
+    autoFilledFields: [],
+    localData: undefined,
+    sendOtpStatus: initialFetchStatus,
+    otpverificationStatus: initialFetchStatus,
+};
 exports.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: {},
 };
@@ -301,7 +267,60 @@ 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 } = 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 };
+            },
+        },
     },
 });
-_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

@@ -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>;

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

@@ -124,6 +124,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 +197,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,

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;

package/lib/view/spendManagement/commonSetup/types/kycKybAutofill.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 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.
+ */
+import { ID } from '../../../../commonStateTypes/common';
+/**
+ * Form-side identity document types as picked in `SelectDocumentField`.
+ * These are camelCase per the web-components convention.
+ */
+export type KycSelectDocumentType = 'driverLicense' | 'passport' | 'ssnCard' | 'stateId';
+/**
+ * KYC document types accepted by the document-service parsers (snake_case).
+ * Subset of {@link KycKybProvidedDocumentType}. `stateId` from the form maps
+ * to no parser today and is skipped at dispatch time.
+ */
+export type KycProvidedDocumentType = 'passport' | 'driving_license' | 'social_security_card';
+/** KYB document types accepted by the document-service parsers. */
+export type KybProvidedDocumentType = 'certificate_of_incorporation' | 'tax_ein';
+/** All KYC / KYB document types accepted by document-communication-agent. */
+export type KycKybProvidedDocumentType = KycProvidedDocumentType | KybProvidedDocumentType;
+/** Field value with model confidence (0..1) as returned by ExtendAI parsers. */
+export interface FieldWithConfidence<T = string | null> {
+    confidence: number;
+    value: T | null;
+}
+/**
+ * Parser payloads — keep in sync with document-service
+ * `processors/parsers/extend_*_parser.py`.
+ */
+export interface ExtendPassportParsed {
+    date_of_birth?: FieldWithConfidence;
+    date_of_expiry?: FieldWithConfidence;
+    date_of_issue?: FieldWithConfidence;
+    first_name?: FieldWithConfidence;
+    gender?: FieldWithConfidence;
+    issuing_authority?: FieldWithConfidence;
+    last_name?: FieldWithConfidence;
+    mrz_line_1?: FieldWithConfidence;
+    mrz_line_2?: FieldWithConfidence;
+    nationality?: FieldWithConfidence;
+    passport_number?: FieldWithConfidence;
+    place_of_birth?: FieldWithConfidence;
+}
+export interface ExtendDrivingLicenseParsed {
+    address_city?: FieldWithConfidence;
+    address_state?: FieldWithConfidence;
+    address_street?: FieldWithConfidence;
+    address_zip?: FieldWithConfidence;
+    date_of_birth?: FieldWithConfidence;
+    date_of_expiry?: FieldWithConfidence;
+    date_of_issue?: FieldWithConfidence;
+    first_name?: FieldWithConfidence;
+    issuing_state?: FieldWithConfidence;
+    last_name?: FieldWithConfidence;
+    license_number?: FieldWithConfidence;
+    middle_name?: FieldWithConfidence;
+}
+export interface ExtendSsnCardParsed {
+    full_name?: FieldWithConfidence;
+}
+export interface ExtendCertificateOfIncorporationParsed {
+    company_address?: FieldWithConfidence;
+    company_legal_name?: FieldWithConfidence;
+    countries_of_operations?: FieldWithConfidence<string[]>;
+    date_of_incorporation?: FieldWithConfidence;
+    ein?: FieldWithConfidence;
+    industry?: FieldWithConfidence;
+    phone_number?: FieldWithConfidence;
+    product_description?: FieldWithConfidence;
+    purpose_of_account?: FieldWithConfidence;
+    registered_address?: FieldWithConfidence;
+    regulated_status?: FieldWithConfidence;
+    source_of_funds?: FieldWithConfidence;
+    state_of_incorporation?: FieldWithConfidence;
+    sub_industry?: FieldWithConfidence;
+    sub_us_nexus?: FieldWithConfidence;
+    transaction_volume_expectations?: FieldWithConfidence;
+    type_of_incorporation?: FieldWithConfidence;
+    us_nexus?: FieldWithConfidence;
+    website?: FieldWithConfidence;
+}
+export interface ExtendTaxEinParsed {
+    ein?: FieldWithConfidence;
+    irs_address?: FieldWithConfidence;
+    legal_business_name?: FieldWithConfidence;
+    trade_name?: FieldWithConfidence;
+}
+/** POST /1.0/documents/process/sync request body. */
+export interface SyncDocumentsProcessRequest {
+    files: Array<{
+        file_id: ID;
+    }>;
+    provided_document_type: KycKybProvidedDocumentType;
+    metadata?: {
+        source?: string;
+    } & Record<string, unknown>;
+    processing_priority?: number;
+}
+/** POST /1.0/documents/process/sync response body. */
+export interface SyncDocumentsProcessResponse {
+    data: ExtendPassportParsed | ExtendDrivingLicenseParsed | ExtendSsnCardParsed | ExtendCertificateOfIncorporationParsed | ExtendTaxEinParsed | null;
+    status: {
+        code: number;
+        message: string;
+    };
+}
+/**
+ * Discriminator for which Redux slice to apply the autofill to — setup pages
+ * (`spendManagement/commonSetup`) and onboarding (`onboardingView/customerView`)
+ * share the same field shapes but live in separate slices.
+ */
+export type KycKybAutofillTarget = 'setup' | 'onboarding';
+/** Confidence floor below which we drop an autofill candidate. */
+export declare 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 declare const toKycProvidedDocumentType: (selectType: KycSelectDocumentType) => KycProvidedDocumentType | null;

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

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toKycProvidedDocumentType = exports.KYC_KYB_AUTOFILL_MIN_CONFIDENCE = void 0;
+/** Confidence floor below which we drop an autofill candidate. */
+exports.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.
+ */
+const toKycProvidedDocumentType = (selectType) => {
+    switch (selectType) {
+        case 'driverLicense':
+            return 'driving_license';
+        case 'passport':
+            return 'passport';
+        case 'ssnCard':
+            return 'social_security_card';
+        case 'stateId':
+            return null;
+    }
+};
+exports.toKycProvidedDocumentType = toKycProvidedDocumentType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.0.84",
+  "version": "5.0.85-beta0ND",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",